Struct RotatingFileSinkBuilder

pub struct RotatingFileSinkBuilder<ArgBP, ArgRP> { /* private fields */ }

Note

The generics here are designed to check for required fields at compile time, users should not specify them manually and/or depend on them. If the generic concrete types or the number of generic types are changed in the future, it may not be considered as a breaking change.

Implementations

impl<ArgBP, ArgRP> RotatingFileSinkBuilder<ArgBP, ArgRP>

pub fn base_path<P>( self, base_path: P, ) -> RotatingFileSinkBuilder<PathBuf, ArgRP>

where P: Into<PathBuf>,

Specifies the base path of the log file.

The path needs to be suffixed with an extension, if you expect the rotated eventual file names to contain the extension.

If there is an extension, the different rotation policies will insert relevant information in the front of the extension. If there is not an extension, it will be appended to the end.

Supposes the given base path is /path/to/base_file.log, the eventual file names may look like the following:

• /path/to/base_file_1.log
• /path/to/base_file_2.log
• /path/to/base_file_2022-03-23.log
• /path/to/base_file_2022-03-24.log
• /path/to/base_file_2022-03-23_03.log
• /path/to/base_file_2022-03-23_04.log

This parameter is required.

pub fn rotation_policy( self, rotation_policy: RotationPolicy, ) -> RotatingFileSinkBuilder<ArgBP, RotationPolicy>

Specifies the rotation policy.

This parameter is required.

pub fn max_files(self, max_files: usize) -> Self

Specifies the maximum number of files.

If the number of existing files reaches this parameter, the oldest file will be deleted on the next rotation.

Specify 0 for no limit.

This parameter is optional.

pub fn rotate_on_open(self, rotate_on_open: bool) -> Self

Specifies whether to rotate files once when constructing RotatingFileSink.

For the RotationPolicy::Daily, RotationPolicy::Hourly, and RotationPolicy::Period rotation policies, it may truncate the contents of the existing file if the parameter is true, since the file name is a time point and not an index.

This parameter is optional.

pub fn level_filter(self, level_filter: LevelFilter) -> Self

Specifies a log level filter.

This parameter is optional.

pub fn formatter(self, formatter: Box<dyn Formatter>) -> Self

Specifies a formatter.

This parameter is optional.

pub fn error_handler(self, handler: ErrorHandler) -> Self

Specifies an error handler.

This parameter is optional.

impl RotatingFileSinkBuilder<PathBuf, RotationPolicy>

pub fn build(self) -> Result<RotatingFileSink>

Builds a RotatingFileSink.

Error

If the argument rotation_policy is invalid, or an error occurs opening the file, Error::CreateDirectory or Error::OpenFile will be returned.