v1

latestOpenAPI 3.1.0MIT2026-07-1393128198.4 KB
Querying

Quantiles

Query duration percentiles (p50, p90, p99) and count/error rate over time. Use this to identify latency outliers, track performance degradation, or compare SLO compliance. Returns named timeseries: count, countPerMin, errorCount, errorCountPerMin, durationP50, durationP90, durationP99, durationMax. Supports WHERE filters (e.g. where service_name = 'myservice'), full-text search, system filtering (e.g. httpserver:all), and duration filtering. Use timeseries instead when you need custom aggregation queries with GROUP BY. Use list_span_groups instead when you need a single aggregated snapshot. Documentation: https://uptrace.dev/features/querying/spans

get/internal/v1/spans/{project_id}/quantiles

Path parameters

project_idinteger required

Uptrace project ID.

Query parameters

time_startstring date-time required

RFC3339 timestamp.

Start time (inclusive) as RFC3339 timestamp.

time_endstring date-time required

RFC3339 timestamp.

End time (exclusive) as RFC3339 timestamp.

querystring

UQL query to filter spans (e.g., where service_name = 'myservice').

wherestring

Additional WHERE clause appended to the query.

searchstring

Full-text search for spans containing the given text.

search_attrsstring[]

Attribute names to search within when using search. Can be repeated for multiple attributes.

systemstring[]

Filter by system (e.g., log:error, db:postgresql). Can be repeated for multiple systems.

duration_gteinteger

Duration greater than or equal to N (milliseconds).

duration_ltinteger

Duration less than N (milliseconds).

limitinteger

Limit number of results.

Response

Quantile timeseries data.