Sign in
Traces

Query trace summaries — one row per trace with span count, error count, root span info, and proper trace-level pagination.

Changed on
get/otel/trace-summaries

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/otel/trace-summaries
  • Auth: HTTP bearer

Query parameters

project_idinteger required

Project ID

trace_idstring

Filter by trace ID

service_namestring

Filter by service name

statusstring

Filter by status (OK, ERROR)

min_duration_msnumber double

Minimum trace duration in ms

start_timestring

Start time (RFC 3339)

end_timestring

End time (RFC 3339)

environment_idinteger

Filter by environment ID

deployment_idinteger

Filter by deployment ID

attributesstring

Filter by span attributes as comma-separated key=value pairs, e.g. "gen_ai.system=openai,gen_ai.request.model=gpt-4"

name_patternstring

Filter by span name pattern (ILIKE)

sort_bystring

Sort field: 'start_time' (default) or 'duration'

sort_orderstring

Sort direction: 'asc' or 'desc' (default)

include_totalboolean

Compute the total count (default: true). Set false to skip the second aggregation when only the page is needed

limitinteger

Max traces to return (default: 50, max: 100)

offsetinteger

Offset for pagination

Response

Trace summaries

totalinteger nullable

Total traces matching the filters, ignoring pagination. Omitted when the request passed include_total=false, in which case the caller asked not to pay for the count — treat its absence as "unknown", not as zero.

Changes

  • 4b228ebed583Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 1dc3e6788214Revision changes
    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status