以獨立模式側寫應用程式

下列資訊適用於 Windows。 下列資訊適用於 AIX。 下列資訊適用於 Linux。 下列資訊適用於 Solaris。 您可以採取獨立模式來側寫應用程式(亦即從指令行),不必安裝「測試和效能工具平台」。 不過,您需要將 Agent Controller 安裝在要側寫的應用程式所在的機器上。

您可以呼叫 Java 側寫代理程式,以獨立模式側寫應用程式, 它是一個與 Java 虛擬機器 (JMV) 連接的程式庫,目的在擷取和記錄 Java 應用程式的行為。 代理程式的輸出格式是 XML 片段。

請利用 -Xrun Java 選項來呼叫 Java 側寫代理程式:

   -XrunpiAgent:agent_parm[,agent_parm]*

比方說,如果要利用 myFilters.txt 檔中定義的過濾器,將側寫階段作業的資料導向名為 PEProfilingData 的檔案中, 以此來側寫 PerformanceExample.java,您要在指令行中輸入下列指令:
    java -XrunpiAgent:server=standalone,filters=myFilters.txt,file=PEProfilingData.trcxml PerformanceExample

附註:如果您要在側寫模式下從指令行啟動 WebSphere Application Server 第 6 版 (WAS),您必須執行下列步驟:
  1. 切換至 <profile root>/config/cells/<nodename>Cell/nodes/<nodename>/servers/server1
  2. 編輯 server.xml 檔案中的 jvmEntries 元素。在此元素中,有一個屬性稱為 genericJvmArguments。請在此屬性值後面附加 -XrunpiAgent:server=enabled
  3. 重新啟動 WAS。
     
 
藉由增加 -XrunpiAgent 參數,您可以指定數種不同的模式來執行側寫代理程式。agent_parm 參數可以採用下列其中一個值:

類別過濾器檔案的格式

過濾檔案必須指定三個欄位:package/classmethodmode,格式如下:
   package/class method mode

其中:

package/class
這個欄位用來指定套件或類別名稱的型樣。 型樣必須指定為不含空格的字串。字串的開頭或尾端可包含一個星號 (*),例如 *.mypackageorg.mycompany.*。 * 會比對零個或多個字元,可以使型樣成為一般的字首或字尾型樣。 您也可以指定單獨一個 * 來代表所有字串。
方法 (method)
這個欄位用來指定方法名稱的型樣。 型樣必須指定為不含空格的字串,且規格規則同於 class 欄位。
mode
這個欄位指定在側寫中是否包含或排除符合型樣的套件或類別。mode 的值可以是 INCLUDE 或 EXCLUDE。

過濾器型樣會依指定的次序來處理,直到第一個 型樣找到相符者為止。如果類別名稱不符合任何指定的過濾器型樣,預設值就是併入 (INCLUDE) 類別。

Java 側寫代理程式控制項

當設定 server=enabledserver=controlled 參數來啟動 Java 側寫代理程式時,與代理程式的通訊是透過主機中的 Agent Controller,利用用戶端工作台來進行的。

附註:

相關概念
側寫工具概觀
側寫資源

相關作業
在 AS/400 以獨立模式側寫應用程式
啟動或連接 Java 程序
使用「側寫監視器」視圖