IBM FileNet P8, 버전 5.1.+            

Workplace XT 로깅 구성

IBM® FileNet® Workplace XT는 Apache log4j 제품을 사용하여 해당 로깅을 관리합니다. 로깅 중에 애플리케이션 활동에 대한 정보는 콘솔 또는 파일 등과 같은 출력 위치에 작성됩니다. 지원 및 개발 담당자는 로그 항목의 정보를 사용하여 애플리케이션 활동을 분석할 뿐만 아니라 문제점을 진단하고 해결합니다. 로깅은 진단 전용이며 보안 또는 감사 추적 정보를 제공하지 않습니다.

log4j 제품은 Workplace XT 설치 중에 설치됩니다. 기본적으로 로깅은 설치 중에는 사용 가능하지 않습니다.

로깅을 사용 또는 사용 안함으로 설정하려면 다음을 수행하십시오.

  1. 설치 중에 지정된 Workplace XT 구성 폴더로 이동하십시오. 기본 경로는 다음과 같습니다. 설치 중에 지정된 Workplace XT 구성 폴더입니다. 기본 경로는 다음과 같습니다.
    • Windows: <drive>:\Program Files\FileNet\Config\WebClient
    • UNIX: /opt/FileNet/config/WebClient
  2. 구성 파일의 이름을 바꿔서 로깅을 사용 또는 사용 안함으로 설정하십시오. 샘플 로깅 구성 파일은 __log4j.properties라고 부릅니다.
    • 로깅을 사용하려면 __log4j.properties to log4j.properties의 이름을 바꾸십시오.
    • 로깅을 사용 안함으로 설정하려면 log4j.properties의 이름을 다른 이름(예: __log4j.properties)으로 바꾸십시오.
  3. 변경을 적용하려면 애플리케이션을 다시 시작하십시오.

로깅 설정 구성

샘플 log4j.properties 파일에는 keyword=value 쌍으로 지정된 기본 옵션 세트가 있습니다. 기본값을 변경하려면 텍스트 편집기로 log4j.properties를 열고, 필요에 따라 수정하고 파일을 저장하십시오. 설치 후에 언제든지 로깅 설정을 구성할 수 있습니다. 로깅 구성 파일의 변경은 자동으로 인식되므로 애플리케이션 또는 애플리케이션 서버를 다시 시작할 필요가 없습니다.

다음 주제는 파일에서 보게 되는 로깅 구성 옵션의 일부에 대한 몇몇 정보를 제공합니다. 로깅 옵션에 대한 자세한 정보는 로깅 프로젝트 아래의 Apache 웹 사이트(http://apache.org) 및 Apache로깅 웹 사이트(http://logging.apache.org/log4j/)를 참조하십시오.

로거

로거는 사용 가능한 로깅 요청을 appender에 씁니다. log4j.properties 파일에서 첫 번째 키워드는 루트 로거를 설명합니다. 루트 로거는 계층에서 최상위 레벨 로거이며 글로벌 기본값을 제공합니다. 옵션이 명시적으로 설정되어 있지 않은 모든 하위 로거는 루트 로거로부터 동작을 상속합니다.

Appender

지정된 출력 대상에 형식화된 로그 항목을 전송하는 Appender를 구성하여 로그 데이터를 쓰는 위치를 지정할 수 있습니다. 대상 유형은 파일 또는 콘솔일 수 있습니다. 출력은 Windows Event 로그로 경로 재지정되고 원격 log4j 서버로 전달될 수 있습니다. (모든 출력 대상 및 포맷팅 옵션은 Apache log4j 문서를 참조하십시오.) 단일 로거에 둘 이상의 Appender가 포함될 수 있습니다. 예를 들어, 출력을 콘솔과 파일에 동시에 쓸 수 있습니다. 대상 수를 늘리면 성능에 영향을 미칠 수 있습니다.

Workplace XT에서는 두 개의 Appender가 기본적으로 구성되어 있습니다. 하나의 Appender는 IBM Support Assistant 도구가 로그를 처리하기 위해 사용하는 IBM Common Base Event(CBE) 형식으로 로그 데이터를 쓰고 다른 Appender는 사람이 읽기에 더 쉬운 형식으로 씁니다. 후자의 Appender를 변경하여 출력의 양을 줄이거나 이 Appender를 완전히 끌 수 있습니다.

주:

레벨

사용자가 지정하는 로깅 레벨이 수집된 정보의 유형과 양을 판별합니다. 수집된 정보의 양과 시스템에 미치는 성능 영향 간에 직접적인 상관이 있습니다.

Workplace XT 애플리케이션 로그는 표준 INFO, WARN, ERROR 및 FATAL 레벨뿐만 아니라 ALL 및 OFF 레벨을 지원합니다. 다음 표는 표준 레벨을 간략하게 설명합니다. 레벨에 대한 자세한 정보는 Apache log4j 문서를 참조하십시오.

표 1. 이 표는 표준 INFO, WARN, ERROR 및 FATAL 레벨뿐만 아니라 ALL 및 OFF 레벨을 지원합니다.
레벨 설명
INFO 애플리케이션의 진행을 대략적으로 설명하는 정보 메시지를 요청합니다.
WARN 잠재적으로 해로운 상황에 대한 로깅을 요청합니다.
ERROR 애플리케이션 내에서 발생된 로깅 예외를 요청합니다.
FATAL 애플리케이션 장애로 이어질 수 있는 매우 심각한 오류 이벤트의 로깅만을 요청합니다.

사용자가 지정하는 레벨이 수집된 정보의 양을 판별합니다. 수집된 정보의 양과 시스템에 미치는 성능 영향 간에 직접적인 상관이 있습니다.

출력 파일 형식

Appender를 구성할 때에는 레이아웃 키워드를 사용하여 데이터를 쓰는 형식을 지정할 수 있습니다. PatternLayout 및 ConversionPattern을 선택하십시오. PatternLayout은 로그 항목의 특정 패턴을 지정하고 Appender에 작성되는 요소 패턴을 식별하는 ConversionPattern은 패턴을 정의합니다. 이 예제를 고려하십시오.

log4j.appender.ErrorOutputFile=org.apache.log4j.RollingFileAppender log4j.appender.ErrorOutputFile.layout=org.apache.log4j.PatternLayout log4j.appender.ErrorOutputFile.layout.ConversionPattern=%d [%t] - %-5p %m\r\n

다음 형식화된 로그 항목이 결과로 나옵니다.

2007-05-31 17:36:12:801 [cwrap] - Document/Checkin ConnectionWrapper.send send.before

포맷팅 옵션에 대한 자세한 정보는 Apache log4j 문서를 참조하십시오.

주: IBM Common Base Event(CBE) 로그 항목의 레이아웃을 변경하지 마십시오. 이를 수행하면 IBM Support Assistant 도구가 판독할 수 없는 출력이 렌더링됩니다.

출력 분석

지원 담당자는 애플리케이션 활동을 분석하고 애플리케이션에서 발생하는 문제점을 진단하기 위해 로그 파일의 항목을 검사할 수 있습니다. 또한 IBM Support Assistant(ISA) 도구를 사용하면 분석 단계를 자동화할 수 있습니다. ISA 도구는 log4j에서 로깅 출력의 CBE 항목을 소비합니다.

GUI 기반 로그 뷰어인 Apache Chainsaw와 같은 도구를 사용하여 비CBE 로그 항목을 직접 검사할 수도 있습니다.



피드백

마지막 업데이트 날짜: 2011년 7월


© Copyright IBM Corp. 2011.
이 Information Center는 Eclipse 기술로 구현됩니다. (http://www.eclipse.org 웹 사이트 참조)