Generic Log Adapter 릴리스 정보

© Copyright International Business Machines Corporation 2000, 2006. All rights reserved. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

알려진 문제점 및 해결 방법

1.0 Generic Log Adapter가 계속 실행될 때 처리되지 않는 마지막 레코드
1.1 UNIX에서 WebSphere Application Server 로그를 구문 분석할 때 제한사항
1.2 UNIX에서 WebSphere MQ 오류 로그를 구문 분석할 때 제한사항
1.3 runregex_showlog_example.bat/sh를 사용하여 로그 파일을 구문 분석할 때 문제점
1.5 올바르지 않은 확장 데이터 요소 생성
1.7 Generic Log Adapter 로깅 정보 및 제한사항
1.8 로그 파일 유형에서 유효성 검증이 수행되지 않음
1.9 WebSphere Application Server activity.log 파일 구문 분석 제한사항
1.10 서로 다른 로케일에서 생성된 로그 파일 구문 분석 제한사항
1.12 고유하지 않은 3자의 시간대 기호를 사용하는 로그 파일을 구문 분석할 때 이벤트에 대해 올바르지 않은 작성 시간이 리턴될 수 있음
1.13 DB2 Express 진단 로그에 대해 구문 분석된 공통 기반 이벤트가 스펙을 따르지 않음
1.14 로그 파일 구문 분석 시 어댑터 유효성 검증 오류
1.15 로그 파일 구문 분석 시 포맷터 오류
1.16 로그 구문 분석 시 구성 문제점

TPTP Generic Log Adapter와 연관된 추가 readme 정보는 TPTP V4.2 릴리스 정보에서 사용 가능합니다.

1.0 Generic Log Adapter가 계속 실행될 때 처리되지 않는 마지막 레코드

Generic Log Adapter가 로그 파일을 계속 모니터링할 때 종료 패턴을 지정하지 않을 경우 마지막 레코드가 처리되지 않습니다. Generic Log Adapter 시스템 종료 시에만 마지막 레코드가 처리됩니다.

모니터링 중에 마지막 레코드를 처리하려면 Generic Log Adapter 구성 파일의 레코드에 대한 종료 패턴을 제공하십시오.

1.1 UNIX에서 WebSphere Application Server 로그를 구문 분석할 때 제한사항

Generic Log Adapter를 사용하여 UNIXTM 플랫폼에서 WebSphere(R) Application Server 2진 활동 또는 서비스 로그를 구문 분석할 때 사용자는 WebSphere Application Server의 설치자와 동일하거나 또는 보다 큰 특권이 필요합니다.

이러한 제한사항을 해결하려면 로그를 구문 분석하기 전에 2진 활동 또는 서비스 로그를 Generic Log Adapter 사용자와 동일한 특권을 갖는 디렉토리로 이동하십시오.

1.2 UNIX에서 WebSphere MQ 오류 로그를 구문 분석할 때 제한사항

Generic Log Adapter를 사용하여 UNIX 플랫폼에서 WebSphere MQ 오류 로그를 구문 분석할 때 사용자는 WebSphere MQ의 설치자와 동일하거나 또는 보다 큰 특권이 필요합니다.

이러한 제한사항을 해결하려면 로그를 구문 분석하기 전에 MQ 오류 로그를 Generic Log Adapter 사용자와 동일한 특권을 가진 디렉토리로 이동하십시오.

1.3 runregex_showlog_example.bat/sh를 사용하여 로그 파일을 구문 분석할 때 문제점

runregex_showlog_example.bat 및 runregex_showlog_example.sh를 사용하여 WebSphere Application Server 활동 로그를 구문 분석하려고 시도할 때 WebSphere Application showlog 유틸리티를 찾을 수 없습니다.

이러한 문제점을 해결하려면 규칙 편집기에서 regex_showlog_example.adapter 파일을 편집하고 WebSphere Application Server의 적절한 디렉토리 위치를 가리키도록 센서 변환기 특성을 갱신하십시오.

1.5 올바르지 않은 확장 데이터 요소 생성

이름 또는 유형 값에 일치하는 규칙이 없을 경우 Generic Log Adapter에서 로그 레코드에 대해 올바르지 않은 extendedDataElements 공통 기반 이벤트 요소를 생성합니다. 로그 레코드에서 구문 분석된 이름 또는 유형이 없을 경우 extendedDataElement가 생성되지 않아야 하지만 Generic Log Adapter에서 값 필드만을 포함하는 extendedDataElement를 생성합니다.

이러한 문제점을 해결하려면 extendedDataElement의 세 개 필드(이름, 값, 유형)를 모두 일치하게 하는 규칙을 제공했는지 확인하십시오.

1.7 Generic Log Adapter 로깅 정보

Generic Log Adapter를 독립형 모드로 실행할 경우 Eclipse 환경 외부에서 현재 작업 디렉토리의 hgla.log라는 파일에 메시지와 오류가 로그됩니다. hgla.log 파일이 현재 작업 디렉토리에 존재할 경우 hgla.nnnnnnnn.log라는 새 로그 파일이 작성되며 여기서 nnnnnnnn은 고유한 번호입니다. Generic Log Adapter가 로그 가져오기 조작의 일부로 실행될 경우 로그되는 오류 메시지가 Log and Trace Analyzer의 오류 대화 상자에 표시됩니다.

Generic Log Adapter Perspective의 Eclipse 환경 내에서 실행할 경우 Generic Log Adapter에서 로그하는 메시지 및 오류가 문제점 보기에 나열됩니다.

Generic Log Adapter는 어댑터 구성 파일의 컨텍스트 및 컴포넌트에 대한 loggingLevel 설정에 따라 로깅 레벨 5, 10, 20, 30, 50 및 60의 이벤트를 로그합니다. 로그 파일을 구문 분석할 때 Generic Log Adapter에 의해 발생한 문제점을 진단하기 위해 hgla.log 파일을 Log and Trace Analyzer에 공통 기반 이벤트 XML 파일 유형으로 가져올 수 있습니다.

1.8 로그 파일 유형에서 유효성 검증이 수행되지 않음

Generic Log Adapter에서 구문 분석 중인 로그 파일 유형이 어댑터 파일 구성과 일치하는지 판별하기 위한 유효성 검증을 수행하지 않습니다. 예를 들어, 어댑터 파일의 센서 구성에 지정된 로그 파일이 구문 분석기 구성의 추출기 구성 및 대체 규칙이 설계된 유형이 아닐 경우, 예기치 않은 결과가 발생할 수도 있습니다. 구문 분석이 오류 없이 성공할 수 있지만 결과로 생성된 공통 기반 이벤트 데이터는 올바르지 않습니다. 올바르지 않은 데이터가 발생했음을 나타내는 오류 메시지와 함께 구문 분석이 실패할 수도 있습니다.

이러한 문제점을 해결하려면 센서 컴포넌트 구성에 지정된 로그 파일이 올바른 유형인지 확인하십시오.

1.9 WebSphere Application Server activity.log 파일 구문 분석 제한사항

2진 WebSphere Application Server 활동 로그 파일을 영어가 아닌 시스템에서 runregex_showlog_example.bat/sh를 사용하여 구문 분석할 때, 로그 레코드 데이터가 공통 기반 이벤트에 성공적으로 맵핑되지 않습니다.  대신 일부 로그 레코드 데이터가 공통 기반 이벤트의 올바르지 않은 필드에 표시될 수도 있습니다.

1.10 서로 다른 로케일에서 생성된 로그 파일 구문 분석 제한사항

Generic Log Adapter를 실행 중인 로케일과 다른 로케일의 시간소인을 포함하는 로그 파일을 구문 분석할 때 creationTime에 대한 대체 규칙에서 시간 형식 속성을 사용하도록 구성된 규칙 기반 어댑터 파일을 사용할 경우, 시간 소인 및 기타 로그 레코드 데이터가 제대로 구문 분석되지 않을 수도 있습니다. 예를 들어, 결과로 생성되는 공통 기반 이벤트의 creationTime 값이 0이고 공통 기반 이벤트 메시지 필드가 공백일 수도 있습니다.

이러한 문제점을 해결하려면 규칙 기반 어댑터 파일에서 컨텍스트 인스턴스의 ISO 언어 코드 및 ISO 국가 코드 속성 값이 구문 분석할 로그 파일의 시간소인 로케일과 일치하는지 확인하십시오.

1.12 고유하지 않은 3자의 시간대 기호를 사용하는 로그 파일을 구문 분석할 때 이벤트에 대해 올바르지 않은 작성 시간이 리턴될 수 있음

Generic Log Adapter를 사용하여 3자의 시간대 기호를 사용하는 로그 파일을 공통 기반 이벤트 형식으로 변환할 때, 3자의 시간대 기호가 고유하지 않을 경우 로그 이벤트에 대해 올바르지 않은 작성 시간이 발생할 수도 있습니다. 예를 들어, 3자 기호 "IST"는 Israeli Standard Time, Indian Standard Time, Iran Standard Time 또는 Irish Summer Time으로 해석할 수 있습니다.

1.13 DB2 Express 진단 로그에 대해 구문 분석된 공통 기반 이벤트가 스펙을 따르지 않음

IBM(R) DB2(R) Express 진단 로그를 % GLA_Install%\GenericLogAdapter\config\DB2\diag\tool의 어댑터를 사용하여 구문 분석할 경우, 출력 파일에 기록되는 결과로 생성된 공통 기반 이벤트가 일부 공통 기반 이벤트 스펙을 따르지 않습니다. 이는 DB2 진단 로그를 공통 기반 이벤트로 변환하는 데 사용되는 db2diag.exe 유틸리티의 버그로 인하여 발생합니다. 구문 분석 조작에는 영향을 미치지 않습니다. db2diag.exe를 수정하는 것 외에는 알려진 해결 방법이 없습니다.

1.14 로그 파일 구문 분석 시 어댑터 유효성 검증 오류

어댑터 구성 편집기의 이전 버전을 사용하여 작성된 어댑터 파일로 로그 파일을 구문 분석할 경우, 다음과 같은 오류 메시지가 Generic Log Adapter 로그 파일 hgla.log에 기록될 수도 있습니다.

IWAT0383E 어댑터 유효성 검증 오류: cvc-complex-type.4:
'lineBreakSymbol' 속성을 'ex:Extractor' 요소에 표시해야 합니다. 

어댑터 구성 편집기의 이전 버전은 필수 추출기 속성 lineBreakSymbol 없이 어댑터 파일을 작성했습니다. 값이 비어 있을지라도 해당 속성이 추출기 요소에 존재해야 합니다. Generic Log Adapter는 이제 사용 전에 Generic Log Adapter 스키마에 대해 어댑터 파일의 유효성을 검증하며 lineBreakSymbol은 스키마의 필수 속성입니다.

이러한 문제점을 해결하려면 어댑터 구성 편집기에서 어댑터 파일을 열고, 추출기 요소의 lineBreakSymbol 필드에 비어 있는 값을 추가하며, 어댑터 파일을 저장한 후, 필요하지 않을 경우 해당 값을 삭제한 다음 파일을 다시 저장하십시오. 어댑터 파일에서 이제 추출기 요소에 lineBreakSymbol 속성을 포함합니다.

1.15 로그 파일 구문 분석 시 포맷터 오류

어댑터 구성 편집기의 이전 버전을 사용하여 작성된 어댑터 파일로 로그 파일을 구문 분석할 경우 다음과 같은 오류 메시지가 Generic Log Adapter 로그 파일 hgla.log에 기록될 수도 있습니다.

IWAT0438E 필수 특성 sourceComponentId가 누락되었으므로
공통 기반 이벤트 포맷터 N76D20B0042411D98000E0362B33D6F0에서 공통 기반 이벤트를 작성할 수 없습니다. 

이 메시지는 sourceComponentId가 공통 기반 이벤트의 필수 특성이지만 누락되었으므로 Generic Log Adapter 포맷터 컴포넌트에서 공통 기반 이벤트를 작성할 수 없음을 나타냅니다. Generic Log Adapter는 이제 모든 필수 특성이 공통 기반 이벤트에 존재하는지와 누락된 특성이 존재하는지를 검증하며 누락된 특성이 있을 경우 공통 기반 이벤트를 리턴하지 않습니다. 메시지에 표시된 특성에 대한 구문 분석 규칙이 어댑터 파일에 존재하지 않거나 또는 구문 분석 규칙이 올바르지 않습니다.

이러한 문제점을 해결하려면 누락된 필수 공통 기반 이벤트 특성에 대한 어댑터 파일에 구문 분석기 규칙을 추가하거나 또는 기존 규칙이 올바른지 확인하십시오.

1.16 로그 구문 분석 시 구성 문제점

로그를 구문 분석할 때 다음과 같은 오류 메시지가 콘솔에 기록될 수도 있습니다.

이 문제점을 해결하려면 gla.bat 및 gla.sh 런타임 스크립트 파일의 -classpath 옵션을 다음과 같이 갱신하십시오.