Struct Trace 

pub struct Trace { /* private fields */ }

A trace event.

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

Implementations

impl Trace

pub fn new(spans: Vec<Span>, resource_tags: impl Into<SharedTagSet>) -> Self

Creates a new Trace with the given spans.

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(&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 resource_tags(&self) -> &SharedTagSet

Returns the resource-level tags associated with this trace.

pub fn sampling(&self) -> Option<&TraceSampling>

Returns a reference to the trace-level sampling metadata, if present.

pub fn set_sampling(&mut self, sampling: Option<TraceSampling>)

Sets the trace-level sampling metadata.

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