Skip to main content
Event emission and observability: subscribe to session and pipeline events, and configure logging, metrics, and tracing for a running agent.

Observability

Where this session’s traces, metrics and logs go. Each stream is configured on its own, and a stream left None follows the runtime’s own settings rather than being switched off.

Fields

Optional[Exporter]
Per-turn spans — what the model was asked, what each provider took.
Optional[Exporter]
Latency and usage counters.
Optional[Exporter]
The agent process’s log records.
str
default:"INFO"
Level the agent process logs at. One of DEBUG, INFO, WARNING, ERROR, CRITICAL.

Exporter

Where one stream of telemetry is shipped.

Fields

bool
default:"True"
Set False to turn this stream off while leaving the rest of the configuration in place.
Optional[str]
An OTLP endpoint. None sends it wherever the runtime is configured to send its own.
Dict[str, str]
default:"…"
Sent with each export — the collector’s auth header, usually.