Package io.opentelemetry.sdk.metrics.export

Interface MetricReader

All Superinterfaces:

AggregationTemporalitySelector, AutoCloseable, Closeable, DefaultAggregationSelector

All Known Implementing Classes:

PeriodicMetricReader

public interface MetricReader
extends AggregationTemporalitySelector, DefaultAggregationSelector, Closeable

A metric reader reads metrics from an SdkMeterProvider.

Custom implementations of MetricReader are not currently supported. Please use one of the built-in readers such as PeriodicMetricReader.

Since:

1.14.0

Method Summary

Modifier and Type	Method	Description
default void	close()	Close this MetricReader, releasing any resources.
io.opentelemetry.sdk.common.CompletableResultCode	forceFlush()	Read and export the metrics.
default Aggregation	getDefaultAggregation(InstrumentType instrumentType)	Return the default aggregation for the InstrumentType.
void	register(CollectionRegistration registration)	Called by SdkMeterProvider and supplies the MetricReader with a handle to collect metrics.
io.opentelemetry.sdk.common.CompletableResultCode	shutdown()	Shuts down the metric reader.

Methods inherited from interface io.opentelemetry.sdk.metrics.export.AggregationTemporalitySelector

getAggregationTemporality

Methods inherited from interface io.opentelemetry.sdk.metrics.export.DefaultAggregationSelector

with

Method Details

register

void register(CollectionRegistration registration)

Called by SdkMeterProvider and supplies the MetricReader with a handle to collect metrics.

CollectionRegistration is currently an empty interface because custom implementations of MetricReader are not currently supported.

getDefaultAggregation

default Aggregation getDefaultAggregation(InstrumentType instrumentType)

Return the default aggregation for the InstrumentType.

Specified by:

getDefaultAggregation in interface DefaultAggregationSelector

Since:

1.16.0

See Also:

• DefaultAggregationSelector.getDefaultAggregation(InstrumentType)

forceFlush

io.opentelemetry.sdk.common.CompletableResultCode forceFlush()

Read and export the metrics.

Called when SdkMeterProvider.forceFlush() is called.

Returns:

the result of the flush.

shutdown

io.opentelemetry.sdk.common.CompletableResultCode shutdown()

Shuts down the metric reader.

Called when SdkMeterProvider.shutdown() is called.

For pull based readers like prometheus, this should shut down the metric hosting endpoint or server doing such a job.

For push based readers like MetricExporter, this should shut down any scheduler threads.

Returns:

the result of the shutdown.

close

default void close()
            throws IOException

Close this MetricReader, releasing any resources.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Throws:

IOException