如需其他有關「TPTP 通用日誌配接器」的 Readme 資訊,請參閱 TPTP 3.3 版的版本注意事項。
當通用日誌配接器在連續監視日誌檔時,如果沒有指定結尾型樣,就不會處理最後一筆記錄。 只有關閉通用日誌配接器,才會處理最後一筆記錄。
如果一定要在進行監視時,處理最後一筆記錄,請為通用日誌配接器配置檔中的記錄,提供結尾型樣。
使用者如果要在 UNIX® 平台上,利用通用日誌配接器來剖析 WebSphere Application Server 二進位活動或服務日誌,必須具備與 WebSphere Application Server 安裝程式同等或更大的專用權。
如果要暫時解決這項限制,最好在剖析這個二進位活動或服務日誌之前,先將它移到與通用日誌配接器使用者專用權相同的目錄下。
使用者如果要在 UNIX 平台上,使用通用日誌配接器來剖析 WebSphere MQ 錯誤日誌時,必須具備與 WebSphere MQ 安裝程式同等或更大的專用權。
如果要暫時解決這項限制,請在剖析 MQ 錯誤日誌之前, 先將它移到具備與通用日誌配接器使用者同等專用權的目錄下。
當您試圖使用 runregex_showlog_example.bat 和 runregex_showlog_example.sh 來剖析 WebSphere Application Server 活動日誌時, 找不到 WebSphere Application 顯示日誌公用程式。
如果要暫時解決這個問題,請在規則編輯器中編輯 regex_showlog_example.adapter 檔, 並且更新感應器轉換器內容,讓它指向 WebSphere Application Server 適當的目錄位置。
在剖析部分日誌時,所產生的時區資訊不正確。
日誌檔的時間戳記必須含有時區資訊, 它所產生的剖析資料,其 creationTime 值才會含有正確的時區。 如果日誌檔中的時間戳記沒有時區資訊, 通用日誌配接器就會產生時區資訊不正確的 creationTime 值。
如果沒有設定尋找相符名稱或類型值的規則, 通用日誌配接器所產生的日誌記錄 extendedDataElements Common Base Event 元素便無效。 如果日誌記錄沒有剖析出任何名稱或類型,但通用日誌配接器只會以值欄位產生名稱或類型, 這樣應該就不會產生 extendedDataElement。
如果要暫時解決這個問題,請務必提供規則,這些規則會產生您要比對的 extendedDataElement 的下列三個欄位(名稱、值、類型)。
將 z/OS 中的 runtime.zip 和 rules.zip 解壓縮,有時會產生無法讀取的 Script 檔。
如果要避免這個問題,請務必按照下列程序,將 z/OS 系統上的 runtime.zip 和 rules.zip 解壓縮。
unzip -a runtime.zip unzip -a rules.zip unzip -o rules.zip *.adapter unzip -o runtime.zip *.xsd
當通用日誌配接器在 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 環境內部執行時(例如,使用「日誌和追蹤分析器」來進行本端日誌匯入作業時),「通用日誌配接器」會將日誌訊息及錯誤記載在 hgla.log 檔中(位於 Eclipse 工作區目錄的 .metadata\.plugins\org.eclipse.hyades.logging.adapter 目錄中)。
「通用日誌配接器」會以 10、20、30、50 和 60 的記載層次來記載事件。 hgla.log 檔可以匯入到「日誌和追蹤分析器」, 以診斷「通用日誌配接器」在剖析日誌檔時所遇到的問題。
通用日誌配接器沒有進行任何驗證作業,來判斷您所剖析的日誌檔類型,是否與配接器檔案配置相符。比方說,如果在配接器檔中的感應器配置所指定的日誌檔, 並非擷取器配置和剖析器配置中替代規則被指定的類型,可能會發生無法預期的結果。剖析作業也許會順利完成,沒有產生錯誤,但是得出的 Common Base Event 資料卻不正確。剖析作業也許會失敗,而且出現錯誤訊息,告訴您資料不正確。
如果要暫時解決這個問題,請確定感應器元件配置中所指定的日誌檔,其類型是正確的。
如果是在非英文的機器上,使用 runregex_showlog_example.bat/sh 來剖析二進位 WebSphere Application Server 活動日誌檔, 日誌記錄資料就無法順利對映到 Common Base Event。有些日誌記錄資料會出現在不正確的 Common Base Event 欄位中。
在剖析日誌檔時,如果這個日誌檔所含的時間戳記,不是位於執行通用日誌配接器所在的語言環境, 而且所用的規則型配接器檔,在 creationTime 的替代規則中必須使用時間格式屬性, 這時候,時間戳記和其他日誌記錄資料可能就無法正確剖析了。例如,當在日文機器中,使用 config\IHS\access\v1.3.19.3\runregex_example.bat/sh 來剖析英文的 IBM HTTP Server 存取日誌檔時, 結果 Common Base Events 中的 creationTime 值為零,Common Base Event msg 欄位會空白。
如果要暫時解決這個問題,請在 Java 指令加上下列 JVM 參數,來變更 runregex_example.bat/sh 檔:
-Duser.language=2-char-language-code -Duser.region=2-char-country-code
其中,語言碼和國碼是針對時間戳記所在的語言環境而設。 以上例來說,JVM 參數為:
-Duser.language=en -Duser.region=US
或者,可以在相關聯的「環境定義實例」屬性中指定時間戳記語言環境的語言及國碼,以變更規則型配接器檔案。
您在 Windows XP 安裝通用日誌配接器時,Windows XP 原有的解壓縮公用程式無法將通用日誌配接器 rules.zip 檔解壓縮。 無法解壓縮部分目錄和檔案。因此,有些日誌檔類型就無法用通用日誌配接器來剖析。 如果要暫時解決這個問題,當在 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.