Source code
Revision control
Copy as Markdown
Other Tools
# 0.1.37 (October 6, 2022)
This release of `tracing` incorporates changes from `tracing-core`
[v0.1.30][core-0.1.30] and `tracing-attributes` [v0.1.23][attrs-0.1.23],
including the new `Subscriber::on_register_dispatch` method for performing late
initialization after a `Subscriber` is registered as a `Dispatch`, and bugfixes
for the `#[instrument]` attribute. Additionally, it fixes instances of the
`bare_trait_objects` lint, which is now a warning on `tracing`'s MSRV and will
become an error in the next edition.
### Fixed
- **attributes**: Incorrect handling of inner attributes in `#[instrument]`ed
functions ([#2307])
- **attributes**: Incorrect location of compiler diagnostic spans generated for
type errors in `#[instrument]`ed `async fn`s ([#2270])
- **attributes**: Updated `syn` dependency to fix compilation with `-Z
minimal-versions` ([#2246])
- `bare_trait_objects` warning in `valueset!` macro expansion ([#2308])
### Added
- **core**: `Subscriber::on_register_dispatch` method ([#2269])
- **core**: `WeakDispatch` type and `Dispatch::downgrade()` function ([#2293])
### Changed
- `tracing-core`: updated to [0.1.30][core-0.1.30]
- `tracing-attributes`: updated to [0.1.23][attrs-0.1.23]
### Documented
- Added [`tracing-web`] and [`reqwest-tracing`] to related crates ([#2283],
[#2331])
Thanks to new contributors @compiler-errors, @e-nomem, @WorldSEnder, @Xiami2012,
and @tl-rodrigo-gryzinski, as well as @jswrenn and @CAD97, for contributing to
this release!
# 0.1.36 (July 29, 2022)
This release adds support for owned values and fat pointers as arguments to the
`Span::record` method, as well as updating the minimum `tracing-core` version
and several documentation improvements.
### Fixed
- Incorrect docs in `dispatcher::set_default` ([#2220])
- Compilation with `-Z minimal-versions` ([#2246])
### Added
- Support for owned values and fat pointers in `Span::record` ([#2212])
- Documentation improvements ([#2208], [#2163])
### Changed
- `tracing-core`: updated to [0.1.29][core-0.1.29]
Thanks to @fredr, @cgbur, @jyn514, @matklad, and @CAD97 for contributing to this
release!
# 0.1.35 (June 8, 2022)
This release reduces the overhead of callsite registration by using new
`tracing-core` APIs.
### Added
- Use `DefaultCallsite` to reduce callsite registration overhead ([#2083])
### Changed
- `tracing-core`: updated to [0.1.27][core-0.1.27]
# 0.1.34 (April 14, 2022)
This release includes bug fixes for the "log" support feature and for the use of
both scoped and global default dispatchers in the same program.
### Fixed
- Failure to use the global default dispatcher when a thread sets a local
default dispatcher before the global default is set ([#2065])
- **log**: Compilation errors due to `async` block/fn futures becoming `!Send`
when the "log" feature flag is enabled ([#2073])
- Broken links in documentation ([#2068])
Thanks to @ben0x539 for contributing to this release!
# 0.1.33 (April 9, 2022)
This release adds new `span_enabled!` and `event_enabled!` variants of the
`enabled!` macro, for testing whether a subscriber would specifically enable a
span or an event.
### Added
- `span_enabled!` and `event_enabled!` macros ([#1900])
- Several documentation improvements ([#2010], [#2012])
### Fixed
- Compilation warning when compiling for <=32-bit targets (including `wasm32`)
([#2060])
Thanks to @guswynn, @arifd, @hrxi, @CAD97, and @name1e5s for contributing to
this release!
# 0.1.32 (March 8th, 2022)
This release reduces the overhead of creating and dropping disabled
spans significantly, which should improve performance when no `tracing`
subscriber is in use or when spans are disabled by a filter.
### Fixed
- **attributes**: Compilation failure with `--minimal-versions` due to a
too-permissive `syn` dependency ([#1960])
### Changed
- Reduced `Drop` overhead for disabled spans ([#1974])
- `tracing-attributes`: updated to [0.1.20][attributes-0.1.20]
# 0.1.31 (February 17th, 2022)
This release increases the minimum supported Rust version (MSRV) to 1.49.0. In
addition, it fixes some relatively rare macro bugs.
### Added
- Added `tracing-forest` to the list of related crates ([#1935])
### Changed
- Updated minimum supported Rust version (MSRV) to 1.49.0 ([#1913])
### Fixed
- Fixed the `warn!` macro incorrectly generating an event with the `TRACE` level
([#1930])
- Fixed macro hygiene issues when used in a crate that defines its own `concat!`
macro, for real this time ([#1918])
Thanks to @QnnOkabayashi, @nicolaasg, and @teohhanhui for contributing to this
release!
# 0.1.30 (February 3rd, 2022)
This release adds *experimental* support for recording structured field
values using the [`valuable`] crate. See [this blog post][post] for
details on `valuable`.
Note that `valuable` support currently requires `--cfg tracing_unstable`. See
the documentation for details.
This release also adds a new `enabled!` macro for testing if a span or event
would be enabled.
### Added
- **field**: Experimental support for recording field values using the
[`valuable`] crate ([#1608], [#1888], [#1887])
- `enabled!` macro for testing if a span or event is enabled ([#1882])
### Changed
- `tracing-core`: updated to [0.1.22][core-0.1.22]
- `tracing-attributes`: updated to [0.1.19][attributes-0.1.19]
### Fixed
- **log**: Fixed "use of moved value" compiler error when the "log" feature is
enabled ([#1823])
- Fixed macro hygiene issues when used in a crate that defines its own `concat!`
macro ([#1842])
- A very large number of documentation fixes and improvements.
Thanks to @@Vlad-Scherbina, @Skepfyr, @Swatinem, @guswynn, @teohhanhui,
@xd009642, @tobz, @d-e-s-o@0b01, and @nickelc for contributing to this release!
# 0.1.29 (October 5th, 2021)
This release adds support for recording `Option<T> where T: Value` as typed
`tracing` field values. It also includes significant performance improvements
for functions annotated with the `#[instrument]` attribute when the generated
span is disabled.
### Changed
- `tracing-core`: updated to v0.1.21
- `tracing-attributes`: updated to v0.1.18
### Added
- **field**: `Value` impl for `Option<T> where T: Value` ([#1585])
- **attributes**: - improved performance when skipping `#[instrument]`-generated
spans below the max level ([#1600], [#1605], [#1614], [#1616], [#1617])
### Fixed
- **instrument**: added missing `Future` implementation for `WithSubscriber`,
making the `WithDispatch` extension trait actually useable ([#1602])
- Documentation fixes and improvements ([#1595], [#1601], [#1597])
Thanks to @brianburgers, @mattiast, @DCjanus, @oli-obk, and @matklad for
contributing to this release!
# 0.1.28 (September 17th, 2021)
This release fixes an issue where the RustDoc documentation was rendered
incorrectly. It doesn't include any actual code changes, and is very boring and
can be ignored.
### Fixed
- **docs**: Incorrect documentation rendering due to unclosed `<div>` tag
([#1572])
# 0.1.27 (September 13, 2021)
This release adds a new [`Span::or_current`] method to aid in efficiently
propagating span contexts to spawned threads or tasks. Additionally, it updates
the [`tracing-core`] version to [0.1.20] and the [`tracing-attributes`] version to
[0.1.16], ensuring that a number of new features in those crates are present.
### Fixed
- **instrument**: Added missing `WithSubscriber` implementations for futures and
other types ([#1424])
### Added
- `Span::or_current` method, to help with efficient span context propagation
([#1538])
- **attributes**: add `skip_all` option to `#[instrument]` ([#1548])
- **attributes**: record primitive types as primitive values rather than as
`fmt::Debug` ([#1378])
- **core**: `NoSubscriber`, a no-op `Subscriber` implementation
([#1549])
- **core**: Added `Visit::record_f64` and support for recording floating-point
values ([#1507], [#1522])
- A large number of documentation improvements and fixes ([#1369], [#1398],
[#1435], [#1442], [#1524], [#1556])
Thanks to new contributors @dzvon and @mbergkvist, as well as @teozkr,
@maxburke, @LukeMathWalker, and @jsgf, for contributing to this
release!
# 0.1.26 (April 30, 2021)
### Fixed
- **attributes**: Compatibility between `#[instrument]` and `async-trait`
v0.1.43 and newer ([#1228])
- Several documentation fixes ([#1305], [#1344])
### Added
- `Subscriber` impl for `Box<dyn Subscriber + Send + Sync + 'static>` ([#1358])
- `Subscriber` impl for `Arc<dyn Subscriber + Send + Sync + 'static>` ([#1374])
- Symmetric `From` impls for existing `Into` impls on `span::Current`, `Span`,
and `Option<Id>` ([#1335], [#1338])
- `From<EnteredSpan>` implementation for `Option<Id>`, allowing `EnteredSpan` to
be used in a `span!` macro's `parent:` field ([#1325])
- `Attributes::fields` accessor that returns the set of fields defined on a
span's `Attributes` ([#1331])
Thanks to @Folyd, @nightmared, and new contributors @rmsc and @Fishrock123 for
contributing to this release!
# 0.1.25 (February 23, 2021)
### Added
- `Span::entered` method for entering a span and moving it into a guard by value
rather than borrowing it ([#1252])
Thanks to @matklad for contributing to this release!
# 0.1.24 (February 17, 2021)
### Fixed
- **attributes**: Compiler error when using `#[instrument(err)]` on functions
which return `impl Trait` ([#1236])
- Fixed broken match arms in event macros ([#1239])
- Documentation improvements ([#1232])
Thanks to @bkchr and @lfranke for contributing to this release!
# 0.1.23 (February 4, 2021)
### Fixed
- **attributes**: Compiler error when using `#[instrument(err)]` on functions
with mutable parameters ([#1167])
- **attributes**: Missing function visibility modifier when using
`#[instrument]` with `async-trait` ([#977])
- **attributes** Removed unused `syn` features ([#928])
- **log**: Fixed an issue where the `tracing` macros would generate code for
events whose levels are disabled statically by the `log` crate's
`static_max_level_XXX` features ([#1175])
- Fixed deprecations and clippy lints ([#1195])
- Several documentation fixes and improvements ([#941], [#965], [#981], [#1146],
[#1215])
### Changed
- **attributes**: `tracing-futures` dependency is no longer required when using
`#[instrument]` on async functions ([#808])
- **attributes**: Updated `tracing-attributes` minimum dependency to v0.1.12
([#1222])
Thanks to @nagisa, @Txuritan, @TaKO8Ki, @okready, and @krojew for contributing
to this release!
# 0.1.22 (November 23, 2020)
### Changed
- Updated `pin-project-lite` dependency to 0.2 ([#1108])
# 0.1.21 (September 28, 2020)
### Fixed
- Incorrect inlining of `Span::new`, `Span::new_root`, and `Span::new_child_of`,
which could result in `dispatcher::get_default` being inlined at the callsite
([#994])
- Regression where using a struct field as a span or event field when other
fields on that struct are borrowed mutably would fail to compile ([#987])
### Changed
- Updated `tracing-core` to 0.1.17 ([#992])
### Added
- `Instrument` trait and `Instrumented` type for attaching a `Span` to a
`Future` ([#808])
- `Copy` implementations for `Level` and `LevelFilter` ([#992])
- Multiple documentation fixes and improvements ([#964], [#980], [#981])
Thanks to @nagisa, and new contributors @SecurityInsanity, @froydnj, @jyn514 and
@TaKO8Ki for contributing to this release!
# 0.1.20 (August 24, 2020)
### Changed
- Significantly reduced assembly generated by macro invocations (#943)
- Updated `tracing-core` to 0.1.15 (#943)
### Added
- Documented minimum supported Rust version policy (#941)
# 0.1.19 (August 10, 2020)
### Fixed
- Updated `tracing-core` to fix incorrect calculation of the global max level
filter (#908)
### Added
- **attributes**: Support for using `self` in field expressions when
instrumenting `async-trait` functions (#875)
- Several documentation improvements (#832, #881, #896, #897, #911, #913)
Thanks to @anton-dutov, @nightmared, @mystor, and @toshokan for contributing to
this release!
# 0.1.18 (July 31, 2020)
### Fixed
- Fixed a bug where `LevelFilter::OFF` (and thus also the `static_max_level_off`
feature flag) would enable *all* traces, rather than *none* (#853)
- **log**: Fixed `tracing` macros and `Span`s not checking `log::max_level`
before emitting `log` records (#870)
### Changed
- **macros**: Macros now check the global max level (`LevelFilter::current`)
before the per-callsite cache when determining if a span or event is enabled.
This significantly improves performance in some use cases (#853)
- **macros**: Simplified the code generated by macro expansion significantly,
which may improve compile times and/or `rustc` optimizatation of surrounding
code (#869, #869)
- **macros**: Macros now check the static max level before checking any runtime
filtering, improving performance when a span or event is disabled by a
`static_max_level_XXX` feature flag (#868)
- `LevelFilter` is now a re-export of the `tracing_core::LevelFilter` type, it
can now be used interchangably with the versions in `tracing-core` and
`tracing-subscriber` (#853)
- Significant performance improvements when comparing `LevelFilter`s and
`Level`s (#853)
- Updated the minimum `tracing-core` dependency to 0.1.12 (#853)
### Added
- **macros**: Quoted string literals may now be used as field names, to allow
fields whose names are not valid Rust identifiers (#790)
- **docs**: Several documentation improvements (#850, #857, #841)
- `LevelFilter::current()` function, which returns the highest level that any
subscriber will enable (#853)
- `Subscriber::max_level_hint` optional trait method, for setting the value
returned by `LevelFilter::current()` (#853)
Thanks to new contributors @cuviper, @ethanboxx, @ben0x539, @dignati,
@colelawrence, and @rbtcollins for helping out with this release!
# 0.1.17 (July 22, 2020)
### Changed
- **log**: Moved verbose span enter/exit log records to "tracing::span::active"
target, allowing them to be filtered separately (#833)
- **log**: All span lifecycle log records without fields now have the `Trace`
log filter, to guard against `log` users enabling them by default with blanket
level filtering (#833)
### Fixed
- **log**/**macros**: Fixed missing implicit imports of the
`tracing::field::debug` and `tracing::field::display` functions inside the
macros when the "log" feature is enabled (#835)
# 0.1.16 (July 8, 2020)
### Added
- **attributes**: Support for arbitrary expressions as fields in `#[instrument]` (#672)
- **attributes**: `#[instrument]` now emits a compiler warning when ignoring unrecognized
input (#672, #786)
- Improved documentation on using `tracing` in async code (#769)
### Changed
- Updated `tracing-core` dependency to 0.1.11
### Fixed
- **macros**: Excessive monomorphization in macros, which could lead to
longer compilation times (#787)
- **log**: Compiler warnings in macros when `log` or `log-always` features
are enabled (#753)
- Compiler error when `tracing-core/std` feature is enabled but `tracing/std` is
not (#760)
Thanks to @nagisa for contributing to this release!
# 0.1.15 (June 2, 2020)
### Changed
- **macros**: Replaced use of legacy `local_inner_macros` with `$crate::` (#740)
### Added
- Docs fixes and improvements (#742, #731, #730)
Thanks to @bnjjj, @blaenk, and @LukeMathWalker for contributing to this release!
# 0.1.14 (May 14, 2020)
### Added
- **log**: When using the [`log`] compatibility feature alongside a `tracing`
`Subscriber`, log records for spans now include span IDs (#613)
- **attributes**: Support for using `#[instrument]` on methods that are part of
[`async-trait`] trait implementations (#711)
- **attributes**: Optional `#[instrument(err)]` argument to automatically emit
an event if an instrumented function returns `Err` (#637)
- Added `#[must_use]` attribute to the guard returned by
`subscriber::set_default` (#685)
### Changed
- **log**: Made [`log`] records emitted by spans much less noisy when span IDs are
not available (#613)
### Fixed
- Several typos in the documentation (#656, #710, #715)
Thanks to @FintanH, @shepmaster, @inanna-malick, @zekisharif, @bkchr, @majecty,
@ilana and @nightmared for contributing to this release!
# 0.1.13 (February 26, 2019)
### Added
- **field**: `field::Empty` type for declaring empty fields whose values will be
recorded later (#548)
- **field**: `field::Value` implementations for `Wrapping` and `NonZero*`
numbers (#538)
- **attributes**: Support for adding arbitrary literal fields to spans generated
by `#[instrument]` (#569)
- **attributes**: `#[instrument]` now emits a helpful compiler error when
attempting to skip a function parameter (#600)
### Changed
- **attributes**: The `#[instrument]` attribute was placed under an on-by-default
feature flag "attributes" (#603)
### Fixed
- Broken and unresolvable links in RustDoc (#595)
Thanks to @oli-cosmian and @Kobzol for contributing to this release!
# 0.1.12 (January 11, 2019)
### Added
- `Span::with_subscriber` method to access the subscriber that tracks a `Span`
(#503)
- API documentation now shows which features are required by feature-flagged
items (#523)
- Improved README examples (#496)
- Documentation links to related crates (#507)
# 0.1.11 (December 20, 2019)
### Added
- `Span::is_none` method (#475)
- `LevelFilter::into_level` method (#470)
- `LevelFilter::from_level` function and `From<Level>` impl (#471)
- Documented minimum supported Rust version (#482)
### Fixed
- Incorrect parameter type to `Span::follows_from` that made it impossible to
call (#467)
- Missing whitespace in `log` records generated when enabling the `log` feature
flag (#484)
- Typos and missing links in documentation (#405, #423, #439)
# 0.1.10 (October 23, 2019)
### Added
- Support for destructuring in arguments to `#[instrument]`ed functions (#397)
- Generated field for `self` parameters when `#[instrument]`ing methods (#397)
- Optional `skip` argument to `#[instrument]` for excluding function parameters
from generated spans (#359)
- Added `dispatcher::set_default` and `subscriber::set_default` APIs, which
return a drop guard (#388)
### Fixed
- Some minor documentation errors (#356, #370)
# 0.1.9 (September 13, 2019)
### Fixed
- Fixed `#[instrument]`ed async functions not compiling on `nightly-2019-09-11`
or newer (#342)
### Changed
- Significantly reduced performance impact of skipped spans and events when a
`Subscriber` is not in use (#326)
- The `log` feature will now only cause `tracing` spans and events to emit log
records when a `Subscriber` is not in use (#346)
### Added
- Added support for overriding the name of the span generated by `#[instrument]`
(#330)
- `log-always` feature flag to emit log records even when a `Subscriber` is set
(#346)
# 0.1.8 (September 3, 2019)
### Changed
- Reorganized and improved API documentation (#317)
### Removed
- Dev-dependencies on `ansi_term` and `humantime` crates, which were used only
for examples (#316)
# 0.1.7 (August 30, 2019)
### Changed
- New (curly-brace free) event message syntax to place the message in the first
field rather than the last (#309)
### Fixed
- Fixed a regression causing macro stack exhaustion when the `log` feature flag
is enabled (#304)
# 0.1.6 (August 20, 2019)
### Added
- `std::error::Error` as a new primitive type (#277)
- Support for mixing key-value fields and `format_args` messages without curly
braces as delimiters (#288)
### Changed
- `tracing-core` dependency to 0.1.5 (#294)
- `tracing-attributes` dependency to 0.1.2 (#297)
# 0.1.5 (August 9, 2019)
### Added
- Support for `no-std` + `liballoc` (#263)
### Changed
- Using the `#[instrument]` attribute on `async fn`s no longer requires a
feature flag (#258)
### Fixed
- The `#[instrument]` macro now works on generic functions (#262)
# 0.1.4 (August 8, 2019)
### Added
- `#[instrument]` attribute for automatically adding spans to functions (#253)
# 0.1.3 (July 11, 2019)
### Added
- Log messages when a subscriber indicates that a span has closed, when the
`log` feature flag is enabled (#180).
### Changed
- `tracing-core` minimum dependency version to 0.1.2 (#174).
### Fixed
- Fixed an issue where event macro invocations with a single field, using local
variable shorthand, would recur infinitely (#166).
- Fixed uses of deprecated `tracing-core` APIs (#174).
# 0.1.2 (July 6, 2019)
### Added
- `Span::none()` constructor, which does not require metadata and
returns a completely empty span (#147).
- `Span::current()` function, returning the current span if it is
known to the subscriber (#148).
### Fixed
- Broken macro imports when used prefixed with `tracing::` (#152).
# 0.1.1 (July 3, 2019)
### Changed
- `cfg_if` dependency to 0.1.9.
### Fixed
- Compilation errors when the `log` feature is enabled (#131).
- Unclear wording and typos in documentation (#124, #128, #142).
# 0.1.0 (June 27, 2019)
- Initial release