This release of tracing-attributes
adds support for passing an optional
level
to the err
and ret
arguments to #[instrument]
, allowing the level
of the generated return-value event to be overridden. For example,
#[instrument(err(level = "info"))]
fn my_great_function() -> Result<(), &'static str> {
// ...
}
will emit an INFO
-level event if the function returns an Err
.
In addition, this release updates the syn
dependency to v2.x.x.
level
argument toerr
andret
to override the level of the generated return value event (#2335)- Improved compiler error message when
#[instrument]
is added to aconst fn
(#2418)
- Updated
syn
dependency to 2.0 (#2516)
- Fix
clippy::unreachable
warnings in#[instrument]
-generated code (#2356) - Removed unused "visit" feature flag from
syn
dependency (#2530)
Thanks to @nitnelave, @jsgf, @Abhicodes-crypto, @LukeMathWalker, @andrewpollack, @quad, @klensy, @davidpdrsn, and @dbidwell94 for contributign to this release!
This release of tracing-attributes
fixes a bug where compiler diagnostic spans
for type errors in #[instrument]
ed async fn
s have the location of the
#[instrument]
attribute rather than the location of the actual error, and a
bug where inner attributes in #[instrument]
ed functions would cause a compiler
error.
- Fix incorrect handling of inner attributes in
#[instrument]
ed functions (#2307) - Add fake return to improve spans generated for type errors in
async fn
s (#2270) - Updated
syn
dependency to fix compilation with-Z minimal-versions
(#2246)
Thanks to new contributors @compiler-errors and @e-nomem, as well as @CAD97, for contributing to this release!
This release fixes an issue where using the err
or ret
arguments to
#[instrument]
along with an overridden target, such as
#[instrument(target = "...", err, ret)]
would not propagate the overridden target to the events generated for errors/return values.
- Error and return value events generated by
#[instrument(err)]
or#[instrument(ret)]
not inheriting an overridden target (#2184) - Incorrect default level in documentation (#2119)
Thanks to new contributor @tbraun96 for contributing to this release!
This release adds support for setting explicit parent and follows-from spans
in the #[instrument]
attribute.
#[instrument(follows_from = ...)]
argument for setting one or more follows-from span (#2093)#[instrument(parent = ...)]
argument for overriding the generated span's parent (#2091)
- Extra braces around
async
blocks in expanded code (causes a Clippy warning) (#2090) - Broken documentation links (#2068, #2077)
Thanks to @jarrodldavis, @ben0x539, and new contributor @jswrenn for contributing to this release!
- Compilation failure with
--minimal-versions
due to a too-permissivesyn
dependency (#1960)
- Bumped minimum supported Rust version (MSRV) to 1.49.0 (#1913)
Thanks to new contributor @udoprog for contributing to this release!
This release introduces a new #[instrument(ret)]
argument to emit an event
with the return value of an instrumented function.
#[instrument(ret)]
to record the return value of a function (#1716)- added
err(Debug)
argument to cause#[instrument(err)]
to record errors withDebug
rather than `Display (#1631)
- incorrect code generation for functions returning async blocks (#1866)
- incorrect diagnostics when using
rust-analyzer
(#1634)
Thanks to @Swatinem, @hkmatsumoto, @cynecx, and @ciuncan for contributing to this release!
This release fixes issues introduced in v0.1.17.
- fixed mismatched types compiler error that may occur when using
#[instrument]
on anasync fn
that returns animpl Trait
value that includes a closure (#1616) - fixed false positives for
clippy::suspicious_else_formatting
warnings due to rust-lang/rust-clippy#7760 and rust-lang/rust-clippy#6249 (#1617) - fixed
clippy::let_unit_value
lints when using#[instrument]
(#1614)
This release significantly improves performance when #[instrument]
-generated
spans are below the maximum enabled level.
Thanks to @oli-obk for contributing to this release!
This release adds a new #[instrument(skip_all)]
option to skip recording all
arguments to an instrumented function as fields. Additionally, it adds support
for recording arguments that are tracing
primitive types as typed values,
rather than as fmt::Debug
.
- add
skip_all
option to#[instrument]
(#1548) - record primitive types as primitive values rather than as
fmt::Debug
(#1378) - added support for
f64
s as typed values (#1522)
Thanks to @Folyd and @jsgf for contributing to this release!
#[instrument]
on functions returningBox::pin
ned futures incorrectly skipping function bodies prior to returning a future (#1297)
Thanks to @nightmared for contributing to this release!
- Compatibility between
#[instrument]
andasync-trait
v0.1.43 and newer (#1228)
Thanks to @nightmared for lots of hard work on this fix!
- Compiler error when using
#[instrument(err)]
on functions which returnimpl Trait
(#1236)
- Compiler error when using
#[instrument(err)]
on functions with mutable parameters (#1167) - Missing function visibility modifier when using
#[instrument]
withasync-trait
(#977) - Multiple documentation fixes and improvements (#965, #981, #1215)
tracing-futures
dependency is no longer required when using#[instrument]
on async functions (#808)
Thanks to @nagisa, @Txuritan, @TaKO8Ki, and @okready for contributing to this release!
- Corrected wrong minimum supported Rust version note in docs (#941)
- Removed unused
syn
features (#928)
Thanks to new contributor @jhpratt for contributing to this release!
- Support for using
self
in field expressions when instrumentingasync-trait
functions (#875) - Several documentation improvements (#832, #897, #911, #913)
Thanks to @anton-dutov and @nightmared for contributing to this release!
- Support for arbitrary expressions as fields in
#[instrument]
(#672)
#[instrument]
now emits a compiler warning when ignoring unrecognized input (#672, #786)
- Support for using
#[instrument]
on methods that are part ofasync-trait
trait implementations (#711) - Optional
#[instrument(err)]
argument to automatically emit an event if an instrumented function returnsErr
(#637)
Thanks to @ilana and @nightmared for contributing to this release!
- Support for adding arbitrary literal fields to spans generated by
#[instrument]
(#569) #[instrument]
now emits a helpful compiler error when attempting to skip a function parameter (#600)
Thanks to @Kobzol for contributing to this release!
- Updated documentation (#468)
- 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)
- Fixed
#[instrument]
ed async functions not compiling onnightly-2019-09-11
or newer (#342)
- Updated
syn
andquote
dependencies to 1.0 (#292) - Removed direct dependency on
proc-macro2
to avoid potential version conflicts (#296)
- Outdated idioms in examples (#271, #273)
- Using the
#[instrument]
attribute onasync fn
s no longer requires a feature flag (#258)
- The
#[instrument]
macro now works on generic functions (#262)
- Initial release