自主運算的通用日誌配接器 - 版本注意事項

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

  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 通用日誌配接器」的 Readme 資訊,請參閱 TPTP 3.3 版的版本注意事項

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.zip
unzip -a rules.zip
unzip -o rules.zip *.adapter
unzip -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 環境內部執行時(例如,使用「日誌和追蹤分析器」來進行本端日誌匯入作業時),「通用日誌配接器」會將日誌訊息及錯誤記載在 hgla.log 檔中(位於 Eclipse 工作區目錄的 .metadata\.plugins\org.eclipse.hyades.logging.adapter 目錄中)。

「通用日誌配接器」會以 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 原有的解壓縮公用程式無法將通用日誌配接器 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" 可解譯成「以色列標準時間」、「印度標準時間」、「伊朗標準時間」或「愛爾蘭夏日時間」。

返回主要 Readme 檔

©Copyright IBM Corporation 2000, 2005. All Rights Reserved.