1 unstable release

0.1.0 Mar 5, 2024

#796 in Unix APIs

MIT and maybe AGPL-3.0-or-later

21KB
438 lines

tracing-systemd: Journald logging with (some) formatting

Putting something here so the repo doesn't look quite so bare

Run examples:

cargo run --example test_log_stdout --features="colored"

cargo run --example test_log_systemd --features="colored"


lib.rs:

tracing-subscriber layer for logging to the systemd journal

Provides a SystemdLayer implementation for use with tracing-subscriber that can be configured. Shows all spans and arguments.

Features

  • colored (default): Enables colored output
  • sd-journal: Enables logging to the systemd journal (useful for running outside of a service)
    • Requires libsystemd-dev to be installed
    • Filter using -t | --identifier (e.g. journalctl -t <identifier>)

Example

use tracing::error;

use tracing::{debug, info, instrument, trace, warn};
use tracing_subscriber::prelude::*;
use tracing_systemd::SystemdLayer;
fn main() {
    tracing_subscriber::registry()
        .with(
            SystemdLayer::new()
                .with_target(true)
                .use_level_prefix(false)
                .use_color(true)
                .with_thread_ids(true),
        )
        .init();

    root_log_fn(true);
}

#[instrument(fields(outside_instrument_field = true))]
fn root_log_fn(outside_instrument_field: bool) {
    info!("Root log");
    inner_log_1(true);
}

#[instrument(fields(inside_instrument_field = true))]
fn inner_log_1(inside_parameter_field: bool) {
    trace!("this is a trace");
    debug!(field_in_function = "also works");
    info!("this is an info log");
    warn!("Inner log 1");
    error!("this is an error");
}

Dependencies

~2–12MB
~86K SLoC