Hanzo
OpenapiO11y

Computes span aggregations over one trace — span count, duration or share of…

Computes span aggregations over one trace — span count, duration or share of execution time — grouped by the resource field each aggregation names.

POST /v1/o11y/traces/{traceId}/aggregations

Addresshttps://api.hanzo.ai/v1/o11y/traces/{traceId}/aggregations
MethodPOST
OperationGetTraceAggregations
AuthAuthorization: Bearer $HANZO_API_KEY

Computes span aggregations over one trace — span count, duration or share of execution time — grouped by the resource field each aggregation names.

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

Request

10 fields, body application/json (required).

FieldInTypeRequiredDescription
traceIdpathstringyes
aggregationsbodyo11y.SpanAggregation[]
aggregations[].aggregationbodyany
aggregations[].fieldbodyo11y.TelemetryFieldKey
aggregations[].field.descriptionbodystring
aggregations[].field.fieldContextbodyany
aggregations[].field.fieldDataTypebodyany
aggregations[].field.namebodystringyes
aggregations[].field.signalbodyany
aggregations[].field.unitbodystring

Response

StatusBodyMeaning
200o11y.O11yTraceAggregationsOutok

200 body — 13 fields.

FieldInTypeAlwaysDescription
databodyo11y.GettableTraceAggregations
data.aggregationsbodyo11y.SpanAggregationResult[]
data.aggregations[].aggregationbodyany
data.aggregations[].fieldbodyo11y.TelemetryFieldKey
data.aggregations[].field.descriptionbodystring
data.aggregations[].field.fieldContextbodyany
data.aggregations[].field.fieldDataTypebodyany
data.aggregations[].field.namebodystringyes
data.aggregations[].field.signalbodyany
data.aggregations[].field.unitbodystring
data.aggregations[].valuebodyobject
data.aggregations[].value.*bodyinteger
statusbodystringStatus is "success".

Failure carries the platform error shape — see Errors.

Examples

hanzo o11y traces aggregations <traceId>

O11y API · All Hanzo APIs · Interactive reference

How is this guide?

On this page