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

以下の情報は 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 には、以下のいずれかの値を指定できます。

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

ファイルのフォーマットは次のようになります。
   pattern mode

ここで:

pattern
組み込みブランクなしのストリングです。このストリングの先頭または末尾には、 1 つのアスタリスク (*) が組み込まれています。この * は、ゼロ以上の文字に一致し、 一般的な接頭部または接尾部のパターンを作成します。単独の * を指定して、ストリング全体を表すこともできます。
mode
パターンに一致するクラスを、プロファイルに組み込む、または除外することを指定します。 mode に指定可能な値は、INCLUDE または EXCLUDE のいずれかです。

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

Java Profiling Agent のコントロール

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

関連概念
プロファイル・ツールの概説
プロファイル・リソース
「プロファイル・モニター」ビュー

関連タスク
AS/400 におけるスタンドアロン・モードでのアプリケーションのプロファイル
Java プロセスの起動または接続