ロギング（ログ出力） とは？

出来事を出力して記録するなら、ロギングに当たるよ。本番でも標準出力を実行環境が収集する構成がある。ただ表示するだけでなく、必要な記録を保存して調べられるかを考える。障害調査にはログ以外の監視情報も役立つんだ。

出来事の重要度などを段階で表すものだよ。例えばDEBUGは詳しい調査情報、INFOは出来事についての情報、WARNは警告、ERRORはエラーを表す。名前や段階は仕組みによって違うので、使うライブラリの定義と記録目的に合わせて設定するんだ。

必要な出来事と、調査に使う項目を決めよう。パスワードやアクセストークンなどの秘密をそのまま出力しないことが大事だよ。出力が多すぎると保存量や処理負荷も増える。閲覧できる人や保存期間を決め、記録が止まっていないかも確認するんだ。

時刻、重要度、出来事、結果などを名前のある項目に分けた記録だよ。JSONは表現方法の一例で、構造化ログが必ずJSONというわけではない。項目の名前や値の型がそろうと、検索や集計で同じ意味の記録を扱いやすくなるんだ。

記録を集約し、時刻や出来事、処理の識別情報などで照合するよ。OpenTelemetryのログにはTraceIdやSpanIdを入れる項目があり、対応する処理との関連付けに使える。ただし任意の項目なので、導入しただけで全ログに自動で付くとは限らない。収集できる情報と設定を確認するんだ。