標準日誌配接器的版本注意事項

© 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.

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

1.0 標準日誌配接器連續執行時,沒有處理最後一筆記錄
1.1 在 UNIX 上剖析 WebSphere Application Server 日誌時有其限制
1.2 在 UNIX 上剖析 WebSphere MQ 錯誤日誌時有其限制
1.3 使用 runregex_showlog_example.bat/sh 來剖析日誌檔發生問題
1.5 產生的延伸資料元素無效
1.7 標準日誌配接器記載資訊和限制
1.8 未驗證日誌檔類型
1.9 剖析 WebSphere Application Server activity.log 檔時有其限制
1.10 剖析不同語言環境下產生的日誌檔時有其限制
1.12 剖析的日誌檔含有非唯一的三個字母時區符號時,可能會傳回不正確的事件建立時間
1.13 DB2 Express 診斷日誌剖析的「通用基礎事件」不符規格
1.14 剖析日誌檔時發生配接器驗證錯誤
1.15 剖析日誌檔時發生格式製作程式錯誤
1.16 剖析日誌時發生配置問題

如需「TPTP 標準日誌配接器」的其他 Readme 資訊,請參閱 TPTP 4.2 版的版本注意事項

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

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

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

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

在 UNIXTM 平台上使用「標準日誌配接器」來剖析 WebSphere(R) 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.5 所產生的延伸資料元素無效

如果缺少符合 name 或 type 值的規則,「標準日誌配接器」將為日誌記錄產生無效的 extendedDataElements「通用基礎事件」元素。 如果不會從日誌記錄剖析 name 或 type,則不應該產生 extendedDataElement,但「標準日誌配接器」會產生一個只有 value 欄位的元素。

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

1.7 標準日誌配接器記載資訊

當「標準日誌配接器」在 Eclipse 環境之外以獨立模式執行時, 訊息和錯誤會記載至現行工作目錄中的 hgla.log 檔案。 如果現行工作目錄中已有 hgla.log 檔案,則會建立新的日誌檔 hgla.nnnnnnnn.log,其中的 nnnnnnnn 是唯一數字。 在日誌匯入作業中執行「標準日誌配接器」時,記載的錯誤訊息會顯示在「日誌和追蹤分析器」的錯誤對話框。

在 Eclipse 環境內的「標準日誌配接器」視景中執行時, 「標準日誌配接器」所記載的訊息和錯誤會列在「問題」視圖中。

「標準日誌配接器」會以 5、10、20、30、50 及 60 記載層次來記載事件, 取決於配接器配置檔中的 Contexts 和 Components 的 loggingLevel 設定。 hgla.log 檔案可當做「通用基礎事件」XML 檔案類型匯入「日誌和追蹤分析器」中, 以診斷「標準日誌配接器」在剖析日誌檔時發生的問題。

1.8 日誌檔類型未完成驗證

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

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

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

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

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

在剖析日誌檔時,如果這個日誌檔所含的時間戳記,不是位於執行標準日誌配接器所在的語言環境, 而且所用的規則型配接器檔,在 creationTime 的替代規則中必須使用時間格式屬性, 這時候,時間戳記和其他日誌記錄資料可能就無法正確剖析了。例如,在產生的「通用基礎事件」中,creationTime 值可能是零, 而「通用基礎事件」的 msg 欄位可能空白。

為了解決這個問題,請確定規則型配接器檔案中的「環境定義實例」的 ISO 語言碼和 ISO 國碼屬性的值,對應於要剖析的日誌檔中的時間戳記的語言環境。

1.12 剖析的日誌檔含有非唯一的三個字母時區符號時,可能會傳回不正確的事件建立時間

使用「標準日誌配接器」將日誌檔(使用三個字母的時區符號)轉換成「通用基礎事件」格式時, 如果三個字母的時區符號不是唯一的,可能會產生不正確的日誌事件建立時間。例如,三個字母符號 "IST" 可解譯成「以色列標準時間」、「印度標準時間」、「伊朗標準時間」或「愛爾蘭夏日時間」。

1.13 DB2 Express 診斷日誌剖析的「通用基礎事件」不符規格

如果使用 %GLA_Install%\GenericLogAdapter\config\DB2\diag\tool 中的配接器來剖析 IBM(R) DB2(R) Express 診斷日誌, 則寫入輸出檔的「通用基礎事件」結果會違反某些「通用基礎事件」規格。 這是因為用來將 DB2 診斷日誌轉換成「通用基礎事件」的 db2diag.exe 公用程式中含有錯誤。否則應該不影響剖析作業。在修正 db2diag.exe 之前,並沒有已知的暫行解決方法。

1.14 剖析日誌檔時發生配接器驗證錯誤

使用舊版「配接器配置編輯器」所建立的配接器檔案來剖析日誌檔時, 可能導致在「標準日誌配接器」日誌檔 hgla.log 中寫入下列錯誤訊息:

IWAT0383E 配接器驗證錯誤:cvc-complex-type.4:屬性
'lineBreakSymbol' 必須出現在元素 'ex:Extractor' 上。

舊版「配接器配置編輯器」所建立的配接器檔案缺少必要的 Extractor 屬性 lineBreakSymbol。Extractor 元素中必須有這個屬性,即使空的值也一樣。 「標準日誌配接器」在使用配接器檔案之前,現在會依據「標準日誌配接器」綱目先驗證配接器檔案, 而 lineBreakSymbol 是綱目中的必要屬性。

為了解決這個問題,請在「配接器配置編輯器」中開啟配接器檔案, 在 Extractor 元素的 lineBreakSymbol 欄位中加上非空白的值, 儲存配接器檔案,如果不需要此值,就刪除此值,然後重新儲存檔案。 現在,配接器檔案的 Extractor 元素中有 lineBreakSymbol 屬性。

1.15 剖析日誌檔時發生格式製作程式錯誤

使用舊版「配接器配置編輯器」所建立的配接器檔案來剖析日誌檔時, 可能導致在「標準日誌配接器」日誌檔 hgla.log 中寫入類似下列的錯誤訊息:

IWAT0438E 「通用基礎事件」格式製作程式 N76D20B0042411D98000E0362B33D6F0 無法建立
CommmonBaseEvent,因為遺漏必要的 sourceComponentId 內容。

這個訊息指出「標準日誌配接器」的格式製作程式元件無法建立「通用基礎事件」,因為 sourceComponentId 是「通用基礎事件」的必要內容,但卻遺漏。「標準日誌配接器」現在會驗證「通用基礎事件」中有所有必要的內容,如果遺漏內容,則不會傳回「通用基礎事件」。 配接器檔案可能缺少訊息所指出的內容的剖析規則,或剖析規則不正確。

為了解決這個問題,請在配接器檔案中為遺漏的必要「通用基礎事件」內容新增剖析器規則,或驗證現有的規則正確。

1.16 剖析日誌時發生配置問題

在剖析日誌時,下列錯誤訊息可能寫入主控台:

為了解決這個問題,請在 gla.bat 和 gla.sh 執行時期 Script 檔中,對 -classpath 選項做下列更新動作: