io.opencensus.stats

Class StatsComponent

java.lang.Object

io.opencensus.stats.StatsComponent

public abstract class StatsComponent
extends Object

Class that holds the implementations for ViewManager and StatsRecorder.

All objects returned by methods on StatsComponent are cacheable.

Constructor Summary

Constructors

Constructor and Description
StatsComponent()

Method Summary

Modifier and Type	Method and Description
abstract StatsCollectionState	getState() Returns the current StatsCollectionState.
abstract StatsRecorder	getStatsRecorder() Returns the default StatsRecorder.
abstract ViewManager	getViewManager() Returns the default ViewManager.
abstract void	setState(StatsCollectionState state) Deprecated. This method is deprecated because other libraries could cache the result of getState(), use a stale value, and behave incorrectly. It is only safe to call early in initialization. This method throws IllegalStateException after getState() has been called, in order to limit changes to the result of getState().

Methods inherited from class java.lang.Object

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

Constructor Detail

StatsComponent

public StatsComponent()

Method Detail

getViewManager

public abstract ViewManager getViewManager()

Returns the default ViewManager.

getStatsRecorder

public abstract StatsRecorder getStatsRecorder()

Returns the default StatsRecorder.

getState

public abstract StatsCollectionState getState()

Returns the current StatsCollectionState.

When no implementation is available, getState always returns StatsCollectionState.DISABLED.

Once getState() is called, subsequent calls to setState(StatsCollectionState) will throw an IllegalStateException.

Returns:

the current StatsCollectionState.

setState

@Deprecated
public abstract void setState(StatsCollectionState state)

Deprecated. This method is deprecated because other libraries could cache the result of getState(), use a stale value, and behave incorrectly. It is only safe to call early in initialization. This method throws IllegalStateException after getState() has been called, in order to limit changes to the result of getState().

Sets the current StatsCollectionState.

When no implementation is available, setState does not change the state.

If state is set to StatsCollectionState.DISABLED, all stats that are previously recorded will be cleared.

Parameters:

state - the new StatsCollectionState.

Throws:

IllegalStateException - if getState() was previously called.