🛈 Note: This is pre-release documentation for the upcoming tracing 0.2.0 ecosystem.

For the release documentation, please see docs.rs, instead.

tracing_appender::rolling

Function hourly

Source
pub fn hourly(
    directory: impl AsRef<Path>,
    file_name_prefix: impl AsRef<Path>,
) -> RollingFileAppender 
Expand description

Creates an hourly-rotating file appender.

The appender returned by rolling::hourly can be used with non_blocking to create a non-blocking, hourly file appender.

The directory of the log file is specified with the directory argument. file_name_prefix specifies the prefix of the log file. RollingFileAppender adds the current date and hour to the log file in UTC.

§Examples

fn main () {
    let appender = tracing_appender::rolling::hourly("/some/path", "rolling.log");
    let (non_blocking_appender, _guard) = tracing_appender::non_blocking(appender);

    let collector = tracing_subscriber::fmt().with_writer(non_blocking_appender);

    tracing::collect::with_default(collector.finish(), || {
        tracing::event!(tracing::Level::INFO, "Hello");
    });
}

This will result in a log file located at /some/path/rolling.log.yyyy-MM-dd-HH.