rampa run¶

Execute a load test script.

$ rampa run load_test.py

Command¶

Usage¶

usage: rampa run [-h] [--vus VUS] [--duration DURATION] [--scenario SCENARIO]
                 [--out JSON_OUTPUT] [--event-log EVENT_LOG] [--quiet]
                 [--output EXTRA_OUTPUTS] [--progress] [--tui]
                 script

Positional Arguments¶

script¶

path to the test script

Default: None
Required

Options¶

--vus¶

override VU count

Default: None
Type: int

--duration¶

override duration (e.g. `30s`, `1m`)

Default: None
Type: str

--scenario¶

run a specific scenario only

Default: None
Type: str

--out¶

JSON output file path

Default: None
Type: str

--event-log¶

JSONL event log file path

Default: None
Type: str

--quiet¶

suppress console summary

Default: False

--output, -O¶

output backend (e.g. csv=results.csv, influxdb=http://...)

Default: None

--progress¶

show single-line progress during execution

Default: False

--tui¶

launch interactive TUI dashboard (requires rampa[tui])

Default: False

Examples¶

Run with 20 VUs for 1 minute:

$ rampa run load_test.py --vus 20 --duration 1m

Run a specific scenario:

$ rampa run load_test.py --scenario smoke

Save results as JSON:

$ rampa run load_test.py --out results.json --quiet

Capture the event stream for postmortem analysis:

$ rampa run load_test.py --event-log events.jsonl

Exit codes¶

Code	Meaning
0	All thresholds passed
1	Threshold breach
2	Iteration exception
3	Invalid configuration
4	Aborted (SIGINT)
5	Setup failure
6	Output failure
7	Teardown failure