bench

Overview ¶

Command bench is a thesis-grade measurement harness for bubblepprof's /debug/memusage pipeline. It spawns a parameterized synthetic workload, drives N iterations of memusage.Compute against the running process (in-process — no HTTP loopback noise), and emits a JSON report with per-iteration measurements and aggregate statistics.

Captured per iteration:

• wall-clock latency of Compute
• max user-visible scheduling pause during Compute (heartbeat goroutine)
• Go heap allocated by Compute (HeapAlloc delta, TotalAlloc delta)
• process RSS before/after (/proc/self/status VmRSS, VmHWM)
• matched_goroutines, reachable_bytes from the response

Aggregates: mean, stddev, min, max, p50, p95, p99 per metric.

One iteration optionally runs under runtime/trace (-trace=path.trace) so the per-stage spans recorded by internal/memusage's trace.StartRegion calls can be inspected with `go tool trace` and cross-checked against the heartbeat-based STW estimate.