IBM® Enterprise Records 애플리케이션에 사용자가 구성할 수 있는 샘플 log4j.properties 파일이 포함되어 있습니다.
log4j.properties 파일은 ier_install_path\RecordsManagerSweep 폴더에 있으며, 다음 특성에 대한 파일에 값을 지정하여 로깅 동작을 구성할 수 있습니다.
log4j.properties 파일의 각 로거에 레벨이 지정됩니다. 로거에 레벨을 지정하지 않는 경우 log4j에서 지정되지 않은 로거에 상위 로거의 레벨을 자동으로 지정합니다. 기본적으로 로거에 WARN 레벨이 지정됩니다.
다른 로거, 어펜더 및 레이아웃 설정으로 log4j.properties 파일을 구성할 수 있습니다. 클래스 경로에서 런타임 시 애플리케이션에서 log4j.properties 파일이 사용 가능해야 합니다. 명령문 접두부로 해시 기호(#)를 붙여 샘플 파일에서 항목의 주석을 처리할 수 있습니다. 해시 기호(#)가 표시된 항목은 런타임 시 건너 뜁니다.
log4j.properties 파일을 열려면, ier_install_path\RecordsManagerSweep 폴더로 이동한 후 텍스트 편집기를 사용하여 파일을 여십시오.
먼저 로거를 설정해야 합니다. 애플리케이션에 필요한 로깅 유형을 분류하기 위해 여러 로거를 사용할 수 있습니다. com.filenet.rm의 모든 클래스 및 해당 하위 패키지에 대한 로깅을 사용하려면 다음 명령문에 표시된 대로 로거를 지정하십시오.
log4j.logger.com.filenet.rm
또는 로거의 이름을 지정할 수 있습니다. 예를 들어, 다음 명령문에 표시된 대로 로거의 이름을 APILOG로 지정할 수 있습니다.
log4j.logger.com.filenet.rm=warn, APILOG
런타임 시 log4j에 의해 기록된 메시지의 세부사항 레벨을 설정하려면 로깅 레벨을 설정해야 합니다. log4j에서는 다음 표에 표시된 대로 5개의 보통 로깅 레벨을 지원합니다.
레벨 | 설명 |
---|---|
DEBUG | 애플리케이션을 디버그하는 데 가장 유용한 세분화된 정보 이벤트를 지정합니다. |
INFO | 비세분 레벨에서 애플리케이션의 진행을 강조표시하는 정보 메시지를 지정합니다. |
WARN | 잠재적으로 유해한 상황을 지정합니다. |
ERROR | 애플리케이션이 계속해서 실행되도록 허용하는 오류 이벤트를 지정합니다. |
FATAL | 애플리케이션 실행을 중지시킬 수 있는 심각한 오류 이벤트를 지정합니다. |
특수 및 사용자 정의 로깅 레벨에 대한 정보는 Apache 웹 사이트의 log4j 문서를 참조하십시오. 기본적으로 애플리케이션이 WARN 레벨에서 시작됩니다. 런타임 시 이 레벨을 DEBUG, INFO, ERROR, WARN 또는 FATAL 레벨로 수정할 수 있습니다. 또한 동일한 로거에 대해 각각 레벨이 다른 여러 로거 명령문을 포함할 수 있습니다(예: DEBUG 및 WARN). 명령문 접두부로 해시 기호(#)를 붙여 샘플 파일에서 둘 중 하나의 주석을 처리할 수 있습니다. 그런 다음, 필요에 따라 DEBUG 레벨과 WARN 레벨 간에 전환하십시오. 해시 기호(#)가 표시된 항목은 런타임 시 건너 뜁니다. 레벨이 없는 로거는 상위 로거의 레벨을 자동으로 상속합니다. 기본적으로, IBM Enterprise Records에서 API 로거에 WARN 레벨이 지정됩니다.
로거는 로그 메시지를 출력 매체에 쓸 수 있도록 하나 이상의 어펜더와 연관되어 있습니다. 로그 정보를 지정된 출력 위치에 송신하는 log4j.properties 파일에 다른 종류의 어펜더를 설정할 수 있습니다. 다음 표에서는 간단한 설명 및 관련 옵션과 함께 log4j.properties 파일에서 사용되는 모든 어펜더의 목록을 제공합니다.
어펜더 | 설명 및 코드 단편 |
---|---|
NTEventLogAppender | Microsoft Windows NT 이벤트 로그에 추가합니다. 이 어펜더가 설치되고 Windows 시스템에만 사용할 수 있습니다.
|
ConsoleAppender | 사용자가 지정한 레이아웃을 사용하여 System.out(기본값) 또는 System.err 스트림에 로그 메시지를 추가합니다.
옵션:
|
FileAppender | 로그 메시지를 파일에 추가합니다.
옵션:
|
RollingFileAppender | 특정 크기에 도달하면 로그 파일을 백업하도록 FileAppender를 확장합니다.
옵션:
|
log4j.properties 파일에 로그 메시지 형식을 지정하는 여러 다른 레이아웃을 설정할 수 있습니다. 로그 메시지에 날짜, 시간, 모듈 이름, 스레드 이름 및 기타 정보가 포함되도록 지정할 수 있습니다. 이러한 구성 설정은 메시지를 로깅하는 동안 런타임 시 사용됩니다.
다음 표에서는 간단한 설명 및 관련 옵션과 함께 IBM Enterprise Records log4j.properties 파일에서 사용되는 모든 레이아웃의 목록을 제공합니다.
레이아웃 | 설명 및 코드 단편 |
---|---|
SimpleLayout | 레벨은 인쇄하며 대시(-) 뒤에 로그 메시지 텍스트가 옵니다.
|
PatternLayout | 지정된 변환 패턴에 따라 로깅 이벤트를 형식화합니다. 변환 패턴은 리터럴 텍스트 및 변환 지정자로 구성됩니다. 리터럴 텍스트는 있는 그대로의 출력입니다. 변환 지정자는 % 문자 뒤에 선택적 형식 수정자 및 필수 변환 문자가 오는 방식으로 구성됩니다. 예를 들어, %-5p [%t]: %m%n은 우선순위 변환 지정자 다음에 리터럴 텍스트 " ["가 오는 방식으로 구성된 변환 패턴입니다. 이 문자열 뒤에는 스레드 변환 지정자가 오며, 그 뒤에는 리터럴 텍스트 "]: "가 옵니다. 이 문자열 뒤에는 메시지 변환 지정자와 시스템별 행 구분 기호가 옵니다.
옵션:
|
HTMLLayout | 출력을 HTML 테이블로 형식화합니다.
옵션:
|
출력을 XML로 형식화합니다.
옵션:
|
IBM Enterprise Records와 함께 제공되는 log4j.properties 파일은 로그 메시지 형식에 PatternLayout을 사용합니다. 다음 표에서는 간단한 설명과 함께 구성 파일에 선언할 수 있는 변환 패턴의 목록을 제공합니다.
패턴 | 설명 |
---|---|
%t | 로그 요청을 작성하는 스레드 이름 |
%c | 로그 요청과 연관된 로거 수 |
%-60c | 최소 60 간격 내에 로거 이름을 왼쪽으로 맞춤 |
%r | 애플리케이션을 시작한 후 경과된 시간(밀리초) |
%p | 로그 명령문의 레벨 |
%m | 메시지 |
%Time | 로깅이 발생하는 시간 |
%d | 로깅 이벤트 날짜 |
%n | 줄 바꾸기 |
다음 코드 명령문은 PatternLayout을 사용하고 단순 변환 패턴을 지정하는 방법을 보여줍니다.
log4j.appender.APILOG.layout=org.apache.log4j.PatternLayout
log4j.appender.APILOG.layout.ConversionPattern=%-5p %d {dd MMM yyyy HH:mm:ss,SSS}, -%m, %r, [%M] % n
예:
WARN, 20 Jun 2005 14:48:20,900, -[enter] getObjectStoreXML(ObjectStores), 102042, [setLoggerMessage]
WARN, 20 Jun 2005 14:48:21,100, -[exit] getObjectStoreXML(ObjectStores), 102342, [setLoggerMessage]