Pular para o conteúdo principal
POST
Query telemetry

Autorizações

Authorization
string
header
obrigatório

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

Corpo

application/json
source
enum<string>
Opções disponíveis:
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.

Opções disponíveis:
timeseries,
scalar
sort
enum<string>

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

Opções disponíveis:
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.

project_id
string

Pins the read to one project the caller can reach. Omit to keep the caller's token scope.

query
string

Free-text trace search, matched like the trace list search. Only for source TRACES with trace aggregate metrics.

oql
string

OQL trace selection (fetch traces | ...), compiled to filters like the OQL trace query. Only for source TRACES with trace aggregate metrics; cannot be combined with filters or query.

Resposta

OK

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