Class SdkLongHistogram

java.lang.Object

io.opentelemetry.sdk.metrics.AbstractInstrument

io.opentelemetry.sdk.metrics.SdkLongHistogram

All Implemented Interfaces:

ExtendedLongHistogram, LongHistogram

final class SdkLongHistogram
extends AbstractInstrument
implements ExtendedLongHistogram

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
(package private) static final class	SdkLongHistogram.SdkLongHistogramBuilder

Field Summary

Fields

Modifier and Type	Field	Description
private static final Logger	logger
private final SdkMeter	sdkMeter
private final WriteableMetricStorage	storage
private final ThrottlingLogger	throttlingLogger

Constructor Summary

Constructors

Modifier	Constructor	Description
private	SdkLongHistogram(InstrumentDescriptor descriptor, SdkMeter sdkMeter, WriteableMetricStorage storage)

Method Summary

Modifier and Type	Method	Description
boolean	isEnabled()	Returns true if the histogram is enabled.
void	record(long value)	Records a value.
void	record(long value, Attributes attributes)	Records a value with a set of attributes.
void	record(long value, Attributes attributes, Context context)	Records a value with a set of attributes.

Methods inherited from class AbstractInstrument

equals, getDescriptor, hashCode, toString

Methods inherited from class Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Details

logger

private static final Logger logger

throttlingLogger

private final ThrottlingLogger throttlingLogger

sdkMeter

private final SdkMeter sdkMeter

storage

private final WriteableMetricStorage storage

Constructor Details

SdkLongHistogram

private SdkLongHistogram(InstrumentDescriptor descriptor,
 SdkMeter sdkMeter,
 WriteableMetricStorage storage)

Method Details

record

public void record(long value,
 Attributes attributes,
 Context context)

Description copied from interface: LongHistogram

Records a value with a set of attributes.

Specified by:

record in interface LongHistogram

Parameters:

value - The amount of the measurement. MUST be non-negative.

attributes - A set of attributes to associate with the value.

context - The explicit context to associate with this measurement.

record

public void record(long value,
 Attributes attributes)

Description copied from interface: LongHistogram

Records a value with a set of attributes.

Note: This may use Context.current() to pull the context associated with this measurement.

Specified by:

record in interface LongHistogram

Parameters:

value - The amount of the measurement. MUST be non-negative.

attributes - A set of attributes to associate with the value.

record

public void record(long value)

Description copied from interface: LongHistogram

Records a value.

Note: This may use Context.current() to pull the context associated with this measurement.

Specified by:

record in interface LongHistogram

Parameters:

value - The amount of the measurement. MUST be non-negative.

isEnabled

public boolean isEnabled()

Description copied from interface: ExtendedLongHistogram

Returns true if the histogram is enabled.

This allows callers to avoid unnecessary compute when nothing is consuming the data. Because the response is subject to change over the application, callers should call this before each call to LongHistogram.record(long), LongHistogram.record(long, Attributes), or LongHistogram.record(long, Attributes, Context).

Specified by:

isEnabled in interface ExtendedLongHistogram