uber-go/zap

これは何？

主な機能

• 01型安全なField値を使った構造化ログ。
• 02柔軟な型のキーと値、およびprintf形式のAPIを備えたSugaredLogger。
• 03リフレクションを使わない、ゼロアロケーションのJSONエンコーダー。
• 04本番環境向けと開発環境向けのプリセットを備えた、ログレベル対応。

ユースケース

• アロケーションのオーバーヘッドが重要となる、レイテンシに敏感なGoサービスでのロギング。
• ログ集約システムが解析できるJSONログの出力。
• バックエンドサービスのリクエストに構造化コンテキストフィールドを追加。

クイックスタート

1. 1

   go get で zap ライブラリをインストールする

   go get -u go.uber.org/zap
2. 2

   本番用ロガーを作成し、SugaredLogger でログを記録する

使う前に知っておきたいこと

• !Go の最新のマイナーバージョン 2 つのみをサポートします。

収録されている特集

トピック

よくある質問

zap とは？

Go向けの高速な構造化ログライブラリ。ゼロアロケーションのLoggerと、より柔軟なSugaredLogger APIを提供します。 Zapは、型付きのキーと値のフィールドを持つ構造化ログを出力し、ログレベルにも対応するGo向けのロギングライブラリです。リフレクションベースのシリアライズや文字列フォーマットがCPUコストとメモリアロケーションを大きく増やす、ホットパスでログを出力するアプリケーションを想定しています。

zap は無料で使えますか？ライセンスは？

zap は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

zap は今もメンテナンスされていますか？

半年以内に更新あり。zap の最終コミットは 2026年9月16日 です。

zap は何に使えますか？

アロケーションのオーバーヘッドが重要となる、レイテンシに敏感なGoサービスでのロギング。 ログ集約システムが解析できるJSONログの出力。 バックエンドサービスのリクエストに構造化コンテキストフィールドを追加。

zap のインストール方法は？

go get で zap ライブラリをインストールする: go get -u go.uber.org/zap 本番用ロガーを作成し、SugaredLogger でログを記録する

zap はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/uber-go/zap