loadtest

Overview ¶

Command loadtest is a stdlib-only load generator for the TinyRaven events API.

It spins up N concurrent workers, each POSTing batched NDJSON to /v0/events?name=<datasource> for a fixed duration, and reports throughput (events/s) and request-latency percentiles (p50/p95/p99). It measures the ack-on-buffer path (ADR 0004): a 202 means the rows were validated and buffered for the ClickHouse flush.

Usage:

go run ./scripts/loadtest \
  -url http://localhost:8000 -token "$TR_ADMIN_TOKEN" \
  -datasource events -workers 50 -duration 30s -batch 1000

See docs/benchmark.md for methodology and the reference figures.