> ## 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

> TypeScript API reference for Events & Observability.

## Observability

Where this session's traces, metrics and logs go.

Each stream is configured on its own, and a stream left `null` follows the
runtime's own settings rather than being switched off.

### Options

```ts theme={null}
Observability(options: ObservabilityOptions)
```

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

<ParamField path="logs" type="Exporter | null">
  The agent process's log records.
</ParamField>

<ParamField path="metrics" type="Exporter | null">
  Latency and usage counters.
</ParamField>

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

***

## Exporter

Where one stream of telemetry is shipped.

### Options

```ts theme={null}
Exporter(options: ExporterOptions)
```

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

<ParamField path="export_headers" type="Record<string, string>">
  Sent with each export -- the collector's auth header, usually.
</ParamField>

<ParamField path="export_url" type="string | null">
  An OTLP endpoint. `null` sends it wherever the runtime is configured to
  send its own.
</ParamField>