📝 Spring Framework 講座【第35回】システムの目と耳！〜ロギングの基本とLogback/SLF4J〜

前回、外部連携における耐障害性を高めるための設計パターンを学びました。システムの開発と安定稼働において、次に欠かせないのが**ロギング（Logging）**です。

ログは、アプリケーションの実行状況、エラー、ユーザーの行動などを記録する「システムの目と耳」であり、トラブルシューティング、デバッグ、セキュリティ監査に不可欠です。

今回は、JavaとSpring Bootにおける標準的なロギングの仕組みである SLF4J と Logback の関係、そして本番運用で重要なログレベルの設定方法を学びます。

1. Javaロギングの標準構成：SLF4JとLogback

Javaのロギングは歴史的に複雑でしたが、現在は以下の2層構造でシンプルに扱われています。

SLF4J (Simple Logging Facade for Java):
- 役割: ログの**インターフェース（窓口）**を提供します。開発者はこのSLF4JのAPIを使ってログを出力するコードを書きます。
- 特徴: どの実装ライブラリ（LogbackやLog4j2など）を使うかに関わらず、コードの書き方を統一できます。
Logback:
- 役割: SLF4Jが受け取ったログを実際に処理し、ファイルやコンソールに出力する**実装ライブラリ（エンジン）**です。
- 特徴: Spring Bootのデフォルトのロギングライブラリであり、高速で柔軟な設定が可能です。

Spring Bootでは、開発者が意識せずとも、このSLF4JとLogbackが依存関係として含まれており、すぐにロギングを開始できます。

2. ロギングの基本：Loggerとログレベル

2-1. Loggerの取得

ログを出力するためには、まず Logger オブジェクトをServiceやControllerクラスで取得します。SLF4JのAPIを使います。

Java

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.stereotype.Service;

@Service
public class ItemService {
    
    // クラスごとにロガーを取得（推奨される方法）
    private static final Logger logger = LoggerFactory.getLogger(ItemService.class); 
    
    public void processOrder(Long itemId) {
        
        // ログレベルを指定してメッセージを出力
        logger.info("注文処理を開始しました。Item ID: {}", itemId);
        
        // ... 処理
        
        // 例外発生時など
        try {
            // ...
        } catch (Exception e) {
            logger.error("注文処理中に予期せぬエラーが発生しました。", e); // 例外オブジェクトを渡す
        }
    }
}

2-2. ログレベルの種類

ログメッセージには、その重要度に応じてログレベルを指定します。Spring Boot（Logback）で標準的に使われる主なレベルは以下の5つです。

レベル	用途	補足
ERROR	致命的なエラー。即座に確認が必要な、アプリケーションが停止するような問題。
WARN	警告。すぐに問題ではないが、将来的にエラーの原因になり得る、注意すべき状況。
INFO	情報。システムの状態変化や重要な処理の区切り（例：処理開始/完了、ユーザーログイン）。
DEBUG	デバッグ。開発時に役立つ、詳細な情報。特定の変数の値など。
TRACE	追跡。DEBUGよりもさらに詳細な、実行パスの追跡情報。

3. 設定ファイルによる制御：ログレベルの切り替え

ロギングの最大の利点は、設定ファイルを通じて、アプリケーションの再起動なしに出力するログの粒度を制御できる点です。

本番環境では情報量が多くなりすぎるため、通常は WARN や INFO レベルに設定し、デバッグが必要な時だけ DEBUG レベルに一時的に切り替えます。

Spring Bootでは、application.properties または application.yml で設定します。

YAML

# application.yml でのロギング設定例

logging:
  # 1. 全てのロガーのデフォルトレベルを設定
  level:
    root: INFO
    
  # 2. 特定のパッケージ/クラスのログレベルを上書き
  # com.example.service パッケージ以下のログは DEBUG レベルで出力する
  level.com.example.service: DEBUG 
  
  # 3. Logbackの設定ファイルパスを指定（より詳細な設定用）
  config: classpath:logback-spring.xml 
  
  # 4. ログをファイルに出力するパスを設定
  file:
    path: /var/log/myapp/

この設定により、通常は INFO レベルのログのみが出力されますが、Service層だけはより詳細な DEBUG ログが出力され、効率的なデバッグが可能になります。