Struct collectd_plugin::CollectdLoggerBuilder [−][src]
pub struct CollectdLoggerBuilder { /* fields omitted */ }
Expand description
Bridges the gap between collectd and rust logging. Terminology and filters methods found here are from env_logger.
It is recommended to instantiate the logger in PluginManager::plugins
.
The use case of multiple rust plugins that instantiate a global logger is supported. Each plugin will have its own copy of a global logger. Thus plugins won’t interefere with others and their logging.
Example
use collectd_plugin::{ConfigItem, PluginManager, PluginRegistration, CollectdLoggerBuilder}; use log::LevelFilter; use std::error; #[derive(Default)] struct MyPlugin; impl PluginManager for MyPlugin { fn name() -> &'static str { "myplugin" } fn plugins(_config: Option<&[ConfigItem]>) -> Result<PluginRegistration, Box<error::Error>> { CollectdLoggerBuilder::new() .prefix_plugin::<Self>() .filter_level(LevelFilter::Info) .try_init() .expect("really the only thing that should create a logger"); unimplemented!() } }
Implementations
Initializes the global logger with the built collectd logger.
Errors
This function will fail if it is called more than once, or if another library has already initialized a global logger.
Prefixes all log messages with a plugin’s name. This is recommended to aid debugging and gain insight into collectd logs.
Trait Implementations
Returns the “default value” for a type. Read more
Auto Trait Implementations
impl !RefUnwindSafe for CollectdLoggerBuilder
impl Send for CollectdLoggerBuilder
impl Sync for CollectdLoggerBuilder
impl Unpin for CollectdLoggerBuilder
impl !UnwindSafe for CollectdLoggerBuilder