ndjsonlogger

ndjsonlogger is an nd (newline delimited) json logger.

Rust 1.60 or greater is required.

TODO/Features

• debug, info, warn and error macros
• debug! macro compiles to no-op on release builds
• trace macro with trace mask
• all JSON primative types (number, bool, null) supported
• one level of nested arrays
• Option<&[_]> and &[Option<_>]
• compile-time iso timestamp feature
• quickstart print log lines to stdout
• configurable alternative sinks for log lines
• initialize with service name - add to all log lines
• custom runtime logic for additional key/value(s)
• work with ndjsonloggercore no_std

Quickstart

[dependencies]
ndjsonlogger = "0.1"
ndjsonloggercore = {version = "0.1", features = ["std"]}

NOTE: You must include BOTH lines in your Cargo.toml. Additionally for the 0.1 release, the std feature is required in ndjsonloggercore.

use ndjsonlogger::{info, debug};

fn main() {
    info!("hello I'm a log line");

    debug!("application closing", {
        reason = "end of main function"
    });
}}

{"level": "info", "msg": "hello I'm a log line"}
{"level": "debug", "msg": "application closing", "reason": "end of main function"}

An example demonstrating all features is here.

Contributing

Contributions welcome. Please open a github issue.