locust 命令

常用示例

说明

Locust is an open-source load testing tool written in Python. It allows you to define user behavior in Python code, making tests flexible and version-controllable. Users are simulated as greenlets (lightweight threads), enabling thousands of concurrent users on a single machine. Tests are defined in a locustfile containing user classes. Each user class defines tasks (HTTP requests or other operations) with optional weights for probability. The @task decorator marks methods as tasks, and between() sets wait times between requests. The web UI (default port 8089) provides real-time statistics, charts, and controls. You can start/stop tests, adjust user counts, and download results. For CI/CD integration, headless mode runs without the UI. Distributed mode scales across multiple machines. One master coordinates workers, aggregating statistics and controlling the test. Workers simulate users and report back. This enables millions of requests per second from commodity hardware. Locust supports custom protocols beyond HTTP through custom clients. The event system allows hooks for custom logging, metrics, and integration with monitoring systems.

参数

-f, --locustfile _FILE_

Path to Python locustfile (default: locustfile.py).

-H, --host _URL_

Host to load test.

-u, --users _NUM_

Peak number of concurrent users.

-r, --spawn-rate _NUM_

Users spawned per second.

-t, --run-time _TIME_

Stop after specified time (e.g., 300s, 5m, 1h).

--headless

Run without web UI.

--autostart

Start test immediately without waiting.

--autoquit _SECONDS_

Quit after test completes (headless mode).

--web-host _HOST_

Host for web interface (default: all interfaces).

--web-port _PORT_

Port for web interface (default: 8089).

--master

Run as distributed master node.

--worker

Run as distributed worker node.

--master-host _HOST_

Master node hostname (for workers).

--master-port _PORT_

Master node port (default: 5557).

--expect-workers _NUM_

Wait for workers before starting (master only).

--csv _PREFIX_

Export results to CSV files with prefix.

--html _FILE_

Generate HTML report.

--json

Output results as JSON.

--loglevel _LEVEL_

Log level: DEBUG, INFO, WARNING, ERROR.

--exit-code-on-error _CODE_

Exit code when errors occur.

-L, --list

List available user classes.