Struct opentracingrust::tracers::NoopTracer

pub struct NoopTracer { /* fields omitted */ }

A tracer that discards spans.

Like for other tracers, spans are still collected in full and are cost memory until they are read from the FinishedSpan receiver and dropped.

Unlike other tracers, the NoopTracer will not propagate or extract tracing information and will discard all FinishedSpans when they are NoopTracer::reported.

This is especially useful as a way to effectively disable tracing in applications built with OpenTracing support when the end user does not wish to collect tracing information.

Examples

extern crate opentracingrust;

use opentracingrust::tracers::NoopTracer;


fn main() {
    let (tracer, receiver) = NoopTracer::new();
    // ... snip ...
}

Methods

impl NoopTracer

pub fn new() -> (Tracer, SpanReceiver)

Instantiate a new NoopTracer.

pub fn report(span: FinishedSpan)

"Reports" the finished span into nowere.

FinishedSpans passed to this method are simply dropped. This method is to provide a common interface with other tracers.

Trait Implementations

impl TracerInterface for NoopTracer

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

Attempt to extract a SpanContext from a carrier.

fn inject(&self, _context: &SpanContext, _fmt: InjectFormat) -> Result<()>

Inject tracing information into a carrier.

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

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