Locust性能測試6-命令行參數詳解

前言

當我們在linux上使用locust工具壓測的時候，會使用no-web模式，然后需要收集運行的日志，方便查找問題。

命令行參數

輸入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.
 --heartbeat-liveness=HEARTBEAT_LIVENESS
 set number of seconds before failed heartbeat from
 slave
 --heartbeat-interval=HEARTBEAT_INTERVAL
 set number of seconds delay between slave heartbeats
 to master
 --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 [DEPRECATED] Do not reset statistics once hatching has
 been completed. This is now the default behavior. See
 --reset-stats to disable
 --reset-stats Reset statistics once hatching has been completed.
 Should be set on both master and slaves when running
 in distributed mode
 -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	HOST	指定被測試的主機，采用以格式：http://10.21.32.33
–web-host=WEB_HOST	WEB_HOST	指定運行 Locust Web 頁面的主機，默認為空 “。
-P PORT, –port=PORT, –web-port=PORT	PORT	指定 –web-host 的端口，默認是8089
-f LOCUSTFILE, –locustfile=LOCUSTFILE	LOCUSTFILE	指定運行 Locust 性能測試文件，默認為: locustfile.py
–csv=CSVFILEBASE, –csv-base-name=CSVFILEBASE	CSVFILEBASE	以CSV格式存儲當前請求測試數據。
–master	不帶參數	Locust 分布式模式使用，當前節點為 master 節點。
–slave	不帶參數	Locust 分布式模式使用，當前節點為 slave 節點。
–master-host=MASTER_HOST	MASTER_HOST	分布式模式運行，設置 master 節點的主機或 IP 地址，只在與 –slave 節點一起運行時使用，默認為：127.0.0.1.
–master-port=MASTER_PORT	MASTER_PORT	分布式模式運行， 設置 master 節點的端口號，只在與 –slave 節點一起運行時使用，默認為：5557。注意，slave 節點也將連接到這個端口+1 上的 master 節點。
–master-bind-host=MASTER_BIND_HOST	MASTER_BIND_HOST	做分布式壓測時，指定分機IP。只用於master。如果沒有指定，默認是所有可用的IP(即所有標記主機IP的slave)
–master-bind-port=MASTER_BIND_PORT	MASTER_BIND_PORT	做分布式壓測時，指定分機port。默認是5557與5558。
–no-web no-web	-c 和 -r 配合	模式運行測試，需要 -c 和 -r 配合使用.
-c NUM_CLIENTS, –clients=NUM_CLIENTS	NUM_CLIENTS	指定並發用戶數，作用於 –no-web 模式。
-r HATCH_RATE, –hatch-rate=HATCH_RATE	HATCH_RATE	指定每秒啟動的用戶數，作用於 –no-web 模式。
-t RUN_TIME, –run-time=RUN_TIME	RUN_TIME	設置運行時間, 例如： (300s, 20m, 3h, 1h30m). 作用於 –no-web 模式。
-L LOGLEVEL, –loglevel=LOGLEVEL	LOGLEVEL	選擇 log 級別（DEBUG/INFO/WARNING/ERROR/CRITICAL）. 默認是 INFO.
–logfile=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 工具的版本.