Telemetry and tracing

Belai can send traces and metrics to an OpenTelemetry collector over OTLP, so your team can see turn latency, token use, tool calls and classifier decisions in the observability stack it already runs.

It carries facts about the session, never its content: no prompts, replies, file contents or command output.

Configure it under telemetry in your settings:

"telemetry": {
  "otlp_endpoint": "http://localhost:4318",
  "headers": { "x-api-key": "env:OTEL_API_KEY" },
  "traces": true,
  "metrics": true
}

A header value of env:NAME is read from that environment variable, so a key is never written in settings. Belai also keeps a local trace of each turn for its own diagnostics, separate from what it exports.

A Pix Sandbox can send its logs and metrics to your collector too. See Pix Sandboxes.