Struct zipkin::Span

pub struct Span { /* fields omitted */ }

A Span represents a single operation over some range of time.

Multiple spans make up a single "trace" of a distributed computation, and spans can be nested. A new trace is created with a "root" span, and subsections of that computation are recorded in individual spans.

For spans tracing a remote service call, two records will typically be generated, one from the client and the other from the server. The client is responsible for recording the timestamp and duration associated with the span, and the server span should omit that information. The client and server may both add their own annotations and binary annotations the span - they will be merged.

Methods

impl Span

fn builder() -> Builder

Returns a builder used to construct a Span.

fn trace_id(&self) -> TraceId

Returns the trace ID associated with this span.

fn name(&self) -> &str

Returns the name of this span.

fn id(&self) -> SpanId

Returns the ID of this span.

fn parent_id(&self) -> Option<SpanId>

Returns the ID of the parent of this span, if one exists.

fn timestamp(&self) -> Option<SystemTime>

Returns the time of the beginning of this span, if known.

fn duration(&self) -> Option<Duration>

Returns the duration of this span, if known.

fn annotations(&self) -> &[Annotation]

Returns the annotations associated with this span.

fn binary_annotations(&self) -> &[BinaryAnnotation]

Returns the binary annotations associated with this span.

Trait Implementations

impl Debug for Span

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

Formats the value using the given formatter.

impl Clone for Span

fn clone(&self) -> Span

Returns a copy of the value.

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

Performs copy-assignment from source.