Struct TargetFilter 

pub struct TargetFilter {
    ignored_targets: Vec<String>,
    allowed_targets: Vec<String>,
    target_levels: Vec<(String, Level)>,
    default_level: Level,
}

A tracing-subscriber layer that filters events based on their target.

Fields

ignored_targets: Vec<String>

Targets where logs should always be ignored.

allowed_targets: Vec<String>

If non-empty, only these targets are allowed.

target_levels: Vec<(String, Level)>

Per-target minimum level that must be met for an event to be logged.

default_level: Level

Default minimum level if no override is found

Implementations

impl TargetFilter

pub fn parse_targets(self, log_targets: String) -> Self

Create a TargetFilter by parsing allowed_targets and ignored_targets from a string in the format target1,target2 or !target1,!target2

pub fn with_verbosity(self, verbosity_level: u8) -> Self

Overrides default level with verbosity level.

pub fn allow_targets<I, S>(self, targets: I) -> Self

where I: IntoIterator<Item = S>, S: AsRef<str>,

Adds multiple allowed targets.

pub fn ignore_targets<I, S>(self, targets: I) -> Self

where I: IntoIterator<Item = S>, S: AsRef<str>,

Adds multiple ignored targets.

pub fn targets_level<I, S>(self, targets: I, level: Level) -> Self

where I: IntoIterator<Item = S>, S: AsRef<str>,

Assign a log level filter for multiple targets.

pub fn default_level(self, level: Level) -> Self

Override default level filter.

fn filter<S: Subscriber>( &self, metadata: &Metadata<'_>, _ctx: &Context<'_, S>, ) -> bool

Helper method to implement the filtering logic.

Trait Implementations

impl Default for TargetFilter

fn default() -> Self

Returns the “default value” for a type.

impl<S: Subscriber> Filter<S> for TargetFilter

Implement [Filter] to be able to filter inside a specific Layer.

fn enabled(&self, metadata: &Metadata<'_>, ctx: &Context<'_, S>) -> bool

Returns true if this layer is interested in a span or event with the given Metadata in the current [Context], similarly to Subscriber::enabled.

fn callsite_enabled(&self, meta: &'static Metadata<'static>) -> Interest

Returns an Interest indicating whether this layer will always, sometimes, or never be interested in the given Metadata.

fn event_enabled(&self, event: &Event<'_>, cx: &Context<'_, S>) -> bool

Called before the filtered [Layer]'s [on_event], to determine if on_event` should be called.

fn max_level_hint(&self) -> Option<LevelFilter>

Returns an optional hint of the highest verbosity level that this Filter will enable.

fn on_new_span(&self, attrs: &Attributes<'_>, id: &Id, ctx: Context<'_, S>)

Notifies this filter that a new span was constructed with the given Attributes and Id.

fn on_record(&self, id: &Id, values: &Record<'_>, ctx: Context<'_, S>)

Notifies this filter that a span with the given Id recorded the given values.

fn on_enter(&self, id: &Id, ctx: Context<'_, S>)

Notifies this filter that a span with the given ID was entered.

fn on_exit(&self, id: &Id, ctx: Context<'_, S>)

Notifies this filter that a span with the given ID was exited.

fn on_close(&self, id: Id, ctx: Context<'_, S>)

Notifies this filter that a span with the given ID has been closed.

impl<S: Subscriber> Layer<S> for TargetFilter

Implement [Filter] to be able to add the filter as a Layer thus filtering for multiple layers.

fn enabled(&self, metadata: &Metadata<'_>, ctx: Context<'_, S>) -> bool

Returns true if this layer is interested in a span or event with the given metadata in the current [Context], similarly to Subscriber::enabled.

fn on_register_dispatch(&self, subscriber: &Dispatch)

Performs late initialization when installing this layer as a Subscriber.

fn on_layer(&mut self, subscriber: &mut S)

Performs late initialization when attaching a Layer to a [Subscriber].

fn register_callsite(&self, metadata: &'static Metadata<'static>) -> Interest

Registers a new callsite with this layer, returning whether or not the layer is interested in being notified about the callsite, similarly to Subscriber::register_callsite.

fn on_new_span(&self, attrs: &Attributes<'_>, id: &Id, ctx: Context<'_, S>)

Notifies this layer that a new span was constructed with the given Attributes and Id.

fn on_record(&self, _span: &Id, _values: &Record<'_>, _ctx: Context<'_, S>)

Notifies this layer that a span with the given Id recorded the given values.

fn on_follows_from(&self, _span: &Id, _follows: &Id, _ctx: Context<'_, S>)

Notifies this layer that a span with the ID span recorded that it follows from the span with the ID follows.

fn event_enabled(&self, _event: &Event<'_>, _ctx: Context<'_, S>) -> bool

Called before on_event, to determine if on_event should be called.

fn on_event(&self, _event: &Event<'_>, _ctx: Context<'_, S>)

Notifies this layer that an event has occurred.

fn on_enter(&self, _id: &Id, _ctx: Context<'_, S>)

Notifies this layer that a span with the given ID was entered.

fn on_exit(&self, _id: &Id, _ctx: Context<'_, S>)

Notifies this layer that the span with the given ID was exited.

fn on_close(&self, _id: Id, _ctx: Context<'_, S>)

Notifies this layer that the span with the given ID has been closed.

fn on_id_change(&self, _old: &Id, _new: &Id, _ctx: Context<'_, S>)

Notifies this layer that a span ID has been cloned, and that the subscriber returned a different ID.

fn and_then<L>(self, layer: L) -> Layered<L, Self, S>

where L: Layer<S>, Self: Sized,

Composes this layer around the given Layer, returning a Layered struct implementing Layer.

fn with_subscriber(self, inner: S) -> Layered<Self, S>

where Self: Sized,

Composes this Layer with the given Subscriber, returning a Layered struct that implements Subscriber.

fn with_filter<F>(self, filter: F) -> Filtered<Self, F, S>

where Self: Sized, F: Filter<S>,

Combines self with a [Filter], returning a Filtered layer.

fn boxed(self) -> Box<dyn Layer<S> + Send + Sync>

where Self: Sized + Layer<S> + Send + Sync + 'static, S: Subscriber,

Erases the type of this [Layer], returning a Boxed dyn Layer trait object.