Package io.opentelemetry.sdk.trace

Class SdkTracerProviderBuilder

java.lang.Object

io.opentelemetry.sdk.trace.SdkTracerProviderBuilder

public final class SdkTracerProviderBuilder
extends Object

Builder of SdkTracerProvider.

Field Summary

Fields

Modifier and Type	Field	Description
private Clock	clock
private static final Sampler	DEFAULT_SAMPLER
private IdGenerator	idsGenerator
private Resource	resource
private Sampler	sampler
private Supplier<SpanLimits>	spanLimitsSupplier
private final List<SpanProcessor>	spanProcessors
private ScopeConfiguratorBuilder<TracerConfig>	tracerConfiguratorBuilder

Constructor Summary

Constructors

Constructor	Description
SdkTracerProviderBuilder()

Method Summary

Modifier and Type	Method	Description
SdkTracerProviderBuilder	addResource(Resource resource)	Merge a Resource with the current.
SdkTracerProviderBuilder	addSpanProcessor(SpanProcessor spanProcessor)	Add a SpanProcessor to the span pipeline that will be built.
(package private) SdkTracerProviderBuilder	addTracerConfiguratorCondition(Predicate<InstrumentationScopeInfo> scopeMatcher, TracerConfig tracerConfig)	Adds a condition to the tracer configurator, which computes TracerConfig for each InstrumentationScopeInfo.
SdkTracerProvider	build()	Create a new SdkTracerProvider instance with the configuration.
SdkTracerProviderBuilder	setClock(Clock clock)	Assign a Clock.
SdkTracerProviderBuilder	setIdGenerator(IdGenerator idGenerator)	Assign an IdGenerator.
SdkTracerProviderBuilder	setResource(Resource resource)	Assign a Resource to be attached to all Spans created by Tracers.
SdkTracerProviderBuilder	setSampler(Sampler sampler)	Assign a Sampler to use for sampling traces.
SdkTracerProviderBuilder	setSpanLimits(SpanLimits spanLimits)	Assign an initial SpanLimits that should be used with this SDK.
SdkTracerProviderBuilder	setSpanLimits(Supplier<SpanLimits> spanLimitsSupplier)	Assign a Supplier of SpanLimits.
(package private) SdkTracerProviderBuilder	setTracerConfigurator(ScopeConfigurator<TracerConfig> tracerConfigurator)	Set the tracer configurator, which computes TracerConfig for each InstrumentationScopeInfo.

Methods inherited from class java.lang.Object

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

Field Details

DEFAULT_SAMPLER

private static final Sampler DEFAULT_SAMPLER

spanProcessors

private final List<SpanProcessor> spanProcessors

clock

private Clock clock

idsGenerator

private IdGenerator idsGenerator

resource

private Resource resource

spanLimitsSupplier

private Supplier<SpanLimits> spanLimitsSupplier

sampler

private Sampler sampler

tracerConfiguratorBuilder

private ScopeConfiguratorBuilder<TracerConfig> tracerConfiguratorBuilder

Constructor Details

SdkTracerProviderBuilder

SdkTracerProviderBuilder()

Method Details

setClock

public SdkTracerProviderBuilder setClock(Clock clock)

Assign a Clock. Clock will be used each time a Span is started, ended or any event is recorded.

The clock must be thread-safe and return immediately (no remote calls, as contention free as possible).

Parameters:

clock - The clock to use for all temporal needs.

Returns:

this

setIdGenerator

public SdkTracerProviderBuilder setIdGenerator(IdGenerator idGenerator)

Assign an IdGenerator. IdGenerator will be used each time a Span is started.

The idGenerator must be thread-safe and return immediately (no remote calls, as contention free as possible).

Parameters:

idGenerator - A generator for trace and span ids.

Returns:

this

setResource

public SdkTracerProviderBuilder setResource(Resource resource)

Assign a Resource to be attached to all Spans created by Tracers.

Parameters:

resource - A Resource implementation.

Returns:

this

addResource

public SdkTracerProviderBuilder addResource(Resource resource)

Merge a Resource with the current.

Parameters:

resource - Resource to merge with current.

Since:

1.29.0

setSpanLimits

public SdkTracerProviderBuilder setSpanLimits(SpanLimits spanLimits)

Assign an initial SpanLimits that should be used with this SDK.

This method is equivalent to calling setSpanLimits(Supplier) like this #setSpanLimits(() -> spanLimits).

Parameters:

spanLimits - the limits that will be used for every Span.

Returns:

this

setSpanLimits

public SdkTracerProviderBuilder setSpanLimits(Supplier<SpanLimits> spanLimitsSupplier)

Assign a Supplier of SpanLimits. SpanLimits will be retrieved each time a Span is started.

The spanLimitsSupplier must be thread-safe and return immediately (no remote calls, as contention free as possible).

Parameters:

spanLimitsSupplier - the supplier that will be used to retrieve the SpanLimits for every Span.

Returns:

this

setSampler

public SdkTracerProviderBuilder setSampler(Sampler sampler)

Assign a Sampler to use for sampling traces. Sampler will be called each time a Span is started.

The sampler must be thread-safe and return immediately (no remote calls, as contention free as possible).

Parameters:

sampler - the Sampler to use for sampling traces.

Returns:

this

addSpanProcessor

public SdkTracerProviderBuilder addSpanProcessor(SpanProcessor spanProcessor)

Add a SpanProcessor to the span pipeline that will be built. SpanProcessor will be called each time a Span is started or ended.

The spanProcessor must be thread-safe and return immediately (no remote calls, as contention free as possible).

Parameters:

spanProcessor - the processor to be added to the processing pipeline.

Returns:

this

setTracerConfigurator

SdkTracerProviderBuilder setTracerConfigurator(ScopeConfigurator<TracerConfig> tracerConfigurator)

Set the tracer configurator, which computes TracerConfig for each InstrumentationScopeInfo.

This method is experimental so not public. You may reflectively call it using SdkTracerProviderUtil.setTracerConfigurator(SdkTracerProviderBuilder, ScopeConfigurator).

Overrides any matchers added via addTracerConfiguratorCondition(Predicate, TracerConfig).

See Also:

• TracerConfig.configuratorBuilder()

addTracerConfiguratorCondition

SdkTracerProviderBuilder addTracerConfiguratorCondition(Predicate<InstrumentationScopeInfo> scopeMatcher,
 TracerConfig tracerConfig)

Adds a condition to the tracer configurator, which computes TracerConfig for each InstrumentationScopeInfo.

This method is experimental so not public. You may reflectively call it using SdkTracerProviderUtil.addTracerConfiguratorCondition(SdkTracerProviderBuilder, Predicate, TracerConfig).

Applies after any previously added conditions.

If setTracerConfigurator(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 SdkTracerProvider build()

Create a new SdkTracerProvider instance with the configuration.

Returns:

The instance.