logback-access-spring-boot-starterSpring Boot向けHTTPアクセスロギング

TomcatとJetty対応のLogback Access自動設定

はじめる

GitHubで見る

⚙️

自動設定

TomcatとJettyの組み込みサーバーに対するゼロコンフィグセットアップ。依存関係を追加するだけでロギング開始。

🔐

Spring Security連携

Spring Securityによる認証済みユーザー名をアクセスログに自動記録（Servlet限定）。

📝

リクエスト/レスポンスボディ記録

オプションのTeeFilterによるリクエストとレスポンスのボディ内容のログ記録（Tomcat限定）。

🎯

URLフィルタリング

包含/除外URLパターンでログ記録対象リクエストを制御。

🌱

Springプロファイル対応

Springプロファイルによる環境別ロギング設定。

📊

JSONロギング

logstash-logback-encoderによるJSON出力。LogstashやELKスタックと互換。

アーキテクチャ

クイックスタート

プロジェクトに依存関係を追加:

VERSIONをMaven Centralの最新バージョンに置き換えてください。

Gradle (Kotlin)Gradle (Groovy)Maven

kotlin

implementation("io.github.seijikohara:logback-access-spring-boot-starter:VERSION")

groovy

implementation 'io.github.seijikohara:logback-access-spring-boot-starter:VERSION'

xml

<dependency>
    <groupId>io.github.seijikohara</groupId>
    <artifactId>logback-access-spring-boot-starter</artifactId>
    <version>VERSION</version>
</dependency>

src/main/resources/logback-access.xmlを作成:

xml

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <appender name="console" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%h %l %u [%t] "%r" %s %b</pattern>
        </encoder>
    </appender>
    <appender-ref ref="console"/>
</configuration>

アプリケーションを起動すると、コンソールにアクセスログが出力されます。

要件

コンポーネント	バージョン
Java	21以上
Spring Boot	4.0以上

ライセンス

このプロジェクトはApache License 2.0の下でライセンスされています。