Module rolling

A rolling file appender.

Creates a new log file at a fixed frequency as defined by Rotation. Logs will be written to this file for the duration of the period and will automatically roll over to the newly created log file once the time period has elapsed.

The log file is created at the specified directory and file name prefix which may be appended with the date and time.

The following helpers are available for creating a rolling file appender.

• Rotation::minutely(): A new log file in the format of some_directory/log_file_name_prefix.yyyy-MM-dd-HH-mm will be created minutely (once per minute)
• Rotation::hourly(): A new log file in the format of some_directory/log_file_name_prefix.yyyy-MM-dd-HH will be created hourly
• Rotation::daily(): A new log file in the format of some_directory/log_file_name_prefix.yyyy-MM-dd will be created daily
• Rotation::never(): This will result in log file located at some_directory/log_file_name

Examples

use tracing_appender::rolling::{RollingFileAppender, Rotation};
let file_appender = RollingFileAppender::new(Rotation::HOURLY, "/some/directory", "prefix.log");

Structs

Builder

A builder for configuring RollingFileAppenders.

InitError

Errors returned by Builder::build.

RollingFileAppender

A file appender with the ability to rotate log files at a fixed schedule.

RollingWriter

A writer that writes to a rolling log file.

Rotation

Defines a fixed period for rolling of a log file.

Functions

daily

Creates a daily-rotating file appender.

hourly

Creates an hourly-rotating file appender.

minutely

Creates a minutely-rotating file appender. This will rotate the log file once per minute.

never

Creates a non-rolling file appender.