このページでは、トランザクション分析用のデータコレクタを設定する方法について説明します。

データコレクタには、HTTP、メソッド呼び出し、SQL の 3 種類があります。データコレクタを使用すると、ビジネスコンテキストをトランザクションに追加することができます。たとえば、メソッド呼び出しデータコレクタ（MIDC）は、メソッドパラメータに基づいて順序が遅いかどうかを通知できます。

はじめに

データコレクタを設定する前に、トランザクション分析を設定する必要があります。詳細については、トランザクション分析データの収集を参照してください。

HTTP リクエストデータコレクタの設定

HTTP 要求データを収集するには、デフォルトの HTTP 要求データコレクタを使用できます。分析用にコレクタを明示的に有効にする必要があります。

分析用の HTTP データコレクタを設定するには、次の手順を実行します。

  1. コントローラ UI で、上部のナビゲーションバーから [Analytics] > [ Configuration] を選択します。 
  2. [Transaction Analytics - Manual Data Collection] タブに移動します。
  3. [Configure Analytics for Application] ドロップダウンから対象のアプリケーションを選択します。 
  4. [HTTP Request Data Collectors] に移動します。有効にする HTTP データコレクタを選択し、[Edit]（新しいコレクタの作成は [Add]）をクリックします。
    HTTP Request Data Collectors
  5. [HTTP Request Data Collector] ページで、収集するデータを確認し、[Transaction Analytics] が選択されていることを確認し、[Save] をクリックします。
    Enable Data Collector
  6. [Configure Transactions ] を選択し、データコレクタが適切なビジネストランザクションで有効になっていることを確認します。「データコレクタ」を参照してください。  

メソッド呼び出しのデータコレクタの構成

[Analytics] > [ Configuration] ページを使用して、既存または新規のメソッド呼び出しデータコレクタを有効にすることもできます。[Method Invocation Data Collectors] パネルを開きます。基本的なプロセスは「データコレクタ」に説明されているものと同じです。

  • 分析でこのコレクタを使用するには、[Transaction Analytics] チェックボックスをオンにします。
  • [Configure Transactions] ポップアップをオンにして、適切なビジネストランザクションが有効になっていることを確認します。
  • MIDC の名前が 50 文字の制限を超えていないことを確認します。

フィールド名の推奨事項

MIDC フィールド名の要件はありませんが、AppDynamics では、英数字、ハイフン、および下線のみを使用することを推奨しています。 

特殊文字で始まる MIDC フィールド名を使用すると、アプリケーションイベントがコントローラの分析から消えることがあります。ベストプラクティスとして、次の文字を MIDC フィールド名に使用することは避けてください。

  • ドット

  • Spaces

  • スラッシュ

  • 特殊文字（$、%、& など）

  • 正規表現文字

フィールドの命名規則と推奨事項の詳細については、「イベントサービス 4.5.3 以降でのデータフィールドの命名」を参照してください。 

メソッド呼び出しデータコレクタの名前を変更すると、トランザクション分析で完全に新しいフィールドが作成されます。データコレクタフィールドのタイプを変更する場合は、古いデータとの競合を回避するために、新しいフィールドを作成することをお勧めします。

フィールド長の制限

カスタムデータフィールドの許容最大文字数は 8,191 文字です。

SQL データコレクタの構成

トランザクション スナップショットは SQL クエリをキャプチャします。SQL データコレクタは、分析用に SQL ステートメントで使用されるパラメータからビジネスデータを抽出する方法を提供します。詳細については、SQL コールからのビジネスデータの収集を参照してください。

データコレクタのトランザクション分析データ型変換の有効化

トランザクション分析データ型の変換には、コントローラバージョン 21.6.3、21.8.0、および 21.9.0 以降が必要です。Java の展開では、トランザクション分析データ型の変換は Java エージェント 21.3.0.32281 以降で使用できます。.NET の展開では、トランザクション分析データ型の変換は .NET エージェント 21.5.1 で使用できます。

データコレクタは、実行時にフィールドタイプ（文字列、ブール値、または数値）を決定します。収集したデータが使用するタイプではない場合があります。たとえば、データコレクタがフィールドタイプ文字列の場合、メトリックを追加することはできません。 

フィールドタイプを変更することはできませんが、トランザクション分析データ型の変換で実行する前にフィールドタイプを指定できます。 

トランザクション分析データ型の変換を有効にするには、次の操作を実行します。

  1. 管理コンソールにログインします。
    http:<controller-hostname>:8080/controller/admin.jsp or https:<controller-hostname>:45/controller/admin.jsp
  2. [Controller Settings] ページで、analytics.type.conversion.enabled の値を false から true に変更します。 
  3. Save をクリックします。 

データ型の変換は、コントローラ上の [HTTP] および [Method Invocation Data Collector] の設定ページで有効になっている場合にのみ表示されます。データ型の変換を有効にしている間にこのページを開いた場合は、ページを更新して変更を確認する必要があります。   

データ型の変換は、次のルールに従って動作します。

  • 新しいデータコレクタのみで使用できます。
  • データコレクタごとにタイプを手動で選択します。
  • 保存後にタイプを変更することはできません。

HTTP データコレクタでのトランザクション分析データ型の変換

トランザクション分析データ型の変換を使用するには、新しい HTTP パラメータを作成します。既存の HTTP 要求データコレクタに追加するか、新規に作成することができます。

このプロセスは、基本的には HTTP パラメータの作成と同じです。ただし、トランザクション分析データ型の変換が有効になったので、今後はドロップダウンを持つ [Type] フィールドが表示されます。

Transaction Analytics Data Type Conversion

HTTP パラメータに必要なフィールドタイプを選択します。タイプを指定しない場合は、このフィールドを空白のままにします。HTTP データコレクタのデフォルトのタイプは string です。

メソッド呼び出しデータコレクタでのトランザクション分析データ型の変換

トランザクション分析データ型の変換を使用するには、新しいメソッド呼び出しデータコレクタ（MIDC）を作成します。既存の MIDC に追加したり、新規に作成したりできます。

このプロセスは、基本的には MIDC を作成するのと同じです。ただし、トランザクション分析データ型の変換が有効になったので、今後はドロップダウンを持つ [Change Type to] フィールドが表示されます。

Transaction Analytics Type Conversion

MIDC に任意のフィールドタイプを選択します。 

[Transaction Analytics Type] は、デフォルトで [Use APM Type] になります。これは、実行時のタイプを決定します。タイプを指定しない場合は、[Use APM Type] を選択します。

トランザクション分析データ型の変換の命名要件

トランザクション分析データ型の変換を使用する場合は、次の命名要件を参照してください。

  • 表示名は、各データコレクタ内で一意である必要があります。名前では大文字と小文字が区別されます。 
  • フィールドタイプも同じである限り、異なるデータコレクタ設定間で表示名を繰り返すことができます。  
  • データコレクタからフィールドを削除して、別のフィールドタイプを使用してフィールドを再度追加する場合は、データコレクタの名前を変更する必要があります。 

フィールドタイプの変更

フィールドタイプは、データコレクタに保存された後は変更できません。フィールドタイプを変更するには、削除して新しい名前で再作成することをお勧めします。