Struct Span 

pub struct Span {
    pub context: SpanContext,
    pub name: String,
    pub kind: SpanKind,
    pub status: SpanStatus,
    pub status_message: Option<String>,
    pub start_time: DateTime<Utc>,
    pub end_time: Option<DateTime<Utc>>,
    pub attributes: HashMap<String, Value>,
    pub events: Vec<SpanEvent>,
    pub node_id: Option<Uuid>,
}

A trace span.

Fields

context: SpanContext

Span context.

name: String

Span name.

kind: SpanKind

Span kind.

status: SpanStatus

Span status.

status_message: Option<String>

Status message (for errors).

start_time: DateTime<Utc>

Start time.

end_time: Option<DateTime<Utc>>

End time.

attributes: HashMap<String, Value>

Attributes.

events: Vec<SpanEvent>

Events within the span.

node_id: Option<Uuid>

Node ID that generated this span.

Implementations

impl Span

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

Create a new span.

pub fn child(&self, name: impl Into<String>) -> Self

Create a child span.

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

Set the span kind.

pub fn with_attribute( self, key: impl Into<String>, value: impl Serialize, ) -> Self

Add an attribute.

pub fn with_node_id(self, node_id: Uuid) -> Self

Set the node ID.

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

Set from a parent context.

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

Add an event.

pub fn end_ok(&mut self)

End the span successfully.

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

End the span with an error.

pub fn duration_ms(&self) -> Option<f64>

Get the duration in milliseconds.

pub fn is_complete(&self) -> bool

Check if the span is complete.

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.