11 unstable releases (4 breaking)
0.5.0 | Feb 4, 2021 |
---|---|
0.4.1 | Jan 7, 2021 |
0.3.2 | Mar 16, 2020 |
0.2.2 | Mar 13, 2020 |
0.1.1 | Mar 12, 2020 |
#215 in Value formatting
40 downloads per month
33KB
140 lines
Key-value logger for Rust
Usage
Like other log
gers, kvlogger
must be initialized and registered as the default log handler in your program. You can then use either that usual log macros (that do not handle key/value pairs), or use the kvlog!
macro and add your data.
Any type that implements Display
can be used as a value.
use std::error::Error;
use log::*;
use kvlogger::{KvLoggerBuilder, *};
fn main() -> Result<(), Box<dyn Error>> {
KvLoggerBuilder::default()
.set_level(Level::Debug)
.set_datetime_format("%Y-%m-%d")
.init()?;
info!("a simple message");
kvlog!(Info, "user tried to log in", {
"username" => "apognu",
"status" => 200
});
Ok(())
}
Configuration
kvlogger
uses env_logger under the hood for filter selection. You have two ways to configure the desired level for your logs:
- You can force the logger at a specific level with the
set_level(mut self, log::Level)
method ofKvLoggerBuilder
:
KvLoggerBuilder::default()
.set_level(Level::Debug)
.init()?;
- Otherwise, you can use the
RUST_LOG
environment variable to specify which logs should be considered. See the env_logger documentation for more information.
$ RUST_LOG=rocket=error,main=info cargo run
- If using the
datetime
feature (see below), you can specify another format from the default, with theset_datetime_format(mut self, Into<String>)
method:
KvLoggerBuilder::default()
.set_datetime_format("%Y-%m-%d")
.init()?;
Optional features
By default, the date used is printed as the number of milliseconds since UNIX epoch. You can opt in the use of more complex (and human readable) formats by enabling the datetime
feature in Cargo.toml
:
[dependencies]
kvlogger = { version = "*", features = ["datetime"] }
Examples
$ cargo run --example simple
$ cargo run --example simple --features datetime
$ RUST_LOG=simple=trace cargo run --example simple --features datetime
Dependencies
~4–14MB
~139K SLoC