通用日誌配接器 6.0.1 版 - Readme

已知的問題和暫行解決方案

  1.0 當通用日誌配接器在進行連續執行時,沒有處理最後一筆記錄
  1.1 在 UNIX 剖析 WebSphere Application Server 日誌時有其限制
  1.2 在 UNIX 剖析 WebSphere MQ 錯誤日誌時有其限制
  1.3 無法利用 runregex_showlog_example.bat/sh 來剖析日誌檔
  1.4 剖析某些日誌時,會產生不正確的時區資訊
  1.5 所產生的延伸資料元素無效
  1.6 通用日誌配接器 Script 無法在 z/OS 上正常讀取
  1.7 通用日誌配接器記載資訊和限制
  1.8 沒有驗證日誌檔類型
  1.9 剖析 WebSphere Application Server activity.log 檔時有其限制
  1.10 剖析不同語言環境中產生的日誌檔時有其限制
  1.11 無法利用 Windows XP Unzip 公用程式來解壓縮
  1.12 利用各別的靜態剖析器來監視 WebSphere Application Server activity.log 檔和 IBM HTTP Server 錯誤日誌檔時有其限制
  1.13 利用非唯一的三字母時區符號來剖析日誌檔時,可能會傳回不正確的事件建立時間

您可在 TPTP 3.3 版版本注意事項中取得其他關聯於 TPTP 通用日誌配接器的 Readme 資訊。

1.0 當通用日誌配接器在進行連續執行時,沒有處理最後一筆記錄

當通用日誌配接器在連續監視日誌檔時,如果沒有指定結尾型樣,就不會處理最後一筆記錄。 只有關閉通用日誌配接器,才會處理最後一筆記錄。

如果一定要在進行監視時,處理最後一筆記錄,請為通用日誌配接器配置檔中的記錄,提供結尾型樣。

1.1 在 UNIX 剖析 WebSphere Application Server 日誌時有其限制

使用者如果要在 UNIX 平台上,利用通用日誌配接器來剖析 WebSphere Application Server 二進位活動或服務日誌,必須具備與 WebSphere Application Server 安裝程式同等或更大的專用權。

如果要暫時解決這項限制,最好在剖析這個二進位活動或服務日誌之前,先將它移到與通用日誌配接器使用者專用權相同的目錄下。

1.2 在 UNIX 剖析 WebSphere MQ 錯誤日誌時有其限制

使用者如果要在 UNIX 平台上,利用通用日誌配接器來剖析 WebSphere MQ 錯誤日誌時,必須具備與 WebSphere MQ 安裝程式同等或更大的專用權。

如果要暫時解決這項限制,請在剖析 MQ 錯誤日誌之前, 先將它移到具備與通用日誌配接器使用者同等專用權的目錄下。

1.3 無法利用 runregex_showlog_example.bat/sh 來剖析日誌檔

當您試圖利用 runregex_showlog_example.bat 和 runregex_showlog_example.sh 來剖析 WebSphere Application Server 活動日誌時, 找不到 WebSphere Application 顯示日誌公用程式。

如果要暫時解決這個問題,請在規則編輯器中編輯 regex_showlog_example.adapter 檔, 並且更新感應器轉換器內容,讓它指向 WebSphere Application Server 適當的目錄位置。

1.4 剖析某些日誌時,會產生不正確的時區資訊

剖析某些日誌,會產生不正確的時區資訊。

日誌檔的時間戳記必須含有時區資訊, 它所產生的剖析資料,其 creationTime 值才會含有正確的時區。 如果日誌檔中的時間戳記沒有時區資訊, 通用日誌配接器就會產生時區資訊不正確的 creationTime 值。

1.5 所產生的延伸資料元素無效

如果沒有設定尋找相符名稱或類型值的規則, 通用日誌配接器所產生的日誌記錄 extendedDataElements Common Base Event 元素便無效。 如果日誌記錄沒有剖析出任何名稱或類型,但通用日誌配接器只會以值欄位產生名稱或類型, 這樣應該就不會產生 extendedDataElement。

如果要暫時解決這個問題,請務必提供規則,這些規則會產生您要比對的 extendedDataElement 的下列三個欄位(名稱、值、類型)。

1.6 通用日誌配接器 Script 無法在 z/OS 上正常讀取

將 z/OS 中的 runtime.zip 和 rules.zip 解壓縮,有時會產生無法讀取的 Script 檔。

如果要避免這個問題,請務必按照下列程序,將 z/OS 系統上的 runtime.zip 和 rules.zip 解壓縮。

unzip -a runtime.zipunzip -a rules.zipunzip -o rules.zip *.adapterunzip -o runtime.zip *.xsd

1.7 通用日誌配接器記載資訊

當通用日誌配接器在 Eclipse 環境外執行時,會將訊息和錯誤記載到 hgla.log 檔中。如果是以獨立式模式執行,就會在現行工作目錄中建立 hgla.log 檔。如果是利用日誌和追蹤分析器進行遠端日誌匯入作業,hgla.log 檔會依 Agent Controller 配置檔 serviceconfig.xmlSYS_TEMP_DIR 變數指定的方式放在遠端系統的暫時目錄中。比方說,如果是在 UNIX 或 Linux 系統上執行,hgla.log 檔會放在 /tmp/var/tmp 目錄中;如果是在 Windows 系統上執行,該檔案會放在 c:\Documents and Settings\userid\Local Settings\Temp 中。

當您在 Eclipse 環境內部執行時, 比方說,利用日誌和追蹤分析器來進行本端日誌匯入作業時,通用日誌配接器會將訊息和錯誤記載到 Eclipse 工作區目錄之 .metadata\.plugins\org.eclipse.hyades.logging.adapter 目錄中的 hgla.log 檔。

通用日誌配接器是以 10、20、30、50 和 60 的記載層次來記載事件。hgla.log 檔可以匯入到日誌和追蹤分析器, 來診斷通用日誌配接器在剖析日誌檔時所遇到的問題。

1.8 沒有驗證日誌檔類型

通用日誌配接器沒有進行任何驗證作業,來判斷您所剖析的日誌檔類型,是否與配接器檔案配置相符。比方說,如果在配接器檔中的感應器配置所指定的日誌檔, 並非擷取器配置和剖析器配置中替代規則被指定的類型,可能會發生無法預期的結果。剖析作業也許會順利完成,沒有產生錯誤,但是得出的 Common Base Event 資料卻不正確。剖析作業也許會失敗,而且出現錯誤訊息,告訴您資料不正確。

如果要暫時解決這個問題,請確定感應器元件配置中所指定的日誌檔,其類型是正確的。

1.9 剖析 WebSphere Application Server activity.log 檔時有其限制

如果是在非英文的機器上,利用 runregex_showlog_example.bat/sh 來剖析二進位 WebSphere Application Server 活動日誌檔, 日誌記錄資料就無法順利對映到 Common Base Event。有些日誌記錄資料會出現在不正確的 Common Base Event 欄位中。

1.10 剖析不同語言環境中產生的日誌檔時有其限制

在剖析日誌檔時,如果這個日誌檔所含的時間戳記,不是位於執行通用日誌配接器所在的語言環境, 而且所用的規則型配接器檔,在 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

或者,您也可以在相關聯的環境定義實例屬性中指定時間戳記語言環境的語言碼和國碼,來變更規則型配接器檔案。

1.11 無法利用 Windows XP Unzip 公用程式來解壓縮

您在 Windows XP 安裝通用日誌配接器時,Windows XP 原有的 Unzip 公用程式無法將通用日誌配接器 rules.zip 檔解壓縮。 無法解壓縮部分目錄和檔案。因此,有些日誌檔類型就無法用通用日誌配接器來剖析。 如果要暫時解決這個問題,當在 Windows XP 中安裝時,請使用另一個 unzip 公用程式,如 WinZip 或 UnZip。

1.12 利用各別的靜態剖析器來監視 WebSphere Application Server activity.log 檔和 IBM HTTP Server 錯誤日誌檔時有其限制

利用各別的靜態剖析器來持續剖析 IBM WebSphere Application Server 活動日誌和 IBM HTTP Server 錯誤日誌檔時,已剖析輸出中有時候會遺漏記錄。更具體的說法是,當日誌檔附加了新記錄時,附加記錄的第一筆記錄未被剖析,因此,也未併入已剖析輸出中。當您利用日誌之靜態配接器配置檔中的 continuousOperation="true" 來配置環境定義實例時,就會發生這個問題。若要暫行解決這個問題,您可以在環境定義實例中配置 continuousOperation="false",來將日誌檔剖析一次,或者,您也可以利用規則型配接器來持續監視。

1.13 利用非唯一的三字母時區符號來剖析日誌檔時,可能會傳回不正確的事件建立時間

利用日誌配接器,將採用三字母時區符號的日誌檔轉換成 CBE 格式時,如果三字母時區符號是非唯一的,就可能會造成不正確的日誌事件建立時間。例如,三字母時區符號 "IST" 可能解譯為 Israeli Standard Time(以色列標準時間)、Indian Standard Time(印度標準時間)、Iran Standard Time(伊朗標準時間)或 Irish Summer Time(愛爾蘭夏令時間)。

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

返回主要 Readme 檔

版權和注意事項