Struct tracing_subscriber::filter::Filter

pub struct Filter { /* fields omitted */ }

A Layer which filters spans and events based on a set of filter directives.

Methods

impl Filter

pub const DEFAULT_ENV: &'static str

The default environment variable used by Filter::from_default_env and Filter::try_from_default_env.

pub fn from_default_env() -> Self

Returns a new Filter from the value of the RUST_LOG environment variable, ignoring any invalid filter directives.

pub fn from_env<A: AsRef<str>>(env: A) -> Self

Returns a new Filter from the value of the given environment variable, ignoring any invalid filter directives.

pub fn new<S: AsRef<str>>(dirs: S) -> Self

Returns a new Filter from the directives in the given string, ignoring any that are invalid.

pub fn try_new<S: AsRef<str>>(dirs: S) -> Result<Self, ParseError>

Returns a new Filter from the directives in the given string, or an error if any are invalid.

pub fn try_from_default_env() -> Result<Self, FromEnvError>

Returns a new Filter from the value of the RUST_LOG environment variable, or an error if the environment variable contains any invalid filter directives.

pub fn try_from_env<A: AsRef<str>>(env: A) -> Result<Self, FromEnvError>

Returns a new Filter from the value of the given environment variable, or an error if the environment variable is unset or contains any invalid filter directives.

Trait Implementations

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

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 enabled(&self, metadata: &Metadata, _: 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 new_span(&self, attrs: &Attributes, id: &Id, _: Context<S>)

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

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

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

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

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

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

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

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

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

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 on_event(&self, _event: &Event, _ctx: Context<S>)

Notifies this layer that an event has occurred.

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].

impl<S> From<S> for Filter where
    S: AsRef<str>, 

fn from(s: S) -> Self

Performs the conversion.

impl Default for Filter

fn default() -> Self

Returns the "default value" for a type.

impl Debug for Filter

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.

impl FromStr for Filter

type Err = ParseError

The associated error which can be returned from parsing.

fn from_str(spec: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.