自主運算的日誌和追蹤分析器 - 版本注意事項

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

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 日誌和追蹤分析器」的 Readme 資訊,請參閱 TPTP 3.3 版的版本注意事項


1.0 日誌和追蹤分析器

1.1 視圖

不適用

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 規格。 這是因為用來將 DB2 診斷日誌轉換成 Common Base Events 的 db2diag.exe 公用程式中含有錯誤。這應該不會影響作業。 在修正 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 msg 欄位會空白。

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

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

1.4.3 使用 Windows XP unzip 公用程式來解壓縮的問題

當在 Windows XP 中安裝日誌和追蹤分析器時,使用 Windows XP 原有的解壓縮公用程式來解壓縮日誌和追蹤分析器執行時期檔會發生問題。 無法解壓縮部分目錄和檔案。這個問題導致無法利用「日誌和追蹤分析器」來匯入某些日誌檔類型。

如果要暫時解決這個問題,當在 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 文件格式的日誌檔(亦即,名為 CommonBaseEvents.log_Viewer.xml 的檔案,其位於安裝目錄之 workspace\.metadata 子目錄中)。 這個檔案只能用 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 建置中已發現這個問題。

返回主要 Readme 檔

©Copyright IBM Corporation 2000, 2005. All Rights Reserved.