Struct RequestTrace 

pub struct RequestTrace { /* private fields */ }

The host-owned trace context for one request transaction. Created by the chain driver (the ConfigSnapshot / fast-path server), it parents every filter span so the whole chain — request side and response side — shares one trace. Cheap to copy.

request_span_id is ALWAYS locally minted — it names the request (SERVER) span Plecto itself owns. An inbound traceparent’s span id is kept separately as parent_span_id (the remote parent), never reused as our own: emitting a span under an id another process minted would collide with that process’s exporter (ADR 000040). This is the standard proxy shape — the upstream and every filter span nest under Plecto’s request span.

Implementations

impl RequestTrace

pub fn root() -> RequestTrace

Start a fresh, sampled root trace for a request with no inbound context.

pub fn from_traceparent(traceparent: &str) -> Option<RequestTrace>

Continue an inbound trace from a W3C traceparent (00-{trace}-{span}-{flags}). The inbound span becomes this request’s REMOTE PARENT; the request span id itself is minted locally. Returns None on any malformed field (fail-soft: a bad header just starts no continuation, never a panic on untrusted input).

pub fn to_traceparent(&self) -> String

Format as a W3C traceparent for downstream propagation. Carries the (locally-minted) request span id, so the upstream’s spans nest under Plecto’s request span.

pub fn trace_id(&self) -> TraceId

pub fn request_span_id(&self) -> SpanId

The request (root) span id — the parent of every filter span in this transaction.

pub fn parent_span_id(&self) -> Option<SpanId>

The inbound (remote) span this transaction continues under, or None for a local root.

pub fn is_sampled(&self) -> bool

Trait Implementations

impl Clone for RequestTrace

fn clone(&self) -> RequestTrace

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for RequestTrace

impl Debug for RequestTrace

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

Formats the value using the given formatter.