下面是所有可用配置选项的表,以及它们对应的环境和配置文件键:
命令行 | 环境 | 配置文件 | 描述 |
---|---|---|---|
-f, --locustfile | LOCUST_LOCUSTFILE | locustfile | 要导入的Python模块,例如’ …/other_test.py '。a.py文件或一个包目录。默认为“locustfile” |
-H, --host | LOCUST_HOST | host | 主机加载测试的格式如下:http://10.21.32.33 |
-u, --users | LOCUST_USERS | users | Locust并发用户数的峰值。主要与-headless或-autostart一起使用。可以在测试期间通过键盘输入w, W(生成1,10个用户)和s,S(停止1,10个用户)进行更改 |
-r, --spawn-rate | LOCUST_SPAWN_RATE | spawn-rate | 生成用户的速率(每秒用户)。主要与-headless或-autostart一起使用 |
–hatch-rate | LOCUST_HATCH_RATE | hatch-rate | 阻止(进程或活动) |
-t, --run-time | LOCUST_RUN_TIME | run-time | 在规定的时间后停止,如(300s、20m、3h、1h30m等)。只能与-headless或-autostart一起使用。默认永远运行。 |
–web-host | LOCUST_WEB_HOST | web-host | web界面绑定的主机。默认为’ * '(所有接口) |
–web-port, -P | LOCUST_WEB_PORT | web-port | 运行web主机的端口 |
–headless | LOCUST_HEADLESS | headless | 关闭web界面,立即开始测试。使用-u和-t控制用户数量和运行时间 |
–autostart | LOCUST_AUTOSTART | autostart | 立即启动测试(不禁用web界面)。使用-u和-t控制用户数量和运行时间 |
–autoquit | LOCUST_AUTOQUIT | autoquit | 在运行结束X秒后完全退出Locust只能与-autostart一起使用。默认值是保持Locust运行,直到使用CTRL+C关闭它 |
–headful | LOCUST_HEADFUL | headful | SUPPRESS |
–web-auth | LOCUST_WEB_AUTH | web-auth | 打开web界面的基本认证。应以以下格式提供:用户名:密码 |
–tls-cert | LOCUST_TLS_CERT | tls-cert | 可选用于HTTPS服务的TLS证书路径 |
–tls-key | LOCUST_TLS_KEY | tls-key | 可选TLS私钥路径,用于HTTPS服务 |
–master | LOCUST_MODE_MASTER | master | 将locust设置为以分布式模式运行,该进程作为主进程 |
–master-bind-host | LOCUST_MASTER_BIND_HOST | master-bind-host | locust主机应该绑定到的接口(主机名,ip)。仅在使用-master运行时使用。默认为*(所有可用接口)。 |
–master-bind-port | LOCUST_MASTER_BIND_PORT | master-bind-port | locust主机应该绑定到的端口。仅在使用-master运行时使用。默认为5557。 |
–expect-workers | LOCUST_EXPECT_WORKERS | expect-workers | 在开始测试之前,master应该期望连接多少worker(仅在使用-headless /autostart时)。 |
–expect-workers-max-wait | LOCUST_EXPECT_WORKERS_MAX_WAIT | expect-workers-max-wait | master应该等workers连接多久才放弃。默认永远等待 |
–worker | LOCUST_MODE_WORKER | worker | 1将locust设置为以分布式模式运行,并将此进程设置为辅助进程 |
–master-host | LOCUST_MASTER_NODE_HOST | master-host | 用于分布式负载测试的locust主机或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] _fails .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 | 刷出完成后重置统计信息。在分布式模式下运行时,是否应该同时设置在主节点和工作节点上 |
–html | LOCUST_HTML | html | 存储HTML报告到指定的文件路径 |
–skip-log-setup | LOCUST_SKIP_LOG_SETUP | skip-log-setup | 禁用Locust的日志记录设置。相反,该配置由Locust测试或Python默认值提供。 |
–loglevel, -L | LOCUST_LOGLEVEL | loglevel | 可选择 DEBUG/INFO/WARNING/ERROR/CRITICAL. 默认 INFO. |
–logfile | LOCUST_LOGFILE | logfile | 日志文件的路径。如果没有设置,log将转到stderr |
–exit-code-on-error | LOCUST_EXIT_CODE_ON_ERROR | exit-code-on-error | 设置在测试结果包含任何失败或错误时使用的进程退出代码 |
-s, --stop-timeout | LOCUST_STOP_TIMEOUT | stop-timeout | 在退出前等待模拟用户完成任何正在执行的任务的秒数。默认是立即终止。该参数只在运行Locust分布式时需要为主进程指定。 |