© 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 視圖
1.1.1 「日誌」視圖的過濾和強調顯示功能有問題
1.2 匯入日誌
1.2.1 匯入遠端日誌檔時的問題
1.2.2 在 Linux 和 AIX 中匯入日誌檔
1.2.3 匯入 WebSphere Application Server trace.log
1.2.4 無法使用 IBM Agent Controller 第 5 版來匯入某些日誌檔
1.2.5 匯入大型日誌檔和症狀型錄時發生記憶體不足的異常狀況
1.2.6 DB2 Express 診斷日誌顯示的「通用基礎事件」不符規格
1.2.7 「日誌和追蹤分析器」未驗證要匯入的日誌檔類型
1.2.8 匯入不同語言環境所產生的日誌檔時有其限制
1.2.9 使用 AIX 的規則剖析器來匯入 WebSphere 應用程式伺服器活動日誌時失敗
1.2.10 無法與 Apache Derby 10.1.2.1 版建立時間性相互關係
1.2.11 建立和顯示大型日誌的相互關係時效能下降
1.3 資料庫支援
1.3.1 不支援用戶端使用相同的資料庫帳戶來同時存取
1.3.2 資源路徑衝突
1.3.3 即使選擇有效,大型資源支援喜好設定仍然停用
1.3.4 改善大型日誌支援的效能
1.3.5 建立資料庫和表格之後重新啟動 DB2
1.3.6 間歇性 SQL 異常狀況
1.3.7 如果未套用喜好設定,測試連線會傳回錯誤
1.3.8 分析大型日誌時不支援 CommonBaseEvent XPath 表示式
1.3.9 大型日誌只顯示一個 contextDataElement
1.4 其他
1.4.1 在 Linux GTK 驅動程式上,無法適當顯示「新建日誌相互關係」精靈
1.4.2 不會遵循在最初啟動工作台之後的外掛程式記載層次修正
1.4.3 在含 IBM JVM 的 Red Hat Linux 8.0 版中建立範例時損毀
1.4.4 只有 TPTP 格式的症狀資料庫可以從「日誌導覽器」工具列及蹦現功能表來建立
1.4.5 「IBM 日誌分析器」最多只能處理 1024 位元組的訊息
1.4.6 使用複式元素時,症狀編輯器產生的 XPATH 規則無效
1.4.7 症狀編輯器產生的 XPATH 規則不符合任何輸入「通用基礎事件」
2.0 側寫工具
2.1 「序列圖」視圖中不支援「代理程式互動」和「程序互動」視圖
2.2 側寫導覽器的「重新整理視圖」指令對追蹤互動無效
2.3 在 Windows 上使用 Sun JDK 1.4.x 來進行側寫會導致 Microsoft(R) 錯誤報告產生
如需「TPTP 日誌和追蹤分析器」的其他 Readme 資訊,請參閱 TPTP 4.2 版的版本注意事項。
在「日誌視圖」中,「過濾」和「強調顯示」功能無法處理「通用基礎事件」的複式元素(例如 sourceComponentId)。下一版修正套件將提供修正程式。
匯入遠端日誌檔(檔案 > 匯入... > 日誌檔)時,在重新整理「側寫監視器的視圖」(側寫 > 重新整理視圖)之後,「日誌視圖」中沒有顯示任何日誌項目,或者在等待 30 秒之後,出現一個「記載訊息」對話框,指出本端用戶端尚未開始監視遠端日誌剖析器。
這個問題是網路等待時間所引起,只要延長 Agent Controller 等待本端用戶端開始監視遠端日誌剖析器的時間,即可解決問題。 如果要暫時解決這個問題,請嘗試下列步驟:
<Application configuration="default" executable="RemoteLogParserLoader" extends="default" location="%SYS_TEMP_DIR%" path="%JAVA_PATH%"> ... <Parameter position="prepend" value="-Dorg.eclipse.hyades.logging.parsers.maxWaitTimeInMillis=xxxxx"/> ... </Application>其中 xxxxx 是等待時間上限(毫秒)(也就是大於 30000)。
有些日誌檔匯入作業完全無法在 Linux(R) 和 AIX(R) 平台上執行。
當使用者沒有存取日誌檔的適當許可權時,便會發生這個情況。 如果要解決這個問題,您應該將日誌檔複製到使用者的起始目錄中,從其中匯入。
1.2.3 匯入 WebSphere Application Server trace.log匯入 WebSphere(R) Application Server trace.log 檔時會建立「內部相互關係」。
使用者不應刪除這些相互關係,因為這些關係包含對應代理程式內部結構的相關資訊。
1.2.4 無法使用 IBM Agent Controller 第 5 版來匯入某些日誌檔IBM(R) Agent Controller 第 5 版無法匯入 activity.log 以外的遠端日誌檔。 從遠端匯入日誌檔時,遠端機器中的 IBM Agent Controller 的層次必須等同於 IBM Log and Trace Analyzer for Eclipse 或更高層次。
為了克服這項限制,請將 IBM Log and Trace Analyzer for Eclipse 隨附的 IBM Agent Controller 安裝在遠端機器中。
1.2.5 匯入大型日誌檔和症狀型錄時發生記憶體不足的異常狀況可匯入工作區和在「日誌和追蹤分析器」中開啟的日誌檔和症狀型錄最大為 25MB。
開啟日誌檔所需的時間取決於檔案中的日誌記錄數,可能發生「記憶體不足」的異常狀況。如果要暫時解決這個問題,請使用大型日誌支援特性。
如果在匯入大型症狀型錄時發生「記憶體不足」的異常狀況,請加入下列 vmargs 來增加資料堆大小:
-vmargs -Xmx1000m
如果採用大型日誌支援特性,但仍無法解決匯入大型日誌時發生的「記憶體不足」的異常狀況,則增加資料堆大小應該可以解決。
如果匯入 IBM DB2(R) Express 診斷日誌,「日誌和追蹤分析器」中顯示的「通用基礎事件」結果會違反某些「通用基礎事件」規格。 這是因為用來將 DB2 診斷日誌轉換成「通用基礎事件」的 db2diag.exe 公用程式中含有錯誤。否則應該不影響匯入作業。在修正 db2diag.exe 之前,並沒有已知的暫行解決方法。
日誌和追蹤分析器不會在匯入的日誌檔類型上進行任何驗證。在匯入日誌檔時,請確定您已為所要匯入的日誌檔選擇了正確的日誌類型和版本。 如果在匯入期間發生問題,「日誌視圖」中並不會顯示任何記錄或不正確的記錄,但會顯示錯誤訊息。關於錯誤的詳細資訊,請檢視錯誤對話框中的詳細資料。
當匯入的日誌檔所包含之時間戳記的語言環境不是日誌和追蹤分析器執行時所用的語言環境時,規則型日誌檔剖析器有時無法正確剖析時間戳記和其他日誌記錄資料。 例如,將英文的 IBM HTTP Server 存取日誌檔匯入在日文機器上執行的「日誌和追蹤分析器」時,所產生的「通用基礎事件」中的 creationTime 值會是零,且「通用基礎事件」的 msg 欄位會空白。
為了解決這個問題,在匯入的日誌檔中,如果時間戳記所在的語言環境與現行機器的語言環境不同時,請在「匯入日誌」精靈的「詳細資料」標籤上指定日誌檔的語言環境(如果有語言環境欄位的話)。
使用 AIX 系統的「規則」剖析器來匯入二進位 WAS 活動日誌時失敗,錯誤對話框顯示下列錯誤:
IWAT0030E 執行遠端日誌剖析器 "com.ibm.etools.logging.adapter.config.StaticParserExtension" 期間發生錯誤: IWAT0412E 剖析日誌檔 /home/tfoun/logs/activity.log 時發生錯誤。 java.lang.Exception:IWAT0239E 轉換器指令失敗:java.lang.Exception: IWAT0238E 轉換器程序傳回結束值 1
在 AIX 上將二進位日誌檔轉換成文字以利於剖析的轉換器指令失敗。 為了解決這個問題,請使用「靜態」剖析器來匯入二進位活動日誌檔, 或使用 WAS showlog 公用程式將二進位活動日誌檔轉換成文字, 再將產生的文字檔匯入「日誌和追蹤分析器」中。 WAS showlog 公用程式位於 WAS 安裝目錄的 bin 目錄中。 例如,使用下列指令將二進位日誌檔轉換成文字檔 activity.txt:
/opt/WebSphere/AppServer/bin/showlog activity.log activity.txt
然後,將 activity.txt 匯入「日誌和追蹤分析器」中。
雖然 TPTP 未正式支援,但 TPTP 使用者試圖將 Derby 10.1.2.1 與大型日誌支援一起使用,結果發生這個問題。 嘗試與大型日誌建立時間性相互關係時會發生 ArrayIndexOutOfBoundsException,導致相互關係不斷執行而無法停止。 這是已知的 Derby 錯誤,在 Derby 10.2.0.0 中已修正。如需相關資訊,請參閱 http://www.archivum.info/derby-dev@db.apache.org/2006-03/msg01624.html 的 Derby 錯誤說明。
請注意,這個異常狀況發生在伺服器端,在使用者的工作台上不會出現。 出現在發出指令來啟動 Derby 伺服器的指令視窗中。
建立或顯示大型日誌的相互關係時,Apache Derby 和 DB2 的效能可能下降。
為了改善建立相互關係時的效能,請以匯入過濾器來匯入日誌,別讓多餘或不相干的事件進入資料庫。 在「日誌互動作業」視圖中開啟相互關係時,利用「僅顯示相關事件」過濾器可改善效能。
用戶端同時存取一個資料庫可能會鎖定一些表格。為了將表格解除鎖定,請重新啟動「工作台」和資料庫伺服器。
如果多個工作區使用相同的資料庫和資料庫帳戶,可能導致資源路徑衝突,資源將無法存入資料庫。
為了解決這個問題,請在每一個工作區使用不同的專案和監視器名稱,以避免路徑衝突。
在 Linux/GTK 中,即使選取有效的資料庫類型,但在「大型資源支援」喜好設定頁面上,資料庫設定欄位仍然停用。
為了解決這個問題,請選取 DB2 做為資料庫類型,並套用設定。關閉再重新開啟喜好設定對話框,這樣就會啟用這些欄位。
若要改善大型日誌支援的效能,請在匯入大型日誌之後執行下列指令:
db2 -tvf plugins/com.ibm.etools.ac.resources.database_x_x_x /scripts/runStatsForAllHyadesTablesDB2-8.1.sql其中,x_x_x 是外掛程式目錄的版本號碼。
在執行資料庫和表格建立 Script (CreateDatabaseAndTablesDB2-8.1.sql) 之後,必須重新啟動 DB2。 從 DB2 指令視窗中,請執行 db2stop,再執行 db2start,讓 Script 所做的配置參數變更生效。
偶而會發生下列 SQL 異常狀況:
com.ibm.db2.jcc.b.SQLException: NULLID.SYSSH203 0X5359534C564C3031
發生這個問題時,如果是在網路模式下使用 DB2 或 CloudscapeTM,請重新啟動工作台和資料庫。 此異常狀況發生時所匯入的日誌將無效,必須重新匯入。
在「喜好設定」對話框的「側寫和記載」區段的「大型日誌支援」頁面中, 如果在套用設定變更之後就先按下測試連線,可能會發生連線錯誤。 為了避免這種情形,請在完成任何設定變更之後就按一下套用,然後才按一下測試連線。
分析大型日誌時,「IBM 日誌分析器」不支援下列 XPath 表示式。
<expression:xpathExpression>/CommonBaseEvent</expression:xpathExpression>
如果使用 DB2 來取得大型日誌支援, 即使事件有多個 contextDataElement,此事件在「日誌」視圖中仍然只顯示一個 contextDataElement。
在「新建日誌相互關係」精靈中,只會顯示「可用的日誌」清單,清單是空白的。 這是因為只會顯示精靈頁面的左側部分。
如果要暫時解決這個問題,請嘗試調整精靈頁面大小,以顯示「所選的日誌」清單和動作按鈕。 另一個暫行解決方案是在按一下「新建日誌相互關係」按鈕之前,在「日誌導覽器」視圖中選取相互關係的日誌檔。
1.4.2 不會遵循在最初啟動工作台之後的外掛程式記載層次修正
如果您在最初啟動工作台之後,又在外掛程式 plugin.xml 檔中修改了外掛程式的記載層次(使用 com.ibm.etools.common.logging.commonLoggingOptions 或 com.ibm.etools.logging.util.loggingOptions 延伸點), 後續啟動工作台不會遵循這項變更。 在最初啟動工作台時,Eclipse 執行時期會快取外掛程式 plugin.xml 檔所指定的記載層次。 雖然 plugin.xml 檔中進行了修改,但後續啟動工作台仍會使用快取的外掛程式記載層次的值。
如果要暫時解決這個問題,請用 -clean 指令行引數來重新啟動工作台。此選項將會清除用來儲存 軟體組相依關係解決方案及 Eclipse 延伸登錄資料的快取記憶體,並強制 Eclipse 重新起始設定這些快取記憶體。在 <工作台安裝目錄>\eclipse\ac.bat (Windows(R)) 或 <工作台安裝目錄>/eclipse/ac.sh (Linux) 中, 請在 eclipse.exe 後面加上此選項。 此外,您也可以在「記載」喜好設定頁面(視窗 > 喜好設定 > 記載)中,修改外掛程式的記載層次,並重新啟動工作台。
在「日誌和追蹤分析器」中使用「建立範例」精靈(新建 > 範例)來建立範例時,工作台會毀損。 當「建立範例」精靈試圖在建立步驟中開啟 readme.html 檔時,便會出現這個情況。 這個問題出現在含 IBM JavaTM 虛擬機器 (JVM) 的 Red Hat Linux 8.0 版,算是 SWT 錯誤 (https://bugs.eclipse.org/bugs/show_bug.cgi?id=76515)。
如果要暫時解決這個問題,請嘗試在 ac.sh 中加入 -Xj9 作為 JVM 引數,以使用 IBM J9 JVM 來啟動(比方說,./eclipse -vmargs -Xj9 -Xmx500m)。 如需在 Red Hat Linux 8.0 版中執行 SWT 的詳細資訊,請查看 SWT FAQ (http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-swt-home/faq.html)。
附註:如 Eclipse 參照平台表 (http://www.eclipse.org/eclipse/development/eclipse_project_plan_3_0.html#TargetOperatingEnvironments) 所述,僅支援下列 Linux 系統:GTK+ 小組件工具箱 2.2.1 版及相關的程式庫(GLib、Pango);SWT HTML 檢視器需要 Mozilla 1.4GTK2。如果是其他 Linux 系統中的 Motif:請開啟 Motif 2.1(已併入);SWT HTML 檢視器需要 Mozilla 1.4GTK2。
因為有 TPTP 限制的關係,使用者無法從日誌導覽器工具列按鈕及快速功能表來同時建立二種類型的症狀資料庫。 暫行解決方法就是從工作台功能表選取檔案 > 新建 > 其他 > 側寫和記載,並選擇您要建立的症狀資料庫類型。
在 XPATH 規則和 IBM 相關性規則中,「通用基礎事件」內容中的 msg 字串不可超過 1024 位元組。 如果字串超過 1024 位元組,「IBM 日誌分析器」將不予處理。
使用「通用基礎事件」的複式元素時(例如 sourceComponentID),「症狀編輯器」會產生無效的 XPATH 規則。 下一版修正套件將提供修正程式。
如果在建立新的 XPATH 表示式時選取任何 ExtendedDataElement,
則產生的症狀型錄會包含 extendedDataElement
,而不是 extendedDataElements
。
因此,「症狀編輯器」產生的 XPATH 規則不符合任何輸入「通用基礎事件」。
日誌檔的「序列圖」視圖不支援「代理程式互動」視圖和「程序互動」視圖。
這個問題目前沒有暫行解決方法。
2.2 側寫導覽器的「重新整理視圖」指令對追蹤互動無效側寫導覽器的「重新整理視圖」指令對追蹤互動無效。 但是追蹤互動本身會自動定期重新整理。
暫行解決方法是在側寫樹狀結構中選取另一個節點,再重新選取前一個節點。
2.3 在 Windows 上使用 Sun JDK 1.4.x 來進行側寫會導致 Microsoft 錯誤報告產生Bugzilla 問題:103058
側寫或應用程式終止時,會產生訊息:「java.exe 發生問題且需要關閉。很抱歉造成不便。訊息含有將錯誤回報 Microsoft 的資訊和選項。 請參閱 Bugzilla 103058,以取得該訊息的擷取畫面。
我們已在下列模式中發現這樣的問題:時間分析(包含或不含「顯示實例」)、記憶體分析,以及這些模式的組合。若要暫時解決問題,您可以在關閉 JIT 的情況下,重新執行側寫作業或應用程式,意即,提供 "-Djava.compiler=NONE" 來作為 JVM 引數。在 Windows 的 SUN JDK 1.4.2_08-b03 建置中已發現這個問題。