#rolling #logging-tracing #logging #tracing

tracing-rolling-file

A rolling file appender with customizable rolling conditions

2 releases

0.1.2 Sep 26, 2023
0.1.1 Aug 16, 2022
0.1.0 Aug 16, 2022

#468 in Debugging

Download history 285/week @ 2024-07-19 284/week @ 2024-07-26 102/week @ 2024-08-02 138/week @ 2024-08-09 178/week @ 2024-08-16 288/week @ 2024-08-23 424/week @ 2024-08-30 245/week @ 2024-09-06 731/week @ 2024-09-13 261/week @ 2024-09-20 361/week @ 2024-09-27 73/week @ 2024-10-04 278/week @ 2024-10-11 803/week @ 2024-10-18 310/week @ 2024-10-25 378/week @ 2024-11-01

1,779 downloads per month

MIT/Apache

23KB
402 lines

tracing-rolling-file

tracing-rolling-file on GitHub Actions tracing-rolling-file on crates.io tracing-rolling-file on docs.rs GitHub: cavivie/tracing-rolling-file license: MIT or Apache-2.0 minimum rustc: 1.42

A rolling file appender with customizable rolling conditions, based on rolling-file. Includes built-in support for rolling conditions on date/time (daily, hourly, every minute) and/or size.

Follows a Debian-style naming convention for logfiles, using basename, basename.1, ..., basename.N where N is the maximum number of allowed historical logfiles.

This is useful to combine with the tracing crate and tracing_appender::non_blocking::NonBlocking -- use it as an alternative to tracing_appender::rolling::RollingFileAppender.

Examples

use tracing_rolling_file::*;
let file_appender = RollingFileAppenderBase::new(
    "/var/log/myprogram",
    RollingConditionBase::new().daily(),
    9
).unwrap();

Development

Must pass latest stable clippy, be formatted with nightly rustfmt, and pass unit tests:

cargo +nightly fmt
cargo clippy --all-targets
cargo test

License

Dual-licensed under the terms of either the MIT license or the Apache 2.0 license.

Dependencies

~1MB
~18K SLoC