Struct opentelemetry::sdk::trace::Span

pub struct Span { /* fields omitted */ }

Single operation within a trace.

Trait Implementations

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.

impl Debug for Span

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

Formats the value using the given formatter.

impl Span for Span

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.

fn span_context(&self) -> &SpanContext

Returns the SpanContext for the given Span.

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.

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.

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

fn update_name(&self, new_name: String)

Updates the Span's name.

fn end_with_timestamp(&self, timestamp: SystemTime)

Finishes the span with given timestamp.

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

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

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

Convenience method to record an exception/error as an Event

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

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

fn end(&self)

Finishes the Span.