Go のログライブラリ 9 選を比較:slog・Zap・Zerolog ほか
Go のログライブラリを API、出力形式、保守状況で比較。Logrus、slog、Zerolog、Zap を実行し、移行時に変わるフィールドを確認します。
決済サービスの JSON ログがすでに収集できているなら、Go のロガーを入れ替えると、後段のパーサーやアラートにも影響する。ターミナルに出るメッセージが同じでも、レベルの値が warning から WARN に変わるだけで、古い値を使うダッシュボードから該当イベントが消えてしまう。
Go 1.21 以降で新しいサービスを作るなら、標準ライブラリの log/slog から始めやすい。既存サービスなら、まず収集側が実際に受け取った一行と、アプリケーションのプロファイルを確認する。どのフィールドが使われていて、ログ処理にどれだけのコストがかかっているかが見えてくる。
Go のログライブラリ 9 種類を比べる
| パッケージ | 選ばれる理由 | 採用前に確認すること |
|---|---|---|
| slog | 標準ライブラリの構造化ログ。テキストと JSON の Handler が組み込み | Handler の変更でフィールド名や出力形式が変わることがある |
| Zerolog | 低オーバーヘッドのチェーン式イベント。既定で 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 を差し替えることもできる。サードパーティーのロガーにつなぐなら、対応する Handler やアダプターを用意する。フィールドのグループ化、レベルの対応、呼び出し元情報は変更後にも確認しておきたい。 Go slog パッケージ(英語)
ライブラリやコントローラーでも、この分担が役に立つ。ホスト側が logr.Logger を渡してくれるなら、コントローラーはリソース名や reconcile のコンテキストを補い、書き出しはアプリケーションに任せられる。Kubernetes のコンテキスト付きロギングは go-logr API を基盤としている。 Kubernetes のコンテキスト付きロギング(英語)
アプリケーションで実装を直接選ぶなら、Zerolog のチェーン式イベントと Zap の型付きフィールドを比較できる。Zap には SugaredLogger があり、AtomicLevel で実行中のレベルも変更できる。運用するコードに合う呼び出し方を決めて、その形で測ると判断しやすい。
エンコードと書き込みを分けて測る
ログのエンコードコストは、フィールド数や型、あらかじめ付与したコンテキスト、呼び出し元の取得、Writer に左右される。Zap の上流ベンチマークは依存バージョンを固定し、条件の違うケースを分けている。数字を見るときは測定条件も合わせて確認する。 Zap のベンチマーク(英語)
プロファイルでログ処理の負荷が目立つなら、代表的なイベントを二つの出力条件で測ってみる。まず出力を捨てる Writer でエンコードとメモリー割り当てを見る。次に実際のコンテナ標準出力やローテーションするファイルで、書き込みのブロックやバッファーが満杯になったときの挙動を見る。レベル、フィールド、サンプリング、並行数をそろえて、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 用にマッピングが必要になる。このローカルテストでは出力のスキーマを確認した。
Guance では DataKit が対応するコンテナの標準出力やログファイルを収集できる。新旧のサンプルを Pipeline で試し、イベント時刻、レベル、メッセージ、業務フィールドの型を見比べる。この警告なら、既存モニターが使うレベル値に変換できるか確認する。フィールドが欠けた行や、実際に出力するならスタックトレース付きの行も試す。切り替える前に、テスト用のソースで同じクエリを実行して結果を確かめる。 DataKit のログ収集 · Guance Pipeline(英語)
今のロガーで要件を満たし、依存関係も維持できるなら、そのまま使う理由は十分にある。新しいサービスには slog、測定で効果が見えた場合は Zerolog や Zap、フレームワークが Logr を渡す場合はその API が候補になる。
Go slog で構造化ログを実装する(英語) · Zap で Go のログを出す(英語) · Zerolog で Go のログを出す(英語)
