Struct SpanHandle 

pub struct SpanHandle {
    pub trace_id: [u8; 16],
    pub span_id: [u8; 8],
}

An opaque handle returned by TracerPlugin::start_span. Passing a SpanHandle back to the same tracer is how the runtime attaches attributes, events, and status to an active span. Handles are cheap Copy values — they are just the id pair the tracer already emits on the wire.

A handle is only valid for the tracer that created it. Passing a handle produced by one tracer to another tracer is a programmer error; implementations should treat unknown handles as a no-op rather than panicking.

Fields

trace_id: [u8; 16]

Trace id (W3C trace-context trace-id, 16 bytes big-endian).

span_id: [u8; 8]

Span id (W3C trace-context parent-id / span-id, 8 bytes).

Implementations

impl SpanHandle

pub const INVALID: SpanHandle

Invalid / “not sampled” handle. Tracer implementations return this from start_span when a sampling decision rejects the span; the runtime treats it as a no-op but still threads it through as the parent of any child spans so the shape of the caller’s code does not change between sampled and non-sampled runs.

pub fn is_invalid(&self) -> bool

Returns true if the handle is the invalid/no-op sentinel.

Trait Implementations

impl Clone for SpanHandle

fn clone(&self) -> SpanHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SpanHandle

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

Formats the value using the given formatter.

impl Hash for SpanHandle

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for SpanHandle

fn eq(&self, other: &SpanHandle) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for SpanHandle

impl Eq for SpanHandle

impl StructuralPartialEq for SpanHandle