Package io.opentelemetry.api
Class GlobalOpenTelemetry
java.lang.Object
io.opentelemetry.api.GlobalOpenTelemetry
A global singleton for the entrypoint to telemetry functionality for tracing, metrics and
baggage.
If using the OpenTelemetry SDK, you may want to instantiate the OpenTelemetry
to
provide configuration, for example of Resource
or Sampler
. See
OpenTelemetrySdk
and OpenTelemetrySdk.builder
for information on how to construct the
SDK OpenTelemetry
.
- See Also:
-
TracerProvider
ContextPropagators
-
Method Summary
Modifier and TypeMethodDescriptionstatic OpenTelemetry
get()
Returns the registered globalOpenTelemetry
.static io.opentelemetry.context.propagation.ContextPropagators
Returns the globally registeredContextPropagators
for remote propagation of a context.static Tracer
Gets or creates a named tracer instance from the globally registeredTracerProvider
.static Tracer
Gets or creates a named and versioned tracer instance from the globally registeredTracerProvider
.static TracerProvider
Returns the globally registeredTracerProvider
.static void
Unsets the globalOpenTelemetry
.static void
set
(OpenTelemetry openTelemetry) Sets theOpenTelemetry
that should be the global instance.static TracerBuilder
tracerBuilder
(String instrumentationName) Creates a TracerBuilder for a namedTracer
instance.
-
Method Details
-
get
Returns the registered globalOpenTelemetry
.- Throws:
IllegalStateException
- if a provider has been specified by system property using the interface FQCN but the specified provider cannot be found.
-
set
Sets theOpenTelemetry
that should be the global instance. Future calls toget()
will return the providedOpenTelemetry
instance. This should be called once as early as possible in your application initialization logic, often in astatic
block in your main class. It should only be called once - an attempt to call it a second time will result in an error. If trying to set the globalOpenTelemetry
multiple times in tests, useresetForTest()
between them.If you are using the OpenTelemetry SDK, you should generally use
OpenTelemetrySdk.builder().buildAndRegisterGlobal()
instead of calling this method directly. -
getTracerProvider
Returns the globally registeredTracerProvider
. -
getTracer
Gets or creates a named tracer instance from the globally registeredTracerProvider
.This is a shortcut method for
getTracerProvider().get(instrumentationName)
- Parameters:
instrumentationName
- The name of the instrumentation library, not the name of the instrument*ed* library (e.g., "io.opentelemetry.contrib.mongodb"). Must not be null.- Returns:
- a tracer instance.
-
getTracer
Gets or creates a named and versioned tracer instance from the globally registeredTracerProvider
.This is a shortcut method for
getTracerProvider().get(instrumentationName, instrumentationVersion)
- Parameters:
instrumentationName
- The name of the instrumentation library, not the name of the instrument*ed* library (e.g., "io.opentelemetry.contrib.mongodb"). Must not be null.instrumentationVersion
- The version of the instrumentation library (e.g., "1.0.0").- Returns:
- a tracer instance.
-
tracerBuilder
Creates a TracerBuilder for a namedTracer
instance.This is a shortcut method for
get().tracerBuilder(instrumentationName)
- Parameters:
instrumentationName
- The name of the instrumentation library, not the name of the instrument*ed* library.- Returns:
- a TracerBuilder instance.
- Since:
- 1.4.0
-
resetForTest
public static void resetForTest()Unsets the globalOpenTelemetry
. This is only meant to be used from tests which need to reconfigureOpenTelemetry
. -
getPropagators
public static io.opentelemetry.context.propagation.ContextPropagators getPropagators()Returns the globally registeredContextPropagators
for remote propagation of a context.
-