TPTP Generic Log Adapter와 연관된 추가 readme 정보는 TPTP V3.3 릴리스 정보에서 사용 가능합니다.
Generic Log Adapter가 로그 파일을 계속 모니터링할 때 종료 패턴을 지정하지 않으면 마지막 레코드가 처리되지 않습니다. 마지막 레코드는 Generic Log Adapter를 종료할 때 처리됩니다.
모니터 도중에 마지막 레코드가 처리되도록 하려면 Generic Log Adapter 구성 파일에서 레코드에 대한 종료 패턴을 제공하십시오.
Generic Log Adapter를 사용하여 UNIX® 플랫폼에서 WebSphere Application Server의 2진 활동(activity)이나 서비스 로그를 구문 분석할 경우, 사용자는 WebSphere Application Server 프로그램을 설치한 권한과 같거나 그 이상의 특권을 가지고 있어야 합니다.
이 제한사항을 해결하려면, 로그를 구문 분석하기 전에 Generic Log Adapter 사용자와 같은 특권을 가지고 있는 디렉토리로 2진 활동 또는 서비스 로그를 이동시키십시오.
UNIX 플랫폼에서 Generic Log Adapter를 사용하여 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의 올바른 디렉토리 위치를 지시하도록 변경하십시오.
일부 로그 구문 분석 시 올바르지 않은 시간대 정보가 생성됩니다.
시간대 정보를 포함하는 시간소인이 있는 로그 파일에만 올바른 시간대를 갖는 creationTime 값으로 구문 분석된 데이터가 생성됩니다. 로그 파일의 시간소인에 시간대 정보가 없으면 Generic Log Adapter에서 올바르지 않은 시간대 정보가 있는 creationTime 값을 생성합니다.
Generic Log Adapter는 이름이나 유형 값에 대해 일치하는 규칙이 없을 경우, 로그 레코드에 대해 유효하지 않은 extendedDataElements 공통 기본 이벤트 요소가 생성됩니다. 로그 레코드에서 구문 분석된 이름이나 유형이 없는 경우 extendedDataElement가 생성되지 않아야 하지만, Generic Log Adapter는 값 필드만으로도 로그 레코드를 생성합니다.
이 문제점을 해결하려면, extendedDataElement의 세 필드(이름, 값, 유형) 모두 일치하는 규칙을 제공해야 합니다.
z/OS 에서 runtime.zip 및 rules.zip의 압축을 해제하면 읽을 수 없는 스크립트 파일이 생성됩니다.
이 문제가 발생하지 않도록 하려면, z/OS 시스템에서 runtime.zip 및 rules.zip 압축을 풀 때 다음을 수행하십시오.
unzip -a runtime.zip unzip -a rules.zip unzip -o rules.zip *.adapter unzip -o runtime.zip *.xsd
Generic Log Adapter가 Eclipse 환경 외부에서 실행될 경우, hgla.log라고 하는 파일에 메시지와 오류를 로깅합니다. 독립형 모드에서 실행할 경우, hgla.log 파일은 현재 작업 디렉토리에 작성됩니다. 로그 및 추적 분석기를 사용하여 원격 로그 가져오기 조작의 일부로 실행할 때, hgla.log 파일은 Agent Controller 구성 파일 serviceconfig.xml의 SYS_TEMP_DIR 변수에 지정된 대로 임시 디렉토리의 원격 시스템에 위치합니다. 예를 들어, UNIX 또는 Linux™ 시스템에서 실행 중인 경우 hgla.log 파일은 /tmp 또는 /var/tmp 디렉토리에 위치하며 Windows 시스템에서 실행 중인 경우 c:\Documents and Settings\userid\Local Settings\Temp에 위치합니다.
Eclipse 환경 내부에서 실행(예를 들어, 로그 및 추적 분석기를 사용하여 로컬 로그 가져오기 조작의 일부로)하면, Generic Log Adapter는 메시지 및 오류를 Eclipse 작업공간 디렉토리에서 .metadata\.plugins\org.eclipse.hyades.logging.adapter 디렉토리의 hgla.log 파일에 로깅합니다.
Generic Log Adapter는 로깅 레벨 10, 20, 30, 50 및 60의 이벤트를 로깅합니다. hgla.log 파일을 로그 및 추적 분석기로 가져와서 로그 파일을 구문 분석하면 Generic Log Adapter에 의해 발생된 문제를 진단할 수 있습니다.
Generic Log Adapter는 구문 분석 중인 로그 파일 유형이 어댑터 파일 구성과 일치하는지 판별하기 위해 유효성 검증을 수행하지 않습니다. 예를 들어, 어댑터 파일의 센서 구성에 지정된 로그 파일이 구문 분석기 구성에서 추출기 구성 및 대체 규칙용으로 디자인된 유형이 아닐 경우, 예측할 수 없는 결과가 발생할 수 있습니다. 구문 분석은 오류없이 성공할 수 있지만 공통 기본 이벤트 데이터는 올바르지 않게 됩니다.올바르지 않은 데이터가 발견되었음을 표시하는 오류 메시지와 함께 구문 분석에 실패할 수 있습니다.
이 문제점을 해결하려면, 센서 구성요소 구성에 지정된 로그 파일이 올바른 유형의 로그 파일인지 확인하십시오.
영어를 사용하지 않는 시스템에서 runregex_showlog_example.bat/sh를 사용하여 2진 WebSphere Application Server 활동 로그 파일을 구문 분석할 경우, 로그 레코드 데이터는 공통 기본 이벤트에 제대로 맵핑되지 않습니다.일부 로그 레코드 데이터가 공통 기본 이벤트의 올바르지 않은 필드에 표시될 수 있습니다.
Generic Log Adapter가 실행 중인 로케일과 다른 로케일로, creationTime의 대체 규칙에 시간 형식 속성을 사용하도록 구성된 규칙 기반 어댑터 파일을 사용하여 시간소인이 있는 로그 파일을 구문 분석할 경우, 시간소인과 기타 로그 레코드 데이터가 올바르게 구문 분석되지 않을 수 있습니다.예를 들어, 일본어 시스템에서 config\IHS\access\v1.3.19.3\runregex_example.bat/sh를 사용하여 영어 IBM HTTP Server 액세스 로그를 구문 분석할 경우, 결과로 생성되는 공통 기본 이벤트의 creationTime 값은 0 값을 갖게 되고 공통 기본 이벤트 msg 필드는 공백이 됩니다.
이 문제점을 해결하려면, 다음 JVM 매개변수를 java 명령에 추가하여 runregex_example.bat/sh 파일을 변경하십시오.
-Duser.language=2-char-language-code -Duser.region=2-char-country-code
여기서, language 및 country 코드는 시간소인 로케일에 해당됩니다. 언급된 예제의 경우, JVM 매개변수는 다음과 같습니다.
-Duser.language=en -Duser.region=US
또는 연관된 컨텍스트 인스턴스 속성에서 시간소인 로케일의 언어 및 국가 코드를 지정하여 규칙 기반 어댑터 파일을 변경하십시오.
Windows XP에 Generic Log Adapter를 설치할 경우, Windows XP 기본 unzip 유틸리티를 사용하여 Generic Log Adapter rules.zip 파일의 압축을 풀 때 문제가 발생합니다. 일부 디렉토리 및 압축 파일이 풀리지 않습니다. 이 문제 때문에 일부 로그 파일 유형을 Generic Log Adapter로 구문 분석할 수 없습니다. 이 문제점을 해결하려면, Windows XP에서 설치할 때 다른 unzip 유틸리티(예: WinZip 또는 UnZip)를 사용하십시오.
각 정적 구문 분석기에서 연속적으로 IBM WebSphere Application Server 활동 로그 및 IBM HTTP Server 오류 로그 파일를 구문 분석하면 구문 분석된 출력에서 레코드가 누락됩니다. 특히, 로그 파일이 새 레코드에 추가되면 추가된 레코드의 첫 번째 레코드는 구문 분석되지 않으며 구문 분석된 출력에 포함되지 않습니다. 컨텍스트 인스턴스가 로그의 정적 어댑터 구성 파일에서 continuousOperation="true"로 구성되면 이 문제점이 발생합니다. 이 문제점을 해결하려면, continuousOperation="false"로 컨텍스트 인스턴스를 구성하여 로그 파일을 한 번만 구문 분석하거나 규칙 기반 어댑터를 사용하여 연속적으로 모니터링하십시오.
로그 어댑터를 사용하여 세 문자 시간대 기호를 사용하는 로그 파일을 CBE 형식으로 변환 시, 세 문자 시간대 기호가 고유하지 않으면 로그 이벤트의 작성 시간이 올바르지 않을 수 있습니다. 예를 들어, 세 문자 "IST"는 이스라엘 표시 시간, 인도 표준 시간, 이란 표준 시간 또는 아일랜드 써머 타임으로 해석될 수 있습니다.
©Copyright IBM Corporation 2000, 2005. All Rights Reserved.