1.0 簡介
2.0 支援的軟體和規格
3.0 限制
3.1 安全特性無法使用
3.2 在 Linux 中升級 Agent Controller
3.3 Agent Controller 可能無法在 AIX 中啟動
3.4 安裝程式會將 Windows Installer 升級至 2.0
3.5 安裝期間發生錯誤 1920
3.6 安裝和解除安裝期間發生其他錯誤
3.7 記憶體不足錯誤
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 檔來變更埠號。本文件會說明這項作業。
如果 Windows Installer 比 2.0 舊,安裝程式會自動將它升級。這需要重新開機。在系統重新開機之後,Agent Controller 安裝作業會自動回復。
如果您在安裝期間發現 Windows 安裝程式錯誤 1920,就表示啟動 IBM Agent Controller 服務時發生問題。 通常是因為系統磁碟機下,有一個名稱為 Program 的檔案。比方說,如果 Windows 安裝在 D: 磁碟機下,且 Agent Controller 安裝在預設位置 D:\Program Files\IBM\IBM Agent Controller 下, 當 D:\ 下面有名稱為 Program 的檔案時,Agent Controller 服務就會停止啟動。 這是因為 Windows 試圖將 Agent Controller 服務啟動成 D:\Program Files\IBM\IBM Agent Controller\bin\RAServer.exe,但這是不正確的。如果要暫時解決這個問題,請遵循下列步驟:
- 將名為 Program 的檔案移除或更名。
- 利用不含空格的目錄(例如:D:\IBM_Agent_Controller)來安裝 Agent Controller。
- 在 Windows 登錄的登錄機碼名稱 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\IBM Agent Controller\ImagePath 之下,用雙引號括住 Agent Controller 的執行檔名稱。 例如:
"D:\Program Files\IBM\IBM Agent Controller\bin\RAServer.exe"
如果您在安裝或解除安裝期間發生錯誤,這可能是因為執行中的程序已載入 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.