[java] Log4j의 로깅 설정 커스터마이징 방법

23 Nov 2023

java

Log4j는 자바 애플리케이션의 로깅을 관리하는 강력한 도구입니다. 이를 통해 애플리케이션의 로그를 효율적으로 관리하고 디버깅 및 모니터링을 수행할 수 있습니다. Log4j의 기본 설정은 대부분의 상황에 적합하지만 때로는 우리의 특정 요구에 맞게 로깅 설정을 커스터마이징해야 할 수도 있습니다.

이 글에서는 Log4j의 로깅 설정을 커스터마이징하는 방법에 대해 알아보겠습니다.

1. Log4j 설정 파일 생성

Log4j의 로깅 설정은 주로 log4j.properties 또는 log4j.xml 파일을 사용하여 지정됩니다. 우선, 프로젝트의 리소스 디렉토리에 해당 파일을 생성합니다.

2. Log4j 설정 파일 내용 작성

Log4j 설정 파일에는 로그 출력 형식, 로그 레벨, 로그의 출력 위치 등을 지정할 수 있습니다. 다음은 Log4j 프로퍼티 파일의 예시입니다.

log4j.rootLogger=DEBUG, console, file

log4j.appender.console=org.apache.log4j.ConsoleAppender
log4j.appender.console.layout=org.apache.log4j.PatternLayout
log4j.appender.console.layout.ConversionPattern=%-5p %d [%t] %c{1} - %m%n

log4j.appender.file=org.apache.log4j.FileAppender
log4j.appender.file.File=/var/log/myapp.log
log4j.appender.file.layout=org.apache.log4j.PatternLayout
log4j.appender.file.layout.ConversionPattern=%-5p %d [%t] %c{1} - %m%n

위 예시에서는 로그 레벨을 “DEBUG”로 설정하고, console과 file 두 개의 출력 장치를 정의하였습니다. console은 콘솔에 로그를 출력하고, file은 /var/log/myapp.log 파일에 로그를 저장합니다. 로그 출력 형식은 %-5p %d [%t] %c{1} - %m%n를 사용하여 로그 레벨, 날짜 및 시간, 쓰레드 이름, 클래스 이름, 로그 메시지를 포맷팅합니다.

3. Log4j 설정 파일 적용

Log4j 설정 파일을 적용하기 위해서는 애플리케이션의 시작 시점에 설정 파일을 로드해야 합니다. 일반적으로는 애플리케이션의 진입점에서 다음과 같은 코드를 추가하여 설정 파일을 로드합니다.

import org.apache.log4j.PropertyConfigurator;

public class MyApp {
    public static void main(String[] args) {
        // Log4j.properties 파일의 경로를 지정합니다.
        String log4jConfigFile = "/path/to/log4j.properties";
        PropertyConfigurator.configure(log4jConfigFile);

        // 애플리케이션 로직 작성...
        // ...
    }
}

위 예시에서는 PropertyConfigurator.configure(log4jConfigFile) 코드를 사용하여 Log4j 설정 파일을 로드합니다. log4jConfigFile 변수에는 실제 설정 파일의 경로를 지정해야 합니다.

4. 로그 생성 및 사용

Log4j의 로깅 기능을 사용하여 로그를 생성 및 출력할 수 있습니다. 다음은 Log4j의 Logger 클래스를 사용하여 로그를 생성하는 예시 코드입니다.

import org.apache.log4j.Logger;

public class MyAppLogic {
    private static final Logger LOGGER = Logger.getLogger(MyAppLogic.class);

    public void doSomething() {
        // 로그 메시지 출력
        LOGGER.debug("Debug message");
        LOGGER.info("Info message");
        LOGGER.warn("Warn message");
        LOGGER.error("Error message");
    }
}

위 예시에서는 Logger.getLogger(MyAppLogic.class) 코드를 사용하여 Logger 인스턴스를 생성하고, 해당 인스턴스의 debug(), info(), warn(), error() 메서드를 사용하여 로그를 출력하고 있습니다.

5. 추가적인 설정

Log4j를 커스터마이징하기 위해선 다양한 설정 옵션을 알아야 합니다. Log4j의 공식 문서와 API 문서는 많은 도움을 줄 수 있습니다. 아래는 참고할만한 Log4j 문서입니다.

위의 문서를 참고하여 Log4j의 로깅 설정을 더욱 세밀하게 조정하고 원하는 결과를 얻을 수 있습니다.