[][src]Struct tracing_subscriber::EnvFilter

pub struct EnvFilter { /* fields omitted */ }

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

Methods

impl EnvFilter[src]

pub const DEFAULT_ENV: &'static str[src]

RUST_LOG is the default environment variable used by EnvFilter::from_default_env and EnvFilter::try_from_default_env.

pub fn from_default_env() -> Self[src]

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

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

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

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

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

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

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

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

Returns a new EnvFilter 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>[src]

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

pub fn add_directive(self, directive: Directive) -> Self[src]

Add a filtering directive to this EnvFilter.

The added directive will be used in addition to any previously set directives, either added using this method or provided when the filter is constructed.

Filters may be created from may be LevelFilters, which will enable all traces at or below a certain verbosity level, or parsed from a string specifying a directive.

If a filter directive is inserted that matches exactly the same spans and events as a previous filter, but sets a different level for those spans and events, the previous directive is overwritten.

Examples

use tracing_subscriber::filter::{EnvFilter, LevelFilter};
let mut filter = EnvFilter::from_default_env()
    .add_directive(LevelFilter::INFO.into());
use tracing_subscriber::filter::{EnvFilter, Directive};

let mut filter = EnvFilter::try_from_default_env()?
    .add_directive("my_crate::module=trace".parse()?)
    .add_directive("my_crate::my_other_module::something=info".parse()?);

Trait Implementations

impl Debug for EnvFilter[src]

impl Default for EnvFilter[src]

impl Display for EnvFilter[src]

impl<S> From<S> for EnvFilter where
    S: AsRef<str>, 
[src]

impl FromStr for EnvFilter[src]

type Err = ParseError

The associated error which can be returned from parsing.

impl<S: Subscriber> Layer<S> for EnvFilter[src]

Auto Trait Implementations

Blanket Implementations

impl<T> Any for T where
    T: 'static + ?Sized
[src]

impl<T> Borrow<T> for T where
    T: ?Sized
[src]

impl<T> BorrowMut<T> for T where
    T: ?Sized
[src]

impl<T> From<T> for T[src]

impl<T, U> Into<U> for T where
    U: From<T>, 
[src]

impl<T> ToString for T where
    T: Display + ?Sized
[src]

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
[src]

type Error = Infallible

The type returned in the event of a conversion error.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
[src]

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.