Legacy

Fetch Legacy Analytics

Changed on

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

Request

  • Base URL
    /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL
    /api/tracing/spans/analytics
  • Auth
    API key in header Authorization

Query parameters

focus'trace' | 'span'
format'agenta' | 'opentelemetry'
string
OR
integer
string
OR
integer
limitinteger nullable
intervalinteger nullable
ratenumber nullable
filterunknown

Response

Successful Response

countinteger

Number of time buckets returned.

Changes

  • a7f9a6823230Revision changes
    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

  • 4c92d005b4cfRevision changes
    • info

      api tag Legacy added

    • info

      api tag Deprecated removed

    • info

      endpoint reactivated