2 unstable releases
0.2.0 | Jun 20, 2024 |
---|---|
0.1.0 | Jun 20, 2024 |
#102 in Caching
33KB
791 lines
Fast and Low Latency Logging Library for Rust
Introduction
low-latency-log
is a high-performance and low-latency Rust logging library.
Features
- Very Low Latency:
low-latency-log
is designed with performance in mind, utilizing techniques such as minimizing the size of critical data structures, avoiding locks on critical paths, and caching formatted strings. - Async Logging:
low-latency-log
offloads all heavy logging operations (such as formatting, time conversion, etc.) to independent threads, ensuring the calling thread is not blocked.
Benchmark
low-latency-log
offers comparable p999 latency to quill
and leads in throughput among quill
, spdlog-rs
, ftlog
, and fast_log
.
For more details, please refer to the Benchmark.
To build the benchmark binaries, run:
cargo b -r -p bench
Usage example
use low_latency_log::{info, Level};
use std::fs;
fn main() {
let rc = RollingCondition::new().daily();
// Remember to keep the following guard, otherwise the global logger stops immediately when the guard auto-drops
let _guard = low_latency_log::Logger::new(rc, "/dev/shm".to_string(), "log.log".to_string())
.cpu(1)
.init()
.unwrap();
for i in 1..1_000_001 {
info!("number {}", i);
}
// _guard auto-dropped and log flushed
}
TODOs
The following optimizations are in progress:
- Optimize std
format!
. - Improve
ufmt
to provide more types of formatting support (e.g., floating-point types). - Support custom format types, as currently
low_latency_log
outputs fixed time and log formats. - Optimize performance when using the
log
crate.
low_latency_log
is heavily inspired by the following projects
License
This project is licensed under the Apache License.
Some code comes from the logflume
project. Please refer to LICENSE-LOGFLUME for more information.
Dependencies
~3.5MB
~66K SLoC