> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeroruntime.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Events & Observability

> Python API reference for Events & Observability.

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

<ParamField path="traces" type="Optional[Exporter]">
  Per-turn spans -- what the model was asked, what each provider took.
</ParamField>

<ParamField path="metrics" type="Optional[Exporter]">
  Latency and usage counters.
</ParamField>

<ParamField path="logs" type="Optional[Exporter]">
  The agent process's log records.
</ParamField>

<ParamField path="log_level" type="str" default="INFO">
  Level the agent process logs at. One of `DEBUG`, `INFO`, `WARNING`, `ERROR`, `CRITICAL`.
</ParamField>

***

## Exporter

Where one stream of telemetry is shipped.

### Fields

<ParamField path="enabled" type="bool" default="True">
  Set False to turn this stream off while leaving the rest of the configuration in place.
</ParamField>

<ParamField path="export_url" type="Optional[str]">
  An OTLP endpoint. `None` sends it wherever the runtime is configured to send its own.
</ParamField>

<ParamField path="export_headers" type="Dict[str, str]" default="…">
  Sent with each export -- the collector's auth header, usually.
</ParamField>