Go 日誌庫怎麼選?比較 slog、Zap、Zerolog 等九種方案
從 API、輸出格式和維護狀態比較九種 Go 日誌方案,實測 Logrus、slog、Zerolog、Zap 的警告欄位差異。
結帳服務已經有一套可用的 JSON 日誌,這時換 Go 日誌庫,改到的還有下游解析規則和告警。終端機顯示的訊息可能一模一樣,級別值卻從 warning 變成 WARN。用舊值篩選的儀表板就看不到這批事件。
Go 1.21 以上的新服務可以從標準庫 log/slog 開始。既有服務則先拿一條採集器實際收到的日誌,再看應用程式的效能剖析。兩者分別回答下游依賴哪些欄位,以及日誌是否真的值得花時間加速。
九種 Go 日誌方案各適合什麼情境?
| 套件 | 常見用途 | 選用時要確認 |
|---|---|---|
| slog | 標準庫的結構化日誌,內建文字與 JSON Handler | 更換 Handler 後,欄位名與輸出方式可能會變 |
| Zerolog | 低開銷的鏈式事件 API,預設輸出 JSON | 時間戳須加在事件或綁定至 Logger |
| Zap | Logger 使用具型別的欄位,SugaredLogger 提供鍵值與格式化方法 |
以實際會用的 API 和編碼器比較 |
| Logrus | 沿用既有 WithFields、Formatter 與 Hook |
上游以修正與相容為主,換庫時要處理原有 Hook |
| Apex/log | 小型結構化 API,可替換 Handler | JSON Handler 把自訂欄位放入 fields,最近的模組標籤發於 2020 年 |
| Log15 | logfmt 與可組合的 Handler | v3 模組路徑不同,2026 年 5 月有 v3.2.1,上游也建議評估 slog |
| Logf | 簡潔的 logfmt API,可設定預設欄位 | 確認實際鎖定的版本與採集器能解析的格式 |
| Phuslu/log | 鏈式事件與支援輪替的 FileWriter |
寫檔時一併驗證輪替與採集行為 |
| Logr | 由應用程式指定輸出的日誌 API | 輸出格式與效能取決於注入的 LogSink |
Logrus 的維護模式說的是上游工作範圍,Apex/log 的標籤日期則是發行紀錄。既有服務要不要遷移,還要看編譯時固定的版本、實際使用的 Hook,以及採集器收到的資料。
分開處理呼叫介面與輸出格式
slog 可用 TextHandler 在終端機輸出,也可用 JSONHandler 把欄位交給採集器。維持同一套 *slog.Logger 呼叫方式時,可以更換背後的 slog.Handler。接第三方 Logger 需要相容的 Handler 或轉接器,之後仍須驗證欄位分組、級別映射和呼叫位置。 Go slog 套件文件
寫程式庫或 Kubernetes 控制器也有這個分工。框架已經注入 logr.Logger 時,沿用它便能讓應用程式決定 Sink。Kubernetes 的上下文日誌以 go-logr API 為基礎,控制器能補上資源名稱等內容,輸出編碼仍由宿主決定。 Kubernetes 上下文日誌(英文)
應用程式直接選實作時,可以試 Zerolog 的鏈式事件或 Zap 的具型別欄位。Zap 另有 SugaredLogger,並可透過 AtomicLevel 在執行期間調整級別。用團隊會保留的寫法和實際欄位測試,結果才適用於自己的程式。
把編碼開銷和寫入成本分開測
編碼微基準會受欄位數量、型別、預先綁定的上下文、呼叫位置和 Writer 影響。Zap 上游基準固定相依版本,並將各種情境分開報告。引用結果時應一併看當時的設定。 Zap 基準測試(英文)
效能剖析若顯示日誌開銷偏高,可以用同一條代表性事件測兩次。丟棄輸出的 Writer 有助於單獨觀察編碼和記憶體配置。換成正式的容器 stdout 或輪替檔案,才看得出寫入阻塞和緩衝區塞滿時會發生什麼。維持相同的級別、欄位、取樣與並行度,再比 CPU、配置次數和延遲。
用同一筆事件驗證換庫前後的輸出
以一筆合成警告為例,訊息為 checkout retry,帶有錯誤和數值欄位 attempt=2。以下為 Go 1.26.1 本機執行的結果。Zerolog 的範例明確加入時間戳,Zap 則使用正式環境的 JSON 編碼器設定。
| 測試實作 | 時間欄位 | 級別值 | 訊息欄位 |
|---|---|---|---|
| Logrus 1.10.2 JSON Formatter | time,RFC3339 |
warning |
msg |
| slog JSON Handler | time,本次為含小數秒的 RFC3339 |
WARN |
msg |
Zerolog 1.35.1 加上 Timestamp() |
time,RFC3339 |
warn |
message |
| Zap 1.28.0 正式環境 JSON Encoder | ts,Unix 秒數值 |
warn |
msg |
四筆資料的 attempt 都是數值。直接篩 level=warning 時,只有原始的 Logrus 事件會匹配。若解析器預期 time 是文字時間戳,遇到 Zap 的數值 ts 就需要另一個映射。這是本機輸出格式測試,沒有測量吞吐量或日誌投遞。
使用觀測雲時,可由 DataKit 採集支援的容器 stdout 或讀取日誌檔案。在 Pipeline 測試新舊樣本,確認解析後的事件時間、狀態、訊息和業務欄位型別。這筆警告要先轉成現有監控使用的級別值。有些記錄缺欄位,出錯時也可能附堆疊,最好同批測試。完成解析後,再用同一條查詢核對測試來源的結果。 DataKit 日誌採集(簡體中文) · 觀測雲 Pipeline(簡體中文)
既有的日誌庫若符合需求、依賴也能維護,可以繼續使用。新服務用 slog 起步能保留之後更換 Handler 的空間。實測有差異再選 Zerolog 或 Zap,框架已提供 Logr 就沿用它的介面。
