使用Lumberjack实现Golang滚动日志记录

Lumberjack是一个流行的Golang日志滚动库，它提供了自动日志文件轮转功能，可以基于文件大小、时间或两者结合来滚动日志文件。下面我将详细介绍如何使用Lumberjack。

Lumberjack基本特性

• 按文件大小滚动日志
• 保留最多N个旧日志文件
• 可选择压缩旧日志文件
• 支持日志文件清理
• 线程安全

安装Lumberjack

go get gopkg.in/natefinch/lumberjack.v2

基本使用示例

package main

import (
	"log"
	"gopkg.in/natefinch/lumberjack.v2"
)

func main() {
	// 配置Lumberjack日志滚动
	log.SetOutput(&lumberjack.Logger{
		Filename:   "/var/log/myapp/foo.log", // 日志文件路径
		MaxSize:    500, // 每个日志文件的最大大小(MB)
		MaxBackups: 3,   // 保留旧日志文件的最大数量
		MaxAge:     28,  // 保留旧日志文件的最大天数
		Compress:   true, // 是否压缩/归档旧日志文件
	})

	// 正常记录日志
	for i := 0; i < 10000; i++ {
		log.Println("这是一条测试日志，编号:", i)
	}
}

与标准log库集成

package main

import (
	"log"
	"os"
	"gopkg.in/natefinch/lumberjack.v2"
)

func main() {
	// 同时输出到控制台和文件
	log.SetOutput(io.MultiWriter(os.Stdout, &lumberjack.Logger{
		Filename:   "app.log",
		MaxSize:    100,   // MB
		MaxBackups: 5,
		MaxAge:     30,    // days
	}))
	
	log.Println("这条日志会同时出现在控制台和日志文件中")
}

与logrus集成示例

package main

import (
	"github.com/sirupsen/logrus"
	"gopkg.in/natefinch/lumberjack.v2"
)

func main() {
	logger := logrus.New()
	
	// 配置Lumberjack
	logger.SetOutput(&lumberjack.Logger{
		Filename:   "logrus.log",
		MaxSize:    100, // MB
		MaxBackups: 5,
		MaxAge:     30,  // days
		Compress:   true,
	})
	
	logger.Info("这是一条logrus日志")
}

高级配置示例

package main

import (
	"log"
	"os"
	"gopkg.in/natefinch/lumberjack.v2"
)

func main() {
	// 自定义日志轮转配置
	lumberjackLogger := &lumberjack.Logger{
		Filename:   "/var/log/myapp/app.log",
		MaxSize:    100,    // MB
		MaxBackups: 5,      // 保留最多5个备份
		MaxAge:     30,     // 最多保存30天
		LocalTime:  true,   // 使用本地时间
		Compress:   true,   // 压缩旧日志
	}
	
	// 设置日志输出
	log.SetOutput(lumberjackLogger)
	
	// 程序退出前关闭日志文件
	defer lumberjackLogger.Close()
	
	// 日志记录
	log.Println("应用程序启动")
	
	// 模拟日志记录
	for i := 0; i < 1000; i++ {
		log.Printf("处理请求 #%d", i)
	}
	
	log.Println("应用程序关闭")
}

动态修改日志配置

package main

import (
	"log"
	"os"
	"os/signal"
	"syscall"
	"gopkg.in/natefinch/lumberjack.v2"
)

func main() {
	// 初始化日志配置
	logger := &lumberjack.Logger{
		Filename:   "dynamic.log",
		MaxSize:    50,
		MaxBackups: 3,
		MaxAge:     7,
	}
	log.SetOutput(logger)
	
	// 监听SIGHUP信号重新打开日志文件
	sigs := make(chan os.Signal, 1)
	signal.Notify(sigs, syscall.SIGHUP)
	
	go func() {
		for {
			<-sigs
			logger.Rotate() // 收到SIGHUP信号时轮转日志
			log.Println("收到SIGHUP信号，日志已轮转")
		}
	}()
	
	// 正常日志记录
	for i := 0; ; i++ {
		log.Printf("这是一条日志记录 #%d", i)
		time.Sleep(time.Second)
	}
}

注意事项

1. Lumberjack不是异步的，日志写入会阻塞调用线程
2. 在高并发场景下，建议结合缓冲写入器使用
3. 确保应用程序对日志目录有写入权限
4. 程序退出前最好调用Close()方法确保所有日志都写入文件

Lumberjack是一个简单而强大的日志滚动解决方案，适合大多数Golang应用的日志需求。对于更复杂的日志场景，可以考虑使用zerolog或zap等更高级的日志库，它们通常也支持与Lumberjack集成。