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
- Shows spans within the plan’s retention (Free 1 day, Pro 7 days), counted from when each span completed. Traces with some expired spans show only the remaining spans.
- Correlation flags only attach DIRECT ID matches — see Correlation.