Create a splitting Business Transaction

Goal of this tutorial

To show how to configure a Business Transaction that splits web requests by user session attribute loginBean.getUserContext().getUserName().

Scenario

Use the easyTravel demo application to learn about various AppMon features and functions. Or you can use any standard web application because this scenario works with simple web requests. The tutorial includes the following steps:

  1. Configure the servlet sensor properties.
  2. Create the measure to use for splitting.
  3. Create the splitting Business Transaction.
  4. See results.

Requirements

Run the demo application with injected agents and connect to a System Profile. If you use your own application, associate and activate the necessary web server Sensor. This tutorial may use naming based on the easyTravel demo app.

Configure the Servlet Sensor

To define Business Transactions based on a web request session attribute, you must enable capture of this parameter in the Configure Sensor Properties dialog box.

  1. Open the System Profile editor, and select the Customer Web Frontend (Java) > Sensor Configuration item.
  2. Double-click the Servlets sensor for editing.
  3. In the Parameters and Attributes pane, click Add, and select the Session Attribute in the Source column of the newly create row.
    You can enter a wildcard (*) to capture all parameters. However, this can result in capturing more data than you need and thus more overhead than necessary. A better approach is to enter action to capture the specific parameter.
  4. In the Attribute column, type loginBean.
  5. In the Accessor column, type getUserContext().getUserName().
  6. Save the new measure.
Configured Servlets sensor
Configured Servlets sensor

Create the measure to use for splitting

Now you need a measure which serves as the input for the Business Transaction.

  1. In the System Profile Preferences dialog box, select the Measures item.
  2. Click Create Measure to create a new measure.
  3. Find and select the Web Requests - Session Attribute Values metric in the Server Side Performance > Transaction based Measures > Business Transaction Evaluation/Filter/Splitting Values group.
  4. Give it a name, such as Demo Session Attribute Value.
  5. In the URI field of the Business Transaction Evaluation/Filter/Splitting Values Specific Attributes pane, select equals from the list, and type /orange-booking-finish.jsf.
  6. In the Session Attribute field of the Business Transaction Evaluation/Filter/Grouping Values Specific Attributes pane, type loginBean.getUserContext().getUserName(), and select contains from the Match list.
Configured measure
Configured measure

Create a splitting Business Transaction

Now you can create splitting Business Transaction.

  1. In the System Profile Preferences dialog box, select the Business Transactions item.
  2. Click Create to create a new business transaction.
  3. Give it a name, such as Demo Splitting.
  4. In the Filter pane, click + to add a filter measure.
  5. Find and select the easyTravel Search measure, to get web requests for our business transactions.
  6. In the Split Results pane, click + to add a splitting measure.
  7. Find and select the Demo Session Attribute Value measure.
  8. Save the new business transaction.
Configured Business Transaction
Configured Business Transaction

See results

Now you can use your business transaction. In the Cockpit, expand the Business Transactions node of the System Profile (easyTravel in this tutorial), and double-click the Demo Splitting. If you have just started easyTravel, you may have to wait while it produces some traffic, and new PurePaths are collected and analyzed.

Business Transaction dashboard
Business Transaction dashboard