pub struct LevelFilter(/* private fields */);
Expand description
A filter comparable to a verbosity Level
.
If a Level
is considered less than or equal to a LevelFilter
, it
should be considered enabled; if greater than the LevelFilter
, that level
is disabled. See LevelFilter::current
for more details.
Note that this is essentially identical to the Level
type, but with the
addition of an OFF
level that completely disables all trace
instrumentation.
See the documentation for the Level
type to see how Level
s
and LevelFilter
s interact.
Implementations§
Source§impl LevelFilter
impl LevelFilter
Sourcepub const OFF: LevelFilter = _
pub const OFF: LevelFilter = _
The “off” level.
Designates that trace instrumentation should be completely disabled.
Sourcepub const ERROR: LevelFilter = _
pub const ERROR: LevelFilter = _
The “error” level.
Designates very serious errors.
Sourcepub const WARN: LevelFilter = _
pub const WARN: LevelFilter = _
The “warn” level.
Designates hazardous situations.
Sourcepub const INFO: LevelFilter = _
pub const INFO: LevelFilter = _
The “info” level.
Designates useful information.
Sourcepub const DEBUG: LevelFilter = _
pub const DEBUG: LevelFilter = _
The “debug” level.
Designates lower priority information.
Sourcepub const TRACE: LevelFilter = _
pub const TRACE: LevelFilter = _
The “trace” level.
Designates very low priority, often extremely verbose, information.
Sourcepub const fn from_level(level: Level) -> LevelFilter ⓘ
pub const fn from_level(level: Level) -> LevelFilter ⓘ
Returns a LevelFilter
that enables spans and events with verbosity up
to and including level
.
Sourcepub const fn into_level(self) -> Option<Level> ⓘ
pub const fn into_level(self) -> Option<Level> ⓘ
Sourcepub fn current() -> LevelFilter ⓘ
pub fn current() -> LevelFilter ⓘ
Returns a LevelFilter
that matches the most verbose Level
that any
currently active collector will enable.
User code should treat this as a hint. If a given span or event has a
level higher than the returned LevelFilter
, it will not be enabled.
However, if the level is less than or equal to this value, the span or
event is not guaranteed to be enabled; the collector will still
filter each callsite individually.
Therefore, comparing a given span or event’s level to the returned
LevelFilter
can be used for determining if something is
disabled, but should not be used for determining if something is
enabled.
Trait Implementations§
Source§impl AsLog for LevelFilter
impl AsLog for LevelFilter
Source§impl Clone for LevelFilter
impl Clone for LevelFilter
1.0.0 · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moreSource§impl Debug for LevelFilter
impl Debug for LevelFilter
Source§impl Display for LevelFilter
impl Display for LevelFilter
Source§impl<C> Filter<C> for LevelFilter
Available on crate features registry
and std
only.
impl<C> Filter<C> for LevelFilter
registry
and std
only.Source§fn enabled(&self, meta: &Metadata<'_>, _: &Context<'_, C>) -> bool
fn enabled(&self, meta: &Metadata<'_>, _: &Context<'_, C>) -> bool
true
if this subscriber is interested in a span or event with the
given Metadata
in the current Context
, similarly to
Collect::enabled
. Read moreSource§fn callsite_enabled(&self, meta: &'static Metadata<'static>) -> Interest
fn callsite_enabled(&self, meta: &'static Metadata<'static>) -> Interest
Source§fn max_level_hint(&self) -> Option<LevelFilter> ⓘ
fn max_level_hint(&self) -> Option<LevelFilter> ⓘ
Source§fn on_new_span(&self, attrs: &Attributes<'_>, id: &Id, ctx: Context<'_, S>)
fn on_new_span(&self, attrs: &Attributes<'_>, id: &Id, ctx: Context<'_, S>)
Source§fn on_enter(&self, id: &Id, ctx: Context<'_, S>)
fn on_enter(&self, id: &Id, ctx: Context<'_, S>)
Source§impl From<Level> for LevelFilter
impl From<Level> for LevelFilter
Source§impl From<LevelFilter> for Directive
Available on crate features env-filter
and std
only.
impl From<LevelFilter> for Directive
env-filter
and std
only.Source§fn from(level: LevelFilter) -> Self
fn from(level: LevelFilter) -> Self
Source§impl FromStr for LevelFilter
impl FromStr for LevelFilter
Source§type Err = ParseLevelFilterError
type Err = ParseLevelFilterError
Source§fn from_str(from: &str) -> Result<LevelFilter, <LevelFilter as FromStr>::Err>
fn from_str(from: &str) -> Result<LevelFilter, <LevelFilter as FromStr>::Err>
s
to return a value of this type. Read moreSource§impl Hash for LevelFilter
impl Hash for LevelFilter
Source§impl Ord for LevelFilter
impl Ord for LevelFilter
Source§fn cmp(&self, other: &LevelFilter) -> Ordering
fn cmp(&self, other: &LevelFilter) -> Ordering
1.21.0 · Source§fn max(self, other: Self) -> Selfwhere
Self: Sized,
fn max(self, other: Self) -> Selfwhere
Self: Sized,
Source§impl PartialEq<Level> for LevelFilter
impl PartialEq<Level> for LevelFilter
Source§impl PartialEq for LevelFilter
impl PartialEq for LevelFilter
Source§impl PartialOrd<Level> for LevelFilter
impl PartialOrd<Level> for LevelFilter
Source§impl PartialOrd for LevelFilter
impl PartialOrd for LevelFilter
Source§fn partial_cmp(&self, other: &LevelFilter) -> Option<Ordering> ⓘ
fn partial_cmp(&self, other: &LevelFilter) -> Option<Ordering> ⓘ
Source§fn lt(&self, other: &LevelFilter) -> bool
fn lt(&self, other: &LevelFilter) -> bool
Source§fn le(&self, other: &LevelFilter) -> bool
fn le(&self, other: &LevelFilter) -> bool
Source§fn gt(&self, other: &LevelFilter) -> bool
fn gt(&self, other: &LevelFilter) -> bool
Source§impl<C: Collect> Subscribe<C> for LevelFilter
impl<C: Collect> Subscribe<C> for LevelFilter
Source§fn register_callsite(&self, metadata: &'static Metadata<'static>) -> Interest
fn register_callsite(&self, metadata: &'static Metadata<'static>) -> Interest
Collect::register_callsite
. Read moreSource§fn enabled(&self, metadata: &Metadata<'_>, _: Context<'_, C>) -> bool
fn enabled(&self, metadata: &Metadata<'_>, _: Context<'_, C>) -> bool
true
if this subscriber is interested in a span or event with the
given metadata
in the current Context
, similarly to
Collect::enabled
. Read moreSource§fn on_register_dispatch(&self, collector: &Dispatch)
fn on_register_dispatch(&self, collector: &Dispatch)
Source§fn on_subscribe(&mut self, collector: &mut C)
fn on_subscribe(&mut self, collector: &mut C)
Source§fn on_new_span(&self, attrs: &Attributes<'_>, id: &Id, ctx: Context<'_, C>)
fn on_new_span(&self, attrs: &Attributes<'_>, id: &Id, ctx: Context<'_, C>)
Attributes
and Id
.Source§fn on_record(&self, _span: &Id, _values: &Record<'_>, _ctx: Context<'_, C>)
fn on_record(&self, _span: &Id, _values: &Record<'_>, _ctx: Context<'_, C>)
Id
recorded the given
values
.Source§fn on_follows_from(&self, _span: &Id, _follows: &Id, _ctx: Context<'_, C>)
fn on_follows_from(&self, _span: &Id, _follows: &Id, _ctx: Context<'_, C>)
span
recorded that it
follows from the span with the ID follows
.Source§fn on_event(&self, _event: &Event<'_>, _ctx: Context<'_, C>)
fn on_event(&self, _event: &Event<'_>, _ctx: Context<'_, C>)
Source§fn on_enter(&self, _id: &Id, _ctx: Context<'_, C>)
fn on_enter(&self, _id: &Id, _ctx: Context<'_, C>)
Source§fn on_exit(&self, _id: &Id, _ctx: Context<'_, C>)
fn on_exit(&self, _id: &Id, _ctx: Context<'_, C>)
Source§fn on_close(&self, _id: Id, _ctx: Context<'_, C>)
fn on_close(&self, _id: Id, _ctx: Context<'_, C>)
Source§fn on_id_change(&self, _old: &Id, _new: &Id, _ctx: Context<'_, C>)
fn on_id_change(&self, _old: &Id, _new: &Id, _ctx: Context<'_, C>)
Source§fn and_then<S>(self, subscriber: S) -> Layered<S, Self, C> ⓘ
fn and_then<S>(self, subscriber: S) -> Layered<S, Self, C> ⓘ
Layered
struct implementing Subscribe
. Read moreSource§fn with_filter<F>(self, filter: F) -> Filtered<Self, F, C> ⓘ
fn with_filter<F>(self, filter: F) -> Filtered<Self, F, C> ⓘ
registry
and std
only.impl Copy for LevelFilter
impl Eq for LevelFilter
impl StructuralPartialEq for LevelFilter
Auto Trait Implementations§
impl Freeze for LevelFilter
impl RefUnwindSafe for LevelFilter
impl Send for LevelFilter
impl Sync for LevelFilter
impl Unpin for LevelFilter
impl UnwindSafe for LevelFilter
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<F, S> FilterExt<S> for Fwhere
F: Filter<S>,
impl<F, S> FilterExt<S> for Fwhere
F: Filter<S>,
Source§fn and<B>(self, other: B) -> And<Self, B, S> ⓘ
fn and<B>(self, other: B) -> And<Self, B, S> ⓘ
registry
and std
only.Source§fn or<B>(self, other: B) -> Or<Self, B, S> ⓘ
fn or<B>(self, other: B) -> Or<Self, B, S> ⓘ
registry
and std
only.