8 releases
| new 0.3.5 | May 18, 2024 |
|---|---|
| 0.3.4 | Mar 13, 2024 |
| 0.3.1 | Feb 2, 2024 |
| 0.3.0 | Jan 27, 2024 |
| 0.1.0 | Jan 24, 2024 |
#217 in Debugging
93 downloads per month
43KB
515 lines
Logkit
Super fast, structured, scalable logging library for Rust
Hello World
#[macro_use] extern crate logkit;
fn main() {
let mut logger = logkit::Logger::new(Some(&logkit::StdoutTarget));
logger.mount(logkit::LevelPlugin);
logger.mount(logkit::TimePlugin::from_millis());
logkit::set_default_logger(logger);
trace!("hello, this is a trace log");
debug!("hello, this is a debug log");
info!(version = "0.1.0", commit = "3291cc60"; "this is a log with two string fields");
warn!(address = "127.0.0.1", port = 3000; "this is a log with a string and a numeric field");
error!("this is a log with a 'println' style string {}:{}", "127.0.0.1", 3000.0);
}
Output sample:
{"level":"trace","time":"2024-01-26T20:33:01.841+08:00","msg":"hello, this is a trace log"}
{"level":"debug","time":"2024-01-26T20:33:01.841+08:00","msg":"hello, this is a debug log"}
{"level":"info","time":"2024-01-26T20:33:01.841+08:00","msg":"this is a log with two string fields","version":"0.1.0","commit":"3291cc60"}
{"level":"warn","time":"2024-01-26T20:33:01.841+08:00","msg":"this is a log with a string and a numeric field","address":"127.0.0.1","port":3000}
{"level":"error","time":"2024-01-26T20:33:01.841+08:00","msg":"this is a log with a 'println' style string 127.0.0.1:3000"}
Benchmark
- MacBook Air, Apple M2 24G, Sonoma 14.2.1
| Name | Time |
|---|---|
| empty_log | [22.526 ns 22.541 ns 22.560 ns] |
| level_off | [1.6941 ns 1.6989 ns 1.7050 ns] |
| msg_only | [63.166 ns 63.172 ns 63.177 ns] |
| msg_format | [63.238 ns 63.373 ns 63.548 ns] |
| fields_only | [96.944 ns 96.974 ns 97.005 ns] |
| fields_msg | [147.03 ns 147.26 ns 147.56 ns] |
| fields_msg_format | [146.44 ns 146.51 ns 146.58 ns] |
| fields_ten_fields | [395.31 ns 395.35 ns 395.40 ns] |
- AWS c5.2xlarge, 8C 16G, Ubuntu 22.04
| Name | Time |
|---|---|
| empty_log | [50.761 ns 50.764 ns 50.768 ns] |
| level_off | [4.1800 ns 4.1804 ns 4.1810 ns] |
| msg_only | [121.12 ns 121.14 ns 121.16 ns] |
| msg_format | [121.18 ns 121.20 ns 121.23 ns] |
| fields_only | [177.70 ns 177.74 ns 177.77 ns] |
| fields_msg | [264.25 ns 264.33 ns 264.45 ns] |
| fields_msg_format | [261.80 ns 261.89 ns 261.98 ns] |
| fields_ten_fields | [654.11 ns 654.31 ns 654.51 ns] |
Documentation
The documentation is available here.
License
This software is released under the MIT License.
Dependencies
~11MB
~213K SLoC