Skip to content

8192K/parallel_logger

Repository files navigation

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

About

A Rust logger implementing the log::Log trait that allows other loggers to run in a separate thread

Resources

License

Apache-2.0, MIT licenses found

Licenses found

Apache-2.0
LICENSE-APACHE.txt
MIT
LICENSE-MIT.txt

Stars

Watchers

Forks

Packages

No packages published

Languages