[java] Log4j의 로깅 메소드 로깅 레벨 설정 방법

23 Nov 2023

java

Log4j는 자바 애플리케이션에서 로그를 생성하고 관리하는 데 사용되는 강력한 로깅 도구입니다. 로그 레벨은 로그 이벤트를 얼마나 상세하게 기록할지 결정하는 데 중요한 역할을 합니다. 이번 블로그 포스트에서는 Log4j에서 로깅 메소드와 로깅 레벨을 설정하는 방법을 알아보겠습니다.

1. Log4j 의존성 추가

먼저, 프로젝트에 Log4j를 사용하려면 Maven 또는 Gradle과 같은 의존성 관리 도구를 사용하여 Log4j를 프로젝트에 추가해야 합니다. 아래는 Maven을 사용하는 경우 pom.xml 파일에 추가해야 할 의존성 설정입니다.

<dependencies>
  <dependency>
    <groupId>org.apache.logging.log4j</groupId>
    <artifactId>log4j-core</artifactId>
    <version>2.14.1</version>
  </dependency>
</dependencies>

의존성을 추가한 후, 프로젝트를 빌드하여 Log4j를 사용할 수 있도록 준비합니다.

2. Log4j.properties 파일 생성

Log4j를 사용하기 전에, log4j.properties라는 이름의 설정 파일을 프로젝트에 생성해야 합니다. 이 파일은 로그 레벨 및 출력 형식 등 로그 관련 설정 정보를 포함합니다.

# Root logger의 로그 레벨 설정
log4j.rootLogger=DEBUG, console

# 콘솔 출력을 위한 Appender 설정
log4j.appender.console=org.apache.log4j.ConsoleAppender
log4j.appender.console.Target=System.out
log4j.appender.console.layout=org.apache.log4j.PatternLayout
log4j.appender.console.layout.ConversionPattern=%d [%-5p] %c{1} - %m%n

위 예제는 로그 레벨을 DEBUG로 설정하고, 콘솔로 로그를 출력하는 설정입니다. log4j.appender.console.layout.ConversionPattern 속성을 사용하여 로그 메시지의 출력 형식을 지정할 수 있습니다.

3. Java 클래스에서 로깅 메소드 사용

Log4j가 설정되고 준비되면 Java 클래스에서 로깅 메소드를 사용하여 로그를 생성할 수 있습니다. Log4j는 다양한 로깅 메소드를 제공하며, 로그 레벨에 따라 메소드를 선택하여 사용할 수 있습니다. 아래는 간단한 예시입니다.

import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.Logger;

public class ExampleClass {
    private static final Logger logger = LogManager.getLogger(ExampleClass.class);

    public static void main(String[] args) {
        logger.debug("This is a debug log message");
        logger.info("This is an info log message");
        logger.warn("This is a warn log message");
        logger.error("This is an error log message");
    }
}

위 예제에서는 Log4j의 LogManager 및 Logger 클래스를 사용하여 로깅을 초기화하고 로그 메시지를 생성합니다. logger.debug(), logger.info(), logger.warn(), logger.error()와 같은 메소드를 사용하여 각각의 로그 레벨에 맞는 로그를 생성할 수 있습니다.

4. 로그 레벨 설정

Log4j에서는 다양한 로그 레벨을 제공합니다. 로그 레벨은 로그 이벤트를 얼마나 상세하게 기록할지를 나타내며, 디버깅 및 운영 환경에서 다른 로그 레벨을 사용할 수 있습니다. 아래는 Log4j에서 지원하는 로그 레벨입니다.

TRACE: 가장 상세한 로그 레벨. 보통 디버깅 용도로 사용됩니다.
DEBUG: 디버깅 정보를 기록하는 로그 레벨.
INFO: 중요한 정보 기록을 위한 로그 레벨.
WARN: 경고 메시지를 기록하는 로그 레벨. 문제가 될 수 있는 상황을 나타냅니다.
ERROR: 오류 상황을 나타내는 로그 레벨. 일반적으로 예상치 못한 예외, 에러 상황 등을 기록합니다.

로그 레벨은 log4j.rootLogger 속성을 통해 설정할 수 있습니다. 위의 설정 파일 예제에서는 DEBUG로 설정되어 있습니다. 필요에 따라 해당 속성의 값을 원하는 로그 레벨로 변경하여 사용할 수 있습니다.

결론

Log4j를 사용하여 로그를 생성하고 관리하는 방법에 대해 알아보았습니다. 로그 레벨을 설정하는 것은 로그의 상세함과 중요도를 조절하는 데 매우 중요합니다. Log4j의 다양한 로그 메소드와 로그 레벨 설정을 사용하여 애플리케이션의 로그를 효율적으로 관리할 수 있습니다.

더 많은 정보를 원한다면 Log4j 공식 문서를 참조해주세요.