13.4 構造化ログを出力する

AWSであればCloudWatch Logs、Google Cloudの場合はCloud Loggingというログ管理のサービスがあります。これらのサービスではログ表示のUIを提供しており、出力されたログをフィルタリングして検索したりできます。このようなサービスを利用するにあたって、利用しやすいログ形式が構造化ロギング です。構造化ロギングはキーと値のペアを持つことができ、分析がしやすいログ形式です。

JSON形式を用いることで、ユーザーID、リクエストパス、エラーコードなどの詳細な情報をログに付与できます。これにより、単にログメッセージを読むだけでなく、特定の条件でログを抽出したり、集計したりすることが容易になります。たとえば、購入商品情報がログに格納されていれば、特定の商品をカートに入れたユーザー一覧を簡単に取得するといった分析も可能でしょう。AWS、Google CloudのどちらのサービスもJSON形式に対応しています。

構造化ログは標準出力に出力された内容をエージェントが収集し、これらのサービスに送信しています。標準のlogパッケージはお手軽ですが、構造化ログやログレベルでのフィルタリングなどはサポートされていませんでした。そのこともあり、従来、構造化ログを出力する場合github.com/rs/zerologやgithub.com/go.uber.org/zapなどの便利なサードパーティーライブラリが利用されていました。こうした中Go 1.21 でlog/slogパッケージが標準に導入され、構造化ログの出力が標準ライブラリで実現できるようになりました。本節ではlog/slogパッケージを用いた構造化ロギングの基本と応用を紹介します。 ...