Hanzo
OpenapiO11y

Executes a composite query over a time range: builder queries over traces, logs…

Executes a composite query over a time range: builder queries over traces, logs and metrics, formulas, trace operators, PromQL and Datastore SQL,…

POST /v1/o11y/query_range

Addresshttps://api.hanzo.ai/v1/o11y/query_range
MethodPOST
Operationpost_o11y_query_range
AuthAuthorization: Bearer $HANZO_API_KEY

Executes a composite query over a time range: builder queries over traces, logs and metrics, formulas, trace operators, PromQL and Datastore SQL, answering time series, scalars or raw records as the request type asks.

Callers need the viewer role; the runtime's own gate enforces it.

Request

16 fields, body application/json (required).

FieldInTypeRequiredDescription
compositeQuerybodyo11y.querybuildertypesv5.CompositeQuery
compositeQuery.queriesbodyo11y.QueryEnvelope[]Queries is the queries to use for the request.
compositeQuery.queries[].specbodyobjectSpec is the deferred decoding of the query if any.
compositeQuery.queries[].typebodyanyType is the type of the query.
endbodyintegerEnd is the end time of the query in epoch milliseconds.
formatOptionsbodyo11y.FormatOptions
formatOptions.fillGapsbodyboolean
formatOptions.formatTableResultForUIbodyboolean
noCachebodybooleanNoCache is a flag to disable caching for the request.
requestTypebodyanyRequestType is the type of the request.
schemaVersionbodystringSchemaVersion is the version of the schema to use for the request payload.
startbodyintegerStart is the start time of the query in epoch milliseconds.
variablesbodyobjectVariables is the variables to use for the request.
variables.*bodyo11y.VariableItem
variables.*.typebodyany
variables.*.valuebodyobject

Response

StatusBodyMeaning
200o11y.O11yQueryRangeOutok

200 body — 2 fields.

FieldInTypeAlwaysDescription
databodyanyData is the query result — the result type, the result set, execution stats and any warning — as the engine rendered it.
statusbodystringStatus is "success".

Failure carries the platform error shape — see Errors.

Examples

hanzo o11y query_range create

O11y API · All Hanzo APIs · Interactive reference

How is this guide?

On this page