logback-access-spring-boot-starterHTTP Access Logging for Spring Boot

Auto-configuration for Logback Access with Tomcat and Jetty support

Get Started

View on GitHub

⚙️

Auto-Configuration

Zero-configuration setup for Tomcat and Jetty embedded servers. Add the dependency and start logging.

🔐

Spring Security Integration

Automatically captures authenticated usernames in access logs via Spring Security (Servlet only).

📝

Request/Response Body Capture

Optional TeeFilter support for logging request and response body content (Tomcat only).

🎯

URL Filtering

Include/exclude URL patterns to control which requests are logged.

🌱

Spring Profiles Support

Environment-specific logging configuration using Spring profiles.

📊

JSON Logging

JSON output via logstash-logback-encoder, compatible with Logstash and ELK stack.

Architecture

Quick Start

Add the dependency to your project:

Replace VERSION with the latest version from 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>

Create 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>

Start your application and access logs will appear in the console.

Requirements

Component	Version
Java	21+
Spring Boot	4.0+

License

This project is licensed under the Apache License 2.0.