[−][src]Crate tracing_subscriber
Utilities for implementing and composing tracing
subscribers.
tracing
is a framework for instrumenting Rust programs to collect
scoped, structured, and async-aware diagnostics. The Subscriber
trait
represents the functionality necessary to collect this trace data. This
crate contains tools for composing subscribers out of smaller units of
behaviour, and batteries-included implementations of common subscriber
functionality.
tracing-subscriber
is intended for use by both Subscriber
authors and
application authors using tracing
to instrument their applications.
Included Subscribers
The following Subscriber
s are provided for application authors:
fmt
- Formats and logs tracing data (requires thefmt
feature flag)
Feature Flags
env-filter
: Enables theEnvFilter
type, which implements filtering similar to theenv_logger
crate. Enabled by default.filter
: Alias forenv-filter
. This feature flag was renamed in version 0.1.2, and will be removed in version 0.2.fmt
: Enables thefmt
module, which provides a subscriber implementation for printing formatted representations of trace events. Enabled by default.ansi
: Enablesfmt
support for ANSI terminal colors. Enabled by default.registry
: enables the experimentalregistry
module.json
: Enablesfmt
support for JSON output. In JSON output, the ANSI feature does nothing.
Optional Dependencies
tracing-log
: Enables better formatting for events emitted bylog
macros in thefmt
subscriber. On by default.chrono
: Enables human-readable time formatting in thefmt
subscriber. Enabled by default.smallvec
: Causes theEnvFilter
type to use thesmallvec
crate (rather thanVec
) as a performance optimization. Enabled by default.parking_lot
: Use theparking_lot
crate'sRwLock
implementation rather than the Rust standard library's implementation.
Re-exports
pub use layer::Layer; |
pub use fmt::Subscriber as FmtSubscriber; |
Modules
field | Utilities for working with fields and field visitors. |
filter |
|
fmt | A |
layer | A composable abstraction for building |
prelude | The |
registry | Storage for span data shared by multiple |
reload | Wrapper for a |
Structs
CurrentSpan | Tracks the currently executing span on a per-thread basis. |
EnvFilter | A |
Registry | A shared, reusable store for spans. |