io.opencensus.trace.export

Class RunningSpanStore

java.lang.Object

io.opencensus.trace.export.RunningSpanStore

@ThreadSafe
public abstract class RunningSpanStore
extends Object

This class allows users to access in-process information about all running spans.

The running spans tracking is available for all the spans with the option Span.Options.RECORD_EVENTS. This functionality allows users to debug stuck operations or long living operations.

Since:

0.5

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	RunningSpanStore.Filter Filter for running spans.
static class	RunningSpanStore.PerSpanNameSummary Summary of all available data for a span name.
static class	RunningSpanStore.Summary The summary of all available data.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	RunningSpanStore()

Method Summary

Modifier and Type	Method and Description
abstract Collection<SpanData>	getRunningSpans(RunningSpanStore.Filter filter) Returns a list of running spans that match the Filter.
abstract RunningSpanStore.Summary	getSummary() Returns the summary of all available data such, as number of running spans.
abstract void	setMaxNumberOfSpans(int maxNumberOfSpans) Sets the maximum number of Spans in th RunningSpanStore.

Methods inherited from class java.lang.Object

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

Constructor Detail

RunningSpanStore

protected RunningSpanStore()

Method Detail

getSummary

public abstract RunningSpanStore.Summary getSummary()

Returns the summary of all available data such, as number of running spans.

Returns:

the summary of all available data.

Since:

0.5

getRunningSpans

public abstract Collection<SpanData> getRunningSpans(RunningSpanStore.Filter filter)

Returns a list of running spans that match the Filter.

Parameters:

filter - used to filter the returned spans.

Returns:

a list of running spans that match the Filter.

Since:

0.5

setMaxNumberOfSpans

public abstract void setMaxNumberOfSpans(int maxNumberOfSpans)

Sets the maximum number of Spans in th RunningSpanStore.

0 means disabled, by default the RunningSpanStore is disabled.

Parameters:

maxNumberOfSpans - the maximum number of Spans in th RunningSpanStore.

Throws:

IllegalArgumentException - if maxNumberOfSpans is negative.

Since:

0.22