ログ出力とSystem.out.printlnとの違いをやさしく解説！Spring Bootでのログ出力を基礎から理解しよう

System.out.printlnとの違いをやさしく解説

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

新人

「先輩、JavaでよくSystem.out.printlnって使いますけど、Spring Bootでは別の方法でログを出すって聞きました。何が違うんですか？」

先輩

「良い質問だね。確かにSystem.out.printlnはJavaの標準出力だけど、Spring Bootではもっと便利で実践的なログ出力方法が用意されているんだ。」

新人

「標準出力とログって何が違うんですか？」

先輩

「その違いをわかりやすく説明していこう。まずはSystem.out.printlnの基本から見てみようか。」

1. System.out.printlnとは？

System.out.printlnは、Javaで最も基本的な出力方法のひとつで、コンソールに文字列を表示するために使われます。主にデバッグや動作確認などの目的で利用されることが多いです。

例えば次のように使います。


public class HelloExample {
    public static void main(String[] args) {
        System.out.println("こんにちは、Javaの世界！");
    }
}


こんにちは、Javaの世界！

このように実行すると、コンソール上にメッセージが表示されます。シンプルで分かりやすいですが、実際の開発現場では問題点もあります。

例えば、出力先を変えられない、ログのレベル（INFO・WARN・ERRORなど）を分けられない、日時やクラス名などの情報が自動で出ないといった制限があります。

特にSpring BootのようなWebアプリケーション開発では、複数のリクエストが同時に処理されるため、単純な標準出力では原因を追うのが難しくなります。

2. Spring Bootでログを出力する方法との違い

Spring Bootでは、ログ出力専用の仕組みを備えています。代表的なのが、org.slf4j.LoggerとLoggerFactoryを利用する方法です。これによって、ログの出力レベルやフォーマット、出力先（ファイル・コンソールなど）を柔軟に設定できます。


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("/log")
    public String logExample() {
        logger.info("INFOレベルのログを出力します");
        logger.warn("WARNレベルのログです");
        logger.error("ERRORレベルのログが発生しました");
        return "index";
    }
}


2025-10-08 10:00:00 INFO  LogExampleController - INFOレベルのログを出力します
2025-10-08 10:00:00 WARN  LogExampleController - WARNレベルのログです
2025-10-08 10:00:00 ERROR LogExampleController - ERRORレベルのログが発生しました

このように、Spring Bootのログ機能では、メッセージに加えて日時・クラス名・ログレベルなどが自動で出力されます。しかもログレベルを指定して必要な情報だけを表示できるため、開発中や本番環境でのトラブル調査にとても役立ちます。

一方で、System.out.printlnではこれらの情報をすべて自分で出力しなければならず、規模の大きなアプリケーションでは管理が難しくなります。

また、Spring Bootのログ出力は内部的にLogbackやSLF4Jを利用しており、アプリケーションの規模に合わせて柔軟に設定可能です。たとえば、application.propertiesに設定を書くだけで、出力するログレベルを変えられます。


logging.level.root=INFO
logging.level.com.example=DEBUG
logging.file.name=app.log

この設定をすると、ルートログはINFO以上を出力し、特定のパッケージだけDEBUGレベルのログを出すことができます。さらに、app.logファイルにログを保存できるため、あとから確認するのも簡単です。

Spring Boot ログを使えば、開発中のデバッグ・本番環境の監視・障害対応まで一貫して効率的に管理できます。対して、System.out.printlnは単なる標準出力であり、ログ管理には向きません。

新人

「なるほど、ログと標準出力って目的が違うんですね。」

先輩

「その通り。開発中の簡単な確認ならSystem.out.printlnでもいいけど、チーム開発や本番運用を考えるなら、Spring Bootのログ出力を使うのが正解だね。」

新人

「これでSpring Boot ログとSystem.out.printlnの違いがよくわかりました！」

3. System.out.printlnを使う場合の問題点

System.out.printlnは手軽に使える一方で、開発規模が大きくなるほどさまざまな問題が表面化します。ここでは代表的な三つの課題を整理してみましょう。

① パフォーマンスの低下

コンソールへの出力は意外と処理コストが高く、大量にSystem.out.printlnを呼び出すとプログラムの実行速度が低下します。特にループの中やリクエストごとに出力してしまうと、処理が遅くなるだけでなく、ログが膨大になり読み取りづらくなります。

② 出力内容が見づらい

System.out.printlnで出したメッセージは、すべて同じフォーマットで並んで表示されます。日時やクラス名が含まれないため、いつどこで発生した出力なのかを後から追跡するのが困難です。チーム開発では特に、複数人が同時に標準出力を使うと、誰のログか分からなくなることもあります。

③ 出力制御が難しい

Spring Bootのようなフレームワークでは、環境ごとに出力を制御することが求められます。しかしSystem.out.printlnにはログレベルの概念がないため、開発環境と本番環境で出力を切り替えることができません。結局、不要な出力を削除する作業が必要になり、運用コストが上がります。

このような問題を解決するのが、Spring Boot Loggerと呼ばれるログ出力の仕組みです。

4. Spring Bootでのログ出力（LoggerとLogbackの仕組み）

Spring Bootでは、標準でSLF4Jという統一インターフェースと、Logbackという実装ライブラリが連携しています。これにより、アプリケーション側はLoggerを使うだけで、複雑な設定を意識せずにログを扱うことができます。

仕組みを簡単に説明すると、以下のような流れで動作します。

アプリケーションコードがLoggerを呼び出す
SLF4Jが呼び出しを受けて、裏側のログ実装（Logbackなど）に処理を渡す
Logbackが設定に基づき、ログをコンソールやファイルへ出力する

この構造により、開発者はSystem.out.printlnのように直接出力するのではなく、レベル別に管理されたログを記録できます。例えばinfo、warn、errorなどのメソッドを使うと、重要度に応じてログを整理できます。

また、application.propertiesにログ設定を書くことで、ファイル出力やログフォーマットを簡単にカスタマイズ可能です。Spring Bootは内部でLogbackを使用しているため、追加設定をしなくても即座に動作します。


# Logback設定の一例
logging.level.root=INFO
logging.level.org.springframework.web=DEBUG
logging.file.name=application.log
logging.pattern.console=%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n

このように設定すれば、ログ出力には日時やスレッド情報、クラス名が自動的に含まれるようになり、System.out.printlnでの手動出力よりもはるかに管理しやすくなります。

5. 実際にLoggerを使ったコード例と出力結果の違い

それでは、実際にLoggerを使ってSpring Bootでログを出力する例を見てみましょう。ここではpleiades＋Gradle環境で、@Controllerを使った構成を前提にしています。


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

@Controller
public class CompareLoggerController {

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

    @GetMapping("/compare")
    public String compareLogger() {
        System.out.println("System.out.printlnで出力しました。");
        logger.info("LoggerでINFOレベルのログを出力しました。");
        logger.debug("LoggerでDEBUGレベルのログを出力しました。");
        logger.error("LoggerでERRORレベルのログを出力しました。");
        return "index";
    }
}

上記のコードを実行すると、コンソールには以下のような結果が表示されます。


System.out.printlnで出力しました。
2025-10-08 10:20:00 INFO  CompareLoggerController - LoggerでINFOレベルのログを出力しました。
2025-10-08 10:20:00 ERROR CompareLoggerController - LoggerでERRORレベルのログを出力しました。

ログ設定がINFOレベルの場合、debugレベルのログは出力されません。このように、Spring Boot Loggerを使うと出力レベルを制御でき、不要な情報を省くことが可能です。

さらに、Logbackではログをファイルにも保存できます。長期間の運用では、コンソールだけでなくファイル出力によって履歴を残すことが重要です。System.out.printlnでは毎回標準出力にしか出せないため、過去の記録を残すには別途リダイレクトなどを設定しなければなりません。

また、Loggerを使えばスレッドごとに識別できる情報が記録されるため、マルチスレッド処理を行うWebアプリケーションでもトラブルシューティングが容易になります。

新人

「実際に出力結果を比べてみると、Loggerの方がずっと見やすいですね！」

先輩

「そうだね。ログレベルごとに整理されているから、あとから特定のエラーだけ確認するのも簡単だよ。Spring Boot LoggerはLogbackと連携していて、効率的で信頼性の高い出力ができる仕組みになっているんだ。」

新人

「これならチーム全体で統一したログ管理ができますね。System.out.printlnを使うよりずっと便利です！」

このように、Spring Boot Loggerは単なるデバッグ出力ではなく、アプリケーションの状態を正確に記録するための重要な仕組みです。System.out.println デバッグから一歩進んで、Logbackによるログ管理を活用することで、安定した運用が実現できます。

6. ログの出力レベル（INFO／DEBUG／ERROR）を使い分ける理由

Spring Bootでログを扱う際に重要なのが、「ログレベル」を使い分けることです。System.out.printlnではすべて同じ出力しかできませんが、Loggerを使うとメッセージの重要度によって分類できます。これにより、必要な情報だけを抽出しやすくなり、開発効率や運用性が向上します。

ログレベルにはいくつかの種類がありますが、代表的なのは次の三つです。

INFO：アプリケーションの通常動作を記録するレベル。起動時や処理の開始・終了など、運用上の確認に使います。
DEBUG：開発中の詳細なデバッグ情報。変数の中身や処理の分岐など、原因調査に役立ちます。
ERROR：エラーが発生したときに出力する重大な情報。システム障害や例外の記録に使われます。

ログレベルを正しく使い分けることで、本番環境ではINFO以上を出力し、開発中はDEBUGも含めるなど柔軟に制御できます。


logger.info("ユーザー登録を開始しました。");
logger.debug("登録データ：" + user.toString());
logger.error("データベース接続に失敗しました。", e);

このように書くことで、Spring Boot デバッグ時には詳細な情報を表示し、本番ではINFO以上だけを残すといった運用が可能になります。System.out.printlnではこれを手動で管理しなければならず、現実的ではありません。

新人

「たしかに、全部System.out.printlnで出すと、どれがエラーか分かりにくいですね。」

先輩

「そうなんだ。ログレベルを分けることで、必要な情報を素早く探せるし、あとからログ解析もしやすくなるよ。」

7. System.out.printlnではできないログ管理のポイント

System.out.printlnは標準出力のみを扱うため、ログの出力先や形式を制御できません。一方、Spring Bootのログ機能ではLogbackを通じて、出力先やレベルを柔軟に切り替えられます。ここではその主なポイントを見てみましょう。

① 出力先の変更

Logbackでは、コンソール出力だけでなく、ファイル・外部サーバーなどにもログを送ることが可能です。設定ファイルにパスを指定するだけで、本番環境ログを自動的に記録できます。


logging.file.name=logs/application.log
logging.level.root=INFO

上記設定を追加するだけで、アプリ起動時にlogs/application.logファイルが生成され、ログが保存されるようになります。System.out.printlnでは標準出力にしか表示できないため、運用時の履歴管理ができません。

② レベルごとの制御

Spring Boot Loggerでは、パッケージ単位で出力レベルを指定できます。特定のモジュールだけ詳細に出すなど、柔軟な運用が可能です。


logging.level.com.example.controller=DEBUG
logging.level.com.example.service=INFO

これにより、開発中はcontroller層の詳細ログを出して確認し、service層はINFOのみといった使い分けができます。System.out.printlnではこうした制御は不可能です。

③ 本番運用での活用

本番環境では、INFOやERRORのログを中心に出力し、トラブルが起きた際に迅速に原因を把握することが重要です。Logbackは自動的にログをローテーション（古いログを日付ごとに保存）してくれるため、長期運用にも適しています。


<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
    <fileNamePattern>logs/app-%d{yyyy-MM-dd}.log</fileNamePattern>
</rollingPolicy>

このように設定すれば、毎日新しいログファイルが生成され、古いファイルは自動的にアーカイブされます。これがSystem.out.printlnにはない強みです。

8. 実践的なヒント（デバッグ時と本番環境での使い分け方）

開発中は詳細な情報を出したい一方、本番環境では必要最低限の情報だけを残したいというニーズがあります。ここで重要になるのが、Spring Bootのプロファイル機能とログ設定の切り替えです。

たとえば、開発用と本番用で別々の設定ファイルを用意します。


# application-dev.properties
logging.level.root=DEBUG
logging.level.com.example=DEBUG

# application-prod.properties
logging.level.root=INFO
logging.level.com.example=INFO
logging.file.name=logs/app.log

実行時に起動プロファイルを指定すれば、環境に応じて自動で設定が切り替わります。


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

これにより、開発中はDEBUGログを詳細に出力し、本番ではINFO以上だけを保存する運用ができます。System.out.printlnでは環境ごとに手動でコメントアウトする必要があり、非常に非効率です。

また、チーム開発ではログに一貫性を持たせることが重要です。Spring Boot デバッグで問題を再現し、本番環境ログで原因を追跡できるようにすることで、トラブル対応がスムーズになります。

新人

「なるほど、環境ごとに設定を切り替えられるんですね！System.out.printlnだと確かに面倒でした。」

先輩

「そうだね。Spring Bootなら、開発と本番で適切にログを分けて管理できるから、トラブルにも強くなる。Loggerを活用すれば、もう単純な標準出力に頼る必要はないんだ。」

新人

「これで、System.out.printlnとLoggerの違いが本当に理解できました！」

このように、Spring Bootのログ機能は、単なる出力ではなく、アプリケーション運用の重要な基盤です。ログレベルを適切に使い分け、環境に応じて設定を切り替えることで、デバッグから本番まで一貫した品質を保つことができます。