データコレクタの手動構成

データコレクタは、少なくとも 2 つの方法で手動で設定できます。

左ペインから：

  1. 左ペインで [Configuration] をクリックします。
  2. [Instrumentation] をクリックします。
  3. [Data Collectors] タブをクリックし、追加するデータコレクタのタイプのデータコレクタボックス下にある [Add] をクリックします。データコレクタ設定パネルが表示されます。

コールグラフから：

  1. コールグラフをダブルクリックします。
  2. メニューバーで [Data Collectors] をクリックします。
  3. Actions をクリックします。
  4. Configure Data Collectors をクリックします。
  5. 追加するデータコレクタのタイプのデータコレクタボックス下にある [Add] をクリックします。データコレクタ設定パネルが表示されます。

データコレクタには、以下に挙げるプラットフォーム固有の考慮事項が適用されるのでご留意ください。

  • appd_bt_add_user_data function()C/C++ SDK：ここで説明するコントローラ UI ではなく、 を使用してメソッドデータコレクタを作成します。「C/C++ SDK 参考資料」を参照してください。
  • addSnapshotData()Node.js エージェント：ここで説明するコントローラ UI ではなく、 Node.js API のみを使用してメソッドデータコレクタを作成します。「Node.js エージェント API 参考資料」を参照してください。
  • Python エージェント：コントローラ UI ではなく、add_snapshot_data() Python エージェント API を使用してメソッドデータコレクタを作成します。「Python エージェント API 参考資料」を参照してください。

  • PHP メソッドデータコレクタ：「with a Class Name that」オプションのみが有効です。また、メソッドデータコレクタはスタンドアロン PHP 関数に追加できません。

データコレクタを構成する一般的な手順は以下のとおりです。

  1. データをキャプチャする方法を特定します。これを行うにはメソッドの署名を定義し、オプションで、メソッド内のコードポイントの値（戻り値や引数など）に基づいてフィルタを定義します。
  2. データのソースとなる実際のコードポイントを指定します。
  3. データコレクタをビジネストランザクションに適用する場合は、該当するビジネストランザクションを選択します。

通常、データコレクタを作成するには、アプリケーションのソースコードまたはドキュメントを参照して、コレクタを設定するコードの知識が必要です。JVM 1.5 や .NET など、いくつかのアプリケーション環境においては、メソッド呼び出しデータコレクタによってインストルメンテーション構成（クラス名、メソッド名、メソッドパラメータなど）が変更される場合に、JVM またはアプリケーションサーバを再起動する必要があります。