log-io 2.0.0

Structured logging pipeline for Rust: filter, format, sink. Allocation-free hot path, JSON / logfmt / human output that is safe for any input, thread and async context propagation, per-target filtering, durable shutdown, background and rotating file sinks, plus optional log and tracing bridges.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50

//! A custom format, two ways: implementing `Format`, or wrapping a
//! closure with `format::from_fn`. Formats are object-safe, so one can be
//! chosen at run time as a `Box<dyn Format>`.
//!
//! Run with `cargo run --example 08_custom_format`.

use core::fmt;

use log_io::format::{self, Format, JsonFormat};
use log_io::{Level, Logger, Record};

/// `level|target|message|k=v|k=v`. Keys and values are written raw:
/// a real format must escape them (see the built-in formats).
struct PipeFormat;

impl Format for PipeFormat {
    fn write_record(&self, record: &Record<'_>, w: &mut dyn fmt::Write) -> fmt::Result {
        write!(
            w,
            "{}|{}|{}",
            record.metadata.level, record.metadata.target, record.message
        )?;
        for field in record.all_fields() {
            write!(w, "|{}={}", field.key, field.value)?;
        }
        w.write_char('\n')
    }
}

fn main() {
    let closure = format::from_fn(|r: &Record<'_>, w: &mut dyn fmt::Write| {
        writeln!(w, "[{}] {}", r.metadata.level.as_str_upper(), r.message)
    });

    // Pick a format at run time.
    let chosen: Box<dyn Format> = match std::env::args().nth(1).as_deref() {
        Some("json") => Box::new(JsonFormat::new()),
        Some("closure") => Box::new(closure),
        _ => Box::new(PipeFormat),
    };

    let logger = Logger::builder()
        .level(Level::Info)
        .no_timestamps()
        .stdout(chosen)
        .build();

    log_io::info!(logger, "deployed", region = "eu-west-1", version = "2.0.0");
    log_io::warn!(logger, "queue depth", n = 200_u32);
}