© 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.
TPTP Generic Log Adapter와 연관된 추가 readme 정보는 TPTP V4.2 릴리스 정보에서 사용 가능합니다.
Generic Log Adapter가 로그 파일을 계속 모니터링하는 경우, 종료 패턴을 지정하지 않으면 마지막 레코드가 처리되지 않습니다. 마지막 레코드는 Generic Log Adapter가 종료될 때만 처리됩니다.
모니터링 도중에 마지막 레코드가 처리되도록 하려면 Generic Log Adapter 구성 파일에서 레코드에 대한 종료 패턴을 제공하십시오.
Generic Log Adapter를 사용하여 UNIXTM 플랫폼에서 WebSphere(R) Application Server 2진 활동(activity)이나 서비스 로그를 구문 분석할 경우, 사용자는 WebSphere Application Server 의 설치 권한과 같거나 그 이상의 특권을 가지고 있어야 합니다.
이 제한사항을 해결하려면, 로그를 구문 분석하기 전에 Generic Log Adapter의 사용자와 동일한 특권을 가진 디렉토리로 2진 활동(activity) 또는 서비스를 이동시키십시오.
UNIX 플랫폼에서 WebSphere MQ 오류 로그를 구문 분석할 경우, 사용자는 WebSphere MQ를 설치한 특권과 같거나 그 이상의 특권이 있어야 합니다.
이 제한사항을 해결하려면, 로그를 구문 분석하기 전에 Generic Log Adapter의 사용자와 동일한 특권을 같는 디렉토리로 MQ 오류 로그를 이동시키십시오.
runregex_showlog_example.bat 및 runregex_showlog_example.sh를 사용하여 WebSphere Application Server 활동 로그를 구문 분석하는 데 필요한 WebSphere Application showlog 유틸리티를 호출할 수 없습니다.
이 문제를 해결하려면, 규칙 편집기에서 regex_showlog_example.adapter 파일을 편집하여 센서 변환기 특성이 WebSphere Application Server의 올바른 디렉토리 위치를 지시하도록 변경하십시오.
Generic Log Adapter는 이름이나 유형 값에 대해 일치하는 규칙이 없을 경우, 로그 레코드에 대해 올바르지 않은 extendedDataElements 공통 기본 이벤트 요소를 생성합니다. 로그 레코드에서 구문 분석된 이름이나 유형이 없는데 Generic Log Adapter가 값 필드만을 갖는 로그 레코드를 생성하는 경우, extendedDataElement를 생성하지 말아야 합니다.
이 문제를 해결하려면, extendedDataElement의 세 필드(이름, 값, 유형) 모두 일치하는 규칙을 제공해야 합니다.
Generic Log Adapter가 Eclipse 환경의 외부에서 독립형 모드로 실행될 경우, 현재의 작업 디렉토리에 있는 hgla.log라는 파일에 메시지와 오류를 로깅합니다. 이미 hgla.log 파일이 현재 디렉토리에 있으면 hgla.nnnnnnnn.log(여기서 nnnnnnnn은 고유 번호)라는 로그 파일이 새로 작성됩니다. Generic Log Adapter가 로그 가져오기 조작의 파트로 실행되는 경우, 로깅되는 오류 메시지는 로그 및 추적 분석기의 오류 대화 상자에 표시됩니다.
Generic Log Adapter Perspective의 Eclipse 환경에서 실행될 때, Generic Log Adpater에 의해 로깅되는 메시지 및 오류는 문제점 보기에 나열됩니다.
Generic Log Adapter는 어댑터 구성 파일의 컨텍스트 및 컴포넌트에 대한 loggingLevel의 설정에 따라 5, 10, 20, 30, 50 및 60의 로깅 레벨로 이벤트를 로깅할 수 있습니다. hgla.log 파일은 로그 파일의 구문 분석 시 Generic Log Adapter에서 발생하는 문제점을 진단하기 위해 공통 기본 이벤트 XML 파일 유형으로 로그 및 추적 분석기로 가져올 수 있습니다.
Generic Log Adapter는 구문 분석 중인 로그 파일 유형이 어댑터 파일 구성과 일치하는지 판별하기 위해 유효성 검증을 수행하지 않습니다.예를 들어, 어댑터 파일의 센서 구성에 지정된 로그 파일이 구문 분석기 구성에서 추출기 구성 및 대체 규칙용으로 디자인된 유형이 아닐 경우, 예측할 수 없는 결과가 발생할 수 있습니다.구문 분석은 오류 없이 성공할 수 있지만 공통 기본 이벤트 데이터는 올바르지 않게 됩니다.올바르지 않은 데이터가 발견되었음을 표시하는 오류 메시지와 함께 구문 분석이 실패할 수 있습니다.
이 문제를 해결하려면, 센서 컴포넌트 구성에 지정된 로그 파일이 올바른 유형의 로그 파일인지 확인하십시오.
영어가 아닌 다른 언어를 사용하는 시스템에서 runregex_showlog_example.bat/sh를 사용하여 2진 WebSphere Application Server 활동 로그 파일을 구문 분석할 경우, 로그 레코드 데이터는 공통 기본 이벤트에 제대로 맵핑되지 않습니다. 대신, 일부 로그 레코드 데이터가 공통 기본 이벤트의 올바르지 않은 필드에 표시될 수 있습니다.
creationTime의 대체 규칙에 시간 형식 속성을 사용하도록 구성된 규칙 기반 어댑터 파일을 사용하여, Generic Log Adapter가 실행 중인 로케일과 다른 로케일로 된 시간소인이 있는 로그 파일을 구문분석할 경우, 시간소인과 기타 로그 레코드 데이터가 올바르게 구문 분석되지 않을 수 있습니다. 예를 들면, 결과로 생성되는 공통 기본 이벤트의 creationTime 값은 0이 되고 공통 기본 이벤트 msg 필드는 공백이 될 수 있습니다.
이 문제점을 해결하려면 규칙 기반의 어댑터 파일에 있는 컨텍스트 인스턴스의 ISO 언어 코드 및 ISO 국가 코드 속성 값이 구문 분석할 로그 파일의 시간소인 로케일과 일치하는지 확인하십시오.
Generic Log Adatper를 사용하여 세 문자 시간대 기호를 사용하는 로그 파일을 공통 기본 이벤트 형식으로 변환하는 경우, 세 문자 시간대 기호가 고유하지 않으면 로그 이벤트의 작성 시간이 올바르지 않을 수 있습니다. 예를 들어, 세 문자 "IST"는 이스라엘 표시 시간, 인도 표준 시간, 이란 표준 시간 또는 아일랜드 써머 타임으로 해석될 수 있습니다.
IBM(R) DB2(R) Express 진단 로그를 % GLA_Install%\GenericLogAdapter\config\DB2\diag\tool의 어댑터로 구문 분석하는 경우, 그 결과로서 출력 파일에 쓰여진 공통 기본 이벤트는 공통 기본 이벤트 스펙의 일부를 손상시킵니다. 이것은 DB2 진단 로그를 공통 기본 이벤트로 변환하는 데 사용되는 db2diag.exe 유틸리티의 결함으로 인한 것입니다. 그렇지 않은 경우에는 구문 분석 조작에 영향을 주지 말아야 합니다. db2diag.exe가 수정될 때까지 알려진 임시 해결 방법이 없습니다.
이전 버전의 어댑터 구성 편집기로 작성된 어댑터 파일과 함께 로그 파일의 구문을 분석하면 다음의 오류 메시지가 Generic Log Adapter 로그 파일인 hgla.log에 작성될 수 있습니다.
IWAT0383E 어댑터 유효성 검증 오류: cvc-complex-type.4: 속성 'lineBreakSymbol'가 'ex:Extractor' 요소에 표시되어야 합니다.
이전 버전의 어댑터 구성 편집기는 필수적인 추출기 속성 lineBreakSymbol이 없는 어댑터 파일을 작성합니다. 이 속성은 값이 비어 있더라도 추출기 요소에 있어야 합니다. 현재 Generic Log Adapter는 어댑터 파일을 사용하기 전에 Generic Log Adapter 스키마에 대해 어댑터 파일의 유효성을 검증하며 이 스키마에서 lineBreakSymbol은 필수 속성입니다.
이 문제점을 해결하려면 어댑터 파일을 어댑터 구성 편집기에서 열고 추출기 요소의 lineBreakSymbol 필드에 공백이 아닌 값을 추가하고 어댑터 파일을 저장한 다음, 그 값이 필수가 아니면 삭제하고 파일을 다시 저장하십시오. 그러면 어댑터 파일의 추출기 요소에 lineBreakSymbol 속성이 포함됩니다.
이전 버전의 어댑터 구성 편집기로 작성된 어댑터 파일과 함께 로그 파일의 구문을 분석하면 다음의 오류 메시지가 Generic Log Adapter 로그 파일인 hgla.log에 작성될 수 있습니다.
필수 특성 sourceComponentId가 누락되었으므로 IWAT0438E 공통 기본 이벤트 포맷터 N76D20B0042411D98000E0362B33D6F0는 CommmonBaseEvent를 작성할 수 없습니다.
sourceComponentId는 공통 기본 이벤트의 필수 특성이고 누락되어 있으므로 이 메시지는 Generic Log Adapter의 포맷터 컴포넌트가 공통 기본 이벤트를 작성할 수 없음을 표시합니다. 그 다음 Generic Log Adapter는 모든 필수 특성이 공통 기본 이벤트에 있는지 확인하고 누락된 특성이 있으면 공통 기본 이벤트가 리턴되지 않습니다. 메시지에 표시된 특성에 대한 구문 분석 규칙이 이 어댑터 파일에 없거나 구문 분석 규칙이 올바르지 않습니다.
이 문제점을 해결하려면 누락된 필수 공통 기본 이벤트의 특성에 대한 어댑터 파일에 구문 분석기 규칙을 추가하고 기존 규칙이 올바른지 확인하십시오.
로그의 구문 분석 시, 다음 오류가 콘솔에 표시될 수 있습니다.
IWAT0310E 구성 문제점 때문에 Generic Log Adapter를 시작할 수 없습니다. IWAT0317E 오류 구성 컴포넌트 AdapterLogSensor. IWAT0319E 클래스 org.eclipse.hyades.logging.adapter.internal.util.AdapterSensor는 구현될 수 없습니다. Exception = org/eclipse/emf/ecore/EObject이 문제점을 해결하려면 gla.bat 및 gla.sh 런타임 스크립트 파일에 있는 -classpath 옵션을 다음과 같이 갱신하십시오.
이 정보는 미국에서 제공되는 제품 및 서비스용으로 작성된 것입니다.
IBM은 다른 국가에서 이 문서에 기술된 제품, 서비스 또는 기능을 제공하지 않을 수도 있습니다. 현재 사용할 수 있는 제품 및 서비스에 대한 정보는 한국 IBM 담당자에게 문의하십시오. 이 책에서 IBM 제품, 프로그램 또는 서비스를 언급했다고 해서 해당 IBM 제품, 프로그램 또는 서비스만을 사용할 수 있다는 것을 의미하지는 않습니다. IBM의 지적 재산권을 침해하지 않는 한, 기능상으로 동등한 제품, 프로그램 또는 서비스를 대신 사용할 수도 있습니다. 그러나 비IBM 제품, 프로그램 또는 서비스의 운영에 대한 평가 및 검증은 사용자의 책임입니다.
IBM은 이 문서에서 다루고 있는 특정 내용에 대해 특허를 보유하고 있거나 현재 특허 출원 중일 수 있습니다. 이 문서를 제공한다고 해서 특허에 대한 라이센스까지 부여하는 것은 아닙니다. 라이센스에 대한 의문사항은 다음으로 문의하십시오.
135-270
2바이트(DBCS) 정보에 관한 라이센스 문의는 한국 IBM 고객만족센터에 문의하거나 다음 주소로 서면 문의하시기 바랍니다.
IBM World Trade Asia Corporation
이 정보에는 기술적으로 부정확한 내용이나 인쇄상의 오류가 있을 수 있습니다. 이 정보는 주기적으로 변경되며, 변경된 사항은 최신판에 통합됩니다. IBM은 이 책에서 설명한 제품 및/또는 프로그램을 사전 통지 없이 언제든지 개선 및/또는 변경할 수 있습니다.
이 정보에서 언급되는 비IBM의 웹 사이트는 단지 편의상 제공된 것으로, 어떤 방식으로든 이들 웹 사이트를 옹호하고자 하는 것은 아닙니다. 해당 웹 사이트의 자료는 본 IBM 제품 자료의 일부가 아니므로 해당 웹 사이트 사용으로 인한 위험은 사용자 본인이 감수해야 합니다.IBM은 귀하의 권리를 침해하지 않는 범위 내에서 적절하다고 생각하는 방식으로 귀하가 제공한 정보를 사용하거나 배포할 수 있습니다.
(i) 독립적으로 작성된 프로그램과 기타 프로그램(본 프로그램 포함) 간의 정보 교환 및 (ii) 교환된 정보의 상호 이용을 목적으로 본 프로그램에 관한 정보를 얻고자 하는 라이센스 사용자는 다음 주소로 문의하십시오.
135-270이러한 정보는 해당 조건(예를 들어, 사용료 지불 등)하에서 사용될 수 있습니다.
본 문서에 기술된 라이센스가 부여된 프로그램 및 이 프로그램에 사용할 수 있는 모든 라이센스가 부여된 자료는 IBM이 IBM 기본 계약(ICA), IBM 국제 프로그램 라이센스 계약 또는 이와 동등한 계약에 따라 제공됩니다.
본 문서에 포함된 모든 성능 데이터는 제한된 환경에서 산출된 것입니다. 따라서 다른 운영 환경에서 얻어진 결과는 상당히 다를 수 있습니다. 일부 성능은 개발 단계의 시스템에서 측정되었을 수 있으므로 이러한 측정치가 일반적으로 사용되고 있는 시스템에서도 동일하게 나타날 것이라고는 보증할 수 없습니다. 또한 일부 성능은 추정을 통해 추측되었을 수도 있으므로 실제 결과는 다를 수 있습니다. 이 책의 사용자는 해당 데이터를 본인의 특정 환경에서 검증해야 합니다.
비IBM 제품에 관한 정보는 해당 제품의 공급업체, 공개 자료 또는 기타 범용 소스로부터 얻은 것입니다. IBM에서는 이러한 비IBM 제품을 반드시 테스트하지 않았으므로, 이들 제품과 관련된 성능의 정확성, 호환성 또는 기타 주장에 대해서는 확인할 수 없습니다. 비IBM 제품의 성능에 대한 의문사항은 해당 제품의 공급업체에 문의하십시오.
저작권:이 정보에는 여러 운영 플랫폼에서의 프로그래밍 기법을 보여주는 소스 언어로 된 샘플 응용프로그램이 들어 있습니다. 귀하는 이러한 샘플 프로그램의 작성 기준이 된 운영 플랫폼의 응용프로그램 프로그래밍 인터페이스(API)에 부합하는 응용프로그램을 개발, 사용, 판매 또는 배포하기 위한 목적으로 이러한 샘플 프로그램을 추가 비용 없이 어떤 형태로든 복사, 수정 및 배포할 수 있습니다. 이러한 샘플 프로그램은 모든 조건하에서 완전히 테스트된 것은 아닙니다. 따라서 IBM은 이들 샘플 프로그램의 신뢰성, 서비스 가능성 또는 기능을 보증하거나 암시하지 않습니다.
이러한 샘플 프로그램 또는 파생 제품의 각 사본이나 그 일부에는 반드시 다음과 같은 저작권 표시가 포함되어야 합니다.(C) (귀하의 회사명) (연도). 이 코드의 일부는 IBM Corp.의 샘플 프로그램에서 파생됩니다. (C) Copyright IBM Corp. 2006. All rights reserved.
이 정보를 소프트카피로 확인하는 경우에는 사진과 컬러 삽화가 제대로 표시되지 않을 수도 있습니다.
프로그래밍 인터페이스 정보는 본 프로그램을 사용하는 응용프로그램 소프트웨어의 작성을 돕기 위해 제공됩니다.
귀하는 범용 프로그래밍 인터페이스를 통해 본 프로그램 툴의 서비스를 제공하는 응용프로그램 소프트웨어를 작성할 수 있습니다.
그러나 본 정보에는 진단, 수정 및 조정 정보도 포함되어 있습니다. 진단, 수정 및 성능 조정 정보는 응용프로그램 소프트웨어의 디버그를 돕기 위해 제공된 것입니다.
경고: 진단, 수정 및 조정 정보는 변경될 수 있으므로 프로그래밍 인터페이스로 사용할 수 없습니다.
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.