Enum TracingConfigError

pub enum TracingConfigError {
    InvalidLevel {
        level: String,
    },
    ConfigFileNotFound,
    AlreadyInitialized,
    TracingConfigGuardDropped,
    FilterNotFound {
        filter: String,
        layer: String,
    },
    FilterParseError {
        filter: String,
        layer: String,
        error: ParseError,
    },
    WriterNotFound {
        writer: String,
        layer: String,
    },
    LayerNotFound {
        sifted_layer: String,
        layer: String,
    },
    SiftingLayerConf {
        sifted_layer: String,
        layer: String,
        error_message: String,
    },
    MissingEnvironmentVariable(VarError),
    IoError(Error),
    Deserialization(Error),
    Serialization(Error),
    FileInitError(InitError),
    PoisonError(String),
}

The only error type in this crate, wraps other errors.

There is no need for multiple error types since this crate is not meant to be used extensively by applications, it is rather meant to be used through a single init macro call in main() with a panic if something goes wrong.

In future versions I might decide to split the errors so that, upon any function call, you only get the specific error that specific function fails at, rather than every possible crate error.

Variants

InvalidLevel

Invalid Level

Fields

level: String

The invalid level name

ConfigFileNotFound

Could not find configuration file

AlreadyInitialized

TracingConfig was already initialized

TracingConfigGuardDropped

TracingConfig guard was dropped, do not drop the guard that the initialize function returns

FilterNotFound

A filter was referenced or is required, but it is not declared in the tracing.toml file

Fields

filter: String

The name of the filter

layer: String

The layer referencing the filter

FilterParseError

Could not parse a filter / directive

Fields

filter: String

The name of the filter

layer: String

The layer referencing the filter

error: ParseError

Indicates that a string could not be parsed as a filtering directive.

WriterNotFound

A writer was referenced but not declared

Fields

writer: String

The name of the writer

layer: String

The layer referencing the filter

LayerNotFound

A referenced layer could not be found

Fields

sifted_layer: String

The name of the layer that could not be found

layer: String

The layer that is referencing the layer that could not be found

SiftingLayerConf

There is a problem with how the Sifting Layer was configured

Fields

sifted_layer: String

The name of the referenced layer that is misconfigured

layer: String

The name of the sifting layer

error_message: String

The error message

MissingEnvironmentVariable(VarError)

An environment variable was referenced but it’s missing

IoError(Error)

An IoError occurred

Deserialization(Error)

Could not deserialize a toml file.

Serialization(Error)

Could not serialize a toml file.

FileInitError(InitError)

Could not initialize a file writer

PoisonError(String)

An internal lock was poisoned, this shouldn’t happen, if it does it’s a bug in TracingConfig

Trait Implementations

impl Debug for TracingConfigError

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

Formats the value using the given formatter.

impl Display for TracingConfigError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for TracingConfigError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for TracingConfigError

fn from(source: StdIoError) -> Self

Converts to this type from the input type.

impl From<Error> for TracingConfigError

fn from(source: TomlDeError) -> Self

Converts to this type from the input type.

impl From<Error> for TracingConfigError

fn from(source: TomlSerError) -> Self

Converts to this type from the input type.

impl From<InitError> for TracingConfigError

fn from(source: TaRollingInitError) -> Self

Converts to this type from the input type.

impl From<VarError> for TracingConfigError

fn from(source: VarError) -> Self

Converts to this type from the input type.