03-Locust-命令行运行及参数说明

目录

命令行运行

所有参数选项

---

命令行运行

• 新建文件test.py

# -*- coding: utf-8 -*-
# @Time    : 2021/4/3
# @Author  : 大海

from locust import HttpUser, task, constant


class MyUser(HttpUser):
    # 固定间隔时间
    wait_time = constant(1)

    @task
    def my_task(self):
        self.client.get('/')

• locust -f test.py --host=http://baidu.com  --headless -u 1000 -r 100 --run-time 1m

    启动参数

• --headless：无UI界面
• -u：并发用户数
• -r：每秒产生的用户数
• -t：运行的时间

所有参数选项

命令行	环境	配置文件	描述
-f， --locustfile	LOCUST_LOCUSTFILE	locustfile	要导入的Python模块文件，例如'../other.py'。默认值：locustfile
-H， --host	LOCUST_HOST	host	主机以以下格式加载测试：http : //10.21.32.33
-u， --users	LOCUST_USERS	users	并发蝗虫用户数。主要与–headless一起使用。可以在测试期间通过输入w，W（生成1，10个用户）和s，S（停止1，10个用户）来更改
-r， --spawn-rate	LOCUST_SPAWN_RATE	spawn-rate	产生用户的每秒速率。主要与–headless一起使用
--hatch-rate	LOCUST_HATCH_RATE	hatch-rate	==抑制==
-t， --run-time	LOCUST_RUN_TIME	run-time	在指定的时间段后停止，例如（300s，20m，3h，1h30m等）。仅与–headless一起使用。默认为永久运行。
--web-host	LOCUST_WEB_HOST	web-host	将Web界面绑定到的主机。默认为“ *”（所有接口）
--web-port， -P	LOCUST_WEB_PORT	web-port	运行虚拟主机的端口
--headless	LOCUST_HEADLESS	headless	禁用Web界面，而是立即开始负载测试。需要指定-u和-t。
--headful	LOCUST_HEADFUL	headful	==抑制==
--web-auth	LOCUST_WEB_AUTH	web-auth	打开Web界面的基本身份验证。应该以以下格式提供：username：password
--tls-cert	LOCUST_TLS_CERT	tls-cert	用于通过HTTPS服务的TLS证书的可选路径
--tls-key	LOCUST_TLS_KEY	tls-key	用于通过HTTPS服务的TLS私钥的可选路径
--master	LOCUST_MODE_MASTER	master	将蝗虫设置为以该进程为主的分布式模式下运行
--master-bind-host	LOCUST_MASTER_BIND_HOST	master-bind-host	蝗虫主机应绑定的接口（主机名，ip）。仅在与–master一起运行时使用。默认为*（所有可用接口）。
--master-bind-port	LOCUST_MASTER_BIND_PORT	master-bind-port	蝗虫主应该绑定的端口。仅在与–master一起运行时使用。默认为5557
--expect-workers	LOCUST_EXPECT_WORKERS	expect-workers	主机在开始测试之前应该期望连接多少工人（仅当使用–headless时）。
--worker	LOCUST_MODE_WORKER	worker	将蝗虫设置为以分布式模式运行，并以该进程作为工作进程
--master-host	LOCUST_MASTER_NODE_HOST	master-host	用于分布式负载测试的蝗虫主服务器的主机或IP地址。仅在与–worker一起运行时使用。默认为127.0.0.1。
--master-port	LOCUST_MASTER_NODE_PORT	master-port	蝗虫主服务器使用与之连接的端口进行分布式负载测试。仅在与–worker一起运行时使用。默认为5557
-T， --tags	LOCUST_TAGS	tags	测试中要包含的标签列表，因此仅执行具有任何匹配标签的任务
-E， --exclude-tags	LOCUST_EXCLUDE_TAGS	exclude-tags	要从测试中排除的标签列表，因此仅执行没有匹配标签的任务
--csv	LOCUST_CSV	csv	将当前请求统计信息以CSV格式存储到文件中。设置此选项将生成三个文件：[CSV_PREFIX] _stats.csv，[CSV_PREFIX] _stats_history.csv和[CSV_PREFIX] _failures.csv
--csv-full-history	LOCUST_CSV_FULL_HISTORY	csv-full-history	将每个统计信息条目以CSV格式存储到_stats_history.csv文件中。您还必须指定“ –csv”参数以启用此功能。
--print-stats	LOCUST_PRINT_STATS	print-stats	在控制台中打印统计信息
--only-summary	LOCUST_ONLY_SUMMARY	only-summary	仅打印摘要统计信息
--reset-stats	LOCUST_RESET_STATS	reset-stats	产卵完成后重置统计信息。在分布式模式下运行时，应同时在master和worker上设置
--html	LOCUST_HTML	html	存储HTML报告文件
--skip-log-setup	LOCUST_SKIP_LOG_SETUP	skip-log-setup	禁用蝗虫的日志记录设置。而是由Locust测试或Python默认设置提供配置。
--loglevel， -L	LOCUST_LOGLEVEL	loglevel	在DEBUG / INFO / WARNING / ERROR / CRITICAL之间进行选择。默认值为INFO。
--logfile	LOCUST_LOGFILE	logfile	日志文件的路径。如果未设置，日志将转到stdout / stderr
--exit-code-on-error	LOCUST_EXIT_CODE_ON_ERROR	exit-code-on-error	设置流程退出代码以在测试结果包含任何故障或错误时使用
-s， --stop-timeout	LOCUST_STOP_TIMEOUT	stop-timeout	退出之前等待模拟用户完成任何正在执行的任务的秒数。默认为立即终止。仅在运行Locust分布式时才需要为主进程指定此参数。