Skip to main content
POST
Query telemetry

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
source
enum<string>
Available options:
TELEMETRY_SOURCE_UNSPECIFIED,
TELEMETRY_SOURCE_TRACES,
TELEMETRY_SOURCE_METRICS,
TELEMETRY_SOURCE_LOGS
from
string<date-time>
to
string<date-time>
compute
object[]
grain
string

Empty string and "none" are equivalent: a single row per group instead of a time series.

group_by
string[]
filters
object[]
filter_operator
string
limit
integer<int32>

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.

time_zone
string
include_totals
boolean
mode
enum<string>

Value shaping. timeseries buckets by grain; scalar returns one row per group. When omitted, grain selects the compatible shape.

Available options:
timeseries,
scalar
sort
enum<string>

Ordering for scalar/top-list rows. Defaults to desc.

Available options:
desc,
asc
interval_seconds
integer<int32>

Explicit bucket width in seconds. Takes precedence over grain when both are set.

selected_range_seconds
integer<int32>

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.

Response

200 - application/json

OK

object
string
data
object[]
totals
object
meta
object
request
object
has_more
boolean