カスタムマッチルールのライブプレビュー

Works with:

Servlet または POJO カスタムマッチルールを AppDynamics で作成または編集する場合、[Live Preview] をクリックして、ノードから関連するトランザクションデータを調べることができます。

カスタムトランザクション検出ルールのライブプレビューセッションでは、ビジネストランザクションでのルール更新の効果をインタラクティブにプレビューできます。ライブプレビューには、アプリケーションからストリーミングするライブデータを調べるためのツールも、異なるルールタイプごとに用意されています。

ライブプレビューを起動するときに、トランザクションをプレビューするノードを選択します。ノードはティア別にまとめられます。どのノードにアクティブなエージェントがあるのか、およびすでにノード上で実行しているライブプレビューセッションがあるかどうかを確認できます。

権限

ライブプレビューを使用するには次の権限が必要です。

トランザクション検出の構成
機密データの表示

AppDynamics ロールベースのアクセス制御の詳細については、「ロールと権限」を参照してください。

ビジネストランザクションのプレビュー

カスタムマッチルールのライブプレビューセッションを開始すると、コントローラの左ペインにルール構成が表示されます。右ペインの [Preview Business Transactions] をクリックして、結果のトランザクションを表示します。ルールを編集し、[Apply] をクリックすると、セッション内で変更内容を更新できます。

エージェントがルールのエントリポイントを検出しても、トランザクションペイロードが既存のトランザクションからの相関データを含む場合、ライブプレビューにはマスキングされたトランザクションが表示されます。

POJOマッチルールツール

次のツールを使用して、データを調べ、POJOカスタムマッチルールのエントリポイントを構成できます。

クラス/メソッドブラウザでは、クラスを検索できます。結果のクラスまたはメソッドを右クリックして、POJOのクラスおよびメソッド一致基準を設定できます。選択したメソッドのメソッド呼び出しも表示できます。
ライブプレビューモードでは、エージェントが返すことのできるメソッドおよびクラスの数が現在制限されています。その制限は次のとおりです。
- クラスの最大数：1000
- メソッドの最大数：300
classmethodservice.max.no.of.classes.reported と classmethodservice.max.no.of.methods.reported のノードプロパティをそれぞれ修正することにより制限を変更できます。
メソッド呼び出しでは、指定したメソッドのサーバーからライブデータを調査できます。メソッド呼び出しを展開して、呼び出されたオブジェクト、パラメータ、戻り値などの詳細情報を表示します。データポイントを右クリックして、トランザクション分割で使用します。AppDynamics によって、get<field>() 構文に従って分割ルールが自動的に作成されます。コードが別の規則に従っている場合は、データポイントに getter メソッドを手動で指定する必要があります。また、getter チェーンをクリップボードにコピーすることもできます。
次の例は、メソッド Order.setQuantity() のデータを示しています。

Servletマッチルールツール

ライブプレビューを使用して、Servlet カスタムマッチルールのデータを調べた場合、AppDynamics にはルール基準を満たすライブ HTTP リクエストが表示されます。個々のリクエスト URL をクリックすると、詳細なリクエストデータ（ヘッダー、cookie、およびパラメータ）を表示できます。

ヘッダーなど個々のデータポイントを右クリックして、一致基準にその値を追加したり、トランザクション分割オプションとして設定します。次の例は、一致基準に特定のヘッダー値を追加する方法を示しています。

受信HTTPリクエストを、URI、HTTPパラメータ、ヘッダーなど、リクエストのさまざまな部分やペイロードでグループ化できます。Values列から結果を右クリックして、HTTPリクエスト一致基準に値を追加できます。

以下の例では、URIでグループ化されたHTTPリクエストのライブプレビューが示されています。

マスキングされたトランザクション

ライブプレビューは、別の既存のビジネストランザクションからのダウンストリームであるトランザクションに、マスキングされたトランザクションとしてフラグを付けます。現在のトランザクションをマスキングしている元のビジネストランザクションを表示するには、トランザクションの数を示すリンクをクリックします。

マスキングトランザクションのビジネストランザクションダッシュボードを表示するには、ビジネストランザクション名のリンクをクリックします。

1つまたは複数のマスキングトランザクションの外部にある現在のエントリポイントのメトリックを表示する場合は、次のように入力します。

アップストリームトランザクションを作成したビジネストランザクション検出ルールを無効にします。または
エントリポイントのサービスエンドポイントを作成します。

それ以外の場合、マスキングされたエントリポイントのパフォーマンスを、現在それが属しているビジネストランザクションのセグメントとして追跡を継続できます。