Struct opentelemetry::sdk::trace::Tracer

pub struct Tracer { /* fields omitted */ }

This is supported on crate feature trace only.

Tracer implementation to create and manage spans

Implementations

impl Tracer

pub fn provider(&self) -> Option<TracerProvider>

TracerProvider associated with this tracer.

pub fn instrumentation_library(&self) -> &InstrumentationLibrary

instrumentation library information of this tracer.

Trait Implementations

impl Clone for Tracer

pub fn clone(&self) -> Tracer

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Tracer

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

Formats the Tracer using the given formatter. Omitting provider here is necessary to avoid cycles.

impl Tracer for Tracer

type Span = Span

This implementation of Tracer produces sdk::Span instances.

pub fn invalid(&self) -> Self::Span

Returns a span with an inactive SpanContext. Used by functions that need to return a default span like get_active_span if no span is present.

pub fn start_with_context(&self, name: &str, cx: Context) -> Self::Span

Starts a new Span with a given context.

Each span has zero or one parent spans and zero or more child spans, which represent causally related operations. A tree of related spans comprises a trace. A span is said to be a root span if it does not have a parent. Each trace includes a single root span, which is the shared ancestor of all other spans in the trace.

pub fn span_builder(&self, name: &str) -> SpanBuilder

Creates a span builder

An ergonomic way for attributes to be configured before the Span is started.

pub fn build(&self, builder: SpanBuilder) -> Self::Span

Starts a span from a SpanBuilder.

Each span has zero or one parent spans and zero or more child spans, which represent causally related operations. A tree of related spans comprises a trace. A span is said to be a root span if it does not have a parent. Each trace includes a single root span, which is the shared ancestor of all other spans in the trace.

pub fn start(&self, name: &str) -> Self::Span

Starts a new Span.

pub fn in_span<T, F>(&self, name: &'static str, f: F) -> T where
    F: FnOnce(Context) -> T,
    Self::Span: Send + Sync, 

Start a new span and execute the given closure with reference to the span's context.

pub fn with_span<T, F>(&self, span: Self::Span, f: F) -> T where
    F: FnOnce(Context) -> T,
    Self::Span: Send + Sync, 

Start a new span and execute the given closure with reference to the span's context.