スタンドアロン・モードのアプリケーションのプロファイル作成

以下の情報は Windows に該当します。 以下の情報は AIX に該当します。 以下の情報は Linux に該当します。 以下の情報は Solaris に該当します。 Hyades ツールがインストールされていなくても、 アプリケーションをスタンドアロン・モードで (つまり、コマンド行から) プロファイルできます。 ただし、プロファイル対象のアプリケーションが常駐するマシンには、Agent Controller が インストールされている必要があります。

Java プロファイル・エージェントを呼び出して、スタンドアロン・モードでアプリケーションの プロファイルを作成できます。このエージェントは、Java 仮想マシン (JVM) に接続して、Java アプリケーションの 動作をキャプチャーおよび記録するライブラリーです。エージェントからの出力は、XML フラグメントの形式です。

-Xrun Java オプションを使用して、Java Profiling Agent を次のように呼び出します。

    -XrunpiAgent:agent_parm[,agent_parm]*

例えば、myFilters.txt ファイルで定義されたフィルターを使用し、 プロファイル・セッションからのデータを PEProfilingData という名前のファイルに送るように 指定して PerformanceExample.java をプロファイルする場合、コマンド行から以下のように入力します。
    java -XrunpiAgent:server=standalone,filters=myFilters.txt,file=PEProfilingData.trcxml PerformanceExample

-XrunpiAgent パラメーターを増やすと、プロファイル・エージェントを実行 するための、さまざまなモードを指定できます。 パラメーター agent_parm には、以下のいずれかの値を指定できます。

クラス・フィルター・ファイルのフォーマット

フィルター・ファイルには、package/classmethod、および mode の 3 つのフィールドを以下のフォーマットで指定する必要があります。
   package/class method mode

ここで:

package/class
このフィールドは、パッケージまたはクラス名のパターンを指定する場合に使用します。パターンは、組み込みブランクなしのストリングとして指定する必要があります。このストリングの先頭または末尾には、1 つのアスタリスク (*) を組み込むことができます (例えば、*.mypackage または org.mycompany.*)。この * は、ゼロ以上の文字に一致し、 一般的な接頭部または接尾部のパターンを作成します。単独の * を指定して、ストリング全体を表すこともできます。
method
このフィールドは、メソッド名のパターンを指定する場合に使用します。パターンは、組み込みブランクなしのストリングとして指定する必要があり、class フィールドと同じ指定規則が適用されます。
mode
このフィールドは、パターンに一致するパッケージまたはクラスをプロファイルに組み込むか、または除外するかを指定します。mode に指定可能な値は、INCLUDE または EXCLUDE のいずれかです。

フィルター・パターンは、最初のパターン・マッチが成功するまでは、指定された順番で処理されます。 クラス名が指定されたいずれのフィルター・パターンにも一致しない場合、 そのクラスはデフォルトで組み込まれます。

Java Profiling Agent のコントロール

Java Profiling Agent が server=enabled または server=controlled パラメーター を指定して開始されると、このエージェントとの通信は、ホスト・マシンの Agent Controller を通じて、 クライアント・ワークベンチを使用して行われます。

関連概念
プロファイル・ツールの概説
プロファイル・リソース

関連タスク
AS/400 スタンドアロン・モードのアプリケーションのプロファイル作成
Java プロセスの起動または接続
「プロファイル・モニター」ビューの使用