Class LongCumulativeImpl

java.lang.Object

io.opencensus.metrics.LongCumulative

io.opencensus.implcore.metrics.LongCumulativeImpl

All Implemented Interfaces:

Meter

public final class LongCumulativeImpl
extends LongCumulative
implements Meter

Implementation of LongCumulative.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	LongCumulativeImpl.PointImpl	Implementation of LongCumulative.LongPoint.

Nested classes/interfaces inherited from class LongCumulative

LongCumulative.LongPoint

Field Summary

Fields

Modifier and Type	Field	Description
private final List<LabelValue>	constantLabelValues
private final List<LabelValue>	defaultLabelValues
private final int	labelKeysSize
private final MetricDescriptor	metricDescriptor
private Map<List<LabelValue>, LongCumulativeImpl.PointImpl>	registeredPoints
private final Timestamp	startTime
(package private) static final LabelValue	UNSET_VALUE

Constructor Summary

Constructors

Constructor	Description
LongCumulativeImpl(String name, String description, String unit, List<LabelKey> labelKeys, Map<LabelKey, LabelValue> constantLabels, Timestamp startTime)

Method Summary

Modifier and Type	Method	Description
void	clear()	Removes all TimeSeries from the cumulative metric.
LongCumulative.LongPoint	getDefaultTimeSeries()	Returns a LongPoint for a cumulative with all labels not set, or default labels.
Metric	getMetric(Clock clock)	Provides a Metric with one or more TimeSeries.
MetricDescriptor	getMetricDescriptor()	Provides a MetricDescriptor.
LongCumulative.LongPoint	getOrCreateTimeSeries(List<LabelValue> labelValues)	Creates a TimeSeries and returns a LongPoint if the specified labelValues is not already associated with this cumulative, else returns an existing LongPoint.
private LongCumulative.LongPoint	registerTimeSeries(List<LabelValue> labelValues)
void	removeTimeSeries(List<LabelValue> labelValues)	Removes the TimeSeries from the cumulative metric, if it is present.

Methods inherited from class Object

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

Field Details

UNSET_VALUE

static final LabelValue UNSET_VALUE

metricDescriptor

private final MetricDescriptor metricDescriptor

registeredPoints

private volatile Map<List<LabelValue>, LongCumulativeImpl.PointImpl> registeredPoints

labelKeysSize

private final int labelKeysSize

defaultLabelValues

private final List<LabelValue> defaultLabelValues

constantLabelValues

private final List<LabelValue> constantLabelValues

startTime

private final Timestamp startTime

Constructor Details

LongCumulativeImpl

LongCumulativeImpl(String name,
 String description,
 String unit,
 List<LabelKey> labelKeys,
 Map<LabelKey, LabelValue> constantLabels,
 Timestamp startTime)

Method Details

getOrCreateTimeSeries

public LongCumulative.LongPoint getOrCreateTimeSeries(List<LabelValue> labelValues)

Description copied from class: LongCumulative

Creates a TimeSeries and returns a LongPoint if the specified labelValues is not already associated with this cumulative, else returns an existing LongPoint.

It is recommended to keep a reference to the LongPoint instead of always calling this method for manual operations.

Specified by:

getOrCreateTimeSeries in class LongCumulative

Parameters:

labelValues - the list of label values. The number of label values must be the same to that of the label keys passed to MetricRegistry.addLongCumulative(String, MetricOptions).

Returns:

a LongPoint the value of single cumulative.

getDefaultTimeSeries

public LongCumulative.LongPoint getDefaultTimeSeries()

Description copied from class: LongCumulative

Returns a LongPoint for a cumulative with all labels not set, or default labels.

Specified by:

getDefaultTimeSeries in class LongCumulative

Returns:

a LongPoint for a cumulative with all labels not set, or default labels.

removeTimeSeries

public void removeTimeSeries(List<LabelValue> labelValues)

Description copied from class: LongCumulative

Removes the TimeSeries from the cumulative metric, if it is present. i.e. references to previous LongPoint objects are invalid (not part of the metric).

Specified by:

removeTimeSeries in class LongCumulative

Parameters:

labelValues - the list of label values.

clear

public void clear()

Description copied from class: LongCumulative

Removes all TimeSeries from the cumulative metric. i.e. references to all previous LongPoint objects are invalid (not part of the metric).

Specified by:

clear in class LongCumulative

getMetricDescriptor

public MetricDescriptor getMetricDescriptor()

Description copied from interface: Meter

Provides a MetricDescriptor.

Specified by:

getMetricDescriptor in interface Meter

Returns:

a MetricDescriptor.

registerTimeSeries

private LongCumulative.LongPoint registerTimeSeries(List<LabelValue> labelValues)

getMetric

@Nullable
public Metric getMetric(Clock clock)

Description copied from interface: Meter

Provides a Metric with one or more TimeSeries.

Specified by:

getMetric in interface Meter

Parameters:

clock - the clock used to get the time.

Returns:

a Metric.