Querying
List groups
List span groups (public API). Stable API for listing aggregated span groups. Supports basic search and duration filtering. For advanced aggregation with UQL queries (GROUP BY, HAVING, aggregate functions), use list_span_groups instead. Documentation: https://uptrace.dev/features/querying/spans
get/api/v1/tracing/{project_id}/groups
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
Aggregate spans using the specified query.
limitinteger
Limit number of results.
searchstring
Search for spans containing option1 or option2.
duration_gteinteger
Duration greater than or equal to N (milliseconds).
duration_ltinteger
Duration less than N (milliseconds).
Response
Aggregated spans.