zipkin.storage

Class InMemorySpanStore

java.lang.Object

zipkin.storage.InMemorySpanStore

All Implemented Interfaces:

SpanStore

public final class InMemorySpanStore
extends Object
implements SpanStore

Constructor Summary

Constructors

Constructor and Description
InMemorySpanStore()

Method Summary

Modifier and Type	Method and Description
List<DependencyLink>	getDependencies(long endTs, Long lookback) Returns dependency links derived from spans.
List<Span>	getRawTrace(long traceId) Retrieves spans that share a trace id, as returned from backend data store queries, with no ordering expectation.
List<String>	getServiceNames() Get all the service names.
List<String>	getSpanNames(String service) Get all the span names for a particular Endpoint.serviceName.
List<Span>	getTrace(long traceId) Get the available trace information from the storage system.
List<List<Span>>	getTraces(QueryRequest request) Get the available trace information from the storage system.
List<Long>	traceIds()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

InMemorySpanStore

public InMemorySpanStore()

Method Detail

traceIds

public List<Long> traceIds()

getTraces

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

Description copied from interface: SpanStore

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.

Specified by:

getTraces in interface SpanStore

getTrace

public List<Span> getTrace(long traceId)

Description copied from interface: SpanStore

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.

Specified by:

getTrace in interface SpanStore

Returns:

a list of spans with the same Span.traceId, or null if not present.

getRawTrace

public List<Span> getRawTrace(long traceId)

Description copied from interface: SpanStore

Retrieves spans that share a trace id, as returned from backend data store queries, with no ordering expectation.

This is different, but related to SpanStore.getTrace(long). SpanStore.getTrace(long) cleans data by merging spans, adding timestamps and performing clock skew adjustment. This feature is for debugging zipkin logic or zipkin instrumentation.

Specified by:

getRawTrace in interface SpanStore

Returns:

a list of spans with the same Span.traceId, or null if not present.

getServiceNames

public List<String> getServiceNames()

Description copied from interface: SpanStore

Get all the service names.

Results are sorted lexicographically

Specified by:

getServiceNames in interface SpanStore

getSpanNames

public List<String> getSpanNames(String service)

Description copied from interface: SpanStore

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

Results are sorted lexicographically

Specified by:

getSpanNames in interface SpanStore

getDependencies

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

Description copied from interface: SpanStore

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.

Some implementations parse DependencyLinkSpan from storage and call DependencyLinker to aggregate links. The reason is certain graph logic, such as skipping up the tree is difficult to implement as a storage query.

Specified by:

getDependencies in interface SpanStore

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