Tracing
Trace Explorer
List and open traces that were ingested. Empty list means no stored traces in range — not a fabricated healthy fleet.
Product UI
Trace list and detail waterfall live at /app/traces. Filter by status, service, session, and time range. Open a trace to inspect spans.
Search API
GET /api/app/traces/search — session auth, entitlement distributed_tracing. Query params include q, status, service, session, project, from / to, cursor, and limit. Workspace is never taken from the client.
Query backends
When ClickHouse is configured, list/detail can use the secondary query plane. Otherwise (and as the durable store) Postgres holds traces and spans. Failures on the ClickHouse path surface as query errors rather than invented empty success.
Limitations
- Pro+ only.
- Correlation flags only attach DIRECT ID matches — see Correlation.