Struct zipkin::Tracer

pub struct Tracer(_);

The root tracing object.

Each thread has its own current span state - the Tracer should be a single global resource.

Methods

impl Tracer

pub fn builder() -> Builder

Creates a Tracer builder.

pub fn new_trace(&self) -> OpenSpan<Attached>

Starts a new trace with no parent.

pub fn new_trace_from(&self, flags: SamplingFlags) -> OpenSpan<Attached>

Starts a new trace with no parent with specific sampling flags.

pub fn join_trace(&self, context: TraceContext) -> OpenSpan<Attached>

Joins an existing trace.

The context can come from, for example, the headers of an HTTP request.

pub fn new_child(&self, parent: TraceContext) -> OpenSpan<Attached>

Starts a new span with the specified parent.

pub fn next_span(&self) -> OpenSpan<Attached>

Starts a new trace parented to the current span if one exists.

pub fn set_current(&self, context: TraceContext) -> CurrentGuard

Sets this thread's current trace context.

This method does not start a span. It is designed to be used when propagating the trace of an existing span to a new thread.

A guard object is returned which will restore the previous trace context when it falls out of scope.

pub fn current(&self) -> Option<TraceContext>

Returns this thread's current trace context.

Trait Implementations

impl Clone for Tracer

fn clone(&self) -> Tracer

Returns a copy of the value.

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

Performs copy-assignment from source.