Package io.opentelemetry.api.metrics

Interface LongGauge

@ThreadSafe
public interface LongGauge

A gauge instrument that synchronously records long values.

Since:

1.38.0

Method Summary

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

Method Details

isEnabled

default boolean isEnabled()

Returns true if the gauge 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 set(long), set(long, Attributes), or set(long, Attributes, Context).

Since:

1.61.0

set

void set(long value)

Set the gauge value.

Parameters:

value - The current gauge value.

set

void set(long value,
 Attributes attributes)

Records a value with a set of attributes.

Parameters:

value - The current gauge value.

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

set

void set(long value,
 Attributes attributes,
 io.opentelemetry.context.Context context)

Records a value with a set of attributes.

Parameters:

value - The current gauge value.

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

context - The explicit context to associate with this measurement.