Package io.opentelemetry.sdk.metrics

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 class	SdkLongHistogram.SdkLongHistogramBuilder

Field Summary

Fields

Modifier and Type	Field	Description
private static java.util.logging.Logger	logger
private SdkMeter	sdkMeter
private WriteableMetricStorage	storage
private 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 io.opentelemetry.sdk.metrics.AbstractInstrument

equals, getDescriptor, hashCode, toString

Methods inherited from class java.lang.Object

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

Field Detail

logger

private static final java.util.logging.Logger logger

throttlingLogger

private final ThrottlingLogger throttlingLogger

sdkMeter

private final SdkMeter sdkMeter

storage

private final WriteableMetricStorage storage

Constructor Detail

SdkLongHistogram

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

Method Detail

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