codexlb2otel¶

codexlb2otel tails the conversation archives written by codex-lb, reconstructs complete Codex turns, and exports the signals that the proxy's request metrics cannot see.

It produces:

• OpenTelemetry metrics for models, tokens, cache behavior, rate limits, tools, latency, and exporter health;
• structured Loki records for turns, messages, tool activity, errors, and transport events;
• Tempo traces for response, engine-call, and tool-call timing;
• optional Grafana Agent Observability generations; and
• an optional live view of current root sessions and their subagent trees.

Why use it?¶

codex-lb already measures the proxy. This project reads the websocket archive to expose the conversation-level facts that exist only on the wire: served engine IDs, queue wait, per-call cache behavior, tool activity, response continuations, and parent-child agent relationships.

The exporter does not decrypt encrypted reasoning content and does not duplicate the proxy's existing request telemetry.

Start here¶

• Getting started — build or run the container and perform a local smoke test.
• Configuration — configure archives, sinks, retention, health, and the live view.
• Signals — understand what reaches metrics, logs, traces, and generations.
• Security — read this before enabling content-bearing sinks.
• Dashboards — deploy or inspect the coverage-checked Grafana dashboard.

Source and releases are at github.com/rknightion/codexlb2otel.