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

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

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

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

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

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

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

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