ログレベル とは？

よく見るのはDEBUG・INFO・WARN・ERRORだよ。詳細な情報、動作の記録、注意が必要な状況、処理の失敗、といった使い分けがある。TRACEやFATALを持つものもあるけれど、名称や段階数は実装によって違う。チーム内で意味をそろえることが大切なんだ。

たとえば再試行で回復した状況をWARN、依頼した処理が失敗した状況をERRORにする、といった運用が考えられるよ。ただし一律の規則ではない。対応の緊急度は、そのレベルだけでなく、利用者への影響や発生状況も見て判断しよう。

それは選択肢のひとつで、すべてのシステムに同じ設定が正解ではないよ。必要な記録、出力量、保存期間、調査にかかる負担を考える。障害調査で詳細ログを一時的に増やすときも、対象と期間を決めよう。出力先や個別のloggerに別の設定がないかも確認するんだ。

どのレベルでも、パスワードやアクセストークンなどの秘密を直接記録しないことが大切だよ。必要な追跡情報は、リクエストIDなどを適切に扱い、閲覧権限や保存期間も管理する。JSON形式で項目をそろえると検索しやすくなるけれど、それだけで秘密が保護されるわけではないんだ。

ログにレベルを付けることと、処理を止めることは別だよ。記録だけで自動終了するとは限らない。実際の動作は、使っているライブラリやプログラムの実装を確認しよう。ログレベルは、まず記録の分類と絞り込みのための目印なんだ。