io.micrometer.core.instrument

Interface Gauge

All Superinterfaces:

java.lang.AutoCloseable, Meter

All Known Subinterfaces:

TimeGauge

All Known Implementing Classes:

DefaultGauge, DropwizardGauge, NoopGauge, NoopTimeGauge

public interface Gauge
extends Meter

A gauge tracks a value that may go up or down. The value that is published for gauges is an instantaneous sample of the gauge at publishing time.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	Gauge.Builder<T> Fluent builder for gauges.

Nested classes/interfaces inherited from interface io.micrometer.core.instrument.Meter

Meter.Id, Meter.Type

Method Summary

Modifier and Type	Method and Description
static <T> Gauge.Builder<T>	builder(java.lang.String name, T obj, java.util.function.ToDoubleFunction<T> f)
default java.lang.Iterable<Measurement>	measure() Get a set of measurements.
double	value() The act of observing the value by calling this method triggers sampling of the underlying number or user-defined function that defines the value for the gauge.

Methods inherited from interface io.micrometer.core.instrument.Meter

builder, close, getId

Method Detail

builder

static <T> Gauge.Builder<T> builder(java.lang.String name,
                                    @Nullable
                                    T obj,
                                    java.util.function.ToDoubleFunction<T> f)

value

double value()

The act of observing the value by calling this method triggers sampling of the underlying number or user-defined function that defines the value for the gauge.

Returns:

The current value.

measure

default java.lang.Iterable<Measurement> measure()

Description copied from interface: Meter

Get a set of measurements. Should always return the same number of measurements and in the same order, regardless of the level of activity or the lack thereof.

Specified by:

measure in interface Meter

Returns:

The set of measurements that represents the instantaneous value of this meter.