Struct Span 

pub struct Span {
    pub name: String,
    pub trace_id: String,
    pub span_id: String,
    pub parent_span_id: Option<String>,
    pub kind: SpanKind,
    pub start_time: Instant,
    pub end_time: Option<Instant>,
    pub status: SpanStatus,
    pub attributes: HashMap<String, SpanValue>,
    pub events: Vec<SpanEvent>,
}

A tracing span representing a unit of work

Fields

name: String

Span name

trace_id: String

Trace ID

span_id: String

Span ID

parent_span_id: Option<String>

Parent span ID

kind: SpanKind

Span kind

start_time: Instant

Start time

end_time: Option<Instant>

End time (set when span ends)

status: SpanStatus

Span status

attributes: HashMap<String, SpanValue>

Attributes

events: Vec<SpanEvent>

Events

Implementations

impl Span

pub fn new(name: impl Into<String>, trace_id: String, span_id: String) -> Self

Create a new span

pub fn with_parent(self, parent_span_id: String) -> Self

Set parent span ID

pub fn with_kind(self, kind: SpanKind) -> Self

Set span kind

pub fn set_attribute( &mut self, key: impl Into<String>, value: impl Into<SpanValue>, )

Set an attribute

pub fn add_event(&mut self, name: impl Into<String>)

Add an event

pub fn add_event_with_attributes( &mut self, name: impl Into<String>, attributes: HashMap<String, SpanValue>, )

Add an event with attributes

pub fn set_status(&mut self, status: SpanStatus)

Set span status

pub fn end(&mut self)

End the span

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

Get span duration

Trait Implementations

impl Clone for Span

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Span

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

Formats the value using the given formatter.