Struct TelemetryConfig 

pub struct TelemetryConfig {
    pub enabled: bool,
    pub backend: TelemetryBackend,
    pub trace_dir: PathBuf,
    pub include_args: bool,
    pub otlp_endpoint: Option<String>,
    pub otlp_headers_vault_key: Option<String>,
    pub pyroscope_endpoint: Option<String>,
    pub service_name: String,
    pub sample_rate: f64,
    pub system_metrics_interval_secs: u64,
}

Profiling and distributed tracing configuration, nested under [telemetry] in TOML.

When enabled = true and the binary is compiled with --features profiling, agent turn phases and LLM provider calls are instrumented with tracing spans. Traces are exported according to the selected TelemetryBackend.

Enabling telemetry has zero overhead when the profiling feature is absent — all instrumentation points are compiled out via cfg_attr.

Example (TOML)

[telemetry]
enabled = true
backend = "local"
trace_dir = ".local/traces"
include_args = false
service_name = "my-zeph"
sample_rate = 0.1

Fields

enabled: bool

Enable tracing instrumentation. Default: false.

backend: TelemetryBackend

Backend to use for trace export. Default: local.

trace_dir: PathBuf

Directory for Chrome JSON trace files (used when backend = "local"). Default: ".local/traces".

include_args: bool

Include function arguments in span attributes. Set to true for local debugging. Keep false (the default) in production to avoid logging potentially sensitive data such as user messages, LLM responses, or tool outputs with PII.

otlp_endpoint: Option<String>

OTLP gRPC endpoint URL (used when backend = "otlp"). Default: "http://localhost:4317" when unset.

otlp_headers_vault_key: Option<String>

Vault key for OTLP authentication headers (e.g. ZEPH_OTLP_HEADERS). When set, the value is resolved from the age vault at startup and passed as Authorization or custom headers to the collector.

pyroscope_endpoint: Option<String>

Pyroscope server URL (used when backend = "pyroscope").

service_name: String

Service name reported in trace metadata. Default: "zeph-agent".

sample_rate: f64

Fraction of traces to sample. 1.0 = record all, 0.1 = record 10%. Applies only to the otlp backend; the local backend always records all spans. Default: 1.0.

system_metrics_interval_secs: u64

Interval in seconds between system-metrics snapshots (Phase 3). Default: 5.

Trait Implementations

impl Clone for TelemetryConfig

fn clone(&self) -> TelemetryConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TelemetryConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for TelemetryConfig

fn default() -> TelemetryConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for TelemetryConfig

fn deserialize<__D>( __deserializer: __D, ) -> Result<TelemetryConfig, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for TelemetryConfig

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.