a ZipkinClient (shared transport) or config options (own transport).
test seams.
Tag keys the server indexes for autocomplete: GET /api/v2/autocompleteKeys (the server's
AUTOCOMPLETE_KEYS, [] when unset).
Distinct values seen for an autocomplete key: GET /api/v2/autocompleteValues?key=
(sorted; [] for a key that is not in AUTOCOMPLETE_KEYS).
Releases connections when this client owns them (no-op for client.query). Idempotent.
Service dependency edges: GET /api/v2/dependencies?endTs=&lookback=, sorted by parent and
child, errorCount defaulting to 0. In-memory storage computes them on read; persistent
backends need the zipkin-dependencies job, so [] is normal there.
One trace in the SPEC §5 model (see zipkinSpanToSpan); null when it does not exist.
Several traces by id: GET /api/v2/traceMany. Ids are lower-cased and de-duplicated (a
16-character id equals its zero-padded 32-character form); an empty list returns []
without a request, a single id uses GET /api/v2/trace/{id}, more are fetched in chunks of
TRACE_MANY_CHUNK. Missing traces are omitted; the result follows the request order.
Searches traces: GET /api/v2/traces, newest first, one ZipkinSpan[] per trace. No match
returns []. Invalid filters (limit <= 0, maxDurationMicros without or below
minDurationMicros, non-positive endTs/lookbackMs) throw ValidationError without a
request.
One trace in the native model: GET /api/v2/trace/{traceId}. Returns null when the trace
does not exist (404). The id is lower-cased; anything but 16 or 32 hex characters throws
ValidationError without a request. Spans come back in storage order.
SPEC §5 alias of listSpans.
Remote services called by a service (remoteEndpoint.serviceName on its spans):
GET /api/v2/remoteServices?serviceName= (sorted).
Service names that reported spans: GET /api/v2/services (sorted, lower-case).
Span names of a service: GET /api/v2/spans?serviceName= (sorted; unknown service → []).
SPEC §5 search: service → serviceName, operation → spanName, tags → exact tag
terms (see ZipkinTraceQuery.tags), durations in µs, endTs = end (default now),
lookback = end - start (last 1 h without start, like every tracing package), limit
default 20. Returns
one summary per trace (root = the span without a parent, else the earliest).
Optionalopts: WaitForTraceOptionsStaticfromBuilds a standalone query client from GROW_ZIPKIN_* / ZIPKIN_URL.
Reads traces back from Zipkin (port 9411): the native v2 query API (
getTraceSpans,getTraces,getTraceMany,listServices,listSpans,listRemoteServices,getDependencies,autocompleteKeys,autocompleteValues) and the SPEC §5TraceQueryClient(getTrace,searchTraces,listOperations,waitForTrace) on top of it. Every call is a GET (retried on 5xx, 429 and network errors).Get one from ZipkinClient.query (shares the client's connections) or construct it from a config (owns its connections; call close).