Query telemetry
Canonical neutral query envelope for traces, metrics, and logs. Select a source, compute list, and time range; optionally group, filter, bucket, sort, limit, and include totals. ReportingService.QueryReport and TraceQueryService.AggregateTraces remain supported compatibility contracts.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
TELEMETRY_SOURCE_UNSPECIFIED, TELEMETRY_SOURCE_TRACES, TELEMETRY_SOURCE_METRICS, TELEMETRY_SOURCE_LOGS Empty string and "none" are equivalent: a single row per group instead of a time series.
Scalar queries: maximum returned rows, default 100. Time-series queries: optional maximum number of distinct groups; exceeding it fails the query instead of truncating timelines. Time-series results are complete within safety budgets of 5000 rows, 5000 buckets, and 50000 metric values. Queries are limited to 90 days and 30 seconds of execution.
Value shaping. timeseries buckets by grain; scalar returns one row per group. When omitted, grain selects the compatible shape.
timeseries, scalar Ordering for scalar/top-list rows. Defaults to desc.
desc, asc Explicit bucket width in seconds. Takes precedence over grain when both are set.
The span originally selected, before live extended [from, to). grain:"auto" resolves bucket width from this span, independent of how far [from, to) has since grown.