Configuration

Every knob you can turn on a Sonda scenario. The CLI flags, the YAML fields, the generators, encoders, and sinks -- this section is the reference you reach for when you know what you want to change and need to confirm the exact field name or the default value.

If you are looking for which generator to pick or how to wire a Loki sink into your pipeline, start with the Tutorial or jump to the relevant guide under Guides. This section answers "what does this field do" and "what are the valid values."

Read this first

If you only open one page in this section, make it v2 Scenario Files. Every other reference here -- generators, encoders, sinks -- plugs into that shape.

Scenario file shape

• v2 Scenario Files

  The canonical file format: version: 2, defaults:, scenarios:, packs, and after: temporal chains.

• Scenario Fields

  Per-entry field reference for everything inside a scenarios: entry -- generators, schedules, labels, encoders, sinks.

Building blocks

• Generators

  Value shapes: constant, sine, sawtooth, sequence, step, spike, csv_replay, plus operational aliases and histogram/summary generators.

• Encoders

  Wire formats: Prometheus text, InfluxDB line protocol, JSON lines, syslog, Prometheus remote write, OTLP.

• Sinks

  Destinations: stdout, file, TCP, UDP, HTTP push, remote write, Kafka, Loki, OTLP/gRPC.

• Sink Batching

  How each sink buffers, default thresholds, and the batch_size field where it applies.

Command line

• CLI Reference

  Every subcommand, every flag, exit codes, and the SONDA_* environment variables that override flags.