Skip to content

Sonda

Synthetic telemetry generator for the people who run the pipeline -- metrics, logs, histograms, and summaries shaped like the real thing, in a single static binary.

crates.io MSRV CI License

New in 1.2.0 -- env-var interpolation in v2 scenarios

Reference ${VAR} and ${VAR:-default} directly in scenario YAML. One file runs from your laptop on the defaults and from a containerized sonda-server on the overrides -- no sed, no per-environment fork. See Environment variable interpolation.

Install

curl -fsSL https://raw.githubusercontent.com/davidban77/sonda/main/install.sh | sh

Other install paths (Cargo, Docker, source) live in Getting Started.

A taste

sonda metrics --name cpu_usage --rate 2 --duration 2s \
  --value-mode sine --amplitude 50 --offset 50 --period-secs 4 \
  --label host=web-01
stdout (Prometheus exposition)
cpu_usage{host="web-01"} 50 1777243958972
cpu_usage{host="web-01"} 85.35533905932738 1777243959525
cpu_usage{host="web-01"} 100 1777243959982
cpu_usage{host="web-01"} 85.35533905932738 1777243960481
cpu_usage{host="web-01"} 50.00000000000001 1777243960974

One command, shaped values, labeled output -- now wire it once in a v2 scenario file and replay it from CI, your laptop, or sonda-server.

Where to next

  • Get started in 5 minutes

    Install Sonda, stream your first metric, and push to a real backend.

  • Built-in scenarios

    Run curated patterns instantly -- sonda metrics --scenario @cpu-spike. Browse the catalog, pin one, customize from there.

  • v2 scenario files

    The canonical file shape: version: 2, shared defaults:, inline packs, after: temporal chains, and env-var interpolation.

  • CSV import

    Turn Grafana exports into portable, parameterized scenarios -- one sonda import away.