#logging #structured-logging #json-log #serialization

structured-logger

A logging implementation for the log crate that logs structured values either synchronous or asynchronous, as JSON, CBOR, or any other format, into a file, stderr, stdout, or any other destination

16 releases (4 stable)

1.0.3 Aug 13, 2023
1.0.2 Jul 26, 2023
1.0.1 Jun 20, 2023
0.5.3 Apr 3, 2023
0.5.2 Mar 30, 2023

#206 in Debugging

Download history 1042/week @ 2024-12-17 895/week @ 2024-12-24 1735/week @ 2024-12-31 2971/week @ 2025-01-07 2389/week @ 2025-01-14 1854/week @ 2025-01-21 2180/week @ 2025-01-28 2813/week @ 2025-02-04 2588/week @ 2025-02-11 2209/week @ 2025-02-18 2304/week @ 2025-02-25 2505/week @ 2025-03-04 2825/week @ 2025-03-11 3164/week @ 2025-03-18 3041/week @ 2025-03-25 2887/week @ 2025-04-01

12,691 downloads per month
Used in 20 crates (16 directly)

MIT/Apache

27KB
399 lines

structured-logger

License Crates.io Codecov CI Docs.rs Latest Version

A logging implementation for the log crate that logs structured values either synchronous or asynchronous, in JSON, CBOR, or any other format, to a file, stderr, stdout, or any other destination.

It is inspired by std-logger.

Usage

See examples and the API documentation for more.

Example

Simple example:

use serde::Serialize;
use structured_logger::{async_json::new_writer, unix_ms, Builder};

#[tokio::main]
async fn main() {
    // Initialize the logger.
    Builder::with_level("info")
        .with_target_writer("*", new_writer(tokio::io::stdout()))
        .init();

    let kv = ContextLog {
        uid: "user123".to_string(),
        action: "upate_book".to_string(),
    };

    log::info!("hello world");
    // This log will be written to stdout:
    // {"level":"INFO","message":"hello world","target":"simple","timestamp":1679745592127}

    log::info!(target: "api",
        method = "GET",
        path = "/hello",
        status = 200_u16,
        start = unix_ms(),
        elapsed = 10_u64,
        kv = log::as_serde!(kv);
        "",
    );
    // This log will be written to stdout:
    // {"elapsed":10,"kv":{"uid":"user123","action":"upate_book"},"level":"INFO","message":"","method":"GET","path":"/hello","start":1679745592127,"status":200,"target":"api","timestamp":1679745592127}
}

#[derive(Serialize)]
struct ContextLog {
    uid: String,
    action: String,
}

License

Copyright © 2023-present IO Rust.

iorust/structured-logger is licensed under either of Apache License, Version 2.0 or MIT license at your option.

Dependencies

~3–11MB
~95K SLoC