データコレクタの手動構成
このページでは、トランザクション分析用のデータコレクタを設定する方法について説明します。
データコレクタには、HTTP、メソッド呼び出し、SQL の 3 種類があります。データコレクタを使用すると、ビジネスコンテキストをトランザクションに追加することができます。たとえば、メソッド呼び出しデータコレクタ（MIDC）は、メソッドパラメータに基づいて順序が遅いかどうかを通知できます。
はじめる前に
HTTP リクエストデータコレクタの設定
HTTP 要求データを収集するには、デフォルトの HTTP 要求データコレクタを使用できます。分析用にコレクタを明示的に有効にする必要があります。
分析用の HTTP データコレクタを設定するには、次の手順を実行します。
- コントローラ UI で、上部のナビゲーションバーから [AnalyticsConfiguration] を選択します。
- [トランザクション分析（Transaction Analytics）] - [手動データ収集（Manual Data Collection）] タブに移動します。
- [Configure Analytics for Application] ドロップダウンから対象のアプリケーションを選択します。
- HTTP Request Data Collectors にアクセスします。有効にする HTTP データコレクタを選択し、[Edit]（新しいコレクタの作成は [Add]）をクリックします。
- [HTTP Request Data Collector] ページで、収集するデータを確認し、[Transaction Analytics] が選択されていることを確認し、[Save] をクリックします。
- [Configure Transactions] を選択し、データコレクタが適切なビジネストランザクションで有効になっていることを確認します。「データコレクター」を参照してください。
Configure Method Invocation Data Collectors
You can also use the page to enable existing or new Method Invocation Data Collectors. Open the Method Invocation Data Collectors panel. The process is essentially the same as described in Data Collectors.
- Check the Transaction Analytics check box to use this collector for Analytics.
- Check the Configure Transactions popup to confirm you have enabled the right Business Transactions.
- Check that the name of the MIDC does not exceed the 50 character limit.
Field Name Recommendations
While there are no requirements for MIDC field names, Splunk AppDynamics recommends using only alpha-numeric characters, hyphens, and underscores.
MIDC field names that start with special characters may cause application events to disappear from Analytics in the Controller. As a best practice, avoid the following characters in your MIDC field names:
-
Dots
-
Spaces
-
Slashes
-
Special characters (such as $, %, &)
-
Regular expression characters
You can learn more about field name conventions and recommendations in Data Field Naming for Events Service >= 4.5.3.
Field Length Limit
The maximum number of characters allowed in a custom data field is 8,191.
SQL データコレクタの構成
トランザクション スナップショットは SQL クエリをキャプチャします。SQL データコレクタは、分析用に SQL ステートメントで使用されるパラメータからビジネスデータを抽出する方法を提供します。「SQL コールからのビジネスデータの収集」を参照してください。
データコレクタのトランザクション分析データ型変換の有効化
データコレクタは、実行時にフィールドタイプ（文字列、ブール値、または数値）を決定します。収集したデータが使用するタイプではない場合があります。たとえば、データコレクタがフィールドタイプ文字列の場合、メトリックを追加することはできません。
フィールドタイプを変更することはできませんが、トランザクション分析データ型の変換で実行する前にフィールドタイプを指定できます。
トランザクション分析データ型の変換を有効にするには、次の操作を実行します。
- 管理コンソールにログインします。
CODE
http:<controller-hostname>:8080/controller/admin.jsp or https: <controller-hostname>:45/controller/admin.jsp. - [Controller Settings] ページで、
analytics.type.conversion.enabledの値を false から true に変更します。 - [Save] をクリックします。
データ型の変換は、コントローラ上の HTTP および [Method Invocation Data Collector] の設定ページで有効になっている場合にのみ表示されます。データ型の変換を有効にしている間にこのページを開いた場合は、ページを更新して変更を確認する必要があります。
データ型の変換は、次のルールに従って動作します。
- 新しいデータコレクタのみで使用できます。
- データコレクタごとにタイプを手動で選択します。
- 保存後にタイプを変更することはできません。
HTTP データコレクタでのトランザクション分析データ型の変換
トランザクション分析データ型の変換を使用するには、新しい HTTP パラメータを作成します。既存の HTTP 要求データコレクタに追加するか、新規に作成することができます。
このプロセスは、基本的には HTTP パラメータの作成と同じです。ただし、トランザクション分析データ型の変換が有効になったので、今後はドロップダウンを持つ [Type] フィールドが表示されます。
HTTP パラメータに必要なフィールドタイプを選択します。タイプを指定しない場合は、このフィールドを空白のままにします。HTTP データコレクタのデフォルトのタイプは string です。
メソッド呼び出しデータコレクタでのトランザクション分析データ型の変換
トランザクション分析データ型の変換を使用するには、新しいメソッド呼び出しデータコレクタ（MIDC）を作成します。既存の MIDC に追加したり、新規に作成したりできます。
このプロセスは、基本的には MIDC を作成するのと同じです。ただし、トランザクション分析データ型の変換が有効になったので、今後はドロップダウンを持つ [Change Type to] フィールドが表示されます。
MIDC に任意のフィールドタイプを選択します。
[Transaction Analytics Type ] は、デフォルトで [Use APM Type] になります。これは、実行時のタイプを決定します。タイプを指定しない場合は、[Use APM Type] を選択します。
トランザクション分析データ型の変換の命名要件
トランザクション分析データ型の変換を使用する場合は、次の命名要件を参照してください。
- 表示名は、各データコレクタ内で一意である必要があります。名前では大文字と小文字が区別されます。
- フィールドタイプも同じである限り、異なるデータコレクタ設定間で表示名を繰り返すことができます。
- データコレクタからフィールドを削除して、別のフィールドタイプを使用してフィールドを再度追加する場合は、データコレクタの名前を変更する必要があります。
フィールドタイプの変更
フィールドタイプは、データコレクタに保存された後は変更できません。フィールドタイプを変更するには、削除して新しい名前で再作成することをお勧めします。