Struct rustracing::Tracer

pub struct Tracer<S, T> { /* fields omitted */ }

Tracer.

Examples

use rustracing::Tracer;
use rustracing::sampler::AllSampler;

let (span_tx, span_rx) = crossbeam_channel::bounded(10);
let tracer = Tracer::with_sender(AllSampler, span_tx);
{
   let _span = tracer.span("foo").start_with_state(());
}
let span = span_rx.try_recv().unwrap();
assert_eq!(span.operation_name(), "foo");

Methods

impl<S: Sampler<T>, T> Tracer<S, T>

pub fn new(sampler: S) -> (Self, SpanReceiver<T>)

Makes a new Tracer instance with an unbounded channel.

This constructor is mainly for backward compatibility, it has the same interface as in previous versions except the type of SpanReceiver. It builds an unbounded channel which may cause memory issues if there is no reader, prefer with_sender() alternative with a bounded one.

pub fn with_sender(sampler: S, span_tx: SpanSender<T>) -> Self

Makes a new Tracer instance.

pub fn span<N>(&self, operation_name: N) -> StartSpanOptions<S, T> where
    N: Into<Cow<'static, str>>, 

Returns StartSpanOptions for starting a span which has the name operation_name.

impl<S, T> Tracer<S, T>

pub fn clone_with_sampler<U: Sampler<T>>(&self, sampler: U) -> Tracer<U, T>

Clone with the given sampler.

Trait Implementations

impl<S, T> Clone for Tracer<S, T>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<S: Debug, T: Debug> Debug for Tracer<S, T>

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.