Package io.opentelemetry.sdk.metrics

Class MeterSdkProvider

java.lang.Object

io.opentelemetry.sdk.metrics.MeterSdkProvider

All Implemented Interfaces:

io.opentelemetry.api.metrics.MeterProvider

public final class MeterSdkProvider
extends java.lang.Object
implements io.opentelemetry.api.metrics.MeterProvider

Meter provider implementation for MeterProvider.

This class is not intended to be used in application code and it is used only by OpenTelemetry.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	MeterSdkProvider.Builder	Builder class for the MeterSdkProvider.

Method Summary

Modifier and Type	Method	Description
static MeterSdkProvider.Builder	builder()	Returns a new MeterSdkProvider.Builder for MeterSdkProvider.
io.opentelemetry.sdk.metrics.MeterSdk	get(java.lang.String instrumentationName)
io.opentelemetry.sdk.metrics.MeterSdk	get(java.lang.String instrumentationName, java.lang.String instrumentationVersion)
MetricProducer	getMetricProducer()	Returns the MetricProducer that can be used to retrieve metrics from this MeterSdkProvider.
void	registerView(InstrumentSelector selector, AggregationConfiguration specification)	Register a view with the given InstrumentSelector.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

get

public io.opentelemetry.sdk.metrics.MeterSdk get(java.lang.String instrumentationName)

Specified by:

get in interface io.opentelemetry.api.metrics.MeterProvider

get

public io.opentelemetry.sdk.metrics.MeterSdk get(java.lang.String instrumentationName,
                                                 @Nullable
                                                 java.lang.String instrumentationVersion)

Specified by:

get in interface io.opentelemetry.api.metrics.MeterProvider

getMetricProducer

public MetricProducer getMetricProducer()

Returns the MetricProducer that can be used to retrieve metrics from this MeterSdkProvider.

WARNING: A MetricProducer is stateful. It will only return changes since the last time it was accessed. This means that if more than one MetricExporter has a handle to this MetricProducer, the two exporters will not receive copies of the same metric data to export.

Returns:

the MetricProducer that can be used to retrieve metrics from this MeterSdkProvider.

builder

public static MeterSdkProvider.Builder builder()

Returns a new MeterSdkProvider.Builder for MeterSdkProvider.

Returns:

a new MeterSdkProvider.Builder for MeterSdkProvider.

registerView

public void registerView(InstrumentSelector selector,
                         AggregationConfiguration specification)

Register a view with the given InstrumentSelector.

Example on how to register a view:

 // get a handle to the MeterSdkProvider
 MeterSdkProvider meterProvider = OpenTelemetrySdk.getMeterProvider();

 // create a selector to select which instruments to customize:
 InstrumentSelector instrumentSelector = InstrumentSelector.newBuilder()
   .instrumentType(InstrumentType.COUNTER)
   .build();

 // create a specification of how you want the metrics aggregated:
 AggregationConfiguration viewSpecification =
   AggregationConfiguration.create(Aggregations.minMaxSumCount(), Temporality.DELTA);

 //register the view with the MeterSdkProvider
 meterProvider.registerView(instrumentSelector, viewSpecification);
 

See Also:

AggregationConfiguration