Expand description
Span and Event key-value data.
Spans and events may be annotated with key-value data, referred to as known
as fields. These fields consist of a mapping from a key (corresponding to
a &str but represented internally as an array index) to a Value.
§Values and Subscribers
Subscribers consume Values as fields attached to spans or Events.
The set of field keys on a given span or is defined on its Metadata.
When a span is created, it provides Attributes to the Subscriber’s
new_span method, containing any fields whose values were provided when
the span was created; and may call the Subscriber’s record method
with additional Records if values are added for more of its fields.
Similarly, the Event type passed to the subscriber’s event method
will contain any fields attached to each event.
tokio_trace represents values as either one of a set of Rust primitives
(i64, u64, bool, and &str) or using a fmt::Display or fmt::Debug
implementation. The record trait method on the Subscriber trait
allow Subscriber implementations to provide type-specific behaviour for
consuming values of each type.
Instances of the Visit trait are provided by Subscribers to record the
values attached to spans and Event. This trait represents the behavior
used to record values of various types. For example, we might record
integers by incrementing counters for their field names, rather than printing
them.
Structs§
- A
Valuewhich serializes as a string usingfmt::Debug. - A
Valuewhich serializes as a string usingfmt::Display. - An opaque key allowing O(1) access to a field in a
Span’s key-value data. - Describes the fields present on a span.
- An iterator over a set of fields.
- A set of fields and values for a span.
Traits§
- A field value of an erased type.
- Visits typed values.
Functions§
- Wraps a type implementing
fmt::Debugas aValuethat can be recorded using itsDebugimplementation. - Wraps a type implementing
fmt::Displayas aValuethat can be recorded using itsDisplayimplementation.