Generic Log Adapter 릴리스 정보

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

릴리스 정보

1.0 알려진 제한사항, 문제점 및 해결책
   1.1 Generic Log Adapter가 연속적으로 실행되는 경우 최종 레코드가 처리되지 않습니다
   1.2 UNIX에서 WebSphere Application Server 로그를 구문 분석하는 경우의 제한사항
   1.3 UNIX에서 WebSphere MQ 오류 로그를 구문 분석하는 경우의 제한사항
   1.4 Generic Log Adapter 로깅 정보
   1.5 로그 파일 유형에 대한 유효성 검증이 실행되지 않습니다
   1.6 다른 로케일에서 생성된 로그 파일을 구문 분석하는 경우의 제한사항
   1.7 고유하지 않은 세 문자의 시간대 기호가 있는 로그 파일을 구문 분석하는 경우 부정확한 이벤트 작성 시간이 리턴됩니다
   1.8 DB2 Express Diagnostic 로그용으로 구문 분석한 Common Base Event가 스펙에 일치하지 않습니다
   1.9 로그 파일을 구문 분석하는 중 어댑터 유효성 검증 오류가 발생합니다
   1.10 로그 파일을 구문 분석하는 중 포맷터 오류가 발생합니다
   1.11 로그를 구문 분석하는 중의 구성 문제점

1.0 알려진 제한사항, 문제점 및 해결책

1.1 Generic Log Adapter가 연속적으로 실행되는 경우 최종 레코드가 처리되지 않습니다

Generic Log Adapter는 Agent Controller에 번들로 포함되어 있습니다. Generic Log Adapater를 사용하여 사용자 정의 로그 형식의 어댑터를 작성할 수 있습니다. Generic Log Adapter가 연속적으로 로그 파일을 모니터링할 때, 종료 패턴이 지정되어 있지 않으면 마지막 레코드가 처리되지 않습니다. Generic Log Adapter가 종료될 때에만 마지막 레코드가 처리됩니다.

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

1.2 UNIX에서 WebSphere Application Server 로그를 구문 분석하는 경우의 제한사항

UNIX™ 플랫폼에서 Generic Log Adapter를 사용하여 WebSphere® Application Server 2진 활동 또는 서비스를 구문 분석하는 경우 사용자는 WebSphere Application Server 설치자 보다 더 높은 권한을 갖고 있어야 합니다.

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

1.3 UNIX에서 WebSphere MQ 오류 로그를 구문 분석하는 경우의 제한사항

UNIX 플랫폼에서 Generic Log Adapter를 사용하여 WebSphere MQ 오류 로그를 구문 분석하는 경우 사용자는 WebSphere MQ 설치자 보다 더 높은 권한을 가지고 있어야 합니다.

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

1.4 Generic Log Adapter 로깅 정보

Generic Log Adapter가 Eclipse 환경 외부에서 독립 모드로 실행되는 경우 현재 작업 디렉토리의 hgla.log 파일에 메시지와 오류를 로그합니다. hgla.log 파일이 이미 존재하는 경우 hgla.nnnnnnnn.log라고 하는 새 로그 파일이 작성되는데, 여기서 nnnnnnnn은 고유 번호입니다. Generic Log Adapter가 로그 가져오기 조작의 일부로 실행되는 경우 로그 및 추적 분석기의 오류 대화 상자에 오류 메시지가 표시됩니다.

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

Generic Log Adapter는 어댑터 구성 파일의 컨텍스트 및 컴포넌트에 대한 loggingLevel 설정에 따라 5, 10, 20, 30, 50 및 60의 5가지 로깅 레벨로 이벤트를 로그합니다. hgla.log 파일을 Common Base Event XML 파일 유형으로 로그 및 추적 분석기로 가져오기하여, 로그 파일을 구문 분석하는 중에 Generic Log Adapter에서 발생한 문제점을 진단할 수 있습니다.

1.5 로그 파일 유형에 대한 유효성 검증이 실행되지 않습니다

구문 분석 중인 로그 파일의 유형이 어댑터 파일 구성과 일치하는지 판별하기 위한 Generic Log Adapter의 유효성 검증 작업이 수행되지 않습니다.   예를 들어 어댑터 파일의 센서 구성에 지정된 로그 파일이 구문 분석기 구성의 추출기 구성 및 대체 규칙에 설계된 유형과 일치하지 않을 경우 예상하지 못한 결과가 발생할 수 있습니다.  구문 분석에는 오류 없이 성공할 수 있지만 얻어지는 Common Base Event 데이터가 부정확합니다.  부정확한 데이터가 발견되었다는 오류 메시지와 함께 구문 분석이 실패할 수 있습니다.

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

1.6 다른 로케일에 생성된 로그 파일을 구문 분석하는 경우의 제한사항

Generic Log Adapter가 실행되고 있는 로케일과 다른 로케일에 시간소인이 들어 있는 로그 파일을, creationTime의 대체 규칙에 있는 시간 형식 속성을 사용하도록 구성된 규칙 기반 어댑터 파일을 사용하여 구문 분석하는 경우 시간소인 및 기타 로그 레코드 데이터가 올바르게 구문 분석되지 않습니다. 예를 들어 얻어지는 Common Base Event의 creationTime 값이 0이고 Common Base Event 메시지 필드가 공백이 될 수 있습니다.

이 문제점을 해결하려면 규칙 기반 어댑터 파일에 있는 컨텍스트 인스턴스의 ISO 언어 코드와 ISO 국가 코드 속성 값이 구문 분석할 로그 파일에 있는 시간소인의 로케일에 부합되게 하십시오.

1.7 고유하지 않은 세 문자의 시간대 기호가 있는 로그 파일을 구문 분석하는 경우 부정확한 이벤트 작성 시간이 리턴됩니다

세 문자로 된 시간대 기호를 사용하는 로그 파일을 Generic Log Adapter를 사용하여 Common Base Event 형식으로 변환하는 경우, 세 문자로 된 시간대 기호가 고유하지 않으면 올바르지 않은 로그 이벤트 작성 시간이 만들어집니다. 예를 들어 "IST"라는 세 문자 기호는 Israeli Standard Time, Indian Standard Time, Iran Standard Time 또는 Irish Summer Time으로 해석될 수 있습니다.  

1.8 DB2 Express Diagnostic 로그용으로 구문 분석한 Common Base Event가 스펙에 일치하지 않습니다

 GLA_INSTALL\GenericLogAdapter\config\DB2\diag\tool에 있는 어댑터를 사용하여 IBM® DB2® Express Diagnostic 로그를 구문 분석하는 경우, 출력 파일에 쓰여지는 Common Base Event가 Common Base Event 스펙의 일부를 위반합니다. 이는 DB2 Diagnostic 로그를 Common Base Event로 변환하는 데 사용된 db2diag.exe 유틸리티의 버그 때문입니다. 이 문제점이 구문 분석 조작에 다른 영향을 미치지는 않습니다. db2diag.exe를 수정할 때까지는 알려진 해결책이 없습니다.

1.9 로그 파일을 구문 분석하는 중 어댑터 유효성 검증 오류가 발생합니다

이전 버전의 어댑터 구성 편집기를 사용하여 작성한 어댑터 파일을 가지고 로그 파일을 구문 분석하면 Generic Log Adapter 로그 파일 hgla.log에 다음 오류 메시지가 쓰여집니다.

IWAT0383E 어댑터 검증 오류: cvc-complex-type.4: 'lineBreakSymbol' 속성이 'ex:Extractor' 요소에 나타나야 합니다.

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

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

1.10 로그 파일을 구문 분석하는 중 포맷터 오류가 발생합니다

이전 버전의 어댑터 구성 편집기를 사용하여 작성된 어댑터 파일을 가지고 로그 파일을 구문 분석하면 Generic Log Adapter 로그 파일 hgla.log에 다음과 같은 오류 메시지가 쓰여집니다.

IWAT0438E Common Base Event 포맷터 N76D20B0042411D98000E0362B33D6F0가 필수 속성 sourceComponentId가 누락되어 CommonBaseEvent를 작성할 수 없습니다.

이 메시지는 sourceComponentId가 Common Base Event의 필수 특성인데 이것이 누락되었으므로 Generic Log Adapter의 포맷터 컴포넌트가 Common Base Event를 작성할 수 없음을 표시합니다. 이제 Generic Log Adapter는 모든 필수 특성이 Common Base Event에 존재하는지 검증하고, 누락된 특성이 있을 경우 Common Base Event가 리턴되지 않습니다. 메시지에 표시된 특성에 대한 구문 분석 규칙이 어댑터 파일에 없거나 구문 분석 규칙이 올바르지 않습니다.

이 문제점을 해결하려면 필수 Common Base Event 특성이 누락된 어댑터 파일에 구문 분석기 규칙을 추가하거나 기존 규칙이 올바른지 확인하십시오.

1.11 로그를 구문 분석하는 중의 구성 문제점

로그를 구문 분석할 때 다음과 같은 오류 메시지가 콘솔에 쓰여집니다.

IWAT0310E Generic Log Adapter는 구성 문제점으로 인해 시작할 수 없습니다.
IWAT0317E AdapterLogSensor 컴포넌트를 빌드하는 중 오류 발생
IWAT0319E Class org.eclipse.hyades.logging.adapter.internal.util.AdapterSensor는 인스턴트화될 수 없습니다.   예외 = org/eclipse/emf/ecore/EObject

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