Package io.opencensus.implcore.metrics

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 class	LongCumulativeImpl.PointImpl	Implementation of LongCumulative.LongPoint.

Nested classes/interfaces inherited from class io.opencensus.metrics.LongCumulative

LongCumulative.LongPoint

Field Summary

Fields

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

Constructor Summary

Constructors

Constructor	Description
LongCumulativeImpl(java.lang.String name, java.lang.String description, java.lang.String unit, java.util.List<LabelKey> labelKeys, java.util.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(java.util.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(java.util.List<LabelValue> labelValues)
void	removeTimeSeries(java.util.List<LabelValue> labelValues)	Removes the TimeSeries from the cumulative metric, if it is present.

Methods inherited from class java.lang.Object

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

Field Detail

UNSET_VALUE

static final LabelValue UNSET_VALUE

metricDescriptor

private final MetricDescriptor metricDescriptor

registeredPoints

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

labelKeysSize

private final int labelKeysSize

defaultLabelValues

private final java.util.List<LabelValue> defaultLabelValues

constantLabelValues

private final java.util.List<LabelValue> constantLabelValues

startTime

private final Timestamp startTime

Constructor Detail

LongCumulativeImpl

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

Method Detail

getOrCreateTimeSeries

public LongCumulative.LongPoint getOrCreateTimeSeries(java.util.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(java.lang.String, io.opencensus.metrics.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(java.util.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(java.util.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.