Class SdkMeterProviderBuilder

java.lang.Object

io.opentelemetry.sdk.metrics.SdkMeterProviderBuilder

public final class SdkMeterProviderBuilder
extends Object

Builder class for the SdkMeterProvider.

Since:

1.14.0

Field Summary

Fields

Modifier and Type	Field	Description
private Clock	clock
private static final ExemplarFilter	DEFAULT_EXEMPLAR_FILTER	By default, the exemplar filter is set to sample with traces.
private ExemplarFilter	exemplarFilter
private ScopeConfiguratorBuilder<MeterConfig>	meterConfiguratorBuilder
private final List<MetricProducer>	metricProducers
private final IdentityHashMap<MetricReader, CardinalityLimitSelector>	metricReaders
private final List<RegisteredView>	registeredViews
private Resource	resource

Constructor Summary

Constructors

Constructor	Description
SdkMeterProviderBuilder()

Method Summary

Modifier and Type	Method	Description
(package private) SdkMeterProviderBuilder	addMeterConfiguratorCondition(Predicate<InstrumentationScopeInfo> scopeMatcher, MeterConfig meterConfig)	Adds a condition to the meter configurator, which computes MeterConfig for each InstrumentationScopeInfo.
SdkMeterProviderBuilder	addResource(Resource resource)	Merge a Resource with the current.
SdkMeterProvider	build()	Returns an SdkMeterProvider built with the configuration of this builder.
SdkMeterProviderBuilder	registerMetricProducer(MetricProducer metricProducer)	Registers a MetricProducer.
SdkMeterProviderBuilder	registerMetricReader(MetricReader reader)	Registers a MetricReader.
SdkMeterProviderBuilder	registerMetricReader(MetricReader reader, CardinalityLimitSelector cardinalityLimitSelector)	Registers a MetricReader with a CardinalityLimitSelector.
SdkMeterProviderBuilder	registerView(InstrumentSelector selector, View view)	Register a View.
SdkMeterProviderBuilder	setClock(Clock clock)	Assign a Clock.
(package private) SdkMeterProviderBuilder	setExemplarFilter(ExemplarFilter filter)	Assign an ExemplarFilter for all metrics created by Meters.
(package private) SdkMeterProviderBuilder	setMeterConfigurator(ScopeConfigurator<MeterConfig> meterConfigurator)	Set the meter configurator, which computes MeterConfig for each InstrumentationScopeInfo.
SdkMeterProviderBuilder	setResource(Resource resource)	Assign a Resource to be attached to all metrics.

Methods inherited from class Object

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

Field Details

DEFAULT_EXEMPLAR_FILTER

private static final ExemplarFilter DEFAULT_EXEMPLAR_FILTER

By default, the exemplar filter is set to sample with traces.

See Also:

• setExemplarFilter(ExemplarFilter)

clock

private Clock clock

resource

private Resource resource

metricReaders

private final IdentityHashMap<MetricReader, CardinalityLimitSelector> metricReaders

metricProducers

private final List<MetricProducer> metricProducers

registeredViews

private final List<RegisteredView> registeredViews

exemplarFilter

private ExemplarFilter exemplarFilter

meterConfiguratorBuilder

private ScopeConfiguratorBuilder<MeterConfig> meterConfiguratorBuilder

Constructor Details

SdkMeterProviderBuilder

SdkMeterProviderBuilder()

Method Details

setClock

public SdkMeterProviderBuilder setClock(Clock clock)

Assign a Clock.

Parameters:

clock - The clock to use for all temporal needs.

setResource

public SdkMeterProviderBuilder setResource(Resource resource)

Assign a Resource to be attached to all metrics.

addResource

public SdkMeterProviderBuilder addResource(Resource resource)

Merge a Resource with the current.

Parameters:

resource - Resource to merge with current.

Since:

1.29.0

setExemplarFilter

SdkMeterProviderBuilder setExemplarFilter(ExemplarFilter filter)

Assign an ExemplarFilter for all metrics created by Meters.

This method is experimental so not public. You may reflectively call it using SdkMeterProviderUtil.setExemplarFilter(SdkMeterProviderBuilder, ExemplarFilter).

registerView

public SdkMeterProviderBuilder registerView(InstrumentSelector selector,
 View view)

Register a View.

The view influences how instruments which match the selector are aggregated and exported.

For example, the following code registers a view which changes all histogram instruments to aggregate with bucket boundaries different from the default:

// create a SdkMeterProviderBuilder
SdkMeterProviderBuilder meterProviderBuilder = SdkMeterProvider.builder();

// register the view with the SdkMeterProviderBuilder
meterProviderBuilder.registerView(
  InstrumentSelector.builder()
      .setType(InstrumentType.HISTOGRAM)
      .build(),
  View.builder()
      .setAggregation(
          Aggregation.explicitBucketHistogram(Arrays.asList(10d, 20d, 30d, 40d, 50d)))
      .build());

registerMetricReader

public SdkMeterProviderBuilder registerMetricReader(MetricReader reader)

Registers a MetricReader.

registerMetricReader

public SdkMeterProviderBuilder registerMetricReader(MetricReader reader,
 CardinalityLimitSelector cardinalityLimitSelector)

Registers a MetricReader with a CardinalityLimitSelector.

If registerMetricReader(MetricReader) is used, the CardinalityLimitSelector.defaultCardinalityLimitSelector() is used.

Since:

1.44.0

registerMetricProducer

public SdkMeterProviderBuilder registerMetricProducer(MetricProducer metricProducer)

Registers a MetricProducer.

Since:

1.31.0

setMeterConfigurator

SdkMeterProviderBuilder setMeterConfigurator(ScopeConfigurator<MeterConfig> meterConfigurator)

Set the meter configurator, which computes MeterConfig for each InstrumentationScopeInfo.

This method is experimental so not public. You may reflectively call it using SdkMeterProviderUtil.setMeterConfigurator(SdkMeterProviderBuilder, ScopeConfigurator).

Overrides any matchers added via addMeterConfiguratorCondition(Predicate, MeterConfig).

See Also:

• MeterConfig.configuratorBuilder()

addMeterConfiguratorCondition

SdkMeterProviderBuilder addMeterConfiguratorCondition(Predicate<InstrumentationScopeInfo> scopeMatcher,
 MeterConfig meterConfig)

Adds a condition to the meter configurator, which computes MeterConfig for each InstrumentationScopeInfo.

This method is experimental so not public. You may reflectively call it using SdkMeterProviderUtil.addMeterConfiguratorCondition(SdkMeterProviderBuilder, Predicate, MeterConfig).

Applies after any previously added conditions.

If setMeterConfigurator(ScopeConfigurator) was previously called, this condition will only be applied if the Function.apply(Object) returns null for the matched InstrumentationScopeInfo(s).

See Also:

• ScopeConfiguratorBuilder.nameEquals(String)
• ScopeConfiguratorBuilder.nameMatchesGlob(String)

build

public SdkMeterProvider build()

Returns an SdkMeterProvider built with the configuration of this builder.