J2EE Request Profiler 探測
簡介
這個範例包含用來收集來自任何 J2EE 應用程式之資料的 J2EE Request Profiler 探測。
探測可以遵循以下提供的指示來注入任何的 J2EE 應用程式。
如需 Hyades Probekit 的相關資訊,請參閱說明檔。
如需 J2EE Request Profiler 的相關資訊,請參閱 readme.html 檔,進入新增功能 > 範例的「J2EE Request Profiler 範例」。
內容
JAR 檔 |
說明 |
j2rp_probe.probe |
這是用來收集來自 J2EE 應用程式之資料的 J2EE Request Profiler 探測 |
sdrt.jar |
包含合作程式為停用的 J2EE Request Profiler。上述的「探測」是用來執行合作程式的工作。 |
需求
執行這個範例需要 WebSphere Application Server(5.0 版或更新版本)。
附註:未提供這個應用程式。
假設情況
如果要使用工作台連接 J2EE Request Profiler,已安裝 Agent Controller 而且在執行中。
執行步驟
遵循以下的指示,將探測套用到 J2EE 應用程式和啟動側寫:
- 停止 WebSphere Application Server(5.0 版或更新版本)。
- 從這個範例將 sdrt.jar 檔新增到 WebSphere Application Server 的 lib 目錄,例如,在 Windows 是
x:\Program Files\WebSphere\AppServer\lib,在 UNIX 是 /opt/WebSphere/AppServer/lib。
- 用滑鼠右鍵按一下 j2rp_probe.probe > probekit > 編譯
- 編譯您的探測會產生 java 類別和 probescript 檔。如果選取了「自動建置」選項,則會編譯 java 類別並且會顯示一些建置路徑錯誤。用滑鼠右鍵按一下您的專案 > 內容 > Java 建置路徑 > 程式庫 > 新增外部 JAR > 選取本範例內含的 sdrt.jar 檔位置。您可以用滑鼠右鍵按一下這個檔案並且選取「內容」來檢視這個檔案的位置。同時也新增 WebSphere 的 lib 目錄中的
j2ee.jar
檔(即 <WAS_HOME>\lib\j2ee.jar)。現在,應該會全部解決所有的建置路徑錯誤。
-
當建置專案之後,在您專案的 bin 目錄之下會產生四個 .class 檔(即 <Workbench_Home>\<Workspace>\<Project_Name>\bin)。這四個類別檔是 j2rp_probe_probe.class、j2rp_probe_probe$Probe_0.class、j2rp_probe_probe$Probe_1.class、j2rp_probe_probe$Probe_2.class。將這些類別複製到與您的 J2EE 應用程式相同的目錄中。
-
請確定您的 CLASSPATH 環境變數包含 probekit.jar 檔的完整路徑和檔名。probekit.jar 檔是在您的 Eclipse plugins 資料夾的 org.eclipse.hyades.probekit 子資料夾中。
請確定您的 PATH 環境變數包含適用您的平台的 org.eclipse.hyades.probekit 子資料夾完整路徑:
Windows 是 os\win32\x86
Solaris 是 os/solaris/sparc
Linux 是 os/linux/x86
其他平台有自己的子目錄。
-
切換至 <Workbench_Home>\<Workspace>\<Project_Name>\bin 目錄。
利用下列指令將探測套用到您的 J2EE 應用程式:java ProbeInstrumenter j2rp_probe.probescript "C:\myservlet\myclass.class"
您也可以在上述指令指定目錄或 JAR 檔來套用探測到一群類別。如需上述指令的相關資訊,請參閱 Probekit 說明檔。
請注意,您不能將探測套用到已進行測試設備的類別。如果套用探測到您的類別,而且希望以後能將修改的探測版本套用到相同的類別集,您應該將所有的 *.class.bak 檔重新命名成為 *.class,然後再套用探測。
- 啟動 WebSphere Application Server。
- 啟用工作台的「側寫和記載」喜好設定中的側寫:
- 從工具列中,選取視窗 > 喜好設定。
- 選取側寫和記載。
- 在「側寫和記載」窗格中,選取啟用側寫。
- 選取確定套用變更。
- 在工作台開啟「側寫和記載」視景:
- 選取視窗 > 開啟視景 > 其他。
- 選取側寫和記載。
- 選取確定。
- 連接「J2EE Request Profiler」側寫代理程式:
- 從工具列選取側寫。這時會開啟啟動配置視窗。
- 從配置清單中選取連接 - Java 程序。
- 按一下新建來建立新的配置。
- 在新建配置窗格中,在名稱欄位指定側寫配置的名稱。
- 選取代理程式標籤。
- 從代理程式清單中使用方向鍵選取 J2EE Request Profiler。
- 按一下側寫開始側寫應用程式。
- 在「側寫監視器」視圖中,用滑鼠右鍵按一下側寫代理程式並選取開始監視。將會開始收集資料。
- 執行您的 J2EE 應用程式。
- 開啟其中一個「側寫和記載」視景的側寫視圖來檢視收集到的側寫資料。若要開啟視圖:
- 在「側寫監視器」視圖中,用滑鼠右鍵按一下側寫代理程式並選取開啟工具。
- 選取列出的其中一個視圖。
附註:線上文件可以找到有關應用程式側寫和「側寫」視景的側寫視圖的詳細資訊(說明 > 說明內容 > 搜尋: >「應用程式側寫視景」> 執行)。
- 在「側寫監視器」中,選取重新整理視圖按鈕重新整理視圖。
- 請注意,您可以採用任何方式來修改探測並重新套用到您的類別。例如,您可以併入
<target>
陳述式而將探測的目標定在特定的類別/方法,併入方式如下:
<target type='exclude' package='*' method='myMethod'/>
強烈建議使用者閱讀 Probekit 說明檔來決定如何修改探測檔最能符合需求。
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.