Documentation
¶
Overview ¶
Command aerolvm-bench measures how fast an AerolVM server creates sandboxes: creates per second, and how long each create takes at p50, p90 and p99 (plans/agent-sandbox-feature-parity.md, O3).
It drives the public API through the Go SDK, so it measures what a client sees, against any AerolVM URL and token. Workers create sandboxes in a closed loop for -duration; each sandbox is deleted in the background as soon as it exists (or all at the end with -hold). Every sandbox it makes is named and tagged with the run's id, deleted before the tool exits, interrupted or not, and set to delete itself after -max-age in case the tool is killed outright.
go run ./cmd/aerolvm-bench -api https://api.example.com -concurrency 8 -duration 60s
The token comes from -token, SB_PAT_TOKEN or SB_API_TOKEN, the URL from -api or SB_API_URL. -json prints the report as JSON. -cleanup <run id> deletes whatever an earlier run left behind.