プローブ・データの収集: 基本的な使用法

プローブ・データを収集するには、「プロファイル」ダイアログ・ボックスで プロファイル構成を定義するときに使用するプローブを選択し、構成します。 プロファイル構成を使用して、ワークベンチでアプリケーションを起動するたびに、 このプローブが適用されます。

注: これらの基本的使用法の手順は、「プロファイル」ダイアログ・ボックスから起動できるアプリケーションの ためのものです。このダイアログ・ボックスは、アプリケーションを実行するための Java? コマンド行を、-Xrun オプションを含めて構成します。 この手順では、データを収集するマシン上で、Agent Controller および JVMPI エージェント piAgent を使用していることも想定されています。

アプリケーションが「プロファイル」ダイアログ・ボックスから起動できない場合、 または Agent Controller あるいは piAgent を使用できない場合は、 『プローブ・データの収集: 特殊な状態』を参照してください。

プロファイル構成でプローブを使用するには、以下のようにします。

  1. プロファイル・セットの編集」ダイアログ・ボックスを開きます。 これを開くには、「プロファイルおよびロギング」パースペクティブのメイン・ワークベンチ・メニューから、 「実行」 > 「プロファイル」の順に選択します。 「プロファイル」ダイアログ・ボックスでプロファイル構成を選択または作成し、「プロファイル作成」ページを選択します。 「概要」ページでプロファイル・セットおよびプロファイル・タイプを選択し、 「編集」をクリックして、「次へ」をクリックします。
  2. プロファイル・タイプのツリーで「プローブ」を展開し、 「プローブの挿入 (Probe Insertion)」を選択します。 「プローブの挿入 (Probe Insertion)」ページで、Probekit レジストリー内のプローブのリストが 表示されます。これらのプローブは、すべてユーザーが使用可能なものです。
  3. 適用するプローブの隣りのチェック・ボックスを選択します。 現行のプロファイル構成を使用してワークベンチでアプリケーションを起動するたびに、 これらのプローブが適用されます。
  4. デフォルトのフィルター・セットを使用したくない場合には、 データを収集するクラスおよびメソッドをターゲットにする、 別のフィルター・セットを指定してください。 選択したプローブにのみ適用されるカスタム・フィルター・セット、 または一般的にプロファイル・データ収集に適用される標準の フィルター・セットを、指定することができます。 両方を指定した場合は、選択されたプローブに対してカスタム・フィルターが標準フィルター・セットより優先します。
    重要: プロファイル・フィルター・セットはグローバルです。 フィルター・セットを変更、名前変更、または除去すると、 そのフィルター・セットを使用しているすべてのプロファイル・セットに影響が及びます。 フィルター・セットを変更または名前変更する場合は、 変更する前にそのフィルター・セットのバックアップ・コピーを取っておいてください。

    カスタム・フィルター・セットを指定するには、以下のようにします。

    1. プローブのリストの下で、「フィルター」タブをクリックします。
    2. 選択されたプローブに対して 「(標準のプロファイル・フィルターでなく) カスタム・フィルターを使用 (Use custom filters (instead of standard profiling filters) for selected probe」のチェック・ボックスを選択します。
    3. フィルター・セットを選択するか、 あるいは「追加」をクリックして新しいセットを構成します。
    4. フィルター・セットを編集するには、「追加」、「編集」 または「除去」をクリックします。
    5. 終了 (Finish)」をクリックするか、 あるいは、標準フィルター・セットも指定したい場合は 「次へ」をクリックします。

    一般的にプロファイル・データ収集に適用される標準フィルター・セットを指定するには、 次のようにします。

    1. 次へ」をクリックします。
    2. フィルター・セットを選択するか、 あるいは「追加」をクリックして新しいセットを構成します。
    3. フィルター・セットを編集するには、「追加」、「編集」 または「除去」をクリックします。
    4. 終了 (Finish)」をクリックします。

    フィルター・セットおよびプローブ・ターゲットの指定が、 計測するクラスおよびメソッドを決定する方法について 詳しくは、『プローブのターゲットおよびフィルター』を参照してください。

  5. プローブの選択および構成が終了したら、「終了 (Finish)」をクリックします。 選択したプローブの名前が、プロファイル・セットの内容リストに表示されます。
    注: プロファイル」ダイアログ・ボックスの「制限」ページに 指定したデータ収集制限は、プローブには適用されません。
  6. アプリケーションを起動し、プロファイルするには、「プロファイル」をクリックします。 アプリケーションが始動し、プロファイルが開始されます。 選択したプローブは、そのフィルター規則に従って適用されます。
    注:

    接続 - Java プロセス」起動構成を使用するとき、 プローブは、Java プロセスに接続した後で ロードされるクラスにのみ適用されます。 接続する にクラスがロードされた場合、プローブはそのクラスに適用されません。

    切り離すと、適用されたプローブはデータの収集を継続します。 さらに、プローブのターゲット指定およびフィルター・パターンがクラス名と一致する場合には、 これらのプローブが、ロードされる新しいクラスに継続して適用されます。

    プロセスに再接続すると、追加のプローブを適用できます。 この場合、新しいプローブと古いプローブの両方が作動します。 それぞれのターゲットおよびフィルターが、ロードされる新しいクラスの名前と比較され、 それぞれが、一致するクラスに適用されます。

関連タスク
Probekit レジストリーの管理
Probekit レジストリーへのプローブのインポート
関連資料
「プローブの挿入 (Probe Insertion)」ページ、「プロファイル・セットの編集」ダイアログ・ボックス
フィードバック
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.