📦 Spring - Logger 알아보기

로그 시스템 알아보기

Spring 에서 많은 개발자들이 @Slf4j 어노테이션을 활용하여, 콘솔창에 레벨화 된 로그를 남겨 확인한다.
- log.info("내용")

스프링에서는 기본 로깅 프레임워크를 Logback으로 설정해놓고 있다.

Slf4j 와 Logback 의 관계?
Slf4J는 여러 로깅 프레임워크를 위한 인터페이스 또는 추상화 계층 역할을 수행한다
Logback은 이 Slf4J를 활용한 구현체로, 실제 로깅을 남기는 역할을 진행한다.

로그 레벨

로그 레벨은 크게 6가지 단계로 나눠지게 됩니다.

레벨	의미	예시
TRACE	가장 세부적인 로그. 코드의 세부적인 실행 경로를 추적하기 위한 레벨	`calculatePrice()` 메서드 진입, `userId=123`, `itemId=45`
DEBUG	디버깅 목적의 로그. 개발 중 변수의 상태나 흐름을 이해 하는데 사용	조회된 `user` 객체 상태: `User{id=123, name='test'}`
INFO	정보성 로그. 중요한 이벤트나 운영 상태, 상태 변화 등에 사용	사용자(ID: 123)가 성공적으로 로그인했습니다.
WARN	주의 로그. 잠재적으로 문제가 발생할 수 있을 수 있는 상황	`v1/api` 호출됨 (Deprecated API)
ERROR	오류 로그. 중요한 문제, 추적이 필요한 상황	주문(ID: 987) 처리 중 `NullPointerException` 발생
FATAL	심각한 오류 시스템 운영을 지속할 수 없을 정도로 중대한 오류가 발생	애플리케이션 시작 실패: 필수 설정 파일을 찾을 수 없습니다.

TRACE 가 가장 낮은 단계이며, FETAL 이 가장 높은 단계입니다.
각각의 상황에 맞게 알맞은 로그 레벨을 잘 정하는 것이 중요합니다.
각 팀의 전략에 따라 로그의 레벨 기준이 다를 수 있으며, 그에 따라 운영 환경 에서 의 로그 기록 레벨이 다를 수 있습니다.

운영 환경에서 의 로그 레벨?
만약 코드에 디버깅과 정보성 로그를 포함한 다수의 로그를 처리 해놓았다고 생각해보겠습니다.
요청에 맞춰 모든 로그가 남게 된다면 무수히 많은 로그 파일이 쌓이게 되어, 실제 오류 확인을 위한 로그 확인이 어려워질 수 잇습니다.
또한, 로그 파일 또한 파일이므로 용량이 커져 운영에 부담이 될 수 있습니다.

기준은 정말 사람마다 다르기 때문에, 로그를 남기는 이유에 대해서 잘 생각을 해보고 레벨을 지정 하는게 좋습니다.
EX) 어떤 API 의 오류 수정 CS 를 처리하기 위한 추적용 로깅
EX) 통계를 위한 로그

Console 만으로 로그를 기록하는 단점

Console 로만 로그를 남기게 된다면 운영 환경에서 log 의 기능을 재대로 활용할 수 없게 됩니다.

특정 문제로 시스템이 꺼지면, 이전에 있었던 문제에 대해서는 절대로 추적이 불가능해집니다.
- 추가적으로, 많은 로그가 발생하고 있다면 과거의 로그를 확인하기도 어려워 지겠죠.

때문에, 로그를 파일로 기록하여 추후에 활용할 수 있도록 구성을 해야 합니다.

Spring - Logback 알아보기

기본 Spring 프로젝트에는 Logback 이 들어가 있기 때문에, 기본 설정은 따로 없습니다.

Logback 은 기본적으로 default 설정으로 console 에 로그를 출력하도록 구성되어있습니다.
명확하게는 src/main/resources/logback.xml 에 파일을 추가하여 설정할 수 있는데, 만약 없을 경우, default 로 설정된 logback.xml 을 기본으로 실행하게 됩니다.
default logback.xml 에는, 다음과 같이 console 에 출력할 수 있도록 구성이 되어 있습니다. Spring 공식 Logging 관련 글

console-appender.xml

<included>
	<appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
		<filter class="ch.qos.logback.classic.filter.ThresholdFilter">
			<level>${CONSOLE_LOG_THRESHOLD}</level>
		</filter>
		<encoder>
			<pattern>${CONSOLE_LOG_PATTERN}</pattern>
			<charset>${CONSOLE_LOG_CHARSET}</charset>
		</encoder>
	</appender>
</included>

다른 말로 생각해보면, 저희는 위 경로에 저희만의 logback.xml 을 저희가 필요한 로깅 시스템을 구성할 수 있다는 뜻 입니다.

Logback XML

공식 문서를 참고하시고 싶으신 분은, 링크 를 통해 Logback 학습이 가능합니다.

가장 알기 쉬운 방법은 무작정 따라하고 실행하기 입니다.

src/main/resources 에 다음과 같이 logback.xml 파일을 만들고 프로젝트를 실행해봅니다.
- 추가적으로 아무 서비스나 컨트롤러 등에서 log.info 나 log.error 등을 넣어서 확인하셔도 됩니다.

<configuration>
    <conversionRule conversionWord="clr" class="org.springframework.boot.logging.logback.ColorConverter"/>
    <conversionRule conversionWord="wex" class="org.springframework.boot.logging.logback.WhitespaceThrowableProxyConverter" />
    <conversionRule conversionWord="wEx" class="org.springframework.boot.logging.logback.ExtendedWhitespaceThrowableProxyConverter" />
    <conversionRule conversionWord="esb" class="org.springframework.boot.logging.logback.EnclosedInSquareBracketsConverter" />

    <property name="LOG_FILE" value="logs/application.log"/>
    <property name="CONSOLE_LOG_PATTERN" value="${CONSOLE_LOG_PATTERN:-%clr(%d{${LOG_DATEFORMAT_PATTERN:-yyyy-MM-dd'T'HH:mm:ss.SSSXXX}}){faint} %clr(${LOG_LEVEL_PATTERN:-%5p}){} %clr(${PID:-}){magenta} %clr(--- %esb(){APPLICATION_NAME}%esb{APPLICATION_GROUP}[%15.15t] ${LOG_CORRELATION_PATTERN:-}){faint}%clr(%-40.40logger{39}){cyan} %clr(:){faint} %m%n${LOG_EXCEPTION_CONVERSION_WORD:-%wEx}}"/>
    <property name="CONSOLE_LOG_CHARSET" value="${CONSOLE_LOG_CHARSET:-${file.encoding:-UTF-8}}"/>

    <!-- 콘솔 출력 -->
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>${CONSOLE_LOG_PATTERN}</pattern>
            <charset>${CONSOLE_LOG_CHARSET}</charset>
        </encoder>
    </appender>

    <!-- 파일 출력 -->
    <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>${LOG_FILE}</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>logs/application.%d{yyyy-MM-dd_HH-mm}.log</fileNamePattern>
            <maxHistory>5</maxHistory>
        </rollingPolicy>
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss} %-5level [%thread] %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>

    <!-- Logger 설정 -->
    <logger name="baekgwa.blogserver" level="DEBUG" />
    <root level="INFO">
        <appender-ref ref="CONSOLE" />
        <appender-ref ref="FILE" />
        <appender-ref ref="LOGSTASH" />
    </root>
</configuration>

실행 후, 정상적으로 기동되었다면, 다음과 같은 logs신규 폴더가 생성되었을 것 입니다.

내부에는, application.log 파일이 생성되고 다음과 같이, 스프링 부트의 기본 로그들과, 서비스 로그 들이 보이게 됩니다.

2025-11-07 15:33:00 INFO  [background-preinit] o.h.validator.internal.util.Version - HV000001: Hibernate Validator 8.0.2.Final
2025-11-07 15:33:00 INFO  [main] b.blogserver.BlogServerApplication - Starting BlogServerApplication using Java 21.0.2 with PID 18076 (C:\Users\ksu98\Desktop\Backgwa Blog project\BackEnd\build\classes\java\main started by ksu98 in C:\Users\ksu98\Desktop\Backgwa Blog project\BackEnd)
2025-11-07 15:33:00 DEBUG [main] b.blogserver.BlogServerApplication - Running with Spring Boot v3.5.0, Spring v6.2.7
2025-11-07 15:33:00 INFO  [main] b.blogserver.BlogServerApplication - The following 4 profiles are active: "dev", "dev_db", "dev_server", "dev_auth"
2025-11-07 15:33:01 INFO  [main] o.s.d.r.c.RepositoryConfigurationDelegate - Multiple Spring Data modules found, entering strict repository configuration mode
2025-11-07 15:33:01 INFO  [main] o.s.d.r.c.RepositoryConfigurationDelegate - Bootstrapping Spring Data JPA repositories in DEFAULT mode.
2025-11-07 15:33:02 INFO  [main] o.s.d.r.c.RepositoryConfigurationDelegate - Finished Spring Data repository scanning in 227 ms. Found 6 JPA repository interfaces.
2025-11-07 15:33:02 INFO  [main] o.s.d.r.c.RepositoryConfigurationDelegate - Multiple Spring Data modules found, entering strict repository configuration mode
2025-11-07 15:33:02 INFO  [main] o.s.d.r.c.RepositoryConfigurationDelegate - Bootstrapping Spring Data Redis repositories in DEFAULT mode.

또한 1분 후, 2분 후 새로운 로그를 찍게 된다면, 다음과 같이 분 단위의 파일이 저장되는 모습을 볼 수 있습니다.
추후, 5분가량이 지난 파일은 자동으로 삭제되는 모습을 볼 수 있습니다.

Logback의 XML 설정 요소 알아보기

logback.xml은 Logback의 설정 파일(Configuration File)로, 각 요소들은 내부적으로 Logback의 자바 객체(Appender, Logger, Layout 등)에 매핑됩니다.

<configuration>
Logback 설정의 루트(root) 요소입니다.
모든 설정은 <configuration> 태그 안에서 작성되어야 하며, Logback이 애플리케이션 실행 시 이 파일을 읽어 초기화합니다.

<property>
설정 파일 내에서 재사용 가능한 변수를 정의합니다.
name으로 지정한 값을 ${name} 형태로 참조할 수 있습니다.
<property name="LOG_FILE" value="logs/application.log"/>

<conversionRule>
로그 패턴(%clr, %highlight 등)에 사용될 커스텀 변환기(converter)를 등록합니다.
Spring Boot에서 제공하는 컬러 출력이나 예외 포맷 등을 활성화할 때 사용합니다.
<conversionRule conversionWord="clr"
                class="org.springframework.boot.logging.logback.ColorConverter"/>

<appender>
로그를 실제로 출력하는 대상(Output Target)을 정의합니다.
즉, 로그 메시지를 콘솔, 파일, 네트워크(Logstash 등)로 내보내는 역할을 합니다.
✅ ConsoleAppender
콘솔 창에 로그를 출력합니다.
<appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
    <encoder>
        <pattern>${CONSOLE_LOG_PATTERN}</pattern>
        <charset>${CONSOLE_LOG_CHARSET}</charset>
    </encoder>
</appender>
✅ RollingFileAppender
로그를 파일에 기록하되, 일정 주기나 용량에 따라 자동으로 새 파일로 교체(롤링)합니다.
<appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <file>${LOG_FILE}</file>
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
        <fileNamePattern>logs/application.%d{yyyy-MM-dd_HH-mm}.log</fileNamePattern>
        <maxHistory>5</maxHistory>
    </rollingPolicy>
    <encoder>
        <pattern>%d{yyyy-MM-dd HH:mm:ss} %-5level [%thread] %logger{36} - %msg%n</pattern>
    </encoder>
</appender>
BasedRollingPolicy
fileNamePattern에서 지정한 시간 포맷에 따라 로그 파일을 분리합니다.
위 예제에서는 분 단위(yyyy-MM-dd_HH-mm)로 파일이 새로 생성됩니다.
maxHistory
유지할 로그 파일의 최대 개수입니다.
예: 5 → 5개까지만 보관하고, 오래된 로그는 자동 삭제.

<logger>
특정 패키지나 클래스 단위로 로그 레벨을 지정합니다.
<logger name="baekgwa.blogserver" level="DEBUG" />
name: 패키지 혹은 클래스 이름
level: 로그 레벨 (TRACE, DEBUG, INFO, WARN, ERROR)
이 설정은 루트 로거보다 우선순위가 높습니다.
예를 들어 위 설정은 baekgwa.blogserver 패키지 내부의 로그는 DEBUG 이상만 출력하도록 지정합니다.

<root>
루트 로거로, 전체 로그의 기본 레벨과 출력 대상(Appender)을 정의합니다.
<root level="INFO">
    <appender-ref ref="CONSOLE" />
    <appender-ref ref="FILE" />
</root>
level: 전체 로그의 기본 수준 (INFO 이상만 출력)
<appender-ref>: 어떤 appender로 출력할지 지정
(ref는 <appender>의 name 속성과 일치해야 함)

이 요소들 제외하고도 다양한 appender 와 요소들이 많으니, 다양한 레퍼런스를 통해 원하시는 로그를 만들어 가시길 바랍니다.

Spring & Logback 알아보기 with Slf4j

스택 시리즈🌈 Spring Boot