v54

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-03522891921.1 KB
Legacy

Fetch Legacy Analytics

Aggregate span metrics using the fixed legacy schema.

Returns time-bucketed aggregates with a fixed set of fields (count, duration, costs, tokens) split into total and errors. The shape predates specs-driven analytics and is kept for the existing observability dashboards that consume it.

New integrations should prefer POST /tracing/analytics/query, which accepts specs and can summarize arbitrary span attributes, not just the four fixed metrics.

post/tracing/spans/analytics

Query parameters

focus'trace' | 'span'
format'agenta' | 'opentelemetry'
string
OR
integer
string
OR
integer
limitinteger nullable
intervalinteger nullable
ratenumber nullable
{"stackTrail":"paths:/tracing/spans/analytics:post:parameters:7:schema","oasType":"schema","type":"unknown","title":"Filter"}

Response

Successful Response

countinteger

Number of time buckets returned.