如何使用 log4rs 的滚动文件追加器来合并滚动日志记录?



我正在尝试基于滚动策略构建一个记录器。以下是我能够实现的最接近的:

let logfile = FileAppender::builder()
.encoder(Box::new(PatternEncoder::new("{d} {l}::{m}{n}")))
.build("log/output.log")?;
let config = Config::builder()
.appender(Appender::builder().build("logfile", Box::new(logfile)))
.build(Root::builder()
.appender("logfile")
.build(LevelFilter::Debug))?;
log4rs::init_config(config)?;

这有助于我记录各个级别的消息。但是,长时间记录到文件可能是一个危险的提议。因此,我正在寻找可以限制保留的日志数据量的东西。我遇到了RollingFileAppender,但我找不到Policy的正确用法。

请指导我完成此操作。我主要在寻找编程配置。

你可以通过使用RollingFileAppenderCompoundPolicyFixedWindowRollerlog4rsSizeTrigger来实现它。

您需要实现以下内容才能创建滚动文件逻辑:

  1. FixedWindowRoller

指定FixedWindowRoller以固定window_size滚动日志文件,如下所示:

let window_size = 3; // log0, log1, log2
let fixed_window_roller = 
FixedWindowRoller::builder().build("log{}",window_size).unwrap();
  1. SizeTrigger

指定SizeTrigger以声明文件的大小限制以触发Roller,如下所示:

let size_limit = 5 * 1024; // 5KB as max log file size to roll
let size_trigger = SizeTrigger::new(size_limit);
  1. CompoundPolicy

声明CompoundPolicy以在RollingFileAppender中使用它,如下所示:

let compound_policy = CompoundPolicy::new(Box::new(size_trigger),Box::new(fixed_window_roller));

然后在您的Config中,您需要使用RollingFileAppender才能获得所需的行为。

let config = Config::builder()
.appender(
Appender::builder()
.filter(Box::new(ThresholdFilter::new(LevelFilter::Debug)))
.build(
"logfile",
Box::new(
RollingFileAppender::builder()
.encoder(Box::new(PatternEncoder::new("{d} {l}::{m}{n}")))
.build("logfile", Box::new(compound_policy))?,
),
),
)
.build(
Root::builder()
.appender("logfile")
.build(LevelFilter::Debug),
)?;

通过此实现,您将获得window size 3roll size 5KB的滚动文件


如果要压缩滚动文件,可以在滚动文件扩展名中定义它。您可以将扩展指定为log{}.gz而不是log{}

但是,如果要使用日志文件启用压缩,则需要在cargo.toml中启用此功能,如下所示:

log4rs = { version ="1.0.0", features = ["gzip"] }

注意:如果你想为自己的目的做一个custom rollercustom trigger,你可以从各自的特征中实现自己的TriggerRoller

最新更新