© 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.
如需「TPTP 標準日誌配接器」的其他 Readme 資訊,請參閱 TPTP 4.2 版的版本注意事項。
當「標準日誌配接器」連續監視日誌檔時,如果沒有指定結尾型樣,則不會處理最後一筆記錄。 只有關閉標準日誌配接器,才會處理最後一筆記錄。
如果一定要在進行監視時,處理最後一筆記錄,請為標準日誌配接器配置檔中的記錄,提供結尾型樣。
在 UNIXTM 平台上使用「標準日誌配接器」來剖析 WebSphere(R) 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 適當的目錄位置。
如果缺少符合 name 或 type 值的規則,「標準日誌配接器」將為日誌記錄產生無效的 extendedDataElements「通用基礎事件」元素。 如果不會從日誌記錄剖析 name 或 type,則不應該產生 extendedDataElement,但「標準日誌配接器」會產生一個只有 value 欄位的元素。
如果要暫時解決這個問題,請務必提供規則,這些規則會產生您要比對的 extendedDataElement 的下列三個欄位(名稱、值、類型)。
當「標準日誌配接器」在 Eclipse 環境之外以獨立模式執行時, 訊息和錯誤會記載至現行工作目錄中的 hgla.log 檔案。 如果現行工作目錄中已有 hgla.log 檔案,則會建立新的日誌檔 hgla.nnnnnnnn.log,其中的 nnnnnnnn 是唯一數字。 在日誌匯入作業中執行「標準日誌配接器」時,記載的錯誤訊息會顯示在「日誌和追蹤分析器」的錯誤對話框。
在 Eclipse 環境內的「標準日誌配接器」視景中執行時, 「標準日誌配接器」所記載的訊息和錯誤會列在「問題」視圖中。
「標準日誌配接器」會以 5、10、20、30、50 及 60 記載層次來記載事件, 取決於配接器配置檔中的 Contexts 和 Components 的 loggingLevel 設定。 hgla.log 檔案可當做「通用基礎事件」XML 檔案類型匯入「日誌和追蹤分析器」中, 以診斷「標準日誌配接器」在剖析日誌檔時發生的問題。
標準日誌配接器沒有進行任何驗證作業,來判斷您所剖析的日誌檔類型,是否與配接器檔案配置相符。比方說,如果在配接器檔中的感應器配置所指定的日誌檔, 並非擷取器配置和剖析器配置中替代規則被指定的類型,可能會發生無法預期的結果。剖析作業也許會順利完成,沒有產生錯誤,但是得出的「通用基礎事件」資料卻不正確。剖析作業也許會失敗,而且出現錯誤訊息,告訴您資料不正確。
如果要暫時解決這個問題,請確定感應器元件配置中所指定的日誌檔,其類型是正確的。
如果是在非英文的機器上,使用 runregex_showlog_example.bat/sh 來剖析二進位 WebSphere Application Server 活動日誌檔, 日誌記錄資料就無法順利對映到「通用基礎事件」。有些日誌記錄資料會出現在不正確的「通用基礎事件」欄位中。
在剖析日誌檔時,如果這個日誌檔所含的時間戳記,不是位於執行標準日誌配接器所在的語言環境, 而且所用的規則型配接器檔,在 creationTime 的替代規則中必須使用時間格式屬性, 這時候,時間戳記和其他日誌記錄資料可能就無法正確剖析了。例如,在產生的「通用基礎事件」中,creationTime 值可能是零, 而「通用基礎事件」的 msg 欄位可能空白。
為了解決這個問題,請確定規則型配接器檔案中的「環境定義實例」的 ISO 語言碼和 ISO 國碼屬性的值,對應於要剖析的日誌檔中的時間戳記的語言環境。
使用「標準日誌配接器」將日誌檔(使用三個字母的時區符號)轉換成「通用基礎事件」格式時, 如果三個字母的時區符號不是唯一的,可能會產生不正確的日誌事件建立時間。例如,三個字母符號 "IST" 可解譯成「以色列標準時間」、「印度標準時間」、「伊朗標準時間」或「愛爾蘭夏日時間」。
如果使用 %GLA_Install%\GenericLogAdapter\config\DB2\diag\tool 中的配接器來剖析 IBM(R) DB2(R) Express 診斷日誌, 則寫入輸出檔的「通用基礎事件」結果會違反某些「通用基礎事件」規格。 這是因為用來將 DB2 診斷日誌轉換成「通用基礎事件」的 db2diag.exe 公用程式中含有錯誤。否則應該不影響剖析作業。在修正 db2diag.exe 之前,並沒有已知的暫行解決方法。
使用舊版「配接器配置編輯器」所建立的配接器檔案來剖析日誌檔時, 可能導致在「標準日誌配接器」日誌檔 hgla.log 中寫入下列錯誤訊息:
IWAT0383E 配接器驗證錯誤:cvc-complex-type.4:屬性 'lineBreakSymbol' 必須出現在元素 'ex:Extractor' 上。
舊版「配接器配置編輯器」所建立的配接器檔案缺少必要的 Extractor 屬性 lineBreakSymbol。Extractor 元素中必須有這個屬性,即使空的值也一樣。 「標準日誌配接器」在使用配接器檔案之前,現在會依據「標準日誌配接器」綱目先驗證配接器檔案, 而 lineBreakSymbol 是綱目中的必要屬性。
為了解決這個問題,請在「配接器配置編輯器」中開啟配接器檔案, 在 Extractor 元素的 lineBreakSymbol 欄位中加上非空白的值, 儲存配接器檔案,如果不需要此值,就刪除此值,然後重新儲存檔案。 現在,配接器檔案的 Extractor 元素中有 lineBreakSymbol 屬性。
使用舊版「配接器配置編輯器」所建立的配接器檔案來剖析日誌檔時, 可能導致在「標準日誌配接器」日誌檔 hgla.log 中寫入類似下列的錯誤訊息:
IWAT0438E 「通用基礎事件」格式製作程式 N76D20B0042411D98000E0362B33D6F0 無法建立 CommmonBaseEvent,因為遺漏必要的 sourceComponentId 內容。
這個訊息指出「標準日誌配接器」的格式製作程式元件無法建立「通用基礎事件」,因為 sourceComponentId 是「通用基礎事件」的必要內容,但卻遺漏。「標準日誌配接器」現在會驗證「通用基礎事件」中有所有必要的內容,如果遺漏內容,則不會傳回「通用基礎事件」。 配接器檔案可能缺少訊息所指出的內容的剖析規則,或剖析規則不正確。
為了解決這個問題,請在配接器檔案中為遺漏的必要「通用基礎事件」內容新增剖析器規則,或驗證現有的規則正確。
在剖析日誌時,下列錯誤訊息可能寫入主控台:
IWAT0310E 由於配置問題,無法啟動「標準日誌配接器」。 IWAT0317E 建置元件 AdapterLogSensor 時發生錯誤。IWAT0319E 無法實例化類別 org.eclipse.hyades.logging.adapter.internal.util.AdapterSensor。為了解決這個問題,請在 gla.bat 和 gla.sh 執行時期 Script 檔中,對 -classpath 選項做下列更新動作:
本資訊係針對 IBM 在美國地區所提供之產品和服務所開發。
在其他國家或地區中,IBM 不見得有提供本文所提及之各項產品、服務或功能。 請洽詢當地的 IBM 業務代表,以取得當地目前提供的產品和服務之相關資訊。 本文件在提及 IBM 產品、程式或服務時,不表示或暗示您只能使用 IBM 產品、程式或服務。 只要未侵犯 IBM 的智慧財產權,任何功能相當的產品、程式或服務都可以取代 IBM 的產品、程式或服務。 不過,任何非 IBM 的產品、程式或服務,使用者必須自行負責作業的評估和驗證責任。
本文所說明的主題內容,IBM 可能擁有其專利或專利申請案。 提供本文件不代表提供這些專利的授權。您可以書面提出授權查詢,來函請寄到:
IBM Director of Licensing
如果是有關雙位元組 (DBCS) 資訊的授權查詢,請洽詢所在國家的 IBM 智慧財產部門,或書面提出授權查詢,來函請寄到:
IBM World Trade Asia Corporation
本資訊可能會有技術上或排版印刷上的訛誤。 因此,IBM 會定期修訂;並將修訂後的內容納入新版中。IBM 隨時會改進及/或變更本出版品所提及的產品及/或程式,不另行通知。
本資訊中任何對非 IBM 網站的敘述僅供參考,IBM 對該網站並不提供保證。 這些網站所提供的資料不是 IBM 本產品的資料內容,如果要使用這些網站的資料,您必須自行承擔風險。IBM 得以各種 IBM 認為適當的方式使用或散布 貴客戶提供的任何資訊,而無需對 貴客戶負責。
如果本程式的獲授權人為了 (i) 在個別建立的程式和其他程式(包括本程式)之間交換資訊, 以及 (ii) 相互使用所交換的資訊,因而需要相關的資訊,請洽詢:
IBM Corporation上述資料之取得有其特殊要件,在某些情況下必須付費方得使用。
IBM 基於雙方之 IBM 客戶合約、IBM 國際程式授權合約(或任何同等合約)條款,提供本文件所提及的授權程式與其所有適用的授權資料。
此處的任何效能資料皆於受管制的環境下決定。因此,其他作業環境下產生之結果可能明顯不同。 部分測量是在開發階段的系統上進行,無法保證這些測量在正式系統上也會相同。 再者,部分測量可能是經由推論來預估。實際結果可能不同。本文使用者應該根據自己的環境來驗證適合的資料。
本書所提及之非 IBM 產品資訊,取自產品的供應商,或其發佈的聲明或其他公開管道。IBM 並未測試過這些產品,也無法確認這些非 IBM 產品的執行效能、相容性或任何對產品的其他主張是否完全無誤。有關非 IBM 產品的性能問題應直接洽詢該產品供應商。
著作權:這份資訊含有原始語言的範例應用程式,用以說明各作業平台中的程式設計技術。您可以基於研發、使用、銷售或散布符合作業平台(撰寫範例程式的作業平台)之應用程式介面的應用程式等目的,以任何形式複製、修改及散布這些範例程式,而不必向 IBM 付費。這些範例並未在所有情況下完整測試。 因此,IBM 不保證或暗示這些程式的可靠性、有用性或功能。
這些範例程式或任何衍生成果的每份複本或任何部分,都必須依照下列方式併入著作權聲明:(C)(您的公司名稱)(年份)。本程式的若干部分係衍生自 IBM 公司的範例程式。 (C) Copyright IBM Corp. 2006. All rights reserved.
如果 貴客戶閱讀的是這項資訊的電子檔,可能不會有照片和彩色說明。
程式設計介面資訊之目的,是要協助您利用這個程式來建立應用軟體。
通用程式設計介面可讓您撰寫應用軟體,以取得本程式工具的服務。
不過,這份資訊也可能包含診斷、修正和調整資訊。提供診斷、修正和調整資訊,是要協助您進行應用軟體的除錯。
警告:請勿將這份診斷、修正和調整資訊當作程式設計介面使用,因為它隨時會改變。
Java 和所有以 Java 為基礎的商標是 Sun Microsystems, Inc. 在美國及/或其他國家或地區的商標。
Microsoft、Windows、Windows NT 及 Windows 標誌是 Microsoft Corporation 在美國及/或其他國家或地區的商標。
Intel、Intel Xeon 及 Pentium 是 Intel Corporation 或子公司在美國及/或其他國家或地區的商標或註冊商標。
UNIX 是 The Open Group 在美國及其他國家或地區的註冊商標。
Linux 是 Linus Torvalds 在美國及/或其他國家或地區的註冊商標。
其他公司、產品或服務名稱可能是第三者的商標或服務標記。
(C) Copyright IBM Corporation 2000, 2006. All Rights Reserved.