Sonda

Sonda is a synthetic telemetry generator written in Rust. It produces metrics and logs shaped like the real signals that break observability pipelines — gaps, micro-bursts, cardinality spikes, value sequences — for testing ingest paths, alert rules, and dashboards.

Install

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

Or with Cargo: cargo install sonda.

Quick start

version: 2
kind: runnable
defaults:
  rate: 1
  duration: 3s
  encoder: { type: prometheus_text }
  sink: { type: stdout }
scenarios:
  - id: cpu_usage
    signal_type: metrics
    name: cpu_usage
    generator: { type: sine, amplitude: 50.0, offset: 50.0, period_secs: 10 }
    labels: { host: web-01 }

sonda run hello.yaml

cpu_usage{host="web-01"} 50 1779724001981
cpu_usage{host="web-01"} 79.38926261462366 1779724001982
cpu_usage{host="web-01"} 97.55282581475768 1779724002984

Documentation

Full documentation — concepts, configuration, deployment, and guides — lives at https://davidban77.github.io/sonda/.

Library usage

The generation engine ships as a separate crate: sonda-core. Heavy dependencies (HTTP, Kafka, OTLP, remote-write) are gated behind Cargo feature flags.

Contributing

Contributions are welcome. See CONTRIBUTING.md for build instructions and the pull request process, or open an issue on GitHub.

License

Licensed under either of the Apache License, Version 2.0 (LICENSE-APACHE) or the MIT license (LICENSE-MIT) at your option.