grafana-observability-api
Codex observability ingestion API backed by ClickHouse. This service accepts flushed spool batches and writes deduplicated rows into grafana_observability_db.codex_turn_usage.
Status check: /health.
Available Endpoints
| Endpoint | Auth | Purpose |
|---|---|---|
GET /health | Public | Service and ClickHouse readiness. |
GET / | Public | Minimal landing page for operators. |
POST /api/turns | Write or Admin key | Ingest one row or an array of rows. |
GET /api/turns | Admin key | Read recent ingested rows for verification. |
GET /metrics | Admin key | High-level row and session counts. |
Runtime
Configured ingest URL: http://127.0.0.1:8787/api/turns
Team machines should send data through local spool + flush. They do not need ClickHouse credentials in API mode.