Struct opentracingrust::tracers::FileTracer

pub struct FileTracer { /* fields omitted */ }

A tracer that writes spans to an std::io::Write.

Useful for local testing, experiments, tests. NOT suited for production use!

Intended to write spans to stderr but can also be used to write spans to stdout or files.

Examples

extern crate opentracingrust;

use std::io;
use std::time::Duration;

use opentracingrust::FinishedSpan;
use opentracingrust::tracers::FileTracer;
use opentracingrust::utils::GlobalTracer;
use opentracingrust::utils::ReporterThread;


fn main() {
    let (tracer, receiver) = FileTracer::new();
    GlobalTracer::init(tracer);

    let reporter = ReporterThread::new_with_duration(
        receiver, Duration::from_millis(50), |span| {
            let mut stderr = io::stderr();
            FileTracer::write_trace(span, &mut stderr).unwrap();
        }
    );

    // ... snip ...
}

Methods

impl FileTracer

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

Instantiate a new file tracer.

pub fn write_trace<W: Write>(span: FinishedSpan, file: &mut W) -> Result<()>

Function to write a FinishedSpan to a stream.

Used to send FinishedSpans to an std::io::Write stream.

Trait Implementations

impl TracerInterface for FileTracer

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

Extract a span context from a text map or HTTP headers.

Note that the binary extraction format is not supported by FileTracer.

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

Inject the span context into a text map or HTTP headers.

Note that the binary injection format is not supported by FileTracer.

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

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