19.3. 기본 로깅 구성 파일

19.3.1. 로깅 구성 개요

기본 로깅 구성 파일 logging.propertiesInstallDir/etc 디렉터리에 있습니다. Apache CXF 로거를 구성하여 경고 수준 메시지를 콘솔에 인쇄합니다. 이 수준의 로깅이 애플리케이션에 적합한 경우 사용하기 전에 파일을 변경할 필요가 없습니다. 그러나 로그 메시지의 세부 수준을 변경할 수 있습니다. 예를 들어 로그 메시지가 콘솔로 전송되는지, 파일 또는 둘 다로 전송되는지 여부를 변경할 수 있습니다. 또한 개별 패키지 수준에서 로깅을 지정할 수 있습니다.

참고

이 섹션에서는 기본 logging.properties 파일에 표시되는 구성 속성에 대해 설명합니다. 그러나 설정할 수 있는 다른 많은 java.util.logging 구성 속성이 있습니다. java.util.logging API에 대한 자세한 내용은 java.util.logging javadoc at: http://download.oracle.com/javase/1.5/docs/api/java/util/logging/package-summary.html 을 참조하십시오.

19.3.2. 로깅 출력 구성

19.3.2.1. 개요

Java 로깅 유틸리티인 java.util.logging 은 핸들러 클래스를 사용하여 로그 메시지를 출력합니다. 표 19.1. “java.util.logging Handler 클래스” 는 기본 logging.properties 파일에 구성된 핸들러를 보여줍니다.

표 19.1. java.util.logging Handler 클래스

처리기 클래스다음에 대한 출력

ConsoleHandler

콘솔에 로그 메시지 출력

FileHandler

파일에 로그 메시지 출력

중요

처리기 클래스는 시작될 때 Java VM에 의해 설치되려면 시스템 클래스 경로에 있어야 합니다. 이 작업은 Apache CXF 환경을 설정할 때 수행됩니다.

19.3.2.2. 콘솔 핸들러 구성

예 19.2. “콘솔 핸들러 구성” 콘솔 로거를 구성하는 코드를 보여줍니다.

예 19.2. 콘솔 핸들러 구성

handlers= java.util.logging.ConsoleHandler

콘솔 처리기는 예 19.3. “콘솔 핸들러 속성” 에 표시된 구성 속성도 지원합니다.

예 19.3. 콘솔 핸들러 속성

java.util.logging.ConsoleHandler.level = WARNING
java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter

예 19.3. “콘솔 핸들러 속성” 에 표시된 구성 속성은 다음과 같이 설명할 수 있습니다.

콘솔 핸들러는 별도의 로그 수준 구성 속성을 지원합니다. 이를 통해 글로벌 로깅 설정이 다를 수 있는 동안 콘솔에 인쇄된 로그 메시지를 제한할 수 있습니다( 19.3.3절. “로깅 수준 구성”참조). 기본 설정은 WARNING 입니다.

콘솔 처리기 클래스에서 로그 메시지를 포맷하는 데 사용하는 java.util.logging formatter 클래스를 지정합니다. 기본 설정은 java.util.logging.SimpleFormatter 입니다.

19.3.2.3. 파일 핸들러 구성

예 19.4. “파일 핸들러 구성” 파일 핸들러를 구성하는 코드를 보여줍니다.

예 19.4. 파일 핸들러 구성

handlers= java.util.logging.FileHandler

파일 핸들러는 예 19.5. “파일 핸들러 구성 속성” 에 표시된 구성 속성도 지원합니다.

예 19.5. 파일 핸들러 구성 속성

java.util.logging.FileHandler.pattern = %h/java%u.log
java.util.logging.FileHandler.limit = 50000
java.util.logging.FileHandler.count = 1
java.util.logging.FileHandler.formatter = java.util.logging.XMLFormatter

예 19.5. “파일 핸들러 구성 속성” 에 표시된 구성 속성은 다음과 같이 설명할 수 있습니다.

출력 파일의 위치 및 패턴을 지정합니다. 기본 설정은 홈 디렉토리입니다.

로거가 하나의 파일에 쓰는 최대 양을 바이트 단위로 지정합니다. 기본 설정은 50000 입니다. 이를 0으로 설정하면 로거가 하나의 파일에 쓰는 양에 제한이 없습니다.

사이클할 출력 파일 수를 지정합니다. 기본 설정은 1 입니다.

파일 처리기 클래스에서 로그 메시지를 포맷하는 데 사용하는 java.util.logging formatter 클래스를 지정합니다. 기본 설정은 java.util.logging.XMLFormatter 입니다.

19.3.2.4. 콘솔 핸들러와 파일 핸들러 모두 구성

콘솔 처리기와 파일 핸들러를 콘솔 로깅 및 파일 모두 구성 와 같이 쉼표로 구분하여 지정하여 콘솔 및 파일에 로그 메시지를 출력하도록 logging 유틸리티를 설정할 수 있습니다.

콘솔 로깅 및 파일 모두 구성

Logging

handlers= java.util.logging.FileHandler, java.util.logging.ConsoleHandler

19.3.3. 로깅 수준 구성

19.3.3.1. 로깅 수준

java.util.logging 프레임워크는 최소 세부 정보에서 가장 자세한 정보까지 다음과 같은 로깅 수준을 지원합니다.

  • SEVERE
  • WARNING
  • INFO
  • CONFIG
  • FINE
  • FINER
  • FINEST

19.3.3.2. 글로벌 로깅 수준 구성

모든 로거에 기록된 이벤트 유형을 구성하려면 예 19.6. “글로벌 로깅 수준 구성” 에 표시된 대로 글로벌 로깅 수준을 구성합니다.

예 19.6. 글로벌 로깅 수준 구성

.level= WARNING

19.3.3.3. 개별 패키지에서 로깅 구성

level

java.util.logging 프레임워크는 개별 패키지 수준에서 로깅 구성을 지원합니다. 예를 들어 예 19.7. “패키지 수준에서 로깅 구성” 에 표시된 코드 줄은 com.xyz.foo 패키지의 클래스의 SEVERE 수준에서 로깅을 구성합니다.

예 19.7. 패키지 수준에서 로깅 구성

com.xyz.foo.level = SEVERE