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
sourceimpl<'a> Attributes<'a>
impl<'a> Attributes<'a>
sourcepub fn new(
metadata: &'static Metadata<'static>,
values: &'a ValueSet<'a>
) -> Attributes<'a>
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.
sourcepub fn new_root(
metadata: &'static Metadata<'static>,
values: &'a ValueSet<'a>
) -> Attributes<'a>
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.
sourcepub fn child_of(
parent: Id,
metadata: &'static Metadata<'static>,
values: &'a ValueSet<'a>
) -> Attributes<'a>
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.
sourcepub fn metadata(&self) -> &'static Metadata<'static>
pub fn metadata(&self) -> &'static Metadata<'static>
Returns a reference to the new span’s metadata.
sourcepub fn values(&self) -> &ValueSet<'a>
pub fn values(&self) -> &ValueSet<'a>
Returns a reference to a ValueSet containing any values the new span
was created with.
sourcepub fn is_contextual(&self) -> bool
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.
sourcepub fn parent(&self) -> Option<&Id>
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.
sourcepub fn record(&self, visitor: &mut dyn Visit)
pub fn record(&self, visitor: &mut dyn Visit)
Records all the fields in this set of Attributes with the provided
Visitor.
sourcepub fn contains(&self, field: &Field) -> bool
pub fn contains(&self, field: &Field) -> bool
Returns true if this set of Attributes contains a value for the
given Field.
sourcepub fn fields(&self) -> &FieldSet
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
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
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
sourceimpl<T> Instrument for T
impl<T> Instrument for T
sourcefn instrument(self, span: Span) -> Instrumented<Self>ⓘNotable traits for Instrumented<T>impl<T: Future> Future for Instrumented<T> type Output = T::Output;
fn instrument(self, span: Span) -> Instrumented<Self>ⓘNotable traits for Instrumented<T>impl<T: Future> Future for Instrumented<T> type Output = T::Output;
sourcefn in_current_span(self) -> Instrumented<Self>ⓘNotable traits for Instrumented<T>impl<T: Future> Future for Instrumented<T> type Output = T::Output;
fn in_current_span(self) -> Instrumented<Self>ⓘNotable traits for Instrumented<T>impl<T: Future> Future for Instrumented<T> type Output = T::Output;
sourceimpl<T> WithSubscriber for T
impl<T> WithSubscriber for T
sourcefn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>ⓘNotable traits for WithDispatch<T>impl<T: Future> Future for WithDispatch<T> type Output = T::Output; where
S: Into<Dispatch>,
fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>ⓘNotable traits for WithDispatch<T>impl<T: Future> Future for WithDispatch<T> type Output = T::Output; where
S: Into<Dispatch>,
Attaches the provided Subscriber to this type, returning a
WithDispatch wrapper. Read more
sourcefn with_current_subscriber(self) -> WithDispatch<Self>ⓘNotable traits for WithDispatch<T>impl<T: Future> Future for WithDispatch<T> type Output = T::Output;
fn with_current_subscriber(self) -> WithDispatch<Self>ⓘNotable traits for WithDispatch<T>impl<T: Future> Future for WithDispatch<T> type Output = T::Output;
Attaches the current default Subscriber to this type, returning a
WithDispatch wrapper. Read more