Skip to content

Latest commit

 

History

History
39 lines (26 loc) · 1.63 KB

README.md

File metadata and controls

39 lines (26 loc) · 1.63 KB

parallel_logger

Crates.io Docs MIT/APACHE-2.0

A simple logger that does not do logging by itself but passes all log events to an arbitrary number of actual loggers running in parallel. Depending on the parallel execution mode, the actual loggers are executed either in sequence (ParallelMode::Sequential) on one thread or in parallel (ParallelMode::Parallel) using one thread per actual logger. ParallelMode::Sequential should be sufficient for most use cases.

Very useful when logging is a bottleneck such as in realtime scenarios and/or when logging to a network or database etc.

Usage

Add the dependency to your Cargo.toml:

[dependencies]
log = "0.4"
parallel_logger = "0.3"

How to use in your application:

use parallel_logger::{ParallelLogger, ParallelMode};

fn main() {
    ParallelLogger::init(log::LevelFilter::Info, ParallelMode::Sequential, vec![any_logger_1, any_logger_2, ...]>);
}

Make sure not to create other loggers by using their respective init methods, but to use their new methods instead. Do not register any other logger with the log crate before as the ParallelLogger will take that place.

License

Licensed under either of