Struct ScopeFrame 

pub struct ScopeFrame { /* private fields */ }

One frame on the per-task / per-thread scope stack.

Implementations

impl ScopeFrame

pub fn new( fields: Vec<ScopeField>, kind: ScopeKind, tail_capacity: u16, ) -> ScopeFrame

Construct a frame with the supplied declared fields and tail buffer capacity.

pub fn set_traceparent_sampled(&mut self, sampled: bool)

Update the inbound traceparent.sampled decision (set by the HTTP middleware at request entry). Spec 13 § 6.

pub fn set_span_identity(&mut self, name: &'static str, target: &'static str)

Set the bridged tracing span identity for obs::SpanTrace rendering. Spec 13 § 9.

pub fn traceparent_sampled(&self) -> Option<bool>

Inbound traceparent.sampled decision, when set.

pub fn fields(&self) -> &[ScopeField]

Read-only view of the declared fields.

pub fn kind(&self) -> ScopeKind

Frame kind.

pub fn seen_error(&self) -> bool

true if the scope has observed an >= ERROR envelope.

pub fn mark_error(&mut self)

Mark this frame’s tail buffer as needing flush.

pub fn tail_capacity(&self) -> u16

Capacity of the tail buffer (in envelopes).

pub fn push_tail(&mut self, env: ObsEnvelope)

Push an envelope onto the ring buffer. No-op for Context.

pub fn drain_tail(&mut self) -> Vec<ObsEnvelope>

Drain and return the buffered envelopes (callers flush on scope-end-with-error).

pub fn tail_snapshot(&self) -> Vec<ObsEnvelope>

Snapshot of currently-buffered envelopes (test-only).

pub fn as_span_frame(&self) -> Option<SpanFrame<'_>>

Render the frame as a SpanFrame for SpanTrace.

Trait Implementations

impl Clone for ScopeFrame

fn clone(&self) -> ScopeFrame

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ScopeFrame

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

Formats the value using the given formatter.