EUM とビジネストランザクションの関連付け

このページでは、エンドユーザモニタリング（EUM）のためにビジネストランザクションを関連付ける方法について説明します。EUM アプリケーションのネットワーク リクエスト イベントと、ビジネスアプリケーションのビジネストランザクションを関連付けることができます。EUM アプリケーションは、ブラウザ、モバイル、または IoT アプリケーションです。この相関は、ネットワーク リクエスト イベント情報とビジネストランザクションのインスタンス（トランザクション スナップショット）を含む EUM アプリケーションビーコン間で行われます。

EUM アプリケーションのタイプごとに何がどのように関連付けられるのかなどの詳細情報については、次のページを参照してください。

Benefits of Correlating Business Transactions

By correlating business transactions with network request snapshots, you can identify potential issues with the backend application that are causing bad user experiences. For example, you might find that a server error or a database query is causing a slow user experience.

Before You Begin

To correlate business transactions:

  1. Purchase licenses for Application Performance Monitoring (APM) and End User Monitoring (EUM).
  2. Instrument a business application with a supported app server agent.
  3. Instrument an EUM application (browser, mobile, or IoT application).
注: If automatic business transaction correlation is not supported for your app server agent, you can manually enable business transaction correlation in the Controller UI.

アプリケーション サーバー エージェントのビジネストランザクション相関のサポート

次の表に、ビジネストランザクションの関連付けをサポートしているアプリケーション サーバ エージェントを示します。

  • 自動相関がサポートされていると、ビジネストランザクションが自動的に関連付けられます。
  • 手動相関の場合、ビジネストランザクション相関を手動で有効にする必要があります。

Javaエージェント

自動（Java エージェント 20.3.0 以降、およびコントローラ 20.4.0 以降）
.NETエージェント .NET Framework：自動（.NET エージェント 20.9.0 以降、およびコントローラ 20.10.0 以降）
.NET Core：自動（.NET エージェント 21.1.0 以降、およびコントローラ 20.10.0 以降）、Windows のみ
Linux：自動（.NET エージェント 21.5 以降）

Node.jsエージェント

手動

PHPエージェント

手動
Pythonエージェント 手動

ビジネストランザクション相関へのアクセス

ビジネストランザクション相関を構成にするには、次の手順を実行します。

  1. [Application Dashboard] で、Configuration > User Experience App Integration の順にクリックします。
  2. [Business Transaction Correlation] タブでは、アプリケーション サーバー エージェントの相関サポートに応じて、次の 2 つのオプションがあります。

ビジネストランザクションの自動相関

デフォルトでは、Java エージェント 20.3.0 以降でインストゥルメント化されているビジネスアプリケーションのビジネストランザクションの相関は有効になっています。

[Business Transaction Correlation] タブでは、一致または除外ルールを使用してリクエストをオプトアウトまたはフィルタ処理することができます。

ビジネストランザクションの相関性

自動相関のオプトイン

ビジネストランザクションが自動的に関連付けられることをオプトインする場合は、Java エージェント 20.3.0 以降を使用する必要があります。古いバージョンの Java エージェントを使用している場合は、エージェントをアップグレードする必要があります。

サポートされていないエージェントの場合は、ビジネストランザクションの相関を手動で有効にする必要があります。

自動相関のオプトアウト

ビジネストランザクション相関がデフォルトで有効になっている場合は、次の手順を実行してオプトアウトできます。

  1. [Application Dashboard] で、[ConfigurationUser Experience App Integration] をクリックします。

  2. [Business Transaction CorrelationOpt Out of Correlation] で、[opt out of correlation] をクリックします。

  3. [Opt Out of Correlation] ダイアログで、[Opt Out] をクリックします。相関のオプトアウト

ビジネストランザクション相関の手動での有効化

自動相関がサポートされていないアプリケーション エージェントの場合は、コントローラ UI でビジネストランザクション相関を有効にする必要があります。

  1. コントローラ UI で、[Applications] に移動し、アプリケーションを選択します。
  2. 左側のパネルで、[Settings Configuration] をクリックします。
  3. [User Experience App IntegrationEnable Business Transaction Correlation] をクリックします。
  4. 左側のパネルで、[Tiers & Nodes] をクリックします。
  5. 相関を有効にするノードをクリックします。手順 8 では、階層内のすべてのノードにプロパティを適用するオプションがあるため、最初にどのノードを選択してもかまいません。
  6. 上部のメニューバーで、[ActionsConfigure App Server Agent.] をクリックします
  7. [Use Custom Configuration] をクリックして、以下の 2 つのプロパティを作成します。
    • enable-eum-cookie：
      • Name：enable-eum-cookie
      • Type：boolean
      • Value：true
    • enable-eum：
      • Name：enable-eum
      • Type：boolean
      • Value：true
  8. Apply to all Nodes in this Tier をクリックします。

Disable Business Transaction Correlation

To disable business transaction correlation:
  1. In the Application Dashboard, click Configuration > User Experience App Integration.
  2. Under the Business Transaction Correlation tab, toggle the Enable button.

Filter Business Transactions for Correlation

You can also specify which business transactions includes or excludes correlation headers. If you do not add request match rules or request exclude rules, ;all requests ;have correlation headers by default.

To add a request match or exclude rule:

  1. From Filtering Options, expand Request Match Rules or Request Exclude Rules.
  2. Click Add Rule.
  3. Check the Method to use ;the default HTTP method GET or ;select a different HTTP method.
  4. Check the URI checkbox and select one of the matching methods from the dropdown:
    • Starts With
    • Ends With
    • Contains
    • Equals
    • Matches RegEx
    • Is in List
  5. (Optional) Clickthe gear iconand check the NOT checkbox. This condition reverses the results by excluding the requests that match the specified parameters.
  6. Click Add Rule.