Struct opentracingrust::Tracer

pub struct Tracer { /* fields omitted */ }

The library users interface to tracing.

This structure is the focus point for clients to use in combination with SpanContext. The configured tracer is stored in this structure and backs the available methods.

The Tracer structure also provides some utility methods to make common operations easier.

Methods

impl Tracer

pub fn new<T: TracerInterface + 'static>(tracer: T) -> Tracer

Creates a new Tracer for a concrete tracer.

impl Tracer

pub fn extract(&self, fmt: ExtractFormat) -> Result<Option<SpanContext>>

Attempt to extract a SpanContext from a carrier.

If the carrier (i.e, HTTP Request, RPC Message, ...) includes tracing information this method returns Ok(Some(context)), otherwise Ok(None) is returned.

If the method fails to extract a context because the carrier fails or because the tracing information is incorrectly formatted an Error is returned.

pub fn inject(&self, context: &SpanContext, fmt: InjectFormat) -> Result<()>

Inject tracing information into a carrier.

If the method fails to inject the context because the carrier fails.

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

Create a new Span with the given operation name and default starting options.

pub fn span_with_options(&self, name: &str, options: StartOptions) -> Span

Create a new Span with the given operation name and starting options.