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 옵션을 다음과 같이 갱신하십시오.



주의사항

이 정보는 미국에서 제공되는 제품 및 서비스용으로 작성된 것입니다.

IBM은 다른 국가에서 이 문서에 기술된 제품, 서비스 또는 기능을 제공하지 않을 수도 있습니다. 현재 사용할 수 있는 제품 및 서비스에 대한 정보는 한국 IBM 담당자에게 문의하십시오. 이 책에서 IBM 제품, 프로그램 또는 서비스를 언급했다고 해서 해당 IBM 제품, 프로그램 또는 서비스만을 사용할 수 있다는 것을 의미하지는 않습니다. IBM의 지적 재산권을 침해하지 않는 한, 기능상으로 동등한 제품, 프로그램 또는 서비스를 대신 사용할 수도 있습니다. 그러나 비IBM 제품, 프로그램 또는 서비스의 운영에 대한 평가 및 검증은 사용자의 책임입니다.

IBM은 이 문서에서 다루고 있는 특정 내용에 대해 특허를 보유하고 있거나 현재 특허 출원 중일 수 있습니다. 이 문서를 제공한다고 해서 특허에 대한 라이센스까지 부여하는 것은 아닙니다. 라이센스에 대한 의문사항은 다음으로 문의하십시오.

135-270
서울특별시 강남구 도곡동 467-12
군인공제회관빌딩
한국 아이.비.엠 주식회사
고객만족센터
전화번호: 080-023-8080

2바이트(DBCS) 정보에 관한 라이센스 문의는 한국 IBM 고객만족센터에 문의하거나 다음 주소로 서면 문의하시기 바랍니다.

IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106-0032, Japan

다음 단락은 현지법과 상충하는 영국이나 기타 국가에서는 적용되지 않습니다. IBM은 타인의 권리 비침해, 상품성 및 특정 목적에의 적합성에 대한 묵시적 보증을 포함하여(단, 이에 한하지 않음) 묵시적이든 명시적이든 어떠한 종류의 보증없이 이 문서를 "현상태대로" 제공합니다. 일부 국가에서는 특정 거래에서 명시적 또는 묵시적 보증의 면책사항을 허용하지 않으므로, 이 사항이 적용되지 않을 수도 있습니다.

이 정보에는 기술적으로 부정확한 내용이나 인쇄상의 오류가 있을 수 있습니다. 이 정보는 주기적으로 변경되며, 변경된 사항은 최신판에 통합됩니다. IBM은 이 책에서 설명한 제품 및/또는 프로그램을 사전 통지 없이 언제든지 개선 및/또는 변경할 수 있습니다.

이 정보에서 언급되는 비IBM의 웹 사이트는 단지 편의상 제공된 것으로, 어떤 방식으로든 이들 웹 사이트를 옹호하고자 하는 것은 아닙니다. 해당 웹 사이트의 자료는 본 IBM 제품 자료의 일부가 아니므로 해당 웹 사이트 사용으로 인한 위험은 사용자 본인이 감수해야 합니다.

IBM은 귀하의 권리를 침해하지 않는 범위 내에서 적절하다고 생각하는 방식으로 귀하가 제공한 정보를 사용하거나 배포할 수 있습니다.

(i) 독립적으로 작성된 프로그램과 기타 프로그램(본 프로그램 포함) 간의 정보 교환 및 (ii) 교환된 정보의 상호 이용을 목적으로 본 프로그램에 관한 정보를 얻고자 하는 라이센스 사용자는 다음 주소로 문의하십시오.

135-270
서울특별시 강남구 도곡동 467-12
군인공제회관빌딩
한국 아이.비.엠 주식회사
고객만족센터

이러한 정보는 해당 조건(예를 들어, 사용료 지불 등)하에서 사용될 수 있습니다.

이 정보에 기술된 라이센스가 있는 프로그램 및 이 프로그램에 대해 사용 가능한 모든 라이센스가 있는 자료는 IBM이 IBM 기본 계약, IBM 프로그램 라이센스 계약(IPLA) 또는 이와 동등한 계약에 따라 제공한 것입니다.

본 문서에 포함된 모든 성능 데이터는 제한된 환경에서 산출된 것입니다. 따라서 다른 운영 환경에서 얻어진 결과는 상당히 다를 수 있습니다. 일부 성능은 개발 단계의 시스템에서 측정되었을 수 있으므로 이러한 측정치가 일반적으로 사용되고 있는 시스템에서도 동일하게 나타날 것이라고는 보증할 수 없습니다. 또한 일부 성능은 추정을 통해 추측되었을 수도 있으므로 실제 결과는 다를 수 있습니다. 이 책의 사용자는 해당 데이터를 본인의 특정 환경에서 검증해야 합니다.

비IBM 제품에 관한 정보는 해당 제품의 공급업체, 공개 자료 또는 기타 범용 소스로부터 얻은 것입니다. IBM에서는 이러한 비IBM 제품을 반드시 테스트하지 않았으므로, 이들 제품과 관련된 성능의 정확성, 호환성 또는 기타 주장에 대해서는 확인할 수 없습니다. 비IBM 제품의 성능에 대한 의문사항은 해당 제품의 공급업체에 문의하십시오.

저작권 라이센스:

이 정보에는 여러 운영 플랫폼에서의 프로그래밍 기법을 보여주는 원어로 된 샘플 응용프로그램이 들어 있습니다. 귀하는 이러한 샘플 프로그램의 작성 기준이 된 운영 플랫폼의 응용프로그램 프로그래밍 인터페이스(API)에 부합하는 응용프로그램을 개발, 사용, 판매 또는 배포할 목적으로 추가 비용없이 이들 샘플 프로그램을 어떠한 형태로든 복사, 수정 및 배포할 수 있습니다. 이러한 샘플 프로그램은 모든 조건하에서 완전히 테스트된 것은 아닙니다. 따라서 IBM은 이들 샘플 프로그램의 신뢰성, 서비스 가능성 또는 기능을 보증하거나 암시하지 않습니다.

이러한 샘플 프로그램 또는 파생 제품의 각 사본이나 그 일부에는 반드시 다음과 같은 저작권 표시가 포함되어야 합니다.

(C) (귀하의 회사명) (연도). 이 코드의 일부는 IBM Corp.의 샘플 프로그램에서 파생됩니다. (C) Copyright IBM Corp. 2006. All rights reserved.

이 정보를 소프트카피로 보는 경우에는 사진과 컬러 삽화가 제대로 나타나지 않을 수도 있습니다.

프로그래밍 인터페이스

프로그래밍 인터페이스 정보는 이 프로그램을 사용한 응용프로그램 소프트웨어 작성을 돕기 위해 제공됩니다.

범용 프로그래밍 인터페이스를 사용하여 해당 프로그램 도구의 서비스를 확보하는 응용프로그램 소프트웨어를 작성할 수 있습니다.

그러나 이 정보에는 또한 진단, 수정 및 조정 정보가 포함될 수도 있습니다. 진단, 수정 및 조정 정보는 응용프로그램 소프트웨어 디버그를 돕기 위해 제공됩니다.

경고: 변경되기 쉬우므로 해당 진단, 수정 및 조정 정보를 프로그래밍 인터페이스로 사용하지 마십시오.

상표 및 서비스표

다음 용어는 미국 또는 기타 국가에서 사용되는 IBM Corporation의 상표입니다.

Java 및 모든 Java 기반 상표는 미국 또는 기타 국가에서 사용되는 Sun Microsystems, Inc.의 상표입니다.

Microsoft, Windows, Windows NT 및 Windows 로고는 미국 또는 기타 국가에서 사용되는 Microsoft Corporation의 상표입니다.

Intel, Intel Xeon 및 Pentium은 미국 또는 기타 국가에서 사용되는 Intel Corporation 또는 그 계열사의 상표 또는 등록상표입니다.

UNIX는 미국 또는 기타 국가에서 사용되는 The Open Group의 등록상표입니다.

Linux는 미국 또는 기타 국가에서 사용되는 Linus Torvalds의 등록상표입니다.

기타 회사, 제품 또는 서비스 이름은 타사의 상표 또는 서비스표입니다.


(C) Copyright IBM Corporation 2000, 2006. All Rights Reserved.