Go Lumberjack 怎样设置历史日志保留数量和天数

我在给 Go 服务补日志轮转时，最容易混淆的不是怎么接入 Lumberjack，而是历史文件到底按“留下几份”还是按“留下几天”计算。这个问题可以拆成两个明确的参数：MaxBackups 限制旧日志的数量，MaxAge 按备份文件名里的轮转时间限制天数。两条规则同时设置时，满足任一删除条件的旧文件都可能被清理。

官方地址：https://github.com/natefinch/lumberjack

下面用一组可复查的配置目标说明：每个当前日志文件最大 200 MB，最多保留 5 份旧文件，轮转时间超过 7×24 小时的备份不再保留，并按需开启 gzip 压缩。这里的数字是配置示例，不是某台机器的运行测量值。

先把“数量”和“天数”分开

Lumberjack v2 的导入路径是 gopkg.in/natefinch/lumberjack.v2。MaxBackups 表示最多保留多少个旧日志文件；MaxAge 表示旧日志最多保留多少天，而且按备份文件名中记录的轮转时间判断，一天按 24 小时计算。它们不是“先按数量、再按天数”的两个流水线步骤，而是两条并行的保留边界。

例如设置 MaxBackups: 5、MaxAge: 7，并不等于“永远保留 5 份且至少 7 天”。实际保留范围还取决于轮转频率：如果日志写得很快，5 份可能只覆盖几小时；如果写得很慢，7 天规则可能先淘汰很久以前的备份。

把保留策略写进 Logger

把轮转阈值和历史策略放到同一个 lumberjack.Logger 中，再交给标准库 log 写入即可。示例采用 200 MB、5 份、7 天的配置目标：

package main

import (
	"log"

	"gopkg.in/natefinch/lumberjack.v2"
)

func main() {
	logger := &lumberjack.Logger{
		Filename:   "/var/log/myapp/app.log",
		MaxSize:    200, // 当前文件达到200 MB附近时触发轮转
		MaxBackups: 5,   // 只保留最近的5个旧日志文件
		MaxAge:     7,   // 按轮转时间保留7天，按24小时计算
		Compress:   true, // 让轮转后的旧文件使用gzip压缩
	}

	// 标准库 log 只关心 io.Writer，历史文件策略由 Logger 负责。
	log.SetOutput(logger)
	log.Println("service started")
}

配置后的容量预估可以先用一个简单指标表达：未压缩上限约为 MaxSize × (MaxBackups + 1)，再把压缩率和实际写入量作为单独变量。它只用于规划磁盘预算，不等同于最终占用，因为压缩文件大小取决于日志内容，且清理只在创建新日志文件时发生。

清理发生在什么时候

Lumberjack 会把当前文件轮转成带时间戳的备份文件，再创建新的当前文件。创建新文件时，库会按照备份文件名中的时间戳找出旧文件：超过 MaxBackups 的数量范围，或超过 MaxAge 天数范围的文件，都可能被删除。它不是一个独立的后台定时清理器，所以低流量服务即使跨过了 7 天，也可能要等下一次轮转或创建新文件才触发清理。

这也是我设置保留指标时会额外看“每天预计轮转几次”的原因。若每个文件大约写满 200 MB 才轮转，而服务每天只产生一个文件，那么 5 份数量上限大约覆盖 5 次轮转；若每天产生 20 个文件，数量边界会比 7 天更早生效。

几个容易把指标看错的边界

第一，MaxAge 不是自然日。官方说明按 24 小时定义一天，夏令时、闰秒等情况不会被简单当作日历日期切换。需要严格按自然日对齐时，应把它当作近似保留窗口，而不是日历任务。

第二，两个参数都为 0 不会删除旧文件。MaxBackups: 0 表示不按数量限制，MaxAge: 0 表示不按年龄删除；二者同时为 0 时，旧文件不会因为这两条规则被删除。只想按天数清理时，保留 MaxBackups: 0 并设置正数 MaxAge；只想按份数清理时则相反。

第三，Compress 改变的是存储形态，不是保留规则。它使用 gzip 压缩轮转后的日志，不能把压缩当作增加 MaxBackups 或 MaxAge 的替代品。另一个实际边界是同一份 Lumberjack 配置不应由多个进程同时写入同一组文件，否则轮转行为可能不正确。

我的配置结论

如果目标是控制磁盘峰值，先给 MaxSize 一个能估算的上限，再用 MaxBackups 限制短时间内的文件数量，用 MaxAge 兜住最长保留窗口；最后根据日志可读性和磁盘压力决定是否开启 Compress。这三个指标要结合轮转频率一起看，不能只盯着某一个参数。

对于单进程写入、需要本地滚动文件的 Go 服务，这套配置足够清晰；如果还需要集中检索、跨主机聚合、告警或审计留存，就应把 Lumberjack 当成写入层组件，而不是完整日志平台。

相关问题

MaxBackups 和 MaxAge 哪个优先？它们是并行的清理条件，数量超限或时间超限的文件都可能被删除，不能理解成固定的先后顺序。

MaxAge 设置为 7 会保留整整七个自然日吗？不会，它按备份文件名中的轮转时间，以 24 小时为一天计算。