io.zipkin

Interface SpanStore

public interface SpanStore

Method Summary

Modifier and Type	Method and Description
void	accept(Iterator<Span> spans) Sinks the given spans, ignoring duplicate annotations.
List<DependencyLink>	getDependencies(long endTs, Long lookback) Returns dependency links derived from spans.
List<String>	getServiceNames() Get all the service names.
List<String>	getSpanNames(String serviceName) Get all the span names for a particular Endpoint.serviceName.
List<List<Span>>	getTraces(QueryRequest request) Get the available trace information from the storage system.
List<List<Span>>	getTracesByIds(List<Long> traceIds) Get the available trace information from the storage system.

Method Detail

accept

void accept(Iterator<Span> spans)

Sinks the given spans, ignoring duplicate annotations.

getTraces

List<List<Span>> getTraces(QueryRequest request)

Get the available trace information from the storage system. Spans in trace are sorted by the first annotation timestamp in that span. First event should be first in the spans list.

Results are sorted in order of the first span's timestamp, and contain up to QueryRequest.limit elements.

getTracesByIds

List<List<Span>> getTracesByIds(List<Long> traceIds)

Get the available trace information from the storage system. Spans in trace are sorted by the first annotation timestamp in that span. First event should be first in the spans list.

Results are sorted in order of the first span's timestamp, and contain less elements than trace IDs when corresponding traces aren't available.

getServiceNames

List<String> getServiceNames()

Get all the service names.

Results are sorted lexicographically

getSpanNames

List<String> getSpanNames(String serviceName)

Get all the span names for a particular Endpoint.serviceName.

Results are sorted lexicographically

getDependencies

List<DependencyLink> getDependencies(long endTs,
                                     @Nullable
                                     Long lookback)

Returns dependency links derived from spans.

Implementations may bucket aggregated data, for example daily. When this is the case, endTs may be floored to align with that bucket, for example midnight if daily. lookback applies to the original endTs, even when bucketed. Using the daily example, if endTs was 11pm and lookback was 25 hours, the implementation would query against 2 buckets.

Parameters:

endTs - only return links from spans where Span.timestamp are at or before this time in epoch milliseconds.

lookback - only return links from spans where Span.timestamp are at or after (endTs - lookback) in milliseconds. Defaults to endTs.

Returns:

dependency links in an interval contained by (endTs - lookback) or empty if none are found