latestSwagger 2.02026-08-106816.0 KB

696558132e8c

Invoking this request retrieves traces matching the below filters.

Results should be filtered against endTs, subject to limit and lookback. For example, if endTs is 10:20 today, limit is 10, and lookback is 7 days, traces returned should be those nearest to 10:20 today, not 10:20 a week ago.

Time units of endTs and lookback are milliseconds as opposed to microseconds, the grain of Span.timestamp. Milliseconds is a more familiar and supported granularity for query, index and windowing functions

get/traces

Query parameters

serviceNamestring

Ex zipkin-server - service that logged an annotation in a trace. Required when constraining on parameters except time and duration. The /services endpoint enumerates possible input values.

spanNamestring

Ex my_span_name - name of a span in a trace. Only return traces that contains spans with this name.

annotationQuerystring

Ex. http.uri=/foo and retried - If key/value (has an =), constrains against Span.binaryAnnotations of time string. If just a word, constrains against Span.annotations. Any values are AND against eachother. This means a span in the trace must match all of these.

minDurationinteger

Ex. 100000 (for 100ms). Only return traces whose Span.duration is greater than or equal to minDuration microseconds.

maxDurationinteger

Only return traces whose Span.duration is less than or equal to maxDuration microseconds. Only valid with minDuration.

endTsinteger

Only return traces where all Span.timestamp are at or before this time in epoch milliseconds. Defaults to current time.

lookbackinteger

Only return traces where all Span.timestamp are at or after (endTs - * lookback) in milliseconds. Defaults to endTs, limited to a system parameter QUERY_LOOKBACK.

limitinteger

Maximum number of traces to return. Defaults to 10

Response

OK