pub struct FilterFn<F = fn(_: &Metadata<'_>) -> bool> { /* private fields */ }
Expand description
A filter implemented by a closure or function pointer that
determines whether a given span or event is enabled, based on its
Metadata
.
This type can be used for both per-subscriber filtering (using its
Filter
implementation) and global filtering (using its
Subscribe
implementation).
See the documentation on filtering with subscribers for details.
Implementations§
Source§impl<F> FilterFn<F>
impl<F> FilterFn<F>
Sourcepub fn new(enabled: F) -> Self
pub fn new(enabled: F) -> Self
Constructs a FilterFn
from a function or closure that returns true
if a span or event should be enabled, based on its Metadata
.
If determining whether a span or event should be enabled also requires
information about the current span context, use DynFilterFn
instead.
See the documentation on per-subscriber filtering for details on using
Filter
s.
§Examples
use tracing_subscriber::{
subscribe::{Subscribe, CollectExt},
filter::FilterFn,
util::SubscriberInitExt,
};
let my_filter = FilterFn::new(|metadata| {
// Only enable spans or events with the target "interesting_things"
metadata.target() == "interesting_things"
});
let my_subscriber = tracing_subscriber::fmt::subscriber();
tracing_subscriber::registry()
.with(my_subscriber.with_filter(my_filter))
.init();
// This event will not be enabled.
tracing::warn!("something important but uninteresting happened!");
// This event will be enabled.
tracing::debug!(target: "interesting_things", "an interesting minor detail...");
Sourcepub fn with_max_level_hint(self, max_level_hint: impl Into<LevelFilter>) -> Self
pub fn with_max_level_hint(self, max_level_hint: impl Into<LevelFilter>) -> Self
Sets the highest verbosity Level
the filter function will enable.
The value passed to this method will be returned by this FilterFn
’s
Filter::max_level_hint
method.
If the provided function will not enable all levels, it is recommended to call this method to configure it with the most verbose level it will enable.
§Examples
use tracing_subscriber::{
subscribe::{Subscribe, CollectExt},
filter::{filter_fn, LevelFilter},
util::SubscriberInitExt,
};
use tracing_core::Level;
let my_filter = filter_fn(|metadata| {
// Only enable spans or events with targets starting with `my_crate`
// and levels at or below `INFO`.
metadata.level() <= &Level::INFO && metadata.target().starts_with("my_crate")
})
// Since the filter closure will only enable the `INFO` level and
// below, set the max level hint
.with_max_level_hint(LevelFilter::INFO);
let my_subscriber = tracing_subscriber::fmt::subscriber();
tracing_subscriber::registry()
.with(my_subscriber.with_filter(my_filter))
.init();
Trait Implementations§
Source§impl<C, F> Filter<C> for FilterFn<F>
Available on crate features registry
and std
only.
impl<C, F> Filter<C> for FilterFn<F>
registry
and std
only.Source§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 callsite_enabled(&self, metadata: &'static Metadata<'static>) -> Interest
fn callsite_enabled(&self, metadata: &'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<C, F> Subscribe<C> for FilterFn<F>
impl<C, F> Subscribe<C> for FilterFn<F>
Source§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 register_callsite(&self, metadata: &'static Metadata<'static>) -> Interest
fn register_callsite(&self, metadata: &'static Metadata<'static>) -> Interest
Collect::register_callsite
. 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.Auto Trait Implementations§
impl<F> Freeze for FilterFn<F>where
F: Freeze,
impl<F> RefUnwindSafe for FilterFn<F>where
F: RefUnwindSafe,
impl<F> Send for FilterFn<F>where
F: Send,
impl<F> Sync for FilterFn<F>where
F: Sync,
impl<F> Unpin for FilterFn<F>where
F: Unpin,
impl<F> UnwindSafe for FilterFn<F>where
F: UnwindSafe,
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.