Struct opentelemetry::sdk::trace::TracerProvider

pub struct TracerProvider { /* private fields */ }

Creator and registry of named Tracer instances.

Implementations

impl TracerProvider

pub fn builder() -> Builder

Create a new TracerProvider builder.

pub fn span_processors(&self) -> &Vec<Box<dyn SpanProcessor>>

Span processors associated with this provider

pub fn config(&self) -> &Config

Config associated with this tracer

pub fn force_flush(&self) -> Vec<Result<(), TraceError>>

Force flush all remaining spans in span processors and return results.

Examples

use opentelemetry_api::global;
use opentelemetry_sdk::trace::TracerProvider;

fn init_tracing() -> TracerProvider {
    let provider = TracerProvider::default();

    // Set provider to be used as global tracer provider
    let _ = global::set_tracer_provider(provider.clone());

    provider
}

fn main() {
    let provider = init_tracing();

    // create spans..

    // force all spans to flush
    for result in provider.force_flush() {
        if let Err(err) = result {
            // .. handle flush error
        }
    }

    // create more spans..

    // dropping provider and shutting down global provider ensure all
    // remaining spans are exported
    drop(provider);
    global::shutdown_tracer_provider();
}

Trait Implementations

impl Clone for TracerProvider

fn clone(&self) -> TracerProvider

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TracerProvider

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for TracerProvider

fn default() -> TracerProvider

Returns the “default value” for a type.

impl TracerProvider for TracerProvider

type Tracer = Tracer

This implementation of TracerProvider produces Tracer instances.

fn versioned_tracer( &self, name: impl Into<Cow<'static, str>>, version: Option<impl Into<Cow<'static, str>>>, schema_url: Option<impl Into<Cow<'static, str>>>, attributes: Option<Vec<KeyValue>> ) -> <TracerProvider as TracerProvider>::Tracer

Create a new versioned Tracer instance.

fn library_tracer( &self, library: Arc<InstrumentationLibrary> ) -> <TracerProvider as TracerProvider>::Tracer

Returns a new versioned tracer with the given instrumentation library.

fn tracer(&self, name: impl Into<Cow<'static, str>>) -> Self::Tracer

Returns a new tracer with the given name.