ログレベルとは何ですか？

アプリケーションが出力するログの重要度を段階的に分類する仕組み。DEBUG、INFO、WARN、ERRORなどがある。

ログレベルのポイントは？

DEBUG < INFO < WARN < ERROR < FATAL の順に重要度が上がる。本番環境ではINFO以上、開発環境ではDEBUGレベルに設定するのが一般的。ログレベルの設定で出力量を制御し、パフォーマンスとデバッグのバランスを取る。構造化ログ（JSON形式）と組み合わせると検索・分析が容易になる

【ろぐれべる】

ログレベルとは？

💡 ログの「重要度フィルター」

📌 このページのポイント

DEBUG < INFO < WARN < ERROR < FATAL の順に重要度が上がる
本番環境ではINFO以上、開発環境ではDEBUGレベルに設定するのが一般的
ログレベルの設定で出力量を制御し、パフォーマンスとデバッグのバランスを取る
構造化ログ（JSON形式）と組み合わせると検索・分析が容易になる

ログレベルのイメージ

ひよこ

ログレベルにはどんな種類があるの？

ペンギン先生

一般的には5段階だよ。DEBUG（開発者向けの詳細情報）、INFO（正常動作の記録）、WARN（問題の予兆だが動作は継続）、ERROR（エラー発生、一部機能に影響）、FATAL（致命的エラー、アプリ停止）。ライブラリによってはTRACEという最も詳細なレベルもあるよ

ひよこ

本番環境でDEBUGログを出すとダメなの？

ペンギン先生

DEBUGログは大量に出力されるから、本番環境で有効にするとディスクを圧迫してパフォーマンスも低下する。さらにDEBUGログにユーザーの個人情報が含まれていると情報漏洩リスクにもなる。本番ではINFO以上に設定して、障害調査時だけ一時的にDEBUGに下げるのが定番だよ

ひよこ

WARNとERRORの使い分けは？

ペンギン先生

WARNは「今は動いてるけど放置するとマズい」状況。例えばディスク使用率80%超え、リトライで成功した通信など。ERRORは「処理が失敗した」状況。例えばDB接続エラー、外部API呼び出し失敗など。WARNは予防的に対処、ERRORは即座に対応が必要、という運用上の違いがあるよ

ひよこ

ログの書き方で注意することは？

ペンギン先生

①パスワードやトークンをログに出さない、②ログメッセージに文脈情報（リクエストID、ユーザーIDなど）を含める、③構造化ログ（JSON）にすると後からの検索が楽、④ログの出力先をファイルだけでなくCloudWatch LogsやDatadogなどの集約基盤に送ると障害調査が捗るよ

まとめ：ざっくりこれだけ覚えればOK！

「ログレベル」って出てきたら「ログの重要度を段階分けする仕組み」と思えればだいたいOK！

📖 おまけ：英語の意味

「Log Level」＝ログの重要度段階

💬 Level（段階）でログの重要度を階層化する。フィルターのように不要なログを除外できるよ

← 用語集にもどる

ログレベル とは？

ログレベルとは？