Package io.opentelemetry.api.trace

Interface TracerProvider

@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(String instrumentationName)	Gets or creates a named tracer instance.
Tracer	get(String instrumentationName, String instrumentationVersion)	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(String instrumentationName)	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(String instrumentationName)

Gets or creates a named tracer instance.

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. If the instrumented library is providing its own instrumentation, this should match the library name.

Returns:

a tracer instance.

get

Tracer get(String instrumentationName,
           String instrumentationVersion)

Gets or creates a named and versioned tracer instance.

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. If the instrumented library is providing its own instrumentation, this should match the library name.

instrumentationVersion - The version of the instrumentation library (e.g., "1.0.0").

Returns:

a tracer instance.

tracerBuilder

default TracerBuilder tracerBuilder(String instrumentationName)

Creates a TracerBuilder for a named Tracer instance.

Parameters:

instrumentationName - The name of the instrumentation library, not the name of the instrument*ed* library.

Returns:

a TracerBuilder instance.

Since:

1.4.0