로깅(logging)

Spring Boot는 기본적으로 SLF4J(Simple Logging Facade for Java)와 Logback을 로깅 프레임워크로 사용합니다. 별도 설정 없이도 동작하지만, 실무에서는 로그 레벨, 출력 형식, 파일 저장 등을 커스터마이징해야 하죠.

Spring Boot Starter에 SLF4J와 Logback이 포함되어 있습니다.

// build.gradle.kts
dependencies {
    implementation("org.springframework.boot:spring-boot-starter")
}

`application.yaml`

# 공통 로깅 설정
logging:
  level:
    root: INFO              # 기본 로깅 레벨
    com.example.myapp: DEBUG  # 특정 패키지의 로깅 레벨
  pattern:
    console: "%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n"  # 콘솔 출력 형식
    file: "%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n"     # 파일 출력 형식

# 개발 환경
---
spring:
  config:
    activate:
      on-profile: dev
logging:
  level:
    root: DEBUG             # 개발 환경에서 더 상세한 로그
  file:
    name: logs/myapp-dev.log  # 로그 파일 경로 및 이름

# 프로덕션 환경
---
spring:
  config:
    activate:
      on-profile: prod
logging:
  level:
    root: WARN              # 프로덕션에서는 경고 이상만 출력
  file:
    name: /var/log/myapp.log  # 프로덕션 로그 파일 경로
  logback:
    rollingpolicy:
      max-file-size: 10MB     # 파일 크기 제한
      max-history: 30         # 최대 보관 기간 (일)
      file-name-pattern: myapp-%d{yyyy-MM-dd}.%i.log  # 롤링 파일 이름 패턴

로깅 설정 옵션

옵션	설명	예시 값
`logging.level.root`	루트 로거의 기본 로깅 레벨 설정 (`TRACE`, `DEBUG`, `INFO`, `WARN`, `ERROR`, `OFF`)	`INFO`
`logging.level.{패키지명}`	특정 패키지나 클래스에 대한 로깅 레벨 설정	`com.example.myapp: DEBUG`
`logging.pattern.console`	콘솔에 출력되는 로그 형식 정의	`%d{yyyy-MM-dd HH:mm:ss} %-5level %msg%n`
`logging.pattern.file`	파일에 기록되는 로그 형식 정의	`%d{yyyy-MM-dd HH:mm:ss} %-5level %msg%n`
`logging.file.name`	로그 파일의 경로와 이름 설정 (절대 경로 또는 상대 경로)	`logs/myapp.log`
`logging.file.path`	로그 파일이 저장될 디렉토리 설정 (파일 이름은 기본값 사용)	`/var/log`
`logging.logback.rollingpolicy.max-file-size`	로그 파일의 최대 크기 (크기 초과 시 롤링)	`10MB`
`logging.logback.rollingpolicy.max-history`	롤링된 로그 파일의 최대 보관 기간 (일 단위)	`30`
`logging.logback.rollingpolicy.file-name-pattern`	롤링된 로그 파일의 이름 패턴 정의	`myapp-%d{yyyy-MM-dd}.%i.log`
`logging.exception-conversion-word`	예외 스택 트레이스를 변환하는 패턴 설정	`%ex`
`logging.charset.console`	콘솔 로그의 문자 인코딩 설정	`UTF-8`
`logging.charset.file`	파일 로그의 문자 인코딩 설정	`UTF-8`

logging.level
- 설명: 로깅 레벨은 로그의 상세도를 결정합니다. DEBUG는 개발 중 디버깅에 유용하고, WARN이나 ERROR는 프로덕션에서 주로 사용됩니다.
- 예시: com.example.myapp: DEBUG로 설정하면 해당 패키지의 로그만 상세히 출력됩니다.
logging.pattern
- 설명: 로그 메시지의 형식을 정의합니다. %d (날짜), %-5level (레벨), %msg (메시지), %n (줄바꿈) 등 패턴을 조합할 수 있습니다.
- 팁: 콘솔과 파일 형식을 다르게 설정해 환경별로 최적화 가능.
logging.file
- 설명: name은 파일 경로를 직접 지정하며, path는 디렉토리만 지정할 때 사용됩니다. 두 옵션을 함께 사용할 경우 name이 우선합니다.
- 예시: logs/myapp-dev.log는 프로젝트 루트 기준 상대 경로로 파일 생성.
logging.logback.rollingpolicy
- 설명: 로그 파일이 커질 경우 롤링(새 파일 생성)을 설정합니다. max-file-size로 크기 제한, max-history로 보관 기간을 지정합니다.
- 예시: file-name-pattern에서 %i는 파일 인덱스를 의미하며, myapp-2025-03-16.0.log 같은 이름으로 생성됩니다.

커스텀 Logback 설정

복잡한 설정은 src/main/resources/logback-spring.xml로 관리합니다.

<configuration>
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>

    <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>logs/my-app.log</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>logs/my-app-%d{yyyy-MM-dd}.log</fileNamePattern>
            <maxHistory>30</maxHistory>
        </rollingPolicy>
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>

    <root level="INFO">
        <appender-ref ref="CONSOLE" />
        <appender-ref ref="FILE" />
    </root>

    <logger name="com.example" level="DEBUG" additivity="false">
        <appender-ref ref="CONSOLE" />
        <appender-ref ref="FILE" />
    </logger>
</configuration>

ConsoleAppender: 콘솔에 로그 출력.
RollingFileAppender: 날짜별로 로그 파일 저장 (30일 보관).
logger: 특정 패키지에 다른 레벨 적용.

코드에서 SLF4J 사용

Lombok의 @Slf4j로 쉽게 로깅을 추가할 수 있습니다.

@Slf4j
@RestController
@RequestMapping("/api")
public class ExampleController {
    @GetMapping("/test")
    public String test() {
        log.debug("디버그 로그 테스트");
        log.info("정보 로그 테스트");
        log.error("에러 로그 테스트");
        return "Log Test";
    }
}

설정 우선순위

환경 변수 > application.yaml > 기본값 순으로 적용.

7.2 KiB Raw Blame History