```
public interface OpenTelemetry
```
The entrypoint to telemetry functionality for tracing, metrics and baggage.
A global singleton can be retrieved by get(). The default for the returned OpenTelemetry, if none has been set via set(OpenTelemetry), will be created with any OpenTelemetryFactory, TracerProviderFactory or MeterProviderFactory found on the classpath, or otherwise will be default, with no-op behavior.
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, MeterProvider

Nested Class Summary

Nested Classes
Modifier and Type Interface Description

static interface OpenTelemetry.Builder<T extends OpenTelemetry.Builder<T>>
A builder of an implementation of the OpenTelemetry API.

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method	Description
`static OpenTelemetry`	`get()`	Returns the registered global `OpenTelemetry`.
`static Meter`	`getGlobalMeter(String instrumentationName)`	Gets or creates a named meter instance from the globally registered `MeterProvider`.
`static Meter`	`getGlobalMeter(String instrumentationName, String instrumentationVersion)`	Gets or creates a named and versioned meter instance from the globally registered `MeterProvider`.
`static MeterProvider`	`getGlobalMeterProvider()`	Returns the globally registered `MeterProvider`.
`static io.opentelemetry.context.propagation.ContextPropagators`	`getGlobalPropagators()`	Returns the globally registered `ContextPropagators` for remote propagation of a context.
`static Tracer`	`getGlobalTracer(String instrumentationName)`	Gets or creates a named tracer instance from the globally registered `TracerProvider`.
`static Tracer`	`getGlobalTracer(String instrumentationName, String instrumentationVersion)`	Gets or creates a named and versioned tracer instance from the globally registered `TracerProvider`.
`static TracerProvider`	`getGlobalTracerProvider()`	Returns the globally registered `TracerProvider`.
`default Meter`	`getMeter(String instrumentationName)`	Gets or creates a named meter instance from the `MeterProvider` in this `OpenTelemetry`.
`default Meter`	`getMeter(String instrumentationName, String instrumentationVersion)`	Gets or creates a named and versioned meter instance from the `MeterProvider` in this `OpenTelemetry`.
`MeterProvider`	`getMeterProvider()`	Returns the `MeterProvider` for this `OpenTelemetry`.
`io.opentelemetry.context.propagation.ContextPropagators`	`getPropagators()`	Returns the `ContextPropagators` for this `OpenTelemetry`.
`default Tracer`	`getTracer(String instrumentationName)`	Gets or creates a named tracer instance from the `TracerProvider` for this `OpenTelemetry`.
`default Tracer`	`getTracer(String instrumentationName, String instrumentationVersion)`	Gets or creates a named and versioned tracer instance from the `TracerProvider` in this `OpenTelemetry`.
`TracerProvider`	`getTracerProvider()`	Returns the `TracerProvider` for this `OpenTelemetry`.
`static void`	`set(OpenTelemetry openTelemetry)`	Sets the `OpenTelemetry` that should be the global instance.
`static void`	`setGlobalPropagators(io.opentelemetry.context.propagation.ContextPropagators propagators)`	Sets the globally registered `ContextPropagators` for remote propagation of a context.
`OpenTelemetry.Builder<?>`	`toBuilder()`	Returns a new `OpenTelemetry.Builder` with the configuration of this `OpenTelemetry`.

- Method Detail
  - get
```
static OpenTelemetry get()
```
    Returns the registered global OpenTelemetry. If no call to set(OpenTelemetry) has been made so far, a default OpenTelemetry composed of functionality any OpenTelemetryFactory, TracerProviderFactory orMeterProviderFactory, found on the classpath, or otherwise will be default, with no-op behavior.
    
    Throws:
    
    IllegalStateException - if a provider has been specified by system property using the interface FQCN but the specified provider cannot be found.
  - set
```
static void set(OpenTelemetry openTelemetry)
```
    Sets the OpenTelemetry that should be the global instance. Future calls to get() will return the provided OpenTelemetry instance. This should be called once as early as possible in your application initialization logic, often in a static block in your main class.
  - getGlobalTracerProvider
```
static TracerProvider getGlobalTracerProvider()
```
    Returns the globally registered TracerProvider.
  - getGlobalTracer
```
static Tracer getGlobalTracer(String instrumentationName)
```
    Gets or creates a named tracer instance from the globally registered TracerProvider.
    This is a shortcut method for getGlobalTracerProvider().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.
  - getGlobalTracer
```
static Tracer getGlobalTracer(String instrumentationName,
                              String instrumentationVersion)
```
    Gets or creates a named and versioned tracer instance from the globally registered TracerProvider.
    This is a shortcut method for getGlobalTracerProvider().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., "semver:1.0.0").
    
    Returns:
    
    a tracer instance.
  - getGlobalMeterProvider
```
static MeterProvider getGlobalMeterProvider()
```
    Returns the globally registered MeterProvider.
  - getGlobalMeter
```
static Meter getGlobalMeter(String instrumentationName)
```
    Gets or creates a named meter instance from the globally registered MeterProvider.
    This is a shortcut method for getGlobalMeterProvider().get(instrumentationName)
    
    Parameters:
    
    instrumentationName - The name of the instrumentation library, not the name of the instrument*ed* library.
    
    Returns:
    
    a tracer instance.
  - getGlobalMeter
```
static Meter getGlobalMeter(String instrumentationName,
                            String instrumentationVersion)
```
    Gets or creates a named and versioned meter instance from the globally registered MeterProvider.
    This is a shortcut method for getGlobalMeterProvider().get(instrumentationName, instrumentationVersion)
    
    Parameters:
    
    instrumentationName - The name of the instrumentation library, not the name of the instrument*ed* library.
    
    instrumentationVersion - The version of the instrumentation library.
    
    Returns:
    
    a tracer instance.
  - getGlobalPropagators
```
static io.opentelemetry.context.propagation.ContextPropagators getGlobalPropagators()
```
    Returns the globally registered ContextPropagators for remote propagation of a context.
  - setGlobalPropagators
```
static void setGlobalPropagators(io.opentelemetry.context.propagation.ContextPropagators propagators)
```
    Sets the globally registered ContextPropagators for remote propagation of a context.
  - getTracerProvider
```
TracerProvider getTracerProvider()
```
    Returns the TracerProvider for this OpenTelemetry.
  - getTracer
```
default Tracer getTracer(String instrumentationName)
```
    Gets or creates a named tracer instance from the TracerProvider for this OpenTelemetry.
    
    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
```
default Tracer getTracer(String instrumentationName,
                         String instrumentationVersion)
```
    Gets or creates a named and versioned tracer instance from the TracerProvider in this OpenTelemetry.
    
    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., "semver:1.0.0").
    
    Returns:
    
    a tracer instance.
  - getMeterProvider
```
MeterProvider getMeterProvider()
```
    Returns the MeterProvider for this OpenTelemetry.
  - getMeter
```
default Meter getMeter(String instrumentationName)
```
    Gets or creates a named meter instance from the MeterProvider in this OpenTelemetry.
    
    Parameters:
    
    instrumentationName - The name of the instrumentation library, not the name of the instrument*ed* library.
    
    Returns:
    
    a tracer instance.
  - getMeter
```
default Meter getMeter(String instrumentationName,
                       String instrumentationVersion)
```
    Gets or creates a named and versioned meter instance from the MeterProvider in this OpenTelemetry.
    
    Parameters:
    
    instrumentationName - The name of the instrumentation library, not the name of the instrument*ed* library.
    
    instrumentationVersion - The version of the instrumentation library.
    
    Returns:
    
    a tracer instance.
  - getPropagators
```
io.opentelemetry.context.propagation.ContextPropagators getPropagators()
```
    Returns the ContextPropagators for this OpenTelemetry.
  - toBuilder
```
OpenTelemetry.Builder<?> toBuilder()
```
    Returns a new OpenTelemetry.Builder with the configuration of this OpenTelemetry.

Interface OpenTelemetry

Nested Class Summary

Method Summary

Method Detail

get

set

getGlobalTracerProvider

getGlobalTracer

getGlobalTracer

getGlobalMeterProvider

getGlobalMeter

getGlobalMeter

getGlobalPropagators

setGlobalPropagators

getTracerProvider

getTracer

getTracer

getMeterProvider

getMeter

getMeter

getPropagators

toBuilder