workload

A standalone synthetic-workload generator. Wraps pkg/workload/ and produces a single binary (pkg/cmd/workload/) used by humans, roachtest, and roachprod-microbench.

Usage

workload init tpcc --warehouses=10 'postgres://root@localhost:26257?sslmode=disable'
workload run tpcc --warehouses=10 --duration=5m 'postgres://...'
workload run kv --read-percent=95 --concurrency=64 --duration=5m 'postgres://...'

Available workloads

See features/workload for the full list. Each is registered in pkg/workload/<name>/ and exposes:

• A init subcommand that creates the schema and bulk-loads data.
• A run subcommand that runs concurrent operations and prints throughput/latency.
• Optional knobs for tuning concurrency, target rate, skew, and verbosity.

Output

Per-second p50/p95/p99 latency and ops/sec are printed to stdout. The same data can be exported to a CSV, Prometheus push gateway, or a roachprod-microbench-compatible file.

Related pages

• features/workload — the library.
• apps/roachtest — uses workload heavily.