側寫和日誌記載工具 - 版本注意事項

1.0 簡介
2.0 支援的軟體和規格
3.0 限制
   3.1 安全特性無法使用
   3.2 在 Linux 中升級 Agent Controller
   3.3 Agent Controller 可能無法在 AIX 中啟動
   3.4 安裝和解除安裝期間發生其他錯誤
   3.5 記憶體不足錯誤
4.0 已知的問題
   4.1 開啟和檢視追蹤檔
   4.2 匯入日誌檔
   4.3 在「日誌交談作業」視圖中顯示較大的檔案
   4.4 隱藏自我參照呼叫會被「日誌交談作業」視圖忽略
   4.5 支援「代理程式交談作業」和「程序交談作業」視圖
   4.6 從 Solaris 匯入日誌檔
   4.7 無法匯入包含非 ASCII 字元的日誌檔
   4.8 在重新連接代理程式之後方法和類別資料會重複
   4.9 IBM HTTP Server 1.3.26.2 未列在「匯入」精靈中
   4.10 在啟動或連接之後,無法變更代理程式內容

1.0 簡介

這個版本注意事項包含可從工作台之「側寫和日誌記載」視景(包括「日誌」視圖)取得的效能和記憶體側寫與分析工具。

其他文件來源


使用範例的指引
從「日誌和追蹤分析器」中,呼叫檔案 > 新建 > 範例...,然後選取「日誌分析器和相互關係」範例樹狀視圖。選取 Apache 日誌相互關係/分析範例功能表項目,然後按「下一步」按鈕。接著,按一下完成按鈕。這時會自動建立範例。


建立剖析器、相互關係引擎和分析引擎的指引
這些指引位於 http://dev.eclipse.org/viewcvs/indextools.cgi/~checkout~/hyades-home/docs/doc.html 中。

2.0 支援的軟體和規格

側寫 Java Applet
如果要側寫在 Eclipse 之下建立的 Java Applet,請執行下列動作:

1. 使用「執行」功能表來選取執行...
2. 選取 Java Applet,然後按一下新建
3. 選取引數標籤。
4. 在 VM 引數中指定下列內容:-XrunpiAgent:server=controlled
5. 按一下執行。請注意,除非您連接程序,否則應用程式不會執行。
6. 切換至側寫和日誌記載視景。
7. 使用「側寫」功能表來選取連接 -> Java 程序
8. 使用精靈來連接程序。
9. 開始監視「代理程式」。這時應用程式應該會執行。
請注意,程序也可以在「已啟用」模式下進行側寫。請參閱 RAC 文件以取得詳細資料。

Readme 檔(使用 Hyades Apache 共同記載範例)執行步驟一節的第 3 步驟沒有指定正確的日誌記載代理程式名稱。 日誌記載代理程式的正確名稱是 org.eclipse.hyades.logging.commons.sample.HyadesLoggingCommonsSample

3.0 限制

3.1 安全特性無法使用

IBM Agent Controller 的「安全」特性無法使用。在安裝期間,當系統提示您啟用或開啟「安全」時,請選取停用

3.2 在 Linux 中升級 Agent Controller

如果您打算在 Linux 中從 5.0.1 版或更舊的版本升級 Agent Controller,您必須先以下列類似指令解除安裝該版本:

rpm -e ibmrac-5.0.1-0
在解除安裝舊版本之後,您就可以用下列指令安裝新版本:
rpm -U ibmrac-5.1.0-0.i386.rpm

3.3 Agent Controller 可能無法在 AIX 中啟動

Agent Controller 可能無法在 AIX 中啟動,且會出現下列訊息:

RAServer 無法啟動。
這通常是因為系統另一個執行中的程序正在使用 TCP/IP 埠 10002,或是 Agent Controller 剛停止。

暫行解決方法:如果有另一個程序在使用埠 10002,您可以編輯 serviceconfig.xml 檔來變更埠號。本文件會說明這項作業。

3.4 安裝和解除安裝期間發生其他錯誤

如果您在安裝或解除安裝期間發生錯誤,這可能是因為執行中的程序已載入 Agent Controller 的目的檔。 為了確保這些目的檔可供修改,請執行下列動作:

  1. 關閉工作台。
  2. 終止包含 Java Profiling AgentJ2EE Request Profiler 的所有 java.exe 程序。
  3. 關閉「服務」視窗。

3.5 記憶體不足錯誤

有時,工作台在處理大量資料時可能會記憶體不足。根據您使用的 JRE,這會發生在不同階段。比方說,在某些情況下,SUN 1.4.1 會執行得比 IBM 1.3.1 或 IBM 1.4.1 快。

暫行解決方法:使用 -Xmx JVM 引數來增加「資料堆」配置。建議您使用 -Xmx200M,不過,根據機器配置和應用程式需求,您可能需要較大的數量。

4.0 已知的問題

4.1 開啟和檢視追蹤檔

使用日誌分析器追蹤輸出格式產生的 WebSphere Application Server 追蹤檔,無法利用「日誌記載」工具開啟和檢視。

暫行解決方法:先將 WebSphere Application Server 追蹤輸出格式設成基本進階,再產生要利用「日誌記載」工具開啟和檢視的追蹤檔。

4.2 匯入日誌檔

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

暫行解決方法:啟動 Eclipse 來增加記憶體,如下所示:

"eclipse.exe -vmargs -Xmx800M" 或將更多的實體記憶體新增至機器上。

4.3 在「日誌交談作業」視圖中顯示較大的檔案

當較大的日誌檔顯示在「日誌交談作業」視圖中時,「序列圖」總覽不會顯示任何日誌檔。總覽按鈕會從視圖底端移至頂端,但視圖本身沒有寬度。

暫行解決方法:無。

4.4 隱藏自我參照呼叫會被「日誌交談作業」視圖忽略

隱藏自我參照呼叫的選項位於「序列圖」視圖的「喜好設定」頁面(視窗 > 喜好設定 > 側寫和日誌記載 > 序列圖),它會被「日誌交談作業」視圖忽略。

暫行解決方法:無。

4.5 支援「代理程式交談作業」和「程序交談作業」視圖

「日誌」檔的「序列圖」視圖不支援「代理程式交談作業」和「程序交談作業」視圖。

暫行解決方法:無。

4.6 從 Solaris 匯入日誌檔

日誌檔無法適當地從 Solaris 匯入。

暫行解決方法:無。Solaris 驅動程式並不穩定,且最近會提供更新版。

4.7 無法匯入包含非 ASCII 字元的日誌檔

如果日誌檔的內容包含非 ASCII 字元(例如:0xFF 0xFB ...),日誌檔將無法適當地匯入。

暫行解決方法:從日誌檔中移除這些非 ASCII 字元。

4.8 在重新連接代理程式之後方法和類別資料會重複

重新連接到同一專案和監視目的地下的相同代理程式,會導致報告重複的類別和方法。

當您預期代理程式由另一個資源連接時,從「代理程式」分離會很有用。

暫行解決方法:選取暫停監視以停止收集側寫資料,接著再選取開始監視來回復側寫作業。

4.9 IBM HTTP Server 1.3.26.2 未列在「匯入」精靈中

IBM HTTP Server 1.3.26.2 版沒有作為支援的日誌格式列在匯入精靈中。 WebSphere Application Server 5.0.2 版使用這個伺服器。 您可以利用 1.3.26.1 來順利匯入 IBM HTTP Server 1.3.26.2 的日誌。

4.10 在啟動或連接之後,無法變更代理程式內容

在啟動或連接作業建立代理程式之後,無法套用代理程式內容中的變更,如選項或過濾器。

暫行解決方法:請分離代理程式,再利用新的選項和過濾器,將它連接至不同的監視器。

返回主 Readme 檔