application.ymlでログレベルを変更する方法｜Spring Bootのログ設定をわかりやすく解説

application.ymlでログレベルを変更する方法

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

新人

「Spring Bootのログが多すぎて見づらいんですけど、ログレベルって変更できるんですか？」

先輩

「いい質問だね。Spring Bootでは、application.ymlを使ってログレベルを簡単に変更できるんだ。」

新人

「設定ファイルでログの出力内容をコントロールできるんですか？便利そうですね！」

先輩

「そうだよ。特に開発中はDEBUGレベル、本番ではINFOやWARNにしておくことで、必要な情報だけを表示できるんだ。」

新人

「なるほど！では、その設定方法を教えてください！」

1. Spring Bootにおけるログ設定の基本（ログレベルとは？）

Spring Bootでは、アプリケーションの動作状況を確認するためにログを出力します。ログは、開発やデバッグの際にとても重要な役割を果たします。特に、エラーの原因を特定したり、処理の流れを追跡するためにログ出力は欠かせません。

ログレベルとは、どの程度の詳細情報を出力するかを制御する設定のことです。Spring Bootでは主に以下のログレベルが使われます。

TRACE：最も詳細なログ。処理の細かい流れまで出力する。
DEBUG：デバッグ用の情報を出力。開発中によく使われる。
INFO：アプリの一般的な動作状況を示す。
WARN：警告レベルのログ。注意が必要な状況を出力。
ERROR：エラー発生時に出力。致命的な問題の確認に使用。

たとえば、ログレベルをDEBUGに設定すると、より多くの内部処理の情報が出力されます。逆にINFOやWARNにすると、必要最小限の情報だけが表示されるため、コンソールがスッキリします。

Spring Bootでは、デフォルトでINFOレベルのログが出力されますが、プロジェクトの性質に応じて変更することが可能です。

2. application.ymlでログレベルを変更できる理由と仕組み

Spring Bootのログ設定は、application.ymlまたはapplication.propertiesに記述できます。ここでyml形式を使うと、階層構造が見やすく整理できるため、多くの開発者に好まれています。

Spring Bootは内部的にSpring Boot Logging（Logback）という仕組みを使っています。この仕組みが、application.ymlの設定を読み取り、指定されたパッケージやクラスごとにログレベルを制御しています。

つまり、特定のパッケージだけDEBUGにして、それ以外はINFOのままにすることもできます。これにより、必要な部分だけを詳細にデバッグし、全体のログ量を抑えることができます。

基本的な書き方は以下のようになります。


logging:
  level:
    root: INFO
    com.example.demo: DEBUG

この例では、アプリ全体（root）のログレベルをINFOに設定し、特定のパッケージ（com.example.demo）だけをDEBUGにしています。

このように、application.ymlに記述することで、Spring Boot起動時に自動的にログ設定が反映されます。特別なコードを書かなくても、設定ファイルの変更だけでログ出力を制御できるのが大きな特徴です。

@Controllerでログを出力する基本コード例

実際に@Controllerでログを出力してみましょう。LoggerFactoryを使って、クラスごとにロガーを作成します。


package com.example.demo.controller;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;

@Controller
public class LogExampleController {

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

    @GetMapping("/logtest")
    public String logTest() {
        logger.trace("TRACEログです");
        logger.debug("DEBUGログです");
        logger.info("INFOログです");
        logger.warn("WARNログです");
        logger.error("ERRORログです");
        return "logTest";
    }
}

上記のようにログを出力しておくと、application.ymlの設定によって、どのレベルまで表示するかが自動的に切り替わります。

この仕組みを理解しておくと、開発中のデバッグや本番環境の監視を効率的に行うことができます。

ログ設定は、Spring Bootのデバッグ効率を大きく左右する重要なポイントです。特に、application.ymlを使うことで、視覚的にも整理しやすく、開発環境と本番環境で異なる設定を簡単に切り替えることができます。次のステップでは、環境ごとのログ設定についてさらに深く学んでいきましょう。

3. application.ymlの基本構造とログ設定の書き方

application.ymlは、Spring Bootの設定をまとめて管理するためのファイルで、アプリケーション全体の動作に関わる重要な役割を持っています。このファイルを理解しておくと、ログ設定だけでなく、データベース接続やサーバーポートなども簡単に管理できるようになります。

yml形式の特徴は、階層構造をインデントで表現できる点です。これにより、設定の関連性が視覚的に分かりやすく、読みやすいファイルになります。

Spring Bootのログ設定をする場合、最も基本的な書き方は次のようになります。


logging:
  level:
    root: INFO

この設定では、アプリ全体のログレベルをINFOに指定しています。つまり、INFO以上のレベル（WARNやERRORなど）が出力され、DEBUGやTRACEのような詳細なログは表示されません。

特定のパッケージやクラスだけにログ設定を適用することも可能です。たとえば、コントローラ層だけ詳細なログを出したい場合は、次のように書きます。


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

これにより、com.example.demo.controllerパッケージ配下のログだけDEBUGレベルで出力され、それ以外はINFOレベルのままになります。このようにapplication.ymlを使えば、パッケージ単位で細かく制御でき、不要なログを減らしながら重要な情報を効率的に確認できます。

Spring Bootのログはアプリ起動時にapplication.ymlを読み込み、設定に応じてLogbackが動作します。そのため、設定を変更した後はアプリを再起動することで、すぐに変更が反映されます。

4. ログレベル（TRACE／DEBUG／INFO／WARN／ERROR）の違いと使い分け

Spring Bootのログには、主に5種類のレベルがあります。それぞれの意味を理解して適切に使い分けることで、効率的なデバッグが可能になります。

TRACE：最も詳細なレベルで、プログラムの流れをすべて追跡します。通常はトラブル解析や内部動作の確認に使用します。
DEBUG：開発中のデバッグ用途に最適です。メソッドの動作や変数の値を確認する際に使用します。
INFO：アプリの正常な動作を確認するためのレベルです。アプリ起動や主要な処理の完了メッセージを表示します。
WARN：軽度の問題や将来的に不具合になりそうな状況を知らせます。
ERROR：実際に異常が発生したときに出力されるレベルです。例外や致命的なエラーの原因を特定するのに使います。

例えば、開発中に処理の流れを確認したい場合はDEBUGを使い、本番環境では必要最低限のINFOやWARNにしておくのが一般的です。

以下は、各ログレベルの出力例です。設定によって、どのレベルのログが表示されるかを確認できます。


2025-10-08 10:00:01 TRACE com.example.demo.controller.LogExampleController - TRACEログです
2025-10-08 10:00:01 DEBUG com.example.demo.controller.LogExampleController - DEBUGログです
2025-10-08 10:00:01 INFO  com.example.demo.controller.LogExampleController - INFOログです
2025-10-08 10:00:01 WARN  com.example.demo.controller.LogExampleController - WARNログです
2025-10-08 10:00:01 ERROR com.example.demo.controller.LogExampleController - ERRORログです

application.ymlでINFOを指定している場合、上記のうちINFO以上のログ（WARN・ERROR）だけが表示されます。これにより、開発段階と本番環境で出力する情報量を適切に調整できます。

Spring Bootでは、ログ設定を環境ごとに切り替えることで、デバッグ中は詳細な情報、本番では必要最低限の情報だけを出すといった柔軟な運用が可能になります。

5. @Controllerクラスでログ出力を確認する実例

では実際に、@Controllerクラスを使ってログ出力を確認してみましょう。LoggerFactoryを使うことで、任意のクラスからログを出力できます。以下は具体的なサンプルコードです。


package com.example.demo.controller;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;

@Controller
public class LogCheckController {

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

    @GetMapping("/checklog")
    public String checkLog() {
        logger.trace("TRACEレベルのログです");
        logger.debug("DEBUGレベルのログです");
        logger.info("INFOレベルのログです");
        logger.warn("WARNレベルのログです");
        logger.error("ERRORレベルのログです");
        return "checklog";
    }
}

上記のコードを実行してブラウザで/checklogにアクセスすると、コンソールにログが出力されます。ここで、application.ymlで設定したログレベルに応じて、表示される内容が変わります。

たとえば、application.ymlを次のように設定した場合を考えてみましょう。


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

この設定では、コントローラ内でDEBUG以上のログ（INFO・WARN・ERROR）が出力されます。一方で、TRACEは表示されません。これをTRACEに変更すると、すべてのログが表示されるようになります。

このように、Spring Bootのログ設定を理解しておくと、デバッグ作業を効率化し、不要な情報に惑わされずにエラーの原因を特定できます。特にapplication.ymlを使えば、わざわざコードを書き換えることなく設定を変更できるため、開発中にも非常に便利です。

また、Gradleプロジェクトであっても、build.gradleに特別な設定を追加する必要はなく、application.ymlだけで簡単に制御できます。この点もSpring Bootの魅力の一つです。

ログレベルを状況に応じて切り替えながら使い分けることで、開発スピードと品質を両立できます。次のステップでは、より実践的な環境別のログ設定方法について理解を深めていきましょう。

6. パッケージ別にログレベルを変更する方法

Spring Bootでは、application.ymlを使ってパッケージごとにログレベルを細かく設定することができます。これにより、プロジェクト全体のログを制御しながら、特定の部分だけ詳細な情報を確認できるようになります。たとえば、コントローラ層ではリクエストの流れを詳しく追いたいけれど、サービス層やリポジトリ層は通常のログで十分という場合に便利です。

具体的な設定例を見てみましょう。


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

この設定では、アプリ全体のログレベルをINFOにしつつ、controllerパッケージだけをDEBUGにしています。これにより、コントローラの詳細な動作を追跡しながら、他の層では必要最低限のログを出すことができます。

このようにパッケージごとにログレベルを調整することで、開発中にどの処理がボトルネックになっているのか、エラーがどのレイヤーで発生しているのかを素早く特定できます。逆に、全レイヤーをDEBUGにするとログが膨大になり、重要な情報が埋もれてしまうこともあるため、範囲を絞るのがポイントです。

また、Spring Bootではクラス単位でもログレベルを設定することができます。以下のように、特定のクラス名まで指定することで、さらに細かい制御が可能です。


logging:
  level:
    com.example.demo.controller.LogCheckController: TRACE

これにより、そのクラスだけ詳細なログを確認できます。特定の機能に不具合がある場合など、部分的なデバッグに非常に役立ちます。

パッケージ別ログ設定を活用すると、Spring Bootのログ出力をよりスマートに管理でき、application.yml ログ設定の柔軟さを実感できるでしょう。

7. 環境ごと（開発／本番）にログレベルを切り替える設定例

次に、開発環境と本番環境でログレベルを切り替える方法を見ていきましょう。Spring Bootでは、プロファイル機能を利用して環境ごとに異なる設定ファイルを適用できます。これにより、開発中は詳細なログ、本番では必要最低限のログを出力する、といった運用が簡単に行えます。

まず、開発用の設定ファイルapplication-dev.ymlと本番用のapplication-prod.ymlを用意します。Spring Bootはアクティブなプロファイルに応じて自動的にこれらを読み込みます。


# application-dev.yml（開発環境）
logging:
  level:
    root: DEBUG
    com.example.demo: DEBUG


# application-prod.yml（本番環境）
logging:
  level:
    root: WARN
    com.example.demo: INFO

上記のように設定すると、開発環境ではDEBUGレベルで詳細な動作を確認でき、本番環境では警告以上のログだけを出力します。これにより、本番のコンソールが不要な情報で溢れるのを防ぎ、トラブル発生時に重要なメッセージだけを確認できます。

どの環境の設定を使うかは、application.ymlで指定します。以下のように記述します。


spring:
  profiles:
    active: dev

この設定により、アプリ起動時にapplication-dev.ymlが読み込まれます。本番にデプロイする際はactive: prodに切り替えるだけで、ログレベルや設定全体を簡単に変更できます。

このプロファイル機能は、Spring Bootの大きな特徴のひとつです。特にpleiadesでのGradle構成では、プロジェクトを再起動するだけで環境ごとの設定が反映されるため、開発効率が高まります。

また、実務では環境変数や起動オプションを使ってプロファイルを切り替えることもよくあります。たとえばコマンドラインで次のように実行します。


java -jar demo.jar --spring.profiles.active=prod

このようにすることで、application-prod.ymlの設定が自動的に適用されます。設定ファイルを直接書き換える必要がないため、安全に運用できます。

環境ごとのログ設定を活用することで、開発時のデバッグ効率と本番の安定性を両立できます。特にSpring Bootのログ出力は柔軟に制御できるため、アプリの成長に合わせて最適化していくことが大切です。

8. よくあるエラーとデバッグ時の注意点

最後に、application.yml ログ設定を行う際によくあるエラーと、その対処法について見ていきましょう。初心者がつまずきやすいポイントを理解しておくと、設定変更時のトラブルを未然に防げます。

まず多いのが、インデントのずれによる構文エラーです。ymlはスペースの数で階層を表現するため、タブではなくスペースで揃える必要があります。タブを混ぜるとSpring Bootが正しく読み取れず、起動時にエラーが発生します。


# ❌ 間違った例（タブ使用）
logging:
	level:
		root: INFO

このようにタブを使うと構文エラーになります。正しくは次のようにスペースで揃えましょう。


# ✅ 正しい例（スペース使用）
logging:
  level:
    root: INFO

次に、ログレベルの指定ミスにも注意が必要です。Spring Bootでは大文字のTRACE・DEBUG・INFO・WARN・ERRORのみが有効です。小文字で書くと認識されない場合があります。

また、設定を変更してもログが反映されない場合は、アプリの再起動を忘れているケースが多いです。Spring Bootは起動時にapplication.ymlを読み込むため、設定変更後は必ず再起動しましょう。

もうひとつの注意点として、複数の設定ファイルがある場合の優先順位にも気をつけてください。Spring Bootは、application.yml → application-{profile}.yml の順で設定を読み込みます。つまり、プロファイルごとの設定が最終的に上書きされるため、思った通りにログが出ない場合はどのファイルが読み込まれているかを確認しましょう。

さらに、ログ出力先をファイルに変更している場合は、ファイルのパスや権限設定にも注意が必要です。ログファイルが作成されないときは、書き込み権限がないディレクトリを指定している可能性があります。

デバッグ時には、まずapplication.ymlの構文、次にログレベル、最後にプロファイル設定の順で確認すると原因を特定しやすくなります。

Spring Bootのログ出力は非常に強力ですが、ちょっとしたミスで思わぬ動作をすることもあります。特にpleiades＋Gradle構成で開発している場合は、再ビルドやクリーン実行でキャッシュをクリアしてから確認すると確実です。

このように、application.ymlを使ったログレベル管理を正しく理解すれば、開発と運用の両方で安定したアプリケーション監視が可能になります。設定ファイルの整備は一見地味ですが、トラブルシューティングの第一歩として非常に重要な作業です。