Struct tracing_core::span::Attributes

pub struct Attributes<'a> { /* fields omitted */ }

Attributes provided to a Subscriber describing a new span when it is created.

Implementations

impl<'a> Attributes<'a>

pub fn new(
    metadata: &'static Metadata<'static>,
    values: &'a ValueSet<'a>
) -> Self

Returns Attributes describing a new child span of the current span, with the provided metadata and values.

pub fn new_root(
    metadata: &'static Metadata<'static>,
    values: &'a ValueSet<'a>
) -> Self

Returns Attributes describing a new span at the root of its own trace tree, with the provided metadata and values.

pub fn child_of(
    parent: Id,
    metadata: &'static Metadata<'static>,
    values: &'a ValueSet<'a>
) -> Self

Returns Attributes describing a new child span of the specified parent span, with the provided metadata and values.

pub fn metadata(&self) -> &'static Metadata<'static>

Returns a reference to the new span's metadata.

pub fn values(&self) -> &ValueSet<'a>

Returns a reference to a ValueSet containing any values the new span was created with.

pub fn is_root(&self) -> bool

Returns true if the new span should be a root.

pub fn is_contextual(&self) -> bool

Returns true if the new span's parent should be determined based on the current context.

If this is true and the current thread is currently inside a span, then that span should be the new span's parent. Otherwise, if the current thread is not inside a span, then the new span will be the root of its own trace tree.

pub fn parent(&self) -> Option<&Id>

Returns the new span's explicitly-specified parent, if there is one.

Otherwise (if the new span is a root or is a child of the current span), returns false.

pub fn record(&self, visitor: &mut dyn Visit)

Records all the fields in this set of Attributes with the provided Visitor.

pub fn contains(&self, field: &Field) -> bool

Returns true if this set of Attributes contains a value for the given Field.

pub fn is_empty(&self) -> bool

Returns true if this set of Attributes contains no values.

Trait Implementations

impl<'a> Debug for Attributes<'a>

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

Formats the value using the given formatter.