🛈 Note: This is pre-release documentation for the upcoming tracing 0.2.0 ecosystem.

For the release documentation, please see docs.rs, instead.

tracing

Macro event_enabled

Source
macro_rules! event_enabled {
    ($($rest:tt)*) => { ... };
}
Expand description

Tests whether an event with the specified level and target would be enabled.

This is similar to enabled!, but queries the current collector specifically for an event, whereas enabled! queries for an event or span.

Although it shares the name, this does not call Collect::event_enabled. Collect::event_enabled is only called once the event fields are available.

See the documentation for [enabled!] for more details on using this macro. See also span_enabled!.

ยงExamples

if event_enabled!(target: "my_crate", Level::DEBUG) {
    // some expensive work...
}
// simpler
if event_enabled!(Level::DEBUG) {
    // some expensive work...
}
// with fields
if event_enabled!(Level::DEBUG, foo_field) {
    // some expensive work...
}