Struct Tracer

pub struct Tracer { /* private fields */ }

Available 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

fn clone(&self) -> Tracer

Returns a duplicate of the value.

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

fn start_with_context<T>(&self, name: T, parent_cx: &Context) -> Self::Span

where T: Into<Cow<'static, str>>,

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.

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

where T: Into<Cow<'static, str>>,

Creates a span builder

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

fn build_with_context( &self, builder: SpanBuilder, parent_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<T>(&self, name: T) -> Self::Span

where T: Into<Cow<'static, str>>,

Starts a new Span.

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

Create a span from a SpanBuilder

fn in_span<T, F>(&self, name: &'static str, f: F) -> T

where F: FnOnce(Context) -> T, Self::Span: Send + Sync + 'static,

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 + 'static,

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