Struct CollectdLoggerBuilder

pub struct CollectdLoggerBuilder { /* private fields */ }

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

impl CollectdLoggerBuilder

pub fn new() -> Self

Initializes the log builder with defaults

pub fn try_init(&mut self) -> Result<(), SetLoggerError>

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.

pub fn prefix_plugin<T: PluginManager>(&mut self) -> &mut Self

Prefixes all log messages with a plugin’s name. This is recommended to aid debugging and gain insight into collectd logs.

pub fn filter_level(&mut self, level: LevelFilter) -> &mut Self

See env_logger::filter::Builder::filter_level

pub fn filter_module(&mut self, module: &str, level: LevelFilter) -> &mut Self

See: env_logger::filter::Builder::filter_module

pub fn filter(&mut self, module: Option<&str>, level: LevelFilter) -> &mut Self

See: env_logger::filter::Builder::filter

pub fn parse(&mut self, filters: &str) -> &mut Self

See: env_logger::filter::Builder::parse

pub fn format<F>(&mut self, format: F) -> &mut Self

where F: Fn(&mut dyn Write, &Record<'_>) -> Result<()> + Sync + Send + 'static,

Sets the format function for formatting the log output.

Trait Implementations

impl Default for CollectdLoggerBuilder

fn default() -> CollectdLoggerBuilder

Returns the “default value” for a type.