#tracing #logging-tracing #logging #log-file #local-time #tracing-appender

logroller

A Rust library for automatic file rotation, working with the tracing-appender crate

3 releases

0.1.2 Nov 29, 2024
0.1.1 Nov 14, 2024
0.1.0 Oct 31, 2024

#394 in Debugging

Download history 115/week @ 2024-10-28 15/week @ 2024-11-04 127/week @ 2024-11-11 20/week @ 2024-11-18 113/week @ 2024-11-25 24/week @ 2024-12-02 31/week @ 2024-12-09

194 downloads per month

MIT license

33KB
471 lines

LogRoller 🪵

Crates.io Docs.rs License

LogRoller is a Rust library for efficient log writing and file rotation. It provides a simple API for writing logs to files and automatically rotating them based on size or time. And it works seamlessly with the tracing-appender crate for use with the tracing framework.

Features ✨

  • Log Writing: Write logs to files with ease.
  • File Rotation: Automatically rotate log files based on size or time.
  • Configurable: Easily customize rotation strategies and settings.
  • Time Zones: Rotate logs according to the local or UTC time zone.
  • Thread-safe: Designed for safe concurrent usage.
  • Tracing Support: Use LogRoller as a file appender for the tracing framework.
  • Compression: Compress rotated log files with Gzip.

Usage 🚀

Add logroller to your Cargo.toml:

[dependencies]
logroller = "0.1"

1. Use logroller as a simple logger

Create a new LogRoller instance and write logs to it:

use logroller::{LogRollerBuilder, Rotation, RotationSize};
use std::io::Write;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut logger = LogRollerBuilder::new("./logs", "logger.log")
        .rotation(Rotation::SizeBased(RotationSize::KB(256)))
        .max_keep_files(3)
        .build()?;

    writeln!(logger, "This is an info message")?;
    writeln!(logger, "This is a warning message")?;
    writeln!(logger, "This is an error message")?;

    Ok(())
}

2. Use logroller with tracing and tracing-appender

logroller can be used as a file appender for the tracing-appender crate, by enabling the tracing feature:

[dependencies]
logroller = { version = "0.1", features = ["tracing"] }

tracing-appender only supports rotating logs according to the UTC time zone. logroller can rotate logs according to the local time zone.

use logroller::{Compression, LogRollerBuilder, Rotation, RotationAge, TimeZone};
use tracing_subscriber::util::SubscriberInitExt;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let appender = LogRollerBuilder::new("./logs", "tracing.log")
        .rotation(Rotation::AgeBased(RotationAge::Minutely))
        .max_keep_files(3)
        .time_zone(TimeZone::Local)
        .compression(Compression::Gzip)
        .build()?;
    let (non_blocking, _guard) = tracing_appender::non_blocking(appender);
    tracing_subscriber::fmt()
        .with_writer(non_blocking)
        .with_ansi(false)
        .with_target(false)
        .with_file(true)
        .with_line_number(true)
        .finish()
        .try_init()?;

    tracing::info!("This is an info message");
    tracing::warn!("This is a warning message");
    tracing::error!("This is an error message");

    Ok(())
}

Dependencies

~3.5–5.5MB
~98K SLoC