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 應用程式和啟動側寫:

  1. 停止 WebSphere Application Server(5.0 版或更新版本)。
  2. 從這個範例將 sdrt.jar 檔新增到 WebSphere Application Server 的 lib 目錄,例如,在 Windows 是 x:\Program Files\WebSphere\AppServer\lib,在 UNIX 是 /opt/WebSphere/AppServer/lib
  3. 用滑鼠右鍵按一下 j2rp_probe.probe > probekit > 編譯
  4. 編譯您的探測會產生 java 類別和 probescript 檔。如果選取了「自動建置」選項,則會編譯 java 類別並且會顯示一些建置路徑錯誤。用滑鼠右鍵按一下您的專案 > 內容 > Java 建置路徑 > 程式庫 > 新增外部 JAR > 選取本範例內含的 sdrt.jar 檔位置。您可以用滑鼠右鍵按一下這個檔案並且選取「內容」來檢視這個檔案的位置。同時也新增 WebSphere 的 lib 目錄中的 j2ee.jar 檔(即 <WAS_HOME>\lib\j2ee.jar)。現在,應該會全部解決所有的建置路徑錯誤。
  5. 當建置專案之後,在您專案的 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 應用程式相同的目錄中。
  6. 請確定您的 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
    其他平台有自己的子目錄。
  7. 切換至 <Workbench_Home>\<Workspace>\<Project_Name>\bin 目錄。
    利用下列指令將探測套用到您的 J2EE 應用程式:java ProbeInstrumenter j2rp_probe.probescript "C:\myservlet\myclass.class" 您也可以在上述指令指定目錄或 JAR 檔來套用探測到一群類別。如需上述指令的相關資訊,請參閱 Probekit 說明檔。
    請注意,您不能將探測套用到已進行測試設備的類別。如果套用探測到您的類別,而且希望以後能將修改的探測版本套用到相同的類別集,您應該將所有的 *.class.bak 檔重新命名成為 *.class,然後再套用探測。
  8. 啟動 WebSphere Application Server。
  9. 啟用工作台的「側寫和記載」喜好設定中的側寫:
    1. 從工具列中,選取視窗 > 喜好設定
    2. 選取側寫和記載
    3. 在「側寫和記載」窗格中,選取啟用側寫
    4. 選取確定套用變更。
  10. 在工作台開啟「側寫和記載」視景:
    1. 選取視窗 > 開啟視景 > 其他
    2. 選取側寫和記載
    3. 選取確定
  11. 連接「J2EE Request Profiler」側寫代理程式:
    1. 從工具列選取側寫。這時會開啟啟動配置視窗。
    2. 配置清單中選取連接 - Java 程序
    3. 按一下新建來建立新的配置。
    4. 在新建配置窗格中,在名稱欄位指定側寫配置的名稱。
    5. 選取代理程式標籤。
    6. 代理程式清單中使用方向鍵選取 J2EE Request Profiler
    7. 按一下側寫開始側寫應用程式。
  12. 在「側寫監視器」視圖中,用滑鼠右鍵按一下側寫代理程式並選取開始監視。將會開始收集資料。
  13. 執行您的 J2EE 應用程式。
  14. 開啟其中一個「側寫和記載」視景的側寫視圖來檢視收集到的側寫資料。若要開啟視圖:
    1. 在「側寫監視器」視圖中,用滑鼠右鍵按一下側寫代理程式並選取開啟工具
    2. 選取列出的其中一個視圖。
    附註:線上文件可以找到有關應用程式側寫和「側寫」視景的側寫視圖的詳細資訊(說明 > 說明內容 > 搜尋: >「應用程式側寫視景」> 執行)。
  15. 在「側寫監視器」中,選取重新整理視圖按鈕重新整理視圖。
  16. 請注意,您可以採用任何方式來修改探測並重新套用到您的類別。例如,您可以併入 <target> 陳述式而將探測的目標定在特定的類別/方法,併入方式如下:
                         <target type='exclude' package='*' method='myMethod'/>
    強烈建議使用者閱讀 Probekit 說明檔來決定如何修改探測檔最能符合需求。



(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.