Struct opentelemetry::sdk::trace::tracer::Tracer

pub struct Tracer { /* fields omitted */ }

Tracer implementation to create and manage spans

Implementations

impl Tracer

pub fn provider(&self) -> &Provider

Provider associated with this tracer

Trait Implementations

impl Clone for Tracer

fn clone(&self) -> Tracer

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Tracer

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 api::Tracer produces sdk::Span instances.

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.

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

Starts a new Span in 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.

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

Creates a span builder

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

fn build_with_context(&self, builder: SpanBuilder, cx: &Context) -> 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.

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

Starts a new Span.

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

Create a span from a SpanBuilder

#[must_use = "Dropping the guard detaches the context."]fn mark_span_as_active(&self, span: Self::Span) -> ContextGuard

Mark a given Span as active.

fn get_active_span<F, T>(&self, f: F) -> T where
    F: FnOnce(&dyn Span) -> T,
    Self: Sized, 

Executes a closure with a reference to this thread's current span.

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.

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.