ログの出力レベルを変更するには？初心者向けSpring logging.levelの基本解説

新人と先輩の会話形式で理解しよう

新人

「アプリケーションの動作を確認するために、ログをもっと詳しく見たいんですけど、どうすればいいんでしょうか？」

先輩

「ログはアプリケーションの状態やエラーを把握するのに非常に役立ちますよ。Spring Bootではlogging.levelを設定すれば、ログの出力レベルを簡単に変えられます。」

新人

「なるほど！でもそもそも、ログって何のためにあるんですか？」

先輩

「じゃあまずは、ログの基本から見ていこうか！」

1. ログとは何か？アプリ開発に欠かせない仕組み

ログとは、アプリケーションの処理の流れやエラー、警告、情報などを記録する仕組みです。プログラムがどのように動作したか、何が起こったかを確認する手がかりになります。

ログを活用することで、以下のようなメリットがあります：

アプリが正常に動作しているか確認できる
不具合が起きたときに原因を追跡できる
利用者の操作履歴を記録できる

開発中だけでなく、本番環境でもログはとても重要です。とくに本番環境では、ログが唯一の「証拠」になることもあります。

Spring Bootでは、開発者がログを簡単に制御できるように、プロパティファイル（application.ymlなど）を通じて設定できるようになっています。

2. Spring Bootにおけるログ出力の仕組み

Spring Bootのプロジェクトでは、デフォルトでログ機能が組み込まれています。ログは主に「SLF4J（Simple Logging Facade for Java）」と「Logback」という2つの仕組みによって制御されています。

特別な設定をしなくても、Spring Bootアプリを起動すると、コンソールにログが出力されるのを見たことがあると思います。

そのログには、次のような情報が含まれています：

ログレベル（INFOやERRORなど）
タイムスタンプ（日付と時刻）
出力元のクラス名
ログメッセージ

例えば、Spring Bootを起動したときのログの一部は次のようになります：


2025-08-07 10:00:00.123  INFO 12345 --- [  main] com.example.demo.DemoApplication : Starting DemoApplication

この例では、INFOがログのレベルで、「Starting DemoApplication」というメッセージが出力されています。

では、この「INFO」や「DEBUG」などのログレベルはどうやって制御できるのでしょうか？

その答えが「logging.level」の設定です。次回はこのプロパティの使い方と、どんなレベルがあるのかを詳しく解説していきます。

3. logging.levelの基本的な書き方（application.ymlの設定方法）

Spring Bootでは、application.ymlファイルを使ってログの出力レベルを細かく設定することができます。これにより、ログを必要なレベルだけ表示するように調整できるため、開発やデバッグが非常に効率的になります。

基本的な書き方は以下のとおりです：


logging:
  level:
    root: INFO

この例では、すべてのログ出力のルート（親）に対してINFOレベルが適用されます。つまり、INFO以上のログ（INFO、WARN、ERROR）が出力され、DEBUGやTRACEは表示されません。

logging.level.rootは全体に対しての設定ですが、個別のクラスやパッケージに対して設定することもできます。それについては後ほど詳しく説明します。

設定ファイルの場所は、通常src/main/resources/application.ymlにあります。Pleiadesを使ってSpring Bootプロジェクトを作成した場合も、Gradle構成でこの場所にファイルが配置されています。

4. ログレベルの種類と違い（ERROR, WARN, INFO, DEBUG, TRACE）

Spring Bootで使用できるログレベルは、重要度の高い順から次の5つがあります：

ERROR：アプリケーションの致命的な問題
WARN：注意すべき警告
INFO：一般的な情報
DEBUG：開発中の詳細な動作確認
TRACE：さらに細かい詳細なログ（トレース）

それぞれの使い分けは以下の通りです：

ERRORは、予期しないエラーが発生したときに出力します。たとえばDB接続失敗などです。
WARNは、すぐには問題とならないが注意が必要な場合に使います。
INFOは、正常な処理の結果などを記録するのに適しています。
DEBUGは、変数の中身や処理の流れなど、開発中に役立つ情報を出力します。
TRACEは、メソッドの呼び出しなどをすべて記録するレベルで、かなり詳細です。

例えば、開発中はDEBUGやTRACEを使って詳細にログを出し、本番環境ではINFOやWARNにするのが一般的です。

以下は、application.ymlでログレベルをDEBUGに設定する例です：


logging:
  level:
    root: DEBUG

このように設定すると、Spring Boot全体のログ出力がDEBUG以上になります。

5. 特定のクラスやパッケージごとにログレベルを変更する方法

アプリケーション全体ではなく、一部のクラスやパッケージだけのログ出力レベルを変更したい場合もあります。Spring Bootでは、logging.levelのキーにパッケージ名を指定することで対応できます。

たとえば、コントローラパッケージcom.example.demo.controllerだけDEBUGにしたい場合は、以下のように設定します：


logging:
  level:
    com.example.demo.controller: DEBUG

このようにすることで、コントローラ関連のログだけが詳細に出力され、その他の部分はrootの設定に従います。

複数のパッケージやクラスごとにレベルを変えたい場合は、以下のように複数設定できます：


logging:
  level:
    root: WARN
    com.example.demo.repository: ERROR
    com.example.demo.service: INFO
    com.example.demo.controller: DEBUG

この設定では、全体はWARN、リポジトリはERROR、サービス層はINFO、コントローラ層はDEBUGというように、細かく制御できます。

これにより、不要なログを減らしつつ、必要な情報だけを取得することが可能になります。ログの出力量をコントロールすることで、デバッグの効率が格段に上がるため非常におすすめです。

Spring Bootのapplication.ymlを活用することで、開発・テスト・本番それぞれの環境で最適なログ出力が実現できます。

6. 複数環境でログレベルを切り替える方法（application-dev.ymlなどの活用）

開発環境と本番環境では、求められるログの出力内容が異なります。開発中は細かくログを出して原因を探りたいですが、本番ではログが多すぎると逆にノイズになってしまいます。

Spring Bootでは、プロファイルごとに設定ファイルを分けることで、環境に応じたログ出力の制御ができます。たとえば、開発用にはapplication-dev.yml、本番用にはapplication-prod.ymlというように分けて管理します。

以下は、開発用のapplication-dev.ymlでログレベルをDEBUGに設定する例です：


logging:
  level:
    root: DEBUG

そして、本番用のapplication-prod.ymlではログレベルをWARNに抑えることが一般的です：


logging:
  level:
    root: WARN

これらの設定ファイルを有効にするには、メインのapplication.ymlにアクティブプロファイルを記述します：


spring:
  profiles:
    active: dev

この設定によって、Spring Bootはapplication-dev.ymlを読み込み、指定したログレベルでアプリケーションを実行します。開発時はdev、本番デプロイ時にはprodに切り替えることで、ログの出力内容も自然に切り替わります。

環境によって適切なログレベルを設定しておくことで、ログの見やすさとトラブル対応のしやすさが大きく向上します。

7. よくあるトラブルとその対処法（ログが出力されない・反映されないなど）

ログの設定を変更したのに、思った通りにログが出力されない……というトラブルは意外とよくあります。ここでは、初心者が陥りやすい代表的な問題とその解決方法を紹介します。

ログが出力されない

ログが一切表示されない場合、次のポイントを確認しましょう：

ファイル名が正しいか：application.ymlと記述されているか。拡張子やファイル名の誤りに注意。
ファイルの配置場所：src/main/resourcesディレクトリに配置されているか。
設定のインデント：YAMLはインデントが重要。スペースの数が正しいか確認。
プロファイルの指定：複数のプロファイルを使っている場合、対象のプロファイルがアクティブになっているか。

ログレベルが反映されない

ログレベルを変更しても期待した内容が出力されない場合は、以下の点を確認してみてください：

対象のパッケージ名やクラス名が正確か：たとえばcom.example.demo.controllerと記述しても、実際のクラスが別のパッケージにあると反映されません。
複数の設定ファイルに同じキーがある：application.ymlとapplication-dev.ymlに同じキーがあると、優先順位に注意が必要です。
キャッシュやビルド結果が古い：一度Gradleでクリーンビルドすることで反映されることがあります。

これらのポイントを一つずつ確認していくことで、「Spring ログ設定切り替えがうまくいかない」といった問題も解決に近づけます。

8. ログ出力レベルを使いこなすことで得られるメリット

logging.levelを使いこなすことで、Spring Bootのアプリケーション開発はより効率的になります。特に開発中や運用中にログが正しく出力されることで、次のようなメリットがあります：

原因の特定が速くなる：DEBUGやTRACEを活用すれば、処理の流れや変数の中身を追いやすくなります。
本番運用が安定する：INFOやWARNに絞ってログを出すことで、重要な情報に集中できます。
ログを使った監視や通知に応用できる：ERRORレベルのログを検知して通知を飛ばす仕組みなども構築できます。

たとえば、以下のようなDEBUGログを出力しておくと、何か問題があったときの手がかりになります：


import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

@Controller
public class SampleController {

    private static final Logger logger = LoggerFactory.getLogger(SampleController.class);

    public String hello() {
        logger.debug("hello()メソッドが呼び出されました");
        return "hello";
    }
}

このようなログを設定されたレベルに応じて出力することで、Spring Bootアプリの状態が「見える化」され、より安定した運用につながります。

Spring Bootでは、こうした細かいログ設定が簡単にできるので、ぜひapplication.ymlとlogging.levelの活用方法を習得しておきましょう。

まとめ

Spring Bootのログ出力レベルを理解することは、あらゆるアプリケーション開発において非常に重要であり、特に初心者がつまずきやすい領域である「logging.level 設定」「application.yml 操作」「ログレベルの切り替え」「開発環境と本番環境のプロファイル管理」などを正しく理解することは、Spring アプリ開発の品質を大きく左右します。ログはただの文字列ではなく、あらゆる不具合の原因追跡やパフォーマンス監視、エラー検出、運用時の障害調査に欠かせない重大な情報源です。とくに、デバッグ作業ではログの内容が決定的なヒントとなり、また本番環境ではログが数少ない観測情報となるため、ログ出力調整の知識は初心者だけでなく経験者にも求められる基本スキルです。 Spring Boot における logging.level の設定は非常に柔軟であり、「root 設定」でアプリ全体を制御する方法、「パッケージ単位の設定」で必要箇所だけログレベルを詳細化する方法、「プロファイルごとのログ切り替え」で開発時は DEBUG、本番時は INFO もしくは WARN のように環境別の最適化を行う方法などが選べます。こうした粒度の細かい制御を行うことで、ログが多すぎて読みづらいという問題や、逆に情報が不足して原因追跡が困難になるといった問題を解消でき、開発効率と運用効率が大幅に高まります。また、YAML特有のインデントミスやファイル名の誤記、複数プロファイル併用時の優先順位、キャッシュによる設定未反映など、初心者が陥りがちな落とし穴も多く存在します。だからこそ、ログ出力レベルの基礎だけでなく、実際のトラブル対処方法も理解しておくことが重要であり、この記事で扱った内容を体系的に理解することで、ログ設定の問題に対して自信を持って取り組めるようになります。実際のログ活用シーンでは、エラー発生時の ERROR ログ、警告を知らせる WARN ログ、実行状況を知らせる INFO ログ、開発時に役立つ DEBUG ログ、超詳細な TRACE ログを使い分け、必要な情報だけを効率よく収集することが求められます。特に Spring MVC やサービス層、リポジトリ層の動作確認では DEBUG ログが有効であり、一部の詳細な処理確認には TRACE が欠かせません。 Spring Boot の logging.level は、以下のようなサンプルコードのように簡潔に記述しつつ、高度な制御も可能です。


logging:
  level:
    root: INFO
    com.example.demo.controller: DEBUG
    com.example.demo.service: INFO
    com.example.demo.repository: ERROR

このように、ログレベルを丁寧に設計し適切に設定することで、アプリケーション全体の動作が「見える化」され、トラブルシューティングの速度も向上し、より安定した開発と運用が実現できます。Spring Boot のログ機能は非常に強力であり、初心者の段階から積極的に使いこなすことで、アプリケーション理解の深まりだけでなく、問題解決力の向上にもつながります。ログ設定は単なる環境設定ではなく、アプリケーションの品質向上に直結する重要な技術であることをしっかり意識しておきましょう。

新卒エンジニアと先輩社員の振り返り会話

新人：「きょうの記事で、Spring Boot のログ設定がすごく大事だということがようやく理解できました。特に logging.level でパッケージごとにログを変えられるなんて全然知りませんでした。」

先輩：「そうそう。ログの量を適切に調整できるかどうかで、デバッグや障害対応の難易度がぜんぜん違うんだ。細かい挙動を知りたい時は DEBUG、本番では INFO や WARN を使うのが鉄則だよ。」

新人：「application-dev.yml と application-prod.yml を使って環境ごとにログレベルを変える方法も便利ですね！これなら間違って本番で DEBUG を使ってしまう心配も減りますね。」

先輩：「そのとおり。環境別設定を覚えると、実務でもかなり便利だよ。ログはシステムの健康状態を教えてくれる重要な情報源だから、毎日意識して触れていくと理解がどんどん深まるよ。」

新人：「はい！これからはログを見るのが怖くなくなりそうです。logging.level の設定もしっかり使いこなせるように練習してみます！」

先輩：「いいね！ログを味方にすれば開発スピードも上がるし、問題対応力も鍛えられるよ。今日の学びを次の開発でぜひ活かしてね。」