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 のログを出す(英語)

最適なプランを相談する

お問い合わせ

コミュニティに参加

WeChatでスキャンして
コミュニティに参加

Guanceを試す

オンラインですぐに始めて、使った分だけお支払いください。

利用を開始

Guanceのプランを選択

コードリポジトリ