第1章 SLF4J の概要
1.1 SLF4J とは？
SLF4J （Simple Logging Facade for Java）は、Javaエコシステムにおいて最も広く使用されているロギングファサード（Logging Facade）フレームワークです。これは具体的なロギング実装ではなく、様々なロギングシステム（Logback、 Log4j2、java.util.loggingなど）に対して統一された抽象インターフェース層を提供するものです。
1.2 なぜSLF4Jが必要なのか？
初期のJavaエコシステムでは、ロギングフレームワークの断片化が深刻でした：
| ロギングフレームワーク | 説明 |
|---|---|
| JUL（java.util.logging） | JDKに組み込まれているが、機能は限定的 |
| Log4j 1.x | Apache 製。機能は豊富だが、メンテナンスは終了 |
| Log4j 2.x | Log4j のリライト版。優れたパフォーマンス |
| Logback | Log4jの創設者であるCeki Gülcüによって再設計され、SLF4Jのネイティブ実装 |
| JCL（Apache Commons Logging） | 初期のログファサードだが、クラスローダーの問題がある |
プロジェクトが複数のサードパーティ製ライブラリに依存しており、それらがそれぞれ異なるロギングフレームワークを使用している場合、ロギングシステムの混乱は避けられません。SLF4Jの登場は、まさにこの問題を解決するためのものでした------ファサードパターンを通じて、すべてのコンポーネントが同一のロギングAPIを統一して使用できるようにするためです。
バージョン1.3の進化
| バージョン | 主な変更点 |
|---|---|
| 1.7.x | クラシックな安定版。StaticLoggerBinder による静的バインディングメカニズムを採用 |
| 2.0.x | 大幅なアップグレード。ServiceLoader（SPI）メカニズムを採用してログ実装を検出。ストリーム型ログ API（Fluent API）を新規追加。Java 8 以上が必要 |
二、SLF4Jの主な機能と利点
2.1 コア機能の一覧
a. 統一されたロギングインターフェース
SLF4J は、6 つのログレベルを網羅した簡潔な Logger インターフェースを提供しています：
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
public class UserService {
// 現在のクラスの完全修飾名を使用して Logger を作成
private static final Logger log = LoggerFactory.getLogger(UserService.class);
public void processUser(String userId) {
log.trace(「processUser メソッドに入りました、userId={}」, userId);
log.debug(「ユーザー情報を照会中...」);
log.info(「ユーザー {} のログインに成功しました」, userId);
log.warn(「ユーザー {} のセッションがまもなく期限切れになります」, userId);
log.error(「ユーザー {} の処理中に例外が発生しました」, userId, new RuntimeException(「サンプル例外」));
}
}b. プレースホルダー（Parameterized Logging）
SLF4J の {} プレースホルダー機構は、その大きな特長の一つです------ログレベルが条件を満たした場合にのみ文字列の連結が行われるため、パフォーマンスが大幅に向上します：
// ❌ 悪い例：ログレベルが条件を満たしているかどうかにかかわらず、文字列の連結が実行される
log.debug(「User: 」 + user.getName() + 「, Age: 」 + user.getAge());
// ✅ 良い例：DEBUG レベルが有効な場合にのみ連結が行われる
log.debug(「User: {}, Age: {}」 , user.getName(), user.getAge());c. MDC（Mapped Diagnostic Context）
MDC は SLF4J が提供するスレッドレベルのコンテキスト情報コンテナであり、分散システムにおけるリクエストチェーンの追跡に非常に適しています：
import org.slf4j. MDC;
public class RequestFilter implements Filter {
@Override
public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
throws IOException, ServletException {
try {
// リクエスト ID を MDC に格納
String requestId = UUID.randomUUID().toString();
MDC.put(「requestId」, requestId);
MDC.put(「clientIp」, request.getRemoteAddr());
chain.doFilter(request, response);
} finally {
// スレッドの再利用によるデータ汚染を防ぐため、必ずクリーンアップを行う
MDC.clear();
}
}
}Logbackの%X{key}フォーマットを使用した出力例：
<pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] [%X{requestId}] %-5level %logger{36} - %msg%n</
pattern>d. マーカー（ログマーカー）
マーカーを使用すると、ログに分類タグを付けることができ、その後のフィルタリングや処理が容易になります：
import org.slf4j.Marker;
import org.slf4j.MarkerFactory;
public class PaymentService {
private static final Logger log = LoggerFactory.getLogger (PaymentService.class);
private static final Marker SECURITY = MarkerFactory.getMarker(「SECURITY」);
private static final Marker PAYMENT = MarkerFactory.getMarker(「PAYMENT」);
public void processPayment(Order order) {
log.info(PAYMENT, 「注文の支払い処理を開始します。orderId={}」, order.getId());
if (order.getAmount() > 10000) {
log.warn(SECURITY, 「高額取引の警告！orderId={}, amount={}」, order.getId(), order.getAmount());
}
}
}e. SLF4J 2.0 ストリーム型ロギング API（Fluent API）
SLF4J 2.0 では、より洗練されたチェーン式呼び出しスタイルが導入されました：
// SLF4J 2.0+ ストリーム型 API
log.atInfo()
.setMessage(「ユーザーログイン成功」)
.addArgument(userId)
.addArgument(loginIp)
.setCause(exception)
.log();
// より簡潔な記述法
log.atDebug()
.setMessage(「クエリ結果: userId={}, result={}」)
.addArgument(userId)
.addArgument(result)
.log();2.2 主な利点のまとめ
| 利点 | 説明 |
|---|---|
| デカップリング | 業務コードと具体的なログ実装が完全に分離されており、ログフレームワークを切り替える際に業務コードを一切修正する必要がない |
| パフォーマンス | プレースホルダーの仕組みにより、不要な文字列連結のオーバーヘッドを回避 |
| ブリッジ機能 | JCL、JUL、Log4j 1.x などの他のログフレームワークの呼び出しを SLF4J にブリッジ可能 |
| 幅広いエコシステム | Spring、Hibernate、MyBatis などの主要フレームワークをすべてサポート |
| 軽量 | slf4j-api 自体のサイズは約 50KB であり、オーバーヘッドはほぼゼロ |
| コンテキスト追跡 | MDC メカニズムは、マイクロサービスのトレースシナリオに最適 |
2.3 ブリッジ方式の一覧
Maven ブリッジ依存関係の例：
<!-- JCLをSLF4Jにブリッジする -->
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>jcl-over-slf4j</artifactId>
<version>2.0.16</version>
</dependency>
<!-- Log4j 1.x を SLF4J にブリッジする -->
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>log4j-over-slf4j</artifactId>
<version>2.0.16</version>
</dependency>
<!-- JULをSLF4Jにブリッジする -->
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>jul-to-slf4j</artifactId>
<version>2.0.16</version>
</dependency>3. Spring プロジェクトへの SLF4J の統合
3.1 Spring Boot プロジェクト（推奨方法）
Spring Boot では、デフォルトで SLF4J + Logback がログソリューションとして使用されており、すぐに利用可能で、 追加の設定は不要です。
手順1：依存関係を確認する
Spring Boot Starter にはログ関連の依存関係が組み込まれているため、通常は手動で追加する必要はありません：
<!-- Spring Boot にはデフォルトで slf4j-api + logback-classic が含まれています -->
&
lt;dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter</artifactId>
</dependency>
<!-- spring-boot-starter-web を使用している場合も、自動的に含まれています -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web< /artifactId>
</dependency>以下のコマンドで依存関係ツリーを確認できます：
mvn dependency:tree | grep -E 「slf4j|logback」の出力は次のようなものになります：
[INFO] | +- org.springframework.boot:spring-boot-starter-logging:jar:3.3.0
[INFO] | | +- ch.qos.logback:logback-classic:jar:1.4.14
[INFO] | | | +- ch.qos.logback:logback-core:jar:1.4.14
[INFO] | | | \\- org.slf4j:slf4j-api:jar:2.0.12
[INFO] | | +- org.apache.logging.log4j:log4j-to-slf4j:jar:2.21.1
[INFO] | | \\- org.slf4j:jul-to-slf4j:jar:2.0.12注意：Spring Boot 3.x では SLF4J 2.0.x が使用されており、ServiceLoader メカニズムが採用されています。
手順 2：application.yml でログを設定する
spring:
application:
name: my-service
# ログの基本設定
logging:
level:
root: INFO
com.example.myproject: DEBUG
com.example.myproject.dao: TRACE
org.springframework.web: WARN
org.hibernate.SQL: DEBUG
# ログファイルの設定
file:
name: logs/my-service.log
# またはパスを指定
# path: /var/log/my-service
# ログ形式
pattern:
console: 「%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] [%X{traceId:-}] %-5level %logger{36} - %msg%n」
file: "%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] [%X{traceId:-}] %-5level %logger{50} - %msg%n"
# ログローリングポリシー（Logbackのネイティブ設定を使用した方が柔軟性が高い）
logback:
rollingpolicy:
max-file-size: 100MB
max-history: 30
total-size-cap: 3GB手順3：logback-spring.xml を使用した高度な設定
src/main/resources/ ディレクトリ下に logback-spring.xml を作成します（注：-spring という拡張子を使用することで、Spring Profile 機能を有効にできます）：
<?xml version="1.0" encoding="UTF-8"?>
<configuration>
<!-- Spring Boot のデフォルト設定をインポート -->
<include resource="org/springframework/boot/logging/logback/defaults.xml"/>
<!-- 属性の定義 -->
<springProperty scope="context" name="APP_NAME" source="spring.application.name" defaultValue="my-app"/>
<property name="LOG_PATH" value="logs/${APP_NAME}"/>
<!-- ===================== コンソール出力 ===================== -->
<appender name="CONSOLE" class="ch.qos.logback.core. ConsoleAppender">
<encoder>
<pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} %highlight(%-5level) [%thread] %cyan(%logger{36}) - %msg%n</pattern>
<charset>UTF-8</charset>
</encoder>
</appender>
<!-- ===================== INFO ログファイル ===================== -->
<appender name="INFO_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
<file>${LOG_PATH}/info.log</
file>
<rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
<fileNamePattern>${LOG_PATH}/info.%d{yyyy-MM-dd}. %i.log.gz</fileNamePattern>
<maxFileSize>100MB</maxFileSize>
<maxHistory>30</maxHistory>
<totalSizeCap>3GB</totalSizeCap>
</rollingPolicy>
<encoder>
<pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] [%X{traceId:-}] %-5level %logger{50} - %msg%n</pattern>
<charset>UTF-8</charset>
</encoder>
<filter class="ch.qos.logback.classic.filter.LevelFilter">
<level>INFO</level>
<onMatch>ACCEPT</onMatch>
<onMismatch>DENY</onMismatch>
</filter>
</appender>
<! -- ===================== ERROR ログファイル ===================== -->
<appender name="ERROR_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
<file>${LOG_PATH}/error.log</ file>
<rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
<fileNamePattern>${LOG_PATH}/ error.%d{yyyy-MM-dd}.%i.log.gz</fileNamePattern>
<maxFileSize>100MB</maxFileSize>
<maxHistory>90</maxHistory>
<totalSizeCap>5GB</totalSizeCap>
</
rollingPolicy>
<encoder>
<pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] [%X{traceId:-}] %-5level %logger{50} - %msg%n</pattern>
<charset>UTF-8</charset>
</ encoder>
<filter class="ch.qos.logback.classic.filter.ThresholdFilter">
<level>ERROR</level>
</filter>
</appender>
<!-- ===================== 非同期ログ（高性能シナリオ） ===================== -->
<appender name="ASYNC_INFO" class="ch.qos.logback.classic.AsyncAppender">
<queueSize>512</queueSize>
<discardingThreshold>0</discardingThreshold>
<neverBlock>true</neverBlock>
<appender-ref ref="INFO_FILE"/>
</appender>
<!-- ===================== 環境ごとの設定 ===================== -->
<!-- 開発環境 -->
<springProfile name="dev">
<root level="INFO">
<appender-ref ref="CONSOLE"/>
</root>
<logger name="com.example.myproject" level="DEBUG"/>
</springProfile>
<!-- テスト環境 -->
<springProfile name="test">
<root level="INFO">
<appender-ref ref="CONSOLE "/>
<appender-ref ref="ASYNC_INFO"/>
<appender-ref ref="ERROR_FILE"/>
</root>
<logger name="com.example.myproject" level="DEBUG"/>
</springProfile>
<!-- 本番環境 -->
<springProfile name="prod">
<root level="WARN">
<appender-ref ref="ASYNC_INFO"/>
<appender-ref ref="ERROR_FILE"/>
</root>
<logger name="com.example.myproject" level="INFO"/>
</springProfile>
</configuration>ステップ4： ビジネスロジックコード内で
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.stereotype.Service;
@Service
public class OrderService {
private static final Logger log = LoggerFactory.getLogger(OrderService.class);
public Order createOrder(OrderRequest request) {
log.info(「注文の作成を開始します, userId={}, productId={}」, request.getUserId(), request.getProductId());
try {
Order order = doCreateOrder (request);
log.info(「注文の作成に成功しました, orderId={}, amount={}」, order.getId(), order.getAmount());
return order;
} catch (Exception e) {
log.error(「注文の作成に失敗しました, userId={}, request={}」, request.getUserId(), request, e);
throw new BusinessException(「注文の作成に失敗しました」, e);
}
}
}3.2 Log4j2 実装への切り替え（オプション）
パフォーマンス上の理由から、Logback の代わりに Log4j2 を使用する必要がある場合：
&
org.springframework.boot
spring-boot-starter-web