Struct opentelemetry::sdk::trace::Span

pub struct Span { /* fields omitted */ }

This is supported on crate feature trace only.

Single operation within a trace.

Trait Implementations

impl Clone for Span

pub fn clone(&self) -> Span

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Span

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

Formats the value using the given formatter.

impl Span for Span

pub fn add_event_with_timestamp(
    &self,
    name: String,
    timestamp: SystemTime,
    attributes: Vec<KeyValue>
)

Records events at a specific time in the context of a given Span.

Note that the OpenTelemetry project documents certain "standard event names and keys" which have prescribed semantic meanings.

pub fn span_context(&self) -> &SpanContext

Returns the SpanContext for the given Span.

pub fn is_recording(&self) -> bool

Returns true if this Span is recording information like events with the add_event operation, attributes using set_attributes, status with set_status, etc. Always returns false after span end.

pub fn set_attribute(&self, attribute: KeyValue)

Sets a single Attribute where the attribute properties are passed as arguments.

Note that the OpenTelemetry project documents certain "standard attributes" that have prescribed semantic meanings.

pub fn set_status(&self, code: StatusCode, message: String)

Sets the status of the Span. If used, this will override the default Span status, which is Unset. message MUST be ignored when the status is OK or Unset

pub fn update_name(&self, new_name: String)

Updates the Span's name.

pub fn end_with_timestamp(&self, timestamp: SystemTime)

Finishes the span with given timestamp.

pub fn add_event(&self, name: String, attributes: Vec<KeyValue>)

An API to record events in the context of a given Span.

pub fn record_exception(&self, err: &dyn Error)

Convenience method to record an exception/error as an Event

pub fn record_exception_with_stacktrace(
    &self,
    err: &dyn Error,
    stacktrace: String
)

Convenience method to record a exception/error as an Event with custom stacktrace

pub fn end(&self)

Finishes the Span.