Struct tracing_fmt::filter::EnvFilter

pub struct EnvFilter { /* 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() -> Filter

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

pub fn from_env<A>(env: A) -> Filter where
    A: AsRef<str>, 

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

pub fn new<S>(dirs: S) -> Filter where
    S: AsRef<str>, 

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

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

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<Filter, 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>(env: A) -> Result<Filter, FromEnvError> where
    A: AsRef<str>, 

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 FromStr for Filter

type Err = ParseError

The associated error which can be returned from parsing.

fn from_str(spec: &str) -> Result<Filter, <Filter as FromStr>::Err>

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

impl Debug for Filter

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

Formats the value using the given formatter.

impl<S> Layer<S> for Filter where
    S: 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 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>, 

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

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

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

impl Default for Filter

fn default() -> Filter

Returns the "default value" for a type.

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

fn from(s: S) -> Filter

Performs the conversion.