Class RunningSpanStore

java.lang.Object

io.opencensus.trace.export.RunningSpanStore

Direct Known Subclasses:

InProcessRunningSpanStore

@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	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	Description
protected	RunningSpanStore()

Method Summary

Modifier and Type	Method	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 Object

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

Constructor Details

RunningSpanStore

protected RunningSpanStore()

Method Details

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