Struct Span 

pub struct Span {
    pub span_id: SpanId,
    pub parent_span_id: Option<SpanId>,
    pub trace_id: TraceId,
    pub name: String,
    pub kind: SpanKind,
    pub start_time_us: u64,
    pub end_time_us: Option<u64>,
    pub attributes: HashMap<String, AttributeValue>,
    pub status: SpanStatus,
    pub events: Vec<SpanEvent>,
    pub links: Vec<SpanLink>,
    pub node_id: NodeId,
}

A span represents a unit of work in a trace

Fields

span_id: SpanId

Unique span ID

parent_span_id: Option<SpanId>

Parent span ID (None for root spans)

trace_id: TraceId

Trace this span belongs to

name: String

Human-readable name

kind: SpanKind

Kind of span

start_time_us: u64

Start timestamp (microseconds since Unix epoch)

end_time_us: Option<u64>

End timestamp (microseconds since Unix epoch)

attributes: HashMap<String, AttributeValue>

Span attributes

status: SpanStatus

Status

events: Vec<SpanEvent>

Events that occurred during the span

links: Vec<SpanLink>

Links to other spans

node_id: NodeId

Node that created this span

Implementations

impl Span

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

Create a new root span within the given trace

pub fn with_parent(self, parent: SpanId) -> Self

Set the parent span ID on this span

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

Set the kind of this span

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

Insert a key-value attribute on this span

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

Record a named event on this span at the current time

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

Record a named event with additional attributes on this span

pub fn add_link(&mut self, trace_id: TraceId, span_id: SpanId)

Add a causal link to another span in a different trace

pub fn set_ok(&mut self)

Mark this span as successfully completed

pub fn set_error(&mut self, message: impl Into<String>)

Mark this span as failed with the given error message

pub fn end(&mut self)

Record the end timestamp if not already set

pub fn duration_us(&self) -> Option<u64>

Return the elapsed duration in microseconds, if the span has ended

Trait Implementations

impl Clone for Span

fn clone(&self) -> Span

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.

impl<'de> Deserialize<'de> for Span

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Span

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.