ログとは？プログラムの動作を記録するしくみ

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

新人

「Springでアプリを作っているんですが、実行中に何が起きているのか分からないときがあります。どうやって確認すればいいですか？」

先輩

「それはいい質問ですね。プログラムの動作を確認するためには、“ログ”を出力するのが基本なんです。ログを見れば、Springアプリがどんな処理をしているのかが一目で分かりますよ。」

新人

「ログってよく聞くんですが、具体的には何を指しているんでしょうか？」

先輩

「簡単に言うと、アプリの動作を記録する“日誌”のようなものです。たとえば、どんなリクエストが来たのか、どこでエラーが発生したのかなどを自動的に出力します。」

1. ログとは？プログラムの動作を記録するしくみ

ログとは、アプリケーションが実行される中で発生した出来事を記録する仕組みのことです。例えば「ユーザーがログインした」「データベースに接続した」「エラーが発生した」などの情報を残しておくことで、あとから動作を追跡できるようにします。

Springアプリケーションでは、このログ出力を通じて動作確認やエラー解析を行います。特に開発中やトラブル発生時に、ログを確認することで原因を素早く見つけることができます。Javaの世界では、SLF4JやLogbackといったライブラリが標準的に使われています。

ログは単なる文字出力ではなく、開発者の目となる大切な情報源です。もしログを出さずに開発してしまうと、エラーが起きたときに原因を特定するのが非常に難しくなります。したがって、Springでの開発においてログ出力は欠かせない存在なのです。

2. なぜログが必要なのか？

ログが必要な理由は、プログラムの動作を「可視化」するためです。特に初心者がSpringを学ぶとき、動いている裏側の処理を理解するのは簡単ではありません。しかし、ログを出力しておけば、アプリがどのようにリクエストを処理しているのかを順番に確認できます。

例えば、ユーザーがボタンをクリックしたとき、Springのコントローラでそのイベントを受け取り、処理を実行します。そのとき、ログに「メソッドが呼び出された」「データベースにアクセスした」「処理が完了した」と出力されるので、どの段階で問題が起きたのかを判断できます。

トラブルシューティングの際にも、ログは非常に役立ちます。例えば、エラーが発生したときにスタックトレース（エラー内容の詳細）が記録されるため、原因を素早く見つけることができます。開発者にとってログは、まるで地図のように「どこで何が起きたのか」を示してくれるのです。

3. Springアプリでログを確認する基本的な流れ

それでは、実際にSpringアプリでログを出力する方法を見てみましょう。Spring BootではデフォルトでLogbackが設定されているため、特別な設定をしなくてもログが自動的に出力されます。Gradleで作成したプロジェクトなら、すぐにログを試すことができます。

例えば、次のような@Controllerを作成して、ログ出力を試してみましょう。


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;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
public class LogSampleController {

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

    @GetMapping("/log-test")
    @ResponseBody
    public String logTest() {
        logger.info("INFOレベルのログを出力しました。");
        logger.debug("DEBUGレベルのログを出力しました。");
        logger.error("ERRORレベルのログを出力しました。");
        return "ログ出力テスト完了";
    }
}

このコードを実行してブラウザからhttp://localhost:8080/log-testにアクセスすると、コンソールにログが出力されます。


INFO  com.example.demo.controller.LogSampleController : INFOレベルのログを出力しました。
DEBUG com.example.demo.controller.LogSampleController : DEBUGレベルのログを出力しました。
ERROR com.example.demo.controller.LogSampleController : ERRORレベルのログを出力しました。

このようにログレベルを分けることで、重要な情報だけを抽出したり、開発中は詳細な動作確認をしたりすることができます。特に初心者のうちは、INFOとERRORを中心に使うのがおすすめです。

Springのログは、application.propertiesで設定を変更することも可能です。例えば、次のように指定すればログレベルを変えられます。


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

この設定を入れることで、特定のパッケージだけ詳細なログを出すこともできます。これにより、不要な情報を減らしながら、必要な部分を重点的にデバッグできます。

Springのログ機能は非常に強力で、シンプルな構文で操作できるのが特徴です。開発環境であるpleiadesを使えば、実行時にコンソール上でログの動作を簡単に確認できます。

4. Springでログを出力するための基本設定

Springでログを出力する際には、application.propertiesを使って簡単に設定を変更できます。これは、Spring Bootアプリの「設定ファイル」であり、ログレベルや出力先などを制御することができます。pleiadesを使ってGradleプロジェクトを作成した場合でも、この設定ファイルはsrc/main/resourcesに自動的に作られています。

Spring Bootでは標準でLogbackというログライブラリが組み込まれており、特別な依存関係を追加する必要はありません。もし設定を変更したい場合は、以下のように記述します。


# ルート（全体）のログレベルをINFOに設定
logging.level.root=INFO

# 自分のアプリケーションパッケージのログをDEBUGに設定
logging.level.com.example.demo=DEBUG

# ログ出力のフォーマットを指定（時間やクラス名を含める）
logging.pattern.console=%d{yyyy-MM-dd HH:mm:ss} %-5level %logger{36} - %msg%n

このように設定すると、コンソールに時間付きでログが出力され、どのクラスでどんな処理が行われたかが見やすくなります。開発環境のpleiadesで実行した場合でも、コンソール上に見やすく整形されたログが表示されます。

また、もしログをファイルにも出力したい場合は、次の設定を追加します。


# ログをファイルにも出力
logging.file.name=application.log
logging.file.path=logs

この設定を追加すると、logsフォルダ内にapplication.logというファイルが生成され、アプリケーションの動作履歴を後から確認できます。特に運用環境では、ファイルに出力しておくことでトラブル発生時の調査がしやすくなります。

5. ログレベルの意味と使い分け

Springのログシステムでは、「ログレベル」を使って出力する情報の詳細度を調整します。これは、アプリケーションの状態や問題の深刻度に応じてメッセージを分類する仕組みです。代表的なログレベルは次のとおりです。

TRACE：最も詳細なログ。プログラムの全ての動作を追跡するレベル。
DEBUG：開発時のデバッグ向け。変数の値や処理の流れを確認するのに使う。
INFO：一般的な動作状況を示す。アプリの起動やリクエスト処理の成功など。
WARN：軽度の問題や注意すべき動作。動作には影響しないが確認が必要。
ERROR：重大なエラー。アプリの処理が途中で止まったり例外が発生した場合。

例えば、開発中はDEBUGレベルで詳細なログを確認し、運用中はINFOレベルで必要な情報だけを出すようにすると効率的です。

これらのレベルはapplication.propertiesで個別に設定できるため、クラスごとに異なるログレベルを指定することも可能です。次の例を見てみましょう。


# 全体をINFOに
logging.level.root=INFO

# データベース関連のパッケージだけをDEBUGに
logging.level.org.springframework.jdbc=DEBUG

このように設定すると、全体ではINFOレベルのログしか出ませんが、データベース周りの処理だけ詳細なログが出力されます。これにより、無駄な情報を減らしつつ必要なデバッグ情報を得ることができます。

6. 実際にログを出して確認する例

それでは、実際にSpringアプリケーションでログを出力してみましょう。今回は、@Controllerを使ってリクエストを受け取り、ログを出す簡単な例を紹介します。


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;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
public class LoggingController {

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

    @GetMapping("/check-log")
    @ResponseBody
    public String checkLog() {
        logger.trace("TRACEレベル：詳細なデバッグ情報");
        logger.debug("DEBUGレベル：処理の流れを確認");
        logger.info("INFOレベル：通常の動作を報告");
        logger.warn("WARNレベル：注意が必要な状況");
        logger.error("ERRORレベル：エラーが発生しました");
        return "ログ出力テスト完了";
    }
}

このコードを実行してhttp://localhost:8080/check-logにアクセスすると、コンソールに各レベルのログが表示されます。出力結果は次のようになります。


2025-10-08 10:01:15 TRACE com.example.demo.controller.LoggingController - TRACEレベル：詳細なデバッグ情報
2025-10-08 10:01:15 DEBUG com.example.demo.controller.LoggingController - DEBUGレベル：処理の流れを確認
2025-10-08 10:01:15 INFO  com.example.demo.controller.LoggingController - INFOレベル：通常の動作を報告
2025-10-08 10:01:15 WARN  com.example.demo.controller.LoggingController - WARNレベル：注意が必要な状況
2025-10-08 10:01:15 ERROR com.example.demo.controller.LoggingController - ERRORレベル：エラーが発生しました

この出力結果を見れば、各ログレベルの違いが明確に分かります。Springのログ設定を理解することで、開発中に発生する問題を早く発見できるようになります。

特に初心者の場合、DEBUGとERRORをうまく使い分けることで、プログラムの流れや例外発生箇所を素早く特定できるようになります。pleiades上で実行すれば、コンソールにリアルタイムでログが表示されるため、デバッグ効率が格段に上がります。

また、Springでは外部ライブラリを使わずとも、標準のLoggerFactoryだけで十分に実用的なログ管理が可能です。ログの出力先やレベルを調整するだけで、開発環境と本番環境の両方で使いやすいログ構成を実現できます。

7. デバッグ時にログを活用する方法

Springアプリケーションを開発していると、思った通りに動かないことがよくあります。そのときに役立つのがログを使ったデバッグです。ログは、プログラムが「今どこを通っているのか」「どのデータを処理しているのか」をリアルタイムで確認できる最強のツールです。特にpleiadesでGradleプロジェクトを実行している場合、コンソール画面にログが自動的に表示されるので、非常に便利です。

例えば、コントローラの中で複数の処理が行われるとき、途中の値を確認したいことがあります。そのような場合は、logger.debug()を使って変数の内容を出力します。次のように書くと、どこまで処理が進んでいるのかが一目で分かります。


@Controller
public class DebugExampleController {
    private static final Logger logger = LoggerFactory.getLogger(DebugExampleController.class);

    @GetMapping("/debug-test")
    @ResponseBody
    public String debugTest() {
        logger.info("メソッド開始");
        int result = 10 + 5;
        logger.debug("計算結果：" + result);
        if (result > 10) {
            logger.warn("結果が10を超えています");
        }
        logger.info("メソッド終了");
        return "デバッグ完了";
    }
}

このように、DEBUGレベルを活用すれば、変数の値や処理の流れを確認しながら動作を追跡できます。Springのログ出力では、通常のSystem.out.println()よりもはるかに効率的で、レベルごとの出力制御も簡単に行えます。

さらに、エラーが発生したときにはlogger.error()を使って例外の情報を出力します。例外オブジェクトを引数に渡すことで、原因箇所までスタックトレースを記録できます。デバッグ時にはこのエラー情報が非常に重要で、バグの再現や修正に直結します。

8. よくあるログ設定のミスとその対処法

Springでログ設定を行うとき、初心者がつまずきやすいのが「ログが出力されない」「レベルを変えても反映されない」といった問題です。これらは小さな設定ミスで起こることが多いため、ポイントを押さえておくことが大切です。

① ログレベル設定の記述ミス
一番多いのが、application.propertiesでのパッケージ指定ミスです。Springのログ設定では、完全修飾パッケージ名を正確に書く必要があります。例えば、logging.level.com.example.demo=DEBUGとするところをlogging.level.demo=DEBUGと短縮してしまうと、設定が反映されません。ログが出ない場合は、まず設定ファイルのスペルを確認しましょう。

② キャッシュや再ビルドの問題
pleiadesでGradleプロジェクトを使っている場合、設定を変更してもビルドキャッシュの影響でログが反映されないことがあります。そのときは「Gradleタスクの再実行」や「クリーンビルド」を試すと改善します。

③ ログ出力ライブラリの競合
まれに他の依存関係がlog4jなど別のロガーを読み込んでいる場合があります。Spring Bootでは標準でLogbackを使うため、競合している場合はgradle dependenciesコマンドで確認し、不要なロガーを除外しましょう。

④ 出力先の指定忘れ
ファイル出力を設定したのにログが保存されない場合、logging.file.pathやlogging.file.nameが正しく指定されていない可能性があります。特に相対パスを使うときは、プロジェクトルートからの位置を意識することが大切です。

このようなログ設定ミスは、開発環境の初期設定時によく発生します。設定が反映されないときは焦らず、まずapplication.propertiesの内容とログレベルを一行ずつ確認してみましょう。Springのログ設定は非常に柔軟ですが、正確な構文を守ることが前提です。

9. 実践的なヒント：開発環境と本番環境でのログ設定の違い

最後に、実際の開発現場でよく行われるログ設定の工夫を紹介します。Springでは同じアプリでも「開発環境」と「本番環境」で出力するログ内容を変えるのが一般的です。これを行うことで、開発時は詳細なデバッグができ、本番では必要最小限のログに絞ることができます。

開発環境（pleiadesで実行）では、主にDEBUGやTRACEレベルを使用します。これにより、クラスの呼び出し順序や変数の値を細かく追跡でき、動作確認やバグ修正がスムーズになります。例えば、次のように設定します。


# 開発環境向け設定
logging.level.root=DEBUG
logging.level.com.example.demo=DEBUG

一方で、本番環境ではINFOやWARNを中心に出力します。本番環境では大量のログを出すとストレージが圧迫されるため、問題発生時だけ確認できるように軽量化するのが基本です。


# 本番環境向け設定
logging.level.root=INFO
logging.level.com.example.demo=INFO
logging.file.name=/var/logs/application.log

また、Spring Bootではapplication.propertiesの代わりに、環境ごとの設定ファイルを分けて管理することもできます。たとえば、application-dev.propertiesとapplication-prod.propertiesを用意して、起動時にプロファイルを切り替える方法です。


spring.profiles.active=dev

この仕組みを使えば、同じソースコードでも環境に応じてログ出力内容を柔軟に変えられます。pleiadesのようなローカル環境で開発しているときはdevプロファイルを、本番サーバーではprodプロファイルを選択するのが自然です。

さらに、本番環境ではログをファイルに出力してローテーション管理することも重要です。一定期間が過ぎた古いログを自動で削除する設定を行えば、ディスク容量を圧迫せずに長期間の履歴を残せます。これはlogback-spring.xmlを使って細かく制御することも可能ですが、初心者のうちはapplication.propertiesで十分です。

このように、Springのログ出力は環境ごとに最適化することで、デバッグの効率を上げながら運用トラブルにも備えることができます。開発段階では「細かく」「多く」出し、本番では「簡潔に」「必要なだけ」出すという考え方が基本です。

ログは単なる文字の羅列ではなく、アプリケーションの健康状態を把握するための大切な情報です。適切に設定し、正しく活用することで、Springアプリの品質と安定性を大きく向上させることができます。