org.apache.rocketmq.shaded.io.opentelemetry.sdk.OpenTelemetrySdkBuilder Maven / Gradle / Ivy
/*
* Copyright The OpenTelemetry Authors
* SPDX-License-Identifier: Apache-2.0
*/
package org.apache.rocketmq.shaded.io.opentelemetry.sdk;
import org.apache.rocketmq.shaded.io.opentelemetry.api.GlobalOpenTelemetry;
import org.apache.rocketmq.shaded.io.opentelemetry.context.propagation.ContextPropagators;
import org.apache.rocketmq.shaded.io.opentelemetry.sdk.logs.SdkLogEmitterProvider;
import org.apache.rocketmq.shaded.io.opentelemetry.sdk.metrics.SdkMeterProvider;
import org.apache.rocketmq.shaded.io.opentelemetry.sdk.trace.SdkTracerProvider;
import org.apache.rocketmq.shaded.io.opentelemetry.sdk.trace.SdkTracerProviderBuilder;
import javax.annotation.Nullable;
/** A builder for configuring an {@link OpenTelemetrySdk}. */
public final class OpenTelemetrySdkBuilder {
private ContextPropagators propagators = ContextPropagators.noop();
@Nullable private SdkTracerProvider tracerProvider;
@Nullable private SdkMeterProvider meterProvider;
@Nullable private SdkLogEmitterProvider logEmitterProvider;
/**
* Package protected to disallow direct initialization.
*
* @see OpenTelemetrySdk#builder()
*/
OpenTelemetrySdkBuilder() {}
/**
* Sets the {@link SdkTracerProvider} to use. This can be used to configure tracing settings by
* returning the instance created by a {@link SdkTracerProviderBuilder}.
*
* @see SdkTracerProvider#builder()
*/
public OpenTelemetrySdkBuilder setTracerProvider(SdkTracerProvider tracerProvider) {
this.tracerProvider = tracerProvider;
return this;
}
/**
* Sets the {@link SdkMeterProvider} to use. This can be used to configure metric settings by
* returning the instance created by a {@link
* org.apache.rocketmq.shaded.io.opentelemetry.sdk.metrics.SdkMeterProviderBuilder}.
*
* @see SdkMeterProvider#builder()
*/
public OpenTelemetrySdkBuilder setMeterProvider(SdkMeterProvider meterProvider) {
this.meterProvider = meterProvider;
return this;
}
/**
* Sets the {@link SdkLogEmitterProvider} to use. This can be used to configure log settings by
* returning the instance created by a {@link
* org.apache.rocketmq.shaded.io.opentelemetry.sdk.logs.SdkLogEmitterProviderBuilder}.
*
* @see SdkLogEmitterProvider#builder()
*/
public OpenTelemetrySdkBuilder setLogEmitterProvider(SdkLogEmitterProvider logEmitterProvider) {
this.logEmitterProvider = logEmitterProvider;
return this;
}
/** Sets the {@link ContextPropagators} to use. */
public OpenTelemetrySdkBuilder setPropagators(ContextPropagators propagators) {
this.propagators = propagators;
return this;
}
/**
* Returns a new {@link OpenTelemetrySdk} built with the configuration of this {@link
* OpenTelemetrySdkBuilder} and registers it as the global {@link
* org.apache.rocketmq.shaded.io.opentelemetry.api.OpenTelemetry}. An exception will be thrown if this method is attempted to
* be called multiple times in the lifecycle of an application - ensure you have only one SDK for
* use as the global instance. If you need to configure multiple SDKs for tests, use {@link
* GlobalOpenTelemetry#resetForTest()} between them.
*
* @see GlobalOpenTelemetry
*/
public OpenTelemetrySdk buildAndRegisterGlobal() {
OpenTelemetrySdk sdk = build();
GlobalOpenTelemetry.set(sdk);
return sdk;
}
/**
* Returns a new {@link OpenTelemetrySdk} built with the configuration of this {@link
* OpenTelemetrySdkBuilder}. This SDK is not registered as the global {@link
* org.apache.rocketmq.shaded.io.opentelemetry.api.OpenTelemetry}. It is recommended that you register one SDK using {@link
* OpenTelemetrySdkBuilder#buildAndRegisterGlobal()} for use by instrumentation that requires
* access to a global instance of {@link org.apache.rocketmq.shaded.io.opentelemetry.api.OpenTelemetry}.
*
* @see GlobalOpenTelemetry
*/
public OpenTelemetrySdk build() {
SdkTracerProvider tracerProvider = this.tracerProvider;
if (tracerProvider == null) {
tracerProvider = SdkTracerProvider.builder().build();
}
SdkMeterProvider meterProvider = this.meterProvider;
if (meterProvider == null) {
meterProvider = SdkMeterProvider.builder().build();
}
SdkLogEmitterProvider logEmitterProvider = this.logEmitterProvider;
if (logEmitterProvider == null) {
logEmitterProvider = SdkLogEmitterProvider.builder().build();
}
return new OpenTelemetrySdk(tracerProvider, meterProvider, logEmitterProvider, propagators);
}
}