Struct tracing::span::Attributes

source ·
pub struct Attributes<'a> { /* private fields */ }
Expand description

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

Implementations§

source§

impl<'a> Attributes<'a>

source

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

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

source

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

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

source

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

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

source

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

Returns a reference to the new span’s metadata.

source

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

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

source

pub fn is_root(&self) -> bool

Returns true if the new span should be a root.

source

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.

source

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 None.

source

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

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

source

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

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

source

pub fn is_empty(&self) -> bool

Returns true if this set of Attributes contains no values.

source

pub fn fields(&self) -> &FieldSet

Returns the set of all fields defined by this span’s Metadata.

Note that the FieldSet returned by this method includes all the fields declared by this span, not just those with values that are recorded as part of this set of Attributes. Other fields with values not present in this Attributes’ value set may record values later.

Trait Implementations§

source§

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

source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

§

impl<'a> !RefUnwindSafe for Attributes<'a>

§

impl<'a> !Send for Attributes<'a>

§

impl<'a> !Sync for Attributes<'a>

§

impl<'a> Unpin for Attributes<'a>

§

impl<'a> !UnwindSafe for Attributes<'a>

Blanket Implementations§

source§

impl<T> Any for Twhere T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for Twhere T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for Twhere T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T> Instrument for T

source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for Twhere U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T, U> TryFrom<U> for Twhere U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for Twhere U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
source§

impl<T> WithSubscriber for T

source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more