前言

在現有的日志庫中，包括 go 1.21.0 引入的 slog 日志庫，它們通常都支持對日志文件進行輪轉與切割，只不過這些功能并不直接被內置，而是需要我們主動配置來啟用。

本文將探討幾個熱門的日志庫如 logrus、zap 和官網的 slog，我將分析這些庫的的關鍵設計元素，探討它們是如何支持日志輪轉與切割功能的配置。

準備好了嗎？準備一杯你最喜歡的咖啡或茶，隨著本文一探究竟吧。

前段時間發布了一篇 Go slog 包：開啟結構化日志的奇妙之旅 文章，有一位網友問我該日志庫是否支持日志輪轉與切割功能，此文章也算是解答他的一個疑惑。

圖片

淺析 logrus、zap 和 slog 的設計

在對 logrus、zap 和 slog 這幾個日志庫的設計進行對比分析時，一個顯著的共同點是它們都包含了 io.Writer 這個關鍵的屬性。這一屬性在日志框架設計中起著核心作用，它決定了日志輸出的目標位置。

logrus 日志庫

logrus 是一個功能豐富的Go語言日志庫，它提供了結構化日志記錄、日志級別控制等功能。

當使用 logrus 時，可以調用 logrus.New() 函數來創建 Logger 實例。通過該實例我們執行很多操作，例如自定義日志輸出的位置和打印日志等。我們看看下面的代碼：

logger := logrus.New()
logger.Out = os.Stdout // 標準輸出
// 或者定向到文件
//out, err := os.OpenFile("file.log", os.O_CREATE|os.O_WRONLY, 0666)
//if err != nil {
//	panic(err)
//}
//logger.Out = out

Logger 結構體的定義如下所示：

type Logger struct {
	Out io.Writer
	Hooks LevelHooks
	Formatter Formatter
    // 其他字段...
}

關鍵屬性 Out，其類型為 io.Writer，這一屬性用于指定日志的輸出目標，無論是標準輸出、文件，還是其他自定義的輸出載體。

zap 日志庫

zap 是一個性能極高的日志庫。它提供了結構化日志記錄、多級別日志控制，以及靈活的配置選項。

與 logrus 類似，zap 也允許支持通過配置來決定日志輸出的位置，但實現方式略有不同。在 zap 中，日志輸出是通過配置 zapcore.Core 實現的。在創建 zapcore.Core 實例時，需要指定一個 zapcore.WriteSyncer 接口實現作為參數，這個參數直接決定了日志的輸出目標。要創建 zapcore.WriteSyncer 實例，通常使用 zapcore.AddSync() 函數，它接收一個類型為 io.Writer 的參數。

下面是一個使用 zap 創建日志實例的基本示例：

writer := zapcore.AddSync(os.Stdout) // 使用標準輸出作為日志目標
core := zapcore.NewCore(
    zapcore.NewJSONEncoder(zap.NewProductionEncoderConfig()),
    writer,
    zap.InfoLevel,
)
logger := zap.New(core)
defer logger.Sync() // 刷新任何緩沖的日志條目

// 使用 logger 進行日志記錄

關鍵在于 zapcore.AddSync() 函數，該函數接收一個類型為 io.Writer 的參數，這一參數用于指定日志的輸出目標，無論是標準輸出、文件，還是其他自定義的輸出載體。

slog 日志庫

slog 是在 go 1.21.0 版本引入的一個官網日志庫，它提供了結構化日志。如果想要更詳細地了解 slog 日志庫，自薦一篇文章 Go slog 包：開啟結構化日志的奇妙之旅。

與 logrus 和 zap 類似，slog 也允許用戶通過指定 io.Writer 參數來設置日志輸出的目標。這一設置是在創建 slog.Handler 接口的實現時進行的。

textLogger := slog.New(slog.NewTextHandler(os.Stdout, nil))
jsonLogger := slog.New(slog.NewJSONHandler(os.Stdout, nil))

在這兩個函數中，slog.NewTextHandler 和 slog.NewJSONHandler 第一個參數的類型都是 io.Writer。

淺析總結

在對 logurs、zap 和 slog 這三個主流日志庫的分析中，我們可以發現一個關鍵的共同點：它們在處理日志輸出時均依賴于 io.Writer 接口。這些日志庫通過將 io.Writer接口作為關鍵參數的類型，以便設置日志的輸出目標。

圖片

日志輪轉與切割功能的實現機制與實踐

實現機制

在淺析了 logurs、zap 和 slog 日志庫的設計后，我們發現了它們的共同點。現在，讓我們深入了解日志輪轉與切割功能的實現機制。

為了實現 日志文件的輪轉與切割，通常我們會借助第三方庫，如 lumberjack，當然還有其他類似的庫可供選擇，這里就不一一列舉了。

lumberjack 是一個專門設計用于日志輪轉和切割的庫，其作用可以類比于一個可插拔的組件。我們可以通過配置該組件，并將其 集成 到所選的日志庫中，從而實現日志文件的輪轉與切割功能。

初始化 lumberjack 組件的代碼如下所示：

log := &lumberjack.Logger{
    Filename:   "/path/file.log", // 日志文件的位置
    MaxSize:    10, // 文件最大尺寸（以MB為單位）
    MaxBackups: 3, // 保留的最大舊文件數量
    MaxAge:     28, // 保留舊文件的最大天數
    Compress:   true, // 是否壓縮/歸檔舊文件
    LocalTime:  true, // 使用本地時間創建時間戳
}

在這個例子中，我們創建了一個 lumberjack.Logger 實例，并設置了以下參數：

• Filename：指定日志文件的存儲路徑。
• MaxSize：日志文件達到多少 MB 后進行輪轉。
• MaxBackups：最多保留多少個舊日志文件。
• MaxAge：舊文件保留的最長時間（天）。
• Compress：是否壓縮舊文件（如轉換為.gz）。

需要特別注意的是， lumberjack 的 Logger 結構體實現了 io.Writer 接口。這意味著所有關于日志文件的輪轉與切割的核心邏輯都封裝在 Write 方法中。這一實現也方便 Logger 結構體被集成到任何支持 io.Writer 參數的日志庫中。

明白了這些，想必你已經知道如何實現日志輪轉與切割的功能了吧。lumberjack 的 logger  結構體實現了 io.Writer 接口，因此將它傳遞到第三方庫中，就能完成集成配置了。

實踐

logrus 日志庫的實現

log := &lumberjack.Logger{
    Filename:   "/path/file.log", // 日志文件的位置
    MaxSize:    10,               // 文件最大尺寸（以MB為單位）
    MaxBackups: 3,                // 保留的最大舊文件數量
    MaxAge:     28,               // 保留舊文件的最大天數
    Compress:   true,             // 是否壓縮/歸檔舊文件
    LocalTime:  true,             // 使用本地時間創建時間戳
}
logger := logrus.New()
logger.Out = log

zap 日志庫的實現

log := &lumberjack.Logger{
    Filename:   "/path/file.log", // 日志文件的位置
    MaxSize:    10,               // 文件最大尺寸（以MB為單位）
    MaxBackups: 3,                // 保留的最大舊文件數量
    MaxAge:     28,               // 保留舊文件的最大天數
    Compress:   true,             // 是否壓縮/歸檔舊文件
    LocalTime:  true,             // 使用本地時間創建時間戳
}
writer := zapcore.AddSync(log)
core := zapcore.NewCore(
    zapcore.NewJSONEncoder(zap.NewProductionEncoderConfig()),
    writer,
    zap.InfoLevel,
)
logger := zap.New(core)
defer logger.Sync() // 刷新任何緩沖的日志條目

slog 日志庫的實現

log := &lumberjack.Logger{
    Filename:   "/path/file.log", // 日志文件的位置
    MaxSize:    10,               // 文件最大尺寸（以MB為單位）
    MaxBackups: 3,                // 保留的最大舊文件數量
    MaxAge:     28,               // 保留舊文件的最大天數
    Compress:   true,             // 是否壓縮/歸檔舊文件
    LocalTime:  true,             // 使用本地時間創建時間戳
}
textLogger := slog.New(slog.NewTextHandler(log, nil))
jsonLogger := slog.New(slog.NewJSONHandler(log, nil))

小結

本文對三個熱門的日志庫 logrus、zap 和 slog 設計要素進行淺析，我們發現雖然它們在創建日志實例的細節上有所差異，但它們共同依賴于 io.Writer 接口參數來處理日志的輸出。掌握如何配置 io.Writer 參數，并結合 lumberjack 庫的使用，我們就可以實現日志文件的輪轉與切割功能。

即使后面推出新的日志庫，我們也可以通過類似的方法，快速地集成日志文件的輪轉與切割功能。

本文轉載自微信公眾號「Go技術干貨」，可以通過以下二維碼關注。轉載本文請聯系Go技術干貨公眾號。