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 在啟動或連接之後,無法變更代理程式內容
這個版本注意事項包含可從工作台之「側寫和日誌記載」視景(包括「日誌」視圖)取得的效能和記憶體側寫與分析工具。
其他文件來源
使用範例的指引
從「日誌和追蹤分析器」中,呼叫檔案 > 新建 > 範例...,然後選取「日誌分析器和相互關係」範例樹狀視圖。選取 Apache 日誌相互關係/分析範例功能表項目,然後按「下一步」按鈕。接著,按一下完成按鈕。這時會自動建立範例。
建立剖析器、相互關係引擎和分析引擎的指引
這些指引位於 http://dev.eclipse.org/viewcvs/indextools.cgi/~checkout~/hyades-home/docs/doc.html 中。
側寫 Java Applet
如果要側寫在 Eclipse 之下建立的 Java Applet,請執行下列動作:請注意,程序也可以在「已啟用」模式下進行側寫。請參閱 RAC 文件以取得詳細資料。
- 1. 使用「執行」功能表來選取執行...。
- 2. 選取 Java Applet,然後按一下新建。
- 3. 選取引數標籤。
- 4. 在 VM 引數中指定下列內容:
-XrunpiAgent:server=controlled
- 5. 按一下執行。請注意,除非您連接程序,否則應用程式不會執行。
- 6. 切換至側寫和日誌記載視景。
- 7. 使用「側寫」功能表來選取連接 -> Java 程序。
- 8. 使用精靈來連接程序。
- 9. 開始監視「代理程式」。這時應用程式應該會執行。
Readme 檔(使用 Hyades Apache 共同記載範例)執行步驟一節的第 3 步驟沒有指定正確的日誌記載代理程式名稱。 日誌記載代理程式的正確名稱是 org.eclipse.hyades.logging.commons.sample.HyadesLoggingCommonsSample。
IBM Agent Controller 的「安全」特性無法使用。在安裝期間,當系統提示您啟用或開啟「安全」時,請選取停用或否。
如果您打算在 Linux 中從 5.0.1 版或更舊的版本升級 Agent Controller,您必須先以下列類似指令解除安裝該版本:
rpm -e ibmrac-5.0.1-0在解除安裝舊版本之後,您就可以用下列指令安裝新版本:rpm -U ibmrac-5.1.0-0.i386.rpm
Agent Controller 可能無法在 AIX 中啟動,且會出現下列訊息:
RAServer 無法啟動。這通常是因為系統另一個執行中的程序正在使用 TCP/IP 埠 10002,或是 Agent Controller 剛停止。暫行解決方法:如果有另一個程序在使用埠 10002,您可以編輯 serviceconfig.xml 檔來變更埠號。本文件會說明這項作業。
如果您在安裝或解除安裝期間發生錯誤,這可能是因為執行中的程序已載入 Agent Controller 的目的檔。 為了確保這些目的檔可供修改,請執行下列動作:
- 關閉工作台。
- 終止包含 Java Profiling Agent 或 J2EE Request Profiler 的所有 java.exe 程序。
- 關閉「服務」視窗。
有時,工作台在處理大量資料時可能會記憶體不足。根據您使用的 JRE,這會發生在不同階段。比方說,在某些情況下,SUN 1.4.1 會執行得比 IBM 1.3.1 或 IBM 1.4.1 快。
暫行解決方法:使用 -Xmx JVM 引數來增加「資料堆」配置。建議您使用 -Xmx200M,不過,根據機器配置和應用程式需求,您可能需要較大的數量。
使用日誌分析器追蹤輸出格式產生的 WebSphere Application Server 追蹤檔,無法利用「日誌記載」工具開啟和檢視。
暫行解決方法:先將 WebSphere Application Server 追蹤輸出格式設成基本或進階,再產生要利用「日誌記載」工具開啟和檢視的追蹤檔。
可匯入工作區和在「日誌和追蹤分析器」中開啟的日誌檔最多為 25MB。開啟日誌檔的時間量會視檔案中的日誌記錄數而定,且您可能收到「記憶體不足」異常狀況。
暫行解決方法:啟動 Eclipse 來增加記憶體,如下所示:
"eclipse.exe -vmargs -Xmx800M" 或將更多的實體記憶體新增至機器上。
當較大的日誌檔顯示在「日誌交談作業」視圖中時,「序列圖」總覽不會顯示任何日誌檔。總覽按鈕會從視圖底端移至頂端,但視圖本身沒有寬度。
暫行解決方法:無。
隱藏自我參照呼叫的選項位於「序列圖」視圖的「喜好設定」頁面(視窗 > 喜好設定 > 側寫和日誌記載 > 序列圖),它會被「日誌交談作業」視圖忽略。
暫行解決方法:無。
「日誌」檔的「序列圖」視圖不支援「代理程式交談作業」和「程序交談作業」視圖。
暫行解決方法:無。
日誌檔無法適當地從 Solaris 匯入。
暫行解決方法:無。Solaris 驅動程式並不穩定,且最近會提供更新版。
如果日誌檔的內容包含非 ASCII 字元(例如:0xFF 0xFB ...),日誌檔將無法適當地匯入。
暫行解決方法:從日誌檔中移除這些非 ASCII 字元。
重新連接到同一專案和監視目的地下的相同代理程式,會導致報告重複的類別和方法。
當您預期代理程式由另一個資源連接時,從「代理程式」分離會很有用。
暫行解決方法:選取暫停監視以停止收集側寫資料,接著再選取開始監視來回復側寫作業。
IBM HTTP Server 1.3.26.2 版沒有作為支援的日誌格式列在匯入精靈中。 WebSphere Application Server 5.0.2 版使用這個伺服器。 您可以利用 1.3.26.1 來順利匯入 IBM HTTP Server 1.3.26.2 的日誌。
在啟動或連接作業建立代理程式之後,無法套用代理程式內容中的變更,如選項或過濾器。
暫行解決方法:請分離代理程式,再利用新的選項和過濾器,將它連接至不同的監視器。
(C) Copyright IBM Corporation 2000, 2003. All Rights Reserved.