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

© 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 選項做下列更新動作:



注意事項

本資訊係針對 IBM 在美國地區所提供之產品和服務所開發。

在其他國家或地區中,IBM 不見得有提供本文所提及之各項產品、服務或功能。 請洽詢當地的 IBM 業務代表,以取得當地目前提供的產品和服務之相關資訊。 本文件在提及 IBM 產品、程式或服務時,不表示或暗示您只能使用 IBM 產品、程式或服務。 只要未侵犯 IBM 的智慧財產權,任何功能相當的產品、程式或服務都可以取代 IBM 的產品、程式或服務。 不過,任何非 IBM 的產品、程式或服務,使用者必須自行負責作業的評估和驗證責任。

本文所說明的主題內容,IBM 可能擁有其專利或專利申請案。 提供本文件不代表提供這些專利的授權。您可以書面提出授權查詢,來函請寄到:

IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.

如果是有關雙位元組 (DBCS) 資訊的授權查詢,請洽詢所在國家的 IBM 智慧財產部門,或書面提出授權查詢,來函請寄到:

IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106-0032, Japan

下列段落若與該國之法律條抵觸時,即視為不適用:International Business Machines Corporation 只依「現況」提供本出版品,不提供任何明示或默示之保證, 其中包括且不限於不違反規定、可商用性或特定目的之適用性的隱含保證。有些地區在特定交易上,不允許排除明示或暗示的保證,因此,這項聲明不一定適合您。

本資訊可能會有技術上或排版印刷上的訛誤。 因此,IBM 會定期修訂;並將修訂後的內容納入新版中。IBM 隨時會改進及/或變更本出版品所提及的產品及/或程式,不另行通知。

本資訊中任何對非 IBM 網站的敘述僅供參考,IBM 對該網站並不提供保證。 這些網站所提供的資料不是 IBM 本產品的資料內容,如果要使用這些網站的資料,您必須自行承擔風險。

IBM 得以各種 IBM 認為適當的方式使用或散布 貴客戶提供的任何資訊,而無需對 貴客戶負責。

如果本程式的獲授權人為了 (i) 在個別建立的程式和其他程式(包括本程式)之間交換資訊, 以及 (ii) 相互使用所交換的資訊,因而需要相關的資訊,請洽詢:

IBM Corporation
U59/600
3600 Steeles Ave East,
Markham, ON; L3R 9Z7
Canada

上述資料之取得有其特殊要件,在某些情況下必須付費方得使用。

IBM 基於雙方之 IBM 客戶合約、IBM 國際程式授權合約(或任何同等合約)條款,提供本文件所提及的授權程式與其所有適用的授權資料。

此處的任何效能資料皆於受管制的環境下決定。因此,其他作業環境下產生之結果可能明顯不同。 部分測量是在開發階段的系統上進行,無法保證這些測量在正式系統上也會相同。 再者,部分測量可能是經由推論來預估。實際結果可能不同。本文使用者應該根據自己的環境來驗證適合的資料。

本書所提及之非 IBM 產品資訊,取自產品的供應商,或其發佈的聲明或其他公開管道。IBM 並未測試過這些產品,也無法確認這些非 IBM 產品的執行效能、相容性或任何對產品的其他主張是否完全無誤。有關非 IBM 產品的性能問題應直接洽詢該產品供應商。

著作權:

這份資訊含有原始語言的範例應用程式,用以說明各作業平台中的程式設計技術。您可以基於研發、使用、銷售或散布符合作業平台(撰寫範例程式的作業平台)之應用程式介面的應用程式等目的,以任何形式複製、修改及散布這些範例程式,而不必向 IBM 付費。這些範例並未在所有情況下完整測試。 因此,IBM 不保證或暗示這些程式的可靠性、有用性或功能。

這些範例程式或任何衍生成果的每份複本或任何部分,都必須依照下列方式併入著作權聲明:

(C)(您的公司名稱)(年份)。本程式的若干部分係衍生自 IBM 公司的範例程式。 (C) Copyright IBM Corp. 2006. All rights reserved.

如果 貴客戶閱讀的是這項資訊的電子檔,可能不會有照片和彩色說明。

程式設計介面

程式設計介面資訊之目的,是要協助您利用這個程式來建立應用軟體。

通用程式設計介面可讓您撰寫應用軟體,以取得本程式工具的服務。

不過,這份資訊也可能包含診斷、修正和調整資訊。提供診斷、修正和調整資訊,是要協助您進行應用軟體的除錯。

警告:請勿將這份診斷、修正和調整資訊當作程式設計介面使用,因為它隨時會改變。

商標和服務標記

下列詞彙是 IBM Corporation 在美國及/或其他國家或地區的商標:

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.