Java 로깅 라이브러리 선택: API, 백엔드, 브리지

Java 로깅 선택지 7개를 비교하고, 런타임 의존성과 Logback·Log4j 2에서 같은 SLF4J 이벤트의 출력 차이를 확인합니다.

모범 사례
로그 이벤트와 데이터 분석을 나타낸 그림

의존성을 업데이트한 뒤에도 결제 오류는 표준 출력에 찍히는데 알림은 오지 않습니다. 새 인코더가 로그 레벨 필드의 위치를 바꿨고, 다른 의존성에서는 두 번째 로깅 프로바이더가 들어왔습니다. 먼저 실행 중인 애플리케이션에서 어느 구현체가 로그를 쓰는지 확인합니다. 그다음 출력한 레코드와 수집기가 저장한 필드를 대조합니다.

로그 호출에 쓰는 API와 출력 구현체 구분하기

선택지 Java 애플리케이션에서의 역할 실행 시 확인할 사항
SLF4J 로깅 퍼사드 SLF4J 2는 호환 프로바이더를 찾습니다. 없으면 경고를 출력한 뒤 로그를 기록하지 않습니다.
Logback Logback Classic이 구현체 제공 appender는 출력 위치를, 내장 JsonEncoder 같은 인코더는 형식을 결정합니다.
Log4j 2 별도의 API와 Log4j Core 구현체 Core는 appender와 비동기 로거를 제공합니다. JSON Template Layout은 별도 모듈입니다.
java.util.logging(JUL) JDK에 포함된 API와 구현체 외부 구현체 없이 핸들러와 포매터로 콘솔이나 파일에 쓸 수 있습니다.
Apache Commons Logging(JCL) 기존 의존성에서 흔히 보는 퍼사드 유지보수 릴리스가 있습니다. 실행 시 어느 구현체나 브리지가 로드되는지 확인합니다.
tinylog 2 API와 구현체 두 아티팩트를 넣으면 기본적으로 콘솔에 출력합니다. 롤링 파일과 JSON 파일용 writer도 있습니다.
Flogger 여러 백엔드를 지원하는 fluent API 독립 실행 앱에서는 런타임 백엔드를 별도로 포함합니다.

배포할 라이브러리에는 SLF4J API만 두고, 프로바이더는 사용하는 애플리케이션에서 선택할 수 있습니다. Spring Boot 기본 starter를 사용하는 서비스는 우선 Logback으로 시작할 수 있습니다. JSON 템플릿이나 Disruptor 기반 비동기 로거가 필요하다면 Log4j Core를 검토합니다. 작은 도구를 JDK만으로 구성하려면 JUL을 바로 쓸 수 있고, 다른 출력 형식이나 목적지가 필요하면 tinylog의 writer도 선택지입니다. 호출 지점에서 출력 빈도를 제어하는 API가 필요하다면 Flogger를 살펴볼 수 있습니다. SLF4J 매뉴얼 · Spring Boot 로깅 · tinylog 설정 · Flogger

런타임 클래스패스에서 브리지 방향 확인하기

mvn dependency:tree -Dscope=runtime을 실행하고, 실제 배포 파일에 포함된 아티팩트도 확인합니다. SLF4J 2의 프로바이더와 예전 1.7의 바인딩은 다릅니다. 한 클래스패스에는 호환되는 프로바이더 하나를 둡니다. 같은 로그가 두 번 나온다면 해당 로거와 상위 로거의 appender가 같은 이벤트를 처리하는지도 확인합니다.

log4j-slf4j2-impl은 SLF4J 호출을 Log4j 2로 보냅니다. log4j-to-slf4j는 Log4j API 호출을 반대 방향으로 보냅니다. 둘을 한 런타임에 넣으면 순환할 수 있습니다. JUL도 마찬가지입니다. jul-to-slf4j 핸들러를 등록했다면 slf4j-jdk14를 통해 JUL로 다시 보내지 않도록 합니다. Spring Framework 5와 6의 자체 브리지인 spring-jcl은 사용할 수 있는 API에 따라 경로를 선택하며 JUL로 돌아갈 수도 있습니다. 브리지를 추가하기 전에 기존 경로부터 확인합니다. Log4j 설치 · SLF4J 브리지 · Spring Framework 6.2 로깅 · JCL 릴리스 기록

Log4j 1.x가 남아 있다면 마이그레이션 중 log4j-1.2-api로 일부 기존 호출을 연결할 수 있습니다. 예전 설정과 사용자 정의 appender를 별도로 파악하고, 전환 후 동작을 확인합니다. Apache 마이그레이션 가이드

기존 쿼리에 필요한 필드 유지하기

아래 코드는 요청 ID를 담은 합성 오류를 한 건 기록하고, MDC를 정리한 뒤 레코드를 한 건 더 남깁니다. 한 번에 SLF4J 2 프로바이더 하나만 두고 JSON 출력으로 설정합니다.

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.slf4j.MDC;

public final class LoggingSample {
    public static void main(String[] args) {
        Logger logger = LoggerFactory.getLogger(LoggingSample.class);
        MDC.put("request_id", "fixture-42");
        try {
            logger.error("checkout failed",
                    new IllegalStateException("synthetic failure"));
        } finally {
            MDC.remove("request_id");
        }
        logger.info("fixture complete");
    }
}

로컬 Java 21과 SLF4J 2.0.20에서 확인한 결과, Logback 1.6.6의 JsonEncoder는 level과 mdc.request_id에 값을 기록했습니다. Log4j 2.26.1의 기본 JSON Template Layout에서는 log.level과 request_id가 그대로 키 이름이었습니다. 시각과 예외의 표현도 달랐고 두 설정 모두 두 번째 레코드에는 요청 ID가 없었습니다. 이 확인은 두 설정의 출력 형식과 MDC 정리를 대상으로 했습니다.

서비스의 요청 ID와 추적의 trace ID는 서로 다른 필드로 다룹니다. 파일에서 컨테이너 표준 출력으로 바꾸거나 JSON 레이아웃을 변경했다면, 수신된 타임스탬프, 레벨, 메시지, 예외, 연관 필드를 살펴봅니다. DataKit으로 파일이나 컨테이너 출력을 수집할 때는 파싱과 필드 매핑을 맞춘 뒤 기존 필터와 알림을 점검합니다. 구조화 로깅을 지원하는 Spring Boot에서는 logging.structured.format.console로 JSON 형식을 고를 수 있습니다. 사용자 정의 encoder나 layout을 쓰는 경우에도 선택한 형식이 적용되는지 확인해야 합니다. DataKit 로그 수집 · Logback 인코더 · Log4j JSON Template Layout

큐를 추가하기 전에 출력 경로 측정하기

큐는 순간적으로 몰리는 로그를 받아 줄 수 있지만, 출력 대상의 처리량이 계속 부족하면 결국 가득 찹니다. 실제 appender와 레이아웃으로 요청 지연과 로그 처리량을 측정합니다. 큐가 찼을 때 버리는지, 호출을 대기시키는지, 일부를 동기로 처리하는지도 확인합니다. 프로세스가 비정상 종료되면 처리되지 않은 로그가 사라질 수 있습니다. 감사 로그는 전체 경로의 내구성과 무결성을 따로 확인해야 합니다. 동기 appender를 쓴다는 사실만으로는 이를 보장할 수 없습니다. Log4j 비동기 로거 · Logback AsyncAppender

Logback 설정(영어) · Log4j 2 설정(영어) · Java 로깅 실무(영어)

맞춤형 플랜 상담

문의하기

커뮤니티 가입

WeChat으로 스캔하여
커뮤니티에 가입하세요

Guance 사용해 보기

온라인에서 바로 시작하고 사용한 만큼만 결제하세요.

시작하기

Guance 요금제 선택

코드 저장소