カスタムマッチルールの作成

  1. Configuration > Instrumentation の順に移動して [Transaction Detection] サブタブを選択します。
  2. [Rules] サブタブを選択します。
    注: [Transaction Detection] タブの特定のスコープ内にルールを追加することもできます。
  3. [Custom Match Rule] が選択された状態で [Add] を選択すると、[Add Rule] ページが開きます。
  4. [Agent Type] と [Entry Point Type] を選択してから [Next] を選択します。
  5. 注: [Override Lockdown] オプションは、Java エージェント 25.3 以降で使用できます。
    （オプション）[Override Lockdown] を選択して、このルールに由来するビジネストランザクションが一般的なロックダウンをバイパスできるようにします。このルールのビジネストランザクションは、ロックダウンが有効になっている場合でも [Overflow] タブに移動しません。
  6. [Summary] タブで一般的なルールを設定します。
    • カスタムマッチ除外ルールを作成している場合は、[Exclude Transactions discovered by this rule] をクリックします。

    • ルールの [Name] を入力します。アプリエージェントは、ルールに一致するリクエストをこのルール名に基づいて命名します。

      注: エラーを回避するために、ルール名には次の特殊文字を使用しないでください。小なり記号（<）および大なり記号（>）。
    • 必要に応じてルールを無効にし、ルール [Priority] を設定して [Scope.] に割り当てます。ルールの優先順位の詳細については、「トランザクション検出ルール」を参照してください。スコープについては、「スコープ構成モデル」を参照してください。
  7. [Rule Configuration] タブで、次を実行します。

    2. エントリポイントタイプに基づいて一致基準を構成します。たとえば、PHP Web では、HTTP メソッド、URI、クエリパラメータなどの HTTP 指向の一致基準を指定できます。

      ヒント: Servlet および POJO エントリポイントタイプには [Live Preview] ボタンがあり、カスタムマッチルールのライブプレビューセッションを起動できます。ライブプレビューは、アクティブノードからデータをストリーミングするので、Add Ruleウィンドウでルール構成をインタラクティブに実験できます。
      （オプション）エントリポイントが POJO である Java エージェント トランザクション検出ルールの場合、[Select from call graphs] オプションを使用すると、インストルメント化されたイグジットポイントまたはロガーにヒットしているすべての潜在的なエントリポイントを自動的に見つけることができます。一部のトラフィックがビジネストランザクションとして検出されていない疑いがある場合、このオプションを使用します。次の設定を行います。

      1. コールグラフのキャプチャ期間を変更するには、find.entry.point.session.window.size コントローラプロパティを設定します。このプロパティでは、コールグラフキャプチャ期間の分数を指定します。コールグラフセッションが開始されると、数分以内にコールグラフが表示されます。

      2. コールグラフのキャプチャ期間を変更するには、find.entry.point.session.window.size コントローラプロパティを設定します。このプロパティで、コールグラフのキャプチャ期間の分数を指定します。コールグラフセッションが開始されると、数分以内にコールグラフを表示できます。
        警告: コールグラフキャプチャは、CPU とメモリを使用します。エージェントパフォーマンスに影響を与える場合があります。コールグラフキャプチャは、CPU とメモリを使用します。エージェントパフォーマンスに影響を与える場合があります。
    3. コールグラフの詳細で、インストゥルメント化する特定のクラスまたはメソッドを検索します。選択したクラスとメソッドは、現在のルールに自動的に追加されます。ルールの優先順位、範囲を設定し、ルールを保存します。ルールの優先順位の詳細については、「トランザクション検出ルールの優先順位」と「」を参照してください。ルールを保存するとすぐに、欠落しているビジネストランザクションの表示を開始できます。