io.opentelemetry

Class OpenTelemetry

java.lang.Object

io.opentelemetry.OpenTelemetry

@ThreadSafe
public final class OpenTelemetry
extends Object

This class provides a static global accessor for telemetry objects Tracer, Meter and CorrelationContextManager.

The telemetry objects are lazy-loaded singletons resolved via ServiceLoader mechanism.

See Also:

TracerProvider, MetricsProvider, CorrelationContextManagerProvider

Method Summary

Modifier and Type	Method and Description
static CorrelationContextManager	getCorrelationContextManager() Returns a singleton CorrelationContextManager.
static MeterProvider	getMeterProvider() Returns a singleton MeterProvider.
static io.opentelemetry.context.propagation.ContextPropagators	getPropagators() Returns a ContextPropagators object, which can be used to access the set of registered propagators for each supported format.
static TracerProvider	getTracerProvider() Returns a singleton TracerProvider.
static void	setPropagators(io.opentelemetry.context.propagation.ContextPropagators propagators) Sets the ContextPropagators object, which can be used to access the set of registered propagators for each supported format.

Methods inherited from class java.lang.Object

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

Method Detail

getTracerProvider

public static TracerProvider getTracerProvider()

Returns a singleton TracerProvider.

Returns:

registered TracerProvider of default via DefaultTracerProvider.getInstance().

Throws:

IllegalStateException - if a specified TracerProvider (via system properties) could not be found.

Since:

0.1.0

getMeterProvider

public static MeterProvider getMeterProvider()

Returns a singleton MeterProvider.

Returns:

registered MeterProvider or default via DefaultMeterProvider.getInstance().

Throws:

IllegalStateException - if a specified MeterProvider (via system properties) could not be found.

Since:

0.1.0

getCorrelationContextManager

public static CorrelationContextManager getCorrelationContextManager()

Returns a singleton CorrelationContextManager.

Returns:

registered manager or default via DefaultCorrelationContextManager.getInstance().

Throws:

IllegalStateException - if a specified manager (via system properties) could not be found.

Since:

0.1.0

getPropagators

public static io.opentelemetry.context.propagation.ContextPropagators getPropagators()

Returns a ContextPropagators object, which can be used to access the set of registered propagators for each supported format.

Returns:

registered propagators container, defaulting to a ContextPropagators object with HttpTraceContext registered.

Throws:

IllegalStateException - if a specified manager (via system properties) could not be found.

Since:

0.3.0

setPropagators

public static void setPropagators(io.opentelemetry.context.propagation.ContextPropagators propagators)

Sets the ContextPropagators object, which can be used to access the set of registered propagators for each supported format.

Parameters:

propagators - the ContextPropagators object to be registered.

Throws:

IllegalStateException - if a specified manager (via system properties) could not be found.

NullPointerException - if propagators is null.

Since:

0.3.0