Correlate Business Transactions for EUM

This page describes how to correlate business transactions for End User Monitoring (EUM). You can correlate the network request events of EUM applications with the business transactions of Business Applications. The EUM application can be a browser, mobile, or IoTapplication. The correlation is made between EUM application beacons containing network request event information and instances of business transactions (transaction snapshots).

For detailed information, including how and what is correlated for each type of EUM application, see these pages:

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).
Note: If automatic business transaction correlation is not supported for your app server agent, you can manually enable business transaction correlation in the Controller UI.

Business Transaction Correlation Support for App Server Agents

This table shows the app server agents that support business transaction correlation.

Java Agent

Automatic (Java Agent >= 20.3.0, and Controller >= 20.4.0)
.NET Agent .NET Framework: Automatic (.NET Agent >= 20.9.0, and Controller >= 20.10.0)
.NET Core: Automatic (.NET Agent >= 21.1.0, and Controller >= 20.10.0), Windows only
Linux: Automatic (.NET Agent >= 21.5)

Node.js Agent

Manual

PHP Agent

Manual
Python Agent Manual

Access Business Transaction Correlation

To configure business transaction correlation:

  1. In theApplication Dashboard, clickConfiguration > User Experience App Integration.
  2. Under theBusiness Transaction Correlationtab, there are two options depending on the correlation support for your App Server Agents:

Automatic Correlation of Business Transactions

By default, the correlation of business transactions of business applications instrumented with Java Agent >= 20.3.0 is enabled.

Under the Business Transaction Correlation tab, you can choose to opt out or filter requests with match or exclude rules.

Business Transaction Correlation

Opt In to Automatic Correlation

To opt in to have business transactions automatically correlated, you must use Java Agent >= 20.3.0. If you are using an older version of the Java Agent, you must upgrade the agent.

For unsupported agents, you need to manually enable business transaction correlation.

Opt Out of Automatic Correlation

If business transaction correlation is enabled by default, you can opt out by:

  1. In the Application Dashboard, click ConfigurationUser Experience App Integration.

  2. Under the Business Transaction Correlation > Opt Out of Correlation, click opt out of correlation.

  3. From the Opt Out of Correlation dialog, click Opt Out.Opt Out of Correlation

Manually Enable Business Transaction Correlation

For app agents that do not support automatic correlation, you need to enable business transaction correlation in the Controller UI:

  1. In the Controller UI, go to Applications and select an application.
  2. On the left-hand panel, click Settings > Configuration.
  3. Click User Experience App Integration > Enable Business Transaction Correlation.
  4. On the left-hand panel, click Tiers & Nodes.
  5. Click on a node you want to enable correlation for. In Step 8, you have the option to apply the properties to all nodes in a tier, so it does not matter which node you initially select.
  6. On the top menu bar, click Actions > Configure App Server Agent.
  7. Click Use Custom Configuration and create two properties:
    • enable-eum-cookie:
      • Name: enable-eum-cookie
      • Type: boolean
      • Value: true
    • enable-eum:
      • Name: enable-eum
      • Type: boolean
      • Value: true
  8. Click 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.