Struct Trace 

pub struct Trace {
    pub trace_id_high: u64,
    pub trace_id_low: u64,
    pub origin: MetaString,
    pub payload: PayloadFields,
    pub attributes: Arc<FastHashMap<MetaString, AttributeValue>>,
    pub priority: Option<i32>,
    pub dropped_trace: bool,
    pub sampling_mechanism: u32,
    pub decision_maker: Option<MetaString>,
    pub otlp_sampling_rate: Option<f64>,
    /* private fields */
}

A trace event.

A trace is a collection of spans that represent a distributed trace.

Fields

trace_id_high: u64

Upper 8 bytes of the 128-bit trace ID (big-endian). Zero for 64-bit-only sources.

trace_id_low: u64

Lower 8 bytes of the 128-bit trace ID (big-endian).

origin: MetaString

Trace origin string (for example, "lambda", "rum").

payload: PayloadFields

Payload-level metadata (promoted from the tracer payload or OTLP resource).

attributes: Arc<FastHashMap<MetaString, AttributeValue>>

Trace chunk-level or resource-level attributes.

priority: Option<i32>

Sampling priority set by the tracer or a sampler.

dropped_trace: bool

Whether this trace was dropped during sampling.

sampling_mechanism: u32

The mechanism by which the sampling decision was made.

decision_maker: Option<MetaString>

Identifier of the component that made the final sampling decision.

otlp_sampling_rate: Option<f64>

Effective OTLP sampling rate (_dd.otlp_sr), if set.

Implementations

impl Trace

pub fn new(spans: Vec<Span>) -> Self

Creates a new Trace with the given spans.

All unified fields default to empty / zero. Callers should set them directly after construction.

pub fn spans(&self) -> &[Span]

Returns a reference to the spans in this trace.

pub fn spans_mut(&mut self) -> &mut [Span]

Returns a mutable reference to the spans in this trace.

pub fn set_spans(&mut self, spans: Vec<Span>)

Replaces the spans in this trace with the given spans.

pub fn retain_spans<F>(&mut self, f: F) -> usize

where F: FnMut(&Trace, &Span) -> bool,

Retains only the spans specified by the predicate.

Returns the number of spans retained. If no spans match, the trace is left unchanged.

pub fn remove_spans<F>(&mut self, f: F)

where F: FnMut(&Trace, &Span) -> bool,

Remove spans only the spans specified by the predicate return true.

Trait Implementations

impl Clone for Trace

fn clone(&self) -> Trace

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Trace

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

Formats the value using the given formatter.

impl PartialEq for Trace

fn eq(&self, other: &Trace) -> 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 StructuralPartialEq for Trace