© Copyright International Business Machines Corporation 2000, 2007. All rights reserved.US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
「標準日誌配接器」已隨附在 Agent Controller 中。「標準日誌配接器」可讓您針對自訂的日誌格式來建立配接器。當「標準日誌配接器」持續監視日誌檔時,如果未指定結尾型樣,則不會處理最後一筆記錄。只有等到「標準日誌配接器」關閉時才會處理最後一筆記錄。
為了確保監視期間一定會處理最後一筆記錄,請在「標準日誌配接器」配置檔中提供記錄的結尾型樣。
在 UNIX™ 平台上使用「標準日誌配接器」來剖析 WebSphere® 應用程式伺服器的二進位活動或服務日誌時,使用者的專用權必須等於或大於 WebSphere 應用程式伺服器的安裝程式。
為了克服這項限制,在剖析日誌之前,請先將二進位活動或服務日誌移至另一個目錄,此目錄上的專用權與「標準日誌配接器」使用者相同。
在 UNIX 平台上使用「標準日誌配接器」來剖析 WebSphere MQ 錯誤日誌時,使用者的專用權必須等於或大於 WebSphere MQ 的安裝程式。
為了克服這項限制,在剖析日誌之前,請先將 MQ 錯誤日誌移至另一個目錄,此目錄上的專用權與「標準日誌配接器」使用者相同。
在 Eclipse 環境外以獨立模式執行「標準日誌配接器」時,訊息和錯誤會記載到現行工作目錄中的 hgla.log 檔案。如果現行工作目錄中已存在 hgla.log 檔案,則會建立新的日誌檔,檔名為 hgla.nnnnnnnn.log,其中的 nnnnnnnn 是唯一的數字。在日誌匯入作業過程中執行「標準日誌配接器」時,記載的錯誤訊息會顯示在「日誌和追蹤分析器」的錯誤對話框中。
在 Eclipse 環境內的「標準日誌配接器」視景中執行時,「標準日誌配接器」所記載的訊息和錯誤會列在「問題」視圖中。
「標準日誌配接器」會以記載層次 5、10、20、30、50 及 60 來記載事件,視配接器配置檔中的「環境定義」和「元件」所設定的 loggingLevel 而定。剖析日誌檔時,可以將 hgla.log 檔案匯入「日誌和追蹤分析器」中成為「通用基礎事件」XML 檔案類型,以診斷「標準日誌配接器」所發現的問題。
「標準日誌配接器」未執行驗證來判斷剖析的日誌檔類型是否符合配接器檔案配置。例如,在配接器檔案中的感應器配置所指定的日誌檔,如果不是剖析器配置中的擷取程式配置和替代規則所指定的類型,則可能發生無法預期的結果。剖析可能完成無誤,但產生的「通用基礎事件」資料會不正確。剖析也可能失敗而出現錯誤訊息,表示發現不正確的資料。
為了解決這個問題,請確定感應器元件配置中指定的日誌檔是正確類型。
在剖析日誌檔時,如果日誌檔包含的時間戳記所用的語言環境和執行「標準日誌配接器」的語言環境不同,且使用的規則型配接器檔案已配置成使用替代規則中的「時間格式」屬性來表示 creationTime,則可能無法正確剖析時間戳記及其他日誌記錄資料。例如,產生的「通用基礎事件」中的 creationTime 值可能是零,而「通用基礎事件」msg 欄位可能空白。
為了解決這個問題,在規則型配接器檔案中,請檢查「環境定義實例」的 ISO 語言碼和 ISO 國碼屬性的值,確定對應於要剖析的日誌檔中的時間戳記的語言環境。
使用「標準日誌配接器」將日誌檔(使用三字母時區符號)轉換成「通用基礎事件」格式時,如果三字母時區符號不是唯一的,則日誌事件的建立時間可能不正確。例如,三字母符號 "IST" 可能解譯成 Israeli Standard Time、Indian Standard Time、Iran Standard Time 或 Irish Summer Time。
如果使用 GLA_INSTALL\GenericLogAdapter\config\DB2\diag\tool 中的配接器來剖析 IBM® DB2® Express 診斷日誌,則寫入輸出檔的「通用基礎事件」結果會違反部分「通用基礎事件」規格。這是因為將 DB2 診斷日誌轉換成「通用基礎事件」所用的 db2diag.exe 公用程式設計有錯誤。不然就不影響剖析作業。目前尚無暫行解決方法,只能靜待 db2diag.exe 修正。
如果使用舊版「配接器配置編輯器」所建立的配接器檔案來剖析日誌檔,可能會造成下列錯誤訊息寫入「標準日誌配接器」日誌檔 hgla.log:
IWAT0383E 配接器驗證錯誤:cvc-complex-type.4:屬性 'lineBreakSymbol' 必須出現在元素 'ex:Extractor' 上。
舊版「配接器配置編輯器」建立的配接器檔案缺少必要的 Extractor 屬性 lineBreakSymbol。這個屬性必須存在 Extractor 元素中,即使只有空白值也一樣。「標準日誌配接器」現在會先根據「標準日誌配接器」綱目來驗證配接器檔案,然後才使用配接器檔案,且 lineBreakSymbol 在綱目中是必要屬性。
為了解決這個問題,請在「配接器配置編輯器」中開啟配接器檔案,在 Extrator 元素的 lineBreakSymbol 欄位中加上非空白的值,儲存配接器檔案,然後刪除此值(如果不是必要的),再重新儲存檔案。配接器檔案現在包含 Extractor 元素的 lineBreakSymbol 屬性。
如果使用舊版「配接器配置編輯器」所建立的配接器檔案來剖析日誌檔,可能會造成類似下列的錯誤訊息寫入「標準日誌配接器」日誌檔 hgla.log:
IWAT0438E「通用基礎事件」格式製作程式 N76D20B0042411D98000E0362B33D6F0 無法建立 CommonBaseEvent,因為遺漏必要內容 sourceComponentId。
這個訊息表示「標準日誌配接器」的格式製作程式元件無法建立「通用基礎事件」,因為 sourceComponentId 是「通用基礎事件」的必要內容,但卻遺漏。「標準日誌配接器」現在會驗證「通用基礎事件」中是否存在所有必要的內容,如果遺漏內容,則不會傳回「通用基礎事件」。配接器檔案可能沒有剖析規則可處理訊息中指出的內容,或剖析規則不正確。
為了解決這個問題,對於遺漏的必要「通用基礎事件」內容,請在配接器檔案中新增剖析器規則,或確認現有的規則正確。
在剖析日誌時,下列錯誤訊息可能寫入主控台:
IWAT0310E 由於配置問題,無法啟動「標準日誌配接器」。
IWAT0317E 建置元件 AdapterLogSensor 時發生錯誤。
IWAT0319E 無法實例化類別 org.eclipse.hyades.logging.adapter.internal.util.AdapterSensor。 異常狀況 = org/eclipse/emf/ecore/EObject為了解決這個問題, 請在 gla.bat 和 gla.sh 執行時期 Script 檔中,對 -classpath 選項做下列更新:
- 將 emf.common_2.2.0.qualifier.jar 改為 emf.common_2.2.0.v200606051102.jar。
- 將 emf.ecore_2.2.0.qualifier.jar 改為 emf.ecore_2.2.0.v200606051102.jar。