日誌和追蹤分析器 6.0.1 版 - Readme

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

1.0 日誌和追蹤分析器
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 在 Linux GTK 驅動程式上,在「匯入日誌檔」精靈中新增日誌檔時,發生索引超出界限的錯誤
1.2.7 針對 DB2 診斷日誌顯示的 Common Base Events 不符合規格
1.2.8 不會顯示「匯入日誌檔時發生錯誤」
1.2.9 匯入 WebSphere activity.log 檔時有其限制
1.2.10 匯入不同語言環境中產生的日誌檔時有其限制
1.2.11 匯入失敗,出現 InvocationTargetException 訊息
1.2.12 匯入空日誌時發生 NullPointerException
1.3 資料庫支援
1.4 其他
1.4.1 在 Linux GTK 驅動程式上,無法適當顯示「新建日誌相互關係」精靈
1.4.2 不會遵循在最初啟動工作台之後的外掛程式記載層次修正
1.4.3 無法利用 Windows XP Unzip 公用程式來解壓縮
1.4.4 在含 IBM JVM 的 Red Hat Linux 8.0 版中建立範例時毀損
1.4.5 檢視記載公用程式 XML 日誌檔時的瀏覽器限制
1.4.6 從日誌導覽器工具列和蹦現功能表中只能建立 TPTP 格式的症狀資料庫
2.0 側寫工具
2.1 「序列圖」視圖中不支援「代理程式互動」和「程序互動」視圖
2.2 側寫導覽器的「重新整理視圖」指令對追蹤互動無效
2.3 在 Windows 中利用 Sun JDK 1.4.x 側寫時,結束時會出現 Microsoft 錯誤報告

您可在 TPTP 3.3 版版本注意事項中取得有關 TPTP 日誌和追蹤分析器的其他 Readme 資訊。


1.0 日誌和追蹤分析器

1.1 視圖

N/A

1.2 匯入日誌

1.2.1 匯入遠端日誌檔時的問題

當匯入遠端日誌檔(檔案 > 匯入... > 日誌檔)時,在重新整理側寫監視器的視圖(側寫 > 重新整理視圖)之後,有可能日誌視圖不會出現任何日誌項目, 也可能出現一個「記載訊息」對話框,指出在等待 30 秒之後,本端用戶端尚未開始監視遠端日誌剖析器。

這個問題是由於網絡等待時間所造成,您可以增加 Agent Controller 等待本端用戶端開始監視遠端日誌剖析器的時間,來修正這個問題。 如果要暫時解決這個問題,請嘗試下列步驟:

  1. 嘗試重新匯入日誌檔。
  2. 如果症狀持續存在,請將下列項目新增至 Agent Controller 配置中的遠端 RemoteLogParserLoader 應用程式(如 <Agent Controller 的安裝目錄>/plugins/com.ibm.etools.logging.parsers/config/pluginconfig.xml)中:
      
    <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)。
  3. 在更新之後,請重新啟動 Agent Controller,再嘗試重新匯入日誌檔。

1.2.2 在 Linux 和 AIX 中匯入日誌檔

部分日誌檔匯入作業完全無法在 Linux 和 AIX 平台中運作。

當使用者沒有存取日誌檔的適當許可權時,便會發生這個情況。 如果要解決這個問題,您應該將日誌檔複製到使用者的起始目錄中,從其中匯入。

1.2.3 匯入 WebSphere Application Server trace.log

當匯入 WebSphere Application Server trace.log 檔時,會建立內部的相互關係。

使用者不應刪除這些相互關係,因為這些關係包含對應代理程式內部結構的相關資訊。

1.2.4 無法利用 IBM Agent Controller 第 5 版來匯入某些日誌檔

activity.log 以外的遠端日誌檔無法利用第 5 版 IBM Agent Controller 來匯入。 當從遠端匯入日誌檔時,遠端機器中的 Agent Controller 必須設在日誌和追蹤分析器的相同層次或更高層次上,以便進行自主運算。

如果要暫時解決這項限制,請將日誌和追蹤分析器所檢附的 IBM Agent Controller 安裝在遠端機器中。

1.2.5 「記憶體不足」異常狀況

可匯入工作區和在「日誌和追蹤分析器」中開啟的日誌檔最多為 25MB。開啟日誌檔的時間量會視檔案中的日誌記錄數而定,且您可能收到「記憶體不足」異常狀況。

如果要暫時解決這個問題,請使用大型日誌支援特性。

1.2.6 在 Linux GTK 驅動程式上,在「匯入日誌檔」精靈中新增日誌檔時,發生索引超出界限的錯誤

在匯入日誌檔期間,當您試圖在「新增日誌檔」精靈中按一下確定時,會出現索引超出界限的錯誤。 這是因為新增的日誌檔沒有選取版本。

請確定已在「新增日誌檔」精靈「詳細資料」標籤之下的版本下拉清單中,選取了有效的版本選項。

1.2.7 針對 DB2 診斷日誌顯示的 Common Base Events 不符合規格

如果匯入 DB2 診斷日誌,日誌和追蹤分析器中顯示之產生的 Common Base Events 會違反某些 Common Base Events 規格。這是 db2diag.exe 公用程式中的錯誤所造成的,這個公用程式可讓您將 DB2 診斷日誌轉換成 Common Base Events。這應該不會影響作業。除非修正 db2diag.exe,否則,這個問題沒有已知的暫行解決方法。

1.2.8 日誌和追蹤分析器不會在匯入的日誌檔類型上進行任何驗證

日誌和追蹤分析器不會在匯入的日誌檔類型上進行任何驗證。匯入日誌檔時,請確定已選擇正在匯入的日誌檔的正確日誌類型和版本。 如果在匯入期間發生問題,日誌視圖就會不顯示記錄或顯示不正確的記錄,且畫面上會顯示錯誤訊息。如需有關該錯誤的詳細資訊,請從錯誤對話框中檢視詳細資料,或者,您也可以嘗試查看檔案 .metadata\.plugins\org.eclipse.hyades.logging.adapter\hgla.log(如果 workspace 目錄中有這個檔案的話)。這個檔案可能包含在剖析日誌檔期間發生之錯誤的相關資訊。

如果匯入日誌檔時發生錯誤,畫面上會顯示錯誤訊息,且日誌視圖中不會顯示記錄,或日誌視圖中的記錄會顯示不正確的資料。

1.2.9 匯入 WebSphere Application Server activity.log 檔時有其限制

當從非英文機器或在非英文機器中匯入 WebSphere Application Server 活動日誌檔時,規則型日誌檔剖析器無法將日誌記錄資料順利對映至 Common Base Event。 相反地,部分日誌記錄資料可能會出現在 Common Base Event 的不正確的欄位中。

如果要暫時解決這個問題,當從非英文機器或在非英文機器中匯入 WebSphere Application Server 活動日誌檔時,請使用靜態日誌檔剖析器。

1.2.10 匯入不同語言環境中產生的日誌檔時有其限制

當匯入的日誌檔所包含之時間戳記的語言環境不是日誌和追蹤分析器執行時所用的語言環境時,規則型日誌檔剖析器有時無法正確剖析時間戳記和其他日誌記錄資料。 比方說,將英文的 IBM HTTP Server 存取日誌檔匯入在日文機器中執行的日誌和追蹤分析器時,產生的 Common Base Events 中的 creationTime 值為零,且 Common Base Event 訊息欄位會空白。

如果要暫時解決這個問題,當匯入的日誌檔所包含之時間戳記的語言環境與現行機器的語言環境不同時,如果有靜態日誌檔剖析器,請使用靜態日誌檔剖析器。

1.2.11 匯入失敗,出現 InvocationTargetException 訊息

如果未正確安裝日誌和追蹤分析器,它的部分檔案會遺失,匯入日誌檔可能會失敗並出現下列記載訊息:

java.lang.reflect.InvocationTargetException

如果要暫時解決這個問題,請重新安裝日誌和追蹤分析器。 附註:當在 Windows XP 中安裝時,請勿使用原生 Windows XP unzip 公用程式。 請參閱下面的利用 Windows XP unzip 公用程式解壓縮的問題,以取得詳細資料。

1.2.12 匯入空日誌時發生 NullPointerException

當匯入空日誌或使用過濾所有日誌事件的匯入過濾器時,日誌視圖會變成空的,且可能會擲出 NullPointerException(在 XMLLoader.endElement 中)。請檢查日誌檔,或嘗試改用另一個允許載入某些事件的過濾器。

1.3 資料庫支援

不適用

1.4 其他

1.4.1 在 Linux GTK 驅動程式上,無法適當顯示「新建日誌相互關係」精靈

在「新建日誌相互關係」精靈中,只會顯示「可用的日誌」清單,清單是空白的。 這是因為只會顯示精靈頁面的左側部分。

如果要暫時解決這個問題,請嘗試調整精靈頁面大小,以顯示「所選的日誌」清單和動作按鈕。 另一個暫行解決方案是在按一下「新建日誌相互關係」按鈕之前,在「日誌導覽器」視圖中選取相互關係的日誌檔。

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.exe(在 <工作台安裝目錄>\eclipse\ac.bat (Windows) 或 <工作台安裝目錄>/eclipse/ac.sh (Linux) 中)後面加上該選項。 另外,您也可以在「記載」喜好設定頁面(視窗 > 喜好設定 > 記載)中修改外掛程式的記載層次,再重新啟動工作台。

1.4.3 無法利用 Windows XP Unzip 公用程式來解壓縮

當在 Windows XP 中安裝日誌和追蹤分析器時,利用 Windows XP 原有的 Unzip 公用程式來解壓縮日誌和追蹤分析器執行時期檔會發生問題。 無法解壓縮某些目錄和檔案。這個問題所造成的結果,就是無法利用日誌和追蹤分析器來匯入某些日誌檔類型。

如果要暫時解決這個問題,當在 Windows XP 中安裝時,請使用另一個 unzip 公用程式,如 WinZip 或 UnZip。

1.4.4 在含 IBM JVM 的 Red Hat Linux 8.0 版中建立範例時毀損

當在日誌和追蹤分析器中,利用「建立範例」精靈(新建 > 範例)來建立範例時,工作台會毀損。 當「建立範例」精靈試圖在建立步驟中開啟 readme.html 檔時,便會出現這個情況。 在含 IBM 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。

1.4.5 檢視共用記載 XML 日誌檔時的瀏覽器限制

如果要檢視工作台產生的 CommonBaseEvents.log 檔,最好是使用記載工具提供的「日誌」視圖。另外,您也可以使用啟用 XML 功能的瀏覽器來檢視 XML 文件格式的日誌檔(也就是安裝目錄的 workspace\.metadata 子目錄中稱為 CommonBaseEvents.log_Viewer.xml 的檔案)。一定要使用 Microsoft Internet Explorer 6.0.28 版和以上的版本,才能檢視這個檔案。

1.4.6 從日誌導覽器工具列和蹦現功能表中只能建立 TPTP 格式的症狀資料庫

因為有 TPTP 限制,所以使用者不能從日誌導覽器工具列按鈕和快速功能表中同時建立兩種症狀資料庫類型。 暫行解決方法是從工作台功能表中選取檔案 > 新建 > 其他 > 側寫和記載,然後選擇您要建立的症狀資料庫類型。

2.0 側寫工具

2.1 「序列圖」視圖中不支援「代理程式互動」和「程序互動」視圖

日誌檔的「序列圖」視圖不支援「代理程式互動」視圖和「程序互動」視圖。

這個問題目前沒有暫行解決方法。

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 建置中,已發現這個問題。


(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.

返回主要 Readme 檔

版權和注意事項