locust

all

Load-testing tool to determine number of concurrent users a system can handle.

Options (4)

-H, --hostboolean

Load-test "example.com" with web interface using locustfile.py

Example: locust {{[-H|--host]}} {{http://example.com}}

-f, --locustfileboolean

Use a different test file

Example: locust {{[-H|--host]}} {{http://example.com}} {{[-f|--locustfile]}} {{test_file.py}}

-u, --usersboolean

Run test without web interface, spawning 1 user a second until there are 100 users

Example: locust {{[-H|--host]}} {{http://example.com}} --headless {{[-u|--users]}} 100 {{[-r|--spawn-rate]}} 1

-r, --spawn-rateboolean

Run test without web interface, spawning 1 user a second until there are 100 users

Example: locust {{[-H|--host]}} {{http://example.com}} --headless {{[-u|--users]}} 100 {{[-r|--spawn-rate]}} 1

Load-test "example.com" with web interface using locustfile.py

locust [-H|--host] http://example.com

Use a different test file

locust [-H|--host] http://example.com [-f|--locustfile] test_file.py

Run test without web interface, spawning 1 user a second until there are 100 users

locust [-H|--host] http://example.com --headless [-u|--users] 100 [-r|--spawn-rate] 1

Start Locust in master mode

locust [-H|--host] http://example.com --master

Connect Locust worker to master

locust [-H|--host] http://example.com --worker

Connect Locust worker to master on a different machine

locust [-H|--host] http://example.com --worker --master-host master_hostname