Trait opentelemetry::trace::TracerProvider

source · [−]

pub trait TracerProvider: Debug + 'static {
    type Tracer: Tracer;

    fn tracer(
        &self,
        name: &'static str,
        version: Option<&'static str>
    ) -> Self::Tracer;
    fn force_flush(&self) -> Vec<TraceResult<()>>;
}

Expand description

Types that can create instances of Tracer.

Required Associated Types

source

type Tracer: Tracer

The Tracer type that this provider will return.

Required Methods

source

fn tracer(
    &self,
    name: &'static str,
    version: Option<&'static str>
) -> Self::Tracer

Returns a new tracer with the given name and version.

The name should be the application name or the name of the library providing instrumentation. If the name is empty, then an implementation-defined default name may be used instead.

Examples

use opentelemetry::{global, trace::TracerProvider};

let provider = global::tracer_provider();

// App tracer
let tracer = provider.tracer("my_app", None);

// Library tracer
let tracer = provider.tracer("my_library", Some(env!("CARGO_PKG_VERSION")));