Package io.opentelemetry.api.trace

Interface TracerProvider

All Known Implementing Classes:

DefaultTracerProvider, ExtendedDefaultTracerProvider, OpenTelemetrySdk.ObfuscatedTracerProvider, SdkTracerProvider

@ThreadSafe
public interface TracerProvider

A registry for creating named Tracers. The name Provider is for consistency with * other languages and it is NOT loaded using reflection.

See Also:

Tracer

Method Summary

Modifier and Type	Method	Description
Tracer	get(java.lang.String instrumentationScopeName)	Gets or creates a named tracer instance.
Tracer	get(java.lang.String instrumentationScopeName, java.lang.String instrumentationScopeVersion)	Gets or creates a named and versioned tracer instance.
static TracerProvider	noop()	Returns a no-op TracerProvider which only creates no-op Spans which do not record nor are emitted.
default TracerBuilder	tracerBuilder(java.lang.String instrumentationScopeName)	Creates a TracerBuilder for a named Tracer instance.

Method Detail

noop

static TracerProvider noop()

Returns a no-op TracerProvider which only creates no-op Spans which do not record nor are emitted.

get

Tracer get(java.lang.String instrumentationScopeName)

Gets or creates a named tracer instance.

Parameters:

instrumentationScopeName - A name uniquely identifying the instrumentation scope, such as the instrumentation library, package, or fully qualified class name. Must not be null.

Returns:

a tracer instance.

get

Tracer get(java.lang.String instrumentationScopeName,
           java.lang.String instrumentationScopeVersion)

Gets or creates a named and versioned tracer instance.

Parameters:

instrumentationScopeName - A name uniquely identifying the instrumentation scope, such as the instrumentation library, package, or fully qualified class name. Must not be null.

instrumentationScopeVersion - The version of the instrumentation scope (e.g., "1.0.0").

Returns:

a tracer instance.

tracerBuilder

default TracerBuilder tracerBuilder(java.lang.String instrumentationScopeName)

Creates a TracerBuilder for a named Tracer instance.

Parameters:

instrumentationScopeName - A name uniquely identifying the instrumentation scope, such as the instrumentation library, package, or fully qualified class name. Must not be null.

Returns:

a TracerBuilder instance.

Since:

1.4.0