Struct LogOutput 

pub struct LogOutput { /* private fields */ }

A log output to be included in the log_outputs parameter of VeilidLog::try_init

Example: (debug logs to the terminal, and informational logs to the api tracing layer)

let log_outputs = [
    LogOutput::stdout(true).with_common_log_level(VeilidConfigLogLevel::Debug),
    LogOutput::api().with_common_log_level(VeilidConfigLogLevel::Info)
];

Example: (no logs to the terminal)

let log_outputs = [LogOutput::stdout(true)];

let logs = VeilidTracing::try_init(log_outputs).expect("logs failed to initialize");
// ...
logs.try_apply_facility_level("#common", VeilidConfigLogLevel::Debug).expect("should set log level");

Implementations

impl LogOutput

pub fn stdout(color: bool) -> Self

Creates a log writing to standard output

pub fn stderr(color: bool) -> Self

Creates a log writing to standard error

pub fn file<P: AsRef<Path>>(path: P, append: bool) -> Self

Creates a log writing to a file on disk

pub fn api() -> Self

Create a log that sends log output to VeilidUpdate::Log events

pub fn layer<L>( name: String, layer: Box<dyn Layer<Registry> + Send + Sync + 'static>, ) -> Self

Creates a log that accepts an arbitrary tracing layer

pub fn with_common_log_level(self, level: VeilidConfigLogLevel) -> Self

Convenience function that applies a default log level to the ‘veilid::common’ Veilid log tags

pub fn try_with_directives<C: TryIntoIterVeilidLogDirective>( self, directives: C, ) -> VeilidAPIResult<Self>

Change which log facilities are enabled by default on this log output. This can also be changed after the VeilidLog is initialized.