CLI Load Testing

atrahasis cli runs load tests from the same step definitions used by the flow runner. Pick a profile, get a live terminal dashboard with percentile metrics, and export reports in HTML, PDF, or OpenTelemetry JSON.

Run a load test

atra run spec-folder -s create-order -t load
atra run spec-folder -s create-order -t stress
atra run spec-folder -s create-order -t spike
atra run spec-folder -s create-order -t soak

Built-in profiles

Profile	Virtual Users	Ramp	Duration	Purpose
load (default)	50	30s	60s	Sustained traffic, gradual ramp
stress	200	10s	60s	Aggressive ramp to find limits
spike	300	2s	30s	Sudden spike, recovery check
soak	30	30s	300s	Long duration, low steady load
custom	yours	yours	yours	User-defined stages

Live dashboard

• Response times — avg, p50, p90, p95, p99 — updated every second
• Throughput in requests per second over time
• Error rate as a percentage of failed responses
• Active virtual users with ramp progression
• Per-step breakdown with full percentile distribution

Reports

• HTML — interactive dashboard for team sharing
• PDF — printable summary for handoff
• OpenTelemetry JSON — feed into downstream observability platforms

Details

• Same binary as the rest of atra — one install covers ad-hoc requests, flows, and load tests
• Spec format is identical to flow definitions, so a smoke test can be promoted to a load test by changing one flag
• Exit code reflects threshold checks: 0 on pass, 1 on any threshold breach