構造化ロギング とは？

たとえば「ERROR ユーザー42が見つからない」という文章を、level、user_id、messageなどの項目に分けて記録するんだ。人が読むだけでなく、プログラムがそれぞれの値を扱いやすくなるよ。

JSONは代表例だよ。{"level":"ERROR","user_id":42,"message":"ユーザーが見つからない"}なら、レベルは文字列、利用者IDは数値として分かれている。ただし構造化の中心は項目と値を持つことで、JSONだけが唯一の形式ではないんだ。

文章のログも検索できるよ。Cloud LoggingではtextPayloadの文字を検索でき、JSONオブジェクトのjsonPayloadでは特定のパスを検索したり項目をインデックス化したりできる。levelがERROR、user_idが42という条件を分けて指定しやすいんだ。

ロギングライブラリに項目を渡して出力できるよ。Pythonのstructlogではイベントを辞書として扱い、JSONRendererを設定するとJSONにできる。ライブラリを使うだけで出力が必ずJSONになるわけではなく、形式の設定も確認するんだ。

調査しやすくなるけれど、必要な情報の記録やログ基盤への取り込みも大切だよ。たとえばelapsed_msを数値にそろえれば処理時間を集計しやすい。同じ意味なのにサービスごとに名前や単位が違うと、横断的な比較には調整が必要になるんだ。