最時候該講一下 locust 工具的參數了,雖然前面幾節我們已經使用了不少參數,例如 “-f” 、“–host” 等。
Locust 參數
打開命令提示符(或Linux終端),輸入 locust --help
。
> locust --help Usage: locust [options] [LocustClass [LocustClass2 ... ]] Options: -h, --help show this help message and exit -H HOST, --host=HOST Host to load test in the following format: http://10.21.32.33 --web-host=WEB_HOST Host to bind the web interface to. Defaults to '' (all interfaces) -P PORT, --port=PORT, --web-port=PORT Port on which to run web host -f LOCUSTFILE, --locustfile=LOCUSTFILE Python module file to import, e.g. '../other.py'. Default: locustfile --csv=CSVFILEBASE, --csv-base-name=CSVFILEBASE Store current request stats to files in CSV format. --master Set locust to run in distributed mode with this process as master --slave Set locust to run in distributed mode with this process as slave --master-host=MASTER_HOST Host or IP address of locust master for distributed load testing. Only used when running with --slave. Defaults to 127.0.0.1. --master-port=MASTER_PORT The port to connect to that is used by the locust master for distributed load testing. Only used when running with --slave. Defaults to 5557. Note that slaves will also connect to the master node on this port + 1. --master-bind-host=MASTER_BIND_HOST Interfaces (hostname, ip) that locust master should bind to. Only used when running with --master. Defaults to * (all available interfaces). --master-bind-port=MASTER_BIND_PORT Port that locust master should bind to. Only used when running with --master. Defaults to 5557. Note that Locust will also use this port + 1, so by default the master node will bind to 5557 and 5558. --expect-slaves=EXPECT_SLAVES How many slaves master should expect to connect before starting the test (only when --no-web used). --no-web Disable the web interface, and instead start running the test immediately. Requires -c and -r to be specified. -c NUM_CLIENTS, --clients=NUM_CLIENTS Number of concurrent Locust users. Only used together with --no-web -r HATCH_RATE, --hatch-rate=HATCH_RATE The rate per second in which clients are spawned. Only used together with --no-web -t RUN_TIME, --run-time=RUN_TIME Stop after the specified amount of time, e.g. (300s, 20m, 3h, 1h30m, etc.). Only used together with --no- web -L LOGLEVEL, --loglevel=LOGLEVEL Choose between DEBUG/INFO/WARNING/ERROR/CRITICAL. Default is INFO. --logfile=LOGFILE Path to log file. If not set, log will go to stdout/stderr --print-stats Print stats in the console --only-summary Only print the summary stats --no-reset-stats Do not reset statistics once hatching has been completed -l, --list Show list of possible locust classes and exit --show-task-ratio print table of the locust classes' task execution ratio --show-task-ratio-json print json data of the locust classes' task execution ratio -V, --version show program's version number and exit
參數說明:
參數 | 說明 |
---|---|
-h, –help | 查看幫助 |
-H HOST, –host=HOST | 指定被測試的主機,采用以格式:http://10.21.32.33 |
–web-host=WEB_HOST | 指定運行 Locust Web 頁面的主機,默認為空 “。 |
-P PORT, –port=PORT, –web-port=PORT | 指定 –web-host 的端口,默認是8089 |
-f LOCUSTFILE, –locustfile=LOCUSTFILE | 指定運行 Locust 性能測試文件,默認為: locustfile.py |
–csv=CSVFILEBASE, –csv-base-name=CSVFILEBASE | 以CSV格式存儲當前請求測試數據。 |
–master | Locust 分布式模式使用,當前節點為 master 節點。 |
–slave | Locust 分布式模式使用,當前節點為 slave 節點。 |
–master-host=MASTER_HOST | 分布式模式運行,設置 master 節點的主機或 IP 地址,只在與 –slave 節點一起運行時使用,默認為:127.0.0.1. |
–master-port=MASTER_PORT | 分布式模式運行, 設置 master 節點的端口號,只在與 –slave 節點一起運行時使用,默認為:5557。注意,slave 節點也將連接到這個端口+1 上的 master 節點。 |
–master-bind-host=MASTER_BIND_HOST | Interfaces (hostname, ip) that locust master should bind to. Only used when running with –master. Defaults to * (all available interfaces). |
–master-bind-port=MASTER_BIND_PORT | Port that locust master should bind to. Only used when running with –master. Defaults to 5557. Note that Locust will also use this port + 1, so by default the master node will bind to 5557 and 5558. |
–expect-slaves=EXPECT_SLAVES | How many slaves master should expect to connect before starting the test (only when –no-web used). |
–no-web | no-web 模式運行測試,需要 -c 和 -r 配合使用. |
-c NUM_CLIENTS, –clients=NUM_CLIENTS | 指定並發用戶數,作用於 –no-web 模式。 |
-r HATCH_RATE, –hatch-rate=HATCH_RATE | 指定每秒啟動的用戶數,作用於 –no-web 模式。 |
-t RUN_TIME, –run-time=RUN_TIME | 設置運行時間, 例如: (300s, 20m, 3h, 1h30m). 作用於 –no-web 模式。 |
-L LOGLEVEL, –loglevel=LOGLEVEL | 選擇 log 級別(DEBUG/INFO/WARNING/ERROR/CRITICAL). 默認是 INFO. |
–logfile=LOGFILE | 日志文件路徑。如果沒有設置,日志將去 stdout/stderr |
–print-stats | 在控制台中打印數據 |
–only-summary | 只打印摘要統計 |
–no-reset-stats | Do not reset statistics once hatching has been completed。 |
-l, –list | 顯示測試類, 配置 -f 參數使用 |
–show-task-ratio | 打印 locust 測試類的任務執行比例,配合 -f 參數使用. |
–show-task-ratio-json | 以 json 格式打印 locust 測試類的任務執行比例,配合 -f 參數使用. |
-V, –version | 查看當前 Locust 工具的版本. |
個別參數,我沒用過,也太清楚其含義,暫時就不翻譯了。