Crate tracing_subscriber_init 

Convenience trait and functions to ease tracing-subscriber initialization.

Program configuration can come from multiple sources. This crate supplies the TracingConfig trait to allow the grouping of tracing-subscriber initialization related items.

For example, I often have some configuration from the command line (quiet and verbose flags), some configuration from a configuration file, and some configuration (secrets) loaded from external sources. I implement this trait on a struct to collect the tracing-subscriber related configuration, then use functions such as full_filtered to configure layers as appropriate.

There are also convenience functions such as set_default that will setup a Registry, add the given vector of Layer, and initialize per the upstream functions of the same name.

Example

#[derive(Clone, Debug, Default)]
struct TomlConfig {
    // ...other configuration
    tracing: Tracing,
    tracing_file: TracingFile,
    // ...other configuration
}

#[derive(Clone, Debug, Default)]
struct Tracing {
    target: bool,
    thread_ids: bool,
    thread_names: bool,
    line_numbers: bool,
}

impl TracingConfig for Tracing {
    // Normally pulled from command line arguments, i.e. prog -qq
    fn quiet(&self) -> u8 {
        0
    }

    // Normally pulled from command line arguments, i.e. prog -vv
    fn verbose(&self) -> u8 {
        2
    }

    fn with_line_number(&self) -> bool {
        self.line_numbers
    }

    fn with_target(&self) -> bool {
        self.target
    }

    fn with_thread_ids(&self) -> bool {
        self.thread_ids
    }

    fn with_thread_names(&self) -> bool {
        self.thread_names
    }
}

#[derive(Clone, Debug, Default)]
struct TracingFile;

impl TracingConfig for TracingFile {
    fn quiet(&self) -> u8 {
        0
    }

    fn verbose(&self) -> u8 {
        3
    }

    fn with_ansi(&self) -> bool {
        false
    }
}

// Load configuration and pull out the tracing specific.
let toml_config = TomlConfig::default();
let tracing_config = toml_config.tracing;
let tracing_file_config = toml_config.tracing_file;

// Setup a full format, filtered layer.  The filtering is set based on the quiet
// and verbose values from the configuration
let layer = full_filtered(&tracing_config);

// Setup a second full format layer to write to a file.  Use the non-filtered
// version when you wish to modify items such as the writer, or the time format.
// You can also chose to ignore the generated level filter and apply your own.
let file = File::create("trace.log")?;
let (file_layer, level_filter) = full(&tracing_file_config);
let file_layer = file_layer.with_writer(file).with_filter(level_filter);

// Create a Registry, add the layers, and set this subscriber as the default
// for this scope
let _unused = set_default(vec![layer.boxed(), file_layer.boxed()]);

// Create a new span and enter it.
let span = span!(Level::INFO, "a new span");
let _enter = span.enter();

// Trace away...
info!("info level");

Re-exports

pub use time::format_description::well_known::Iso8601;time

pub use time::format_description::well_known::Rfc2822;time

pub use time::format_description::well_known::Rfc3339;time

pub use tracing_subscriber::Layer;tstime

pub use tracing_subscriber::fmt::time::OffsetTime;tstime

pub use tracing_subscriber::fmt::time::SystemTime;tstime

pub use tracing_subscriber::fmt::time::Uptime;tstime

pub use tracing_subscriber::fmt::time::UtcTime;tstime

Traits

TracingConfig

Implement this trait to supply tracing configuration that can be used to build a Layer with functions such as full_filtered.

Functions

compact

Create a Compact format layer configured from the given TracingConfig.

compact_filtered

Create a Compact format filtered layer configured from the given TracingConfig.

full

Create a Full format layer configured from the given TracingConfig.

full_filtered

Create a Full format filtered layer configured from the given TracingConfig.

get_effective_level

Determine the effective logging level based on quiet and verbosity settings.

init

Creates a Registry, adds the given Layers to it, and attempts to set itself as the global default subscriber in the current scope, panicking if this fails.

jsonjson

Create a Json format layer configured from the given TracingConfig.

json_filteredjson

Create a Json format filtered layer configured from the given TracingConfig.

pretty

Create a Pretty format layer configured from the given TracingConfig.

pretty_filtered

Create a Pretty format filtered layer configured from the given TracingConfig.

set_default

Creates a Registry, adds the given Layers to it, and sets itself as the default subscriber in the current scope, returning a guard that will unset it when dropped.

try_init

Creates a Registry, adds the given Layers to it, and attempts to set self as the global default subscriber in the current scope, returning an error if one is already set.