Integrating with AppDynamics
This section describes how to integrate WebLOAD with AppDynamics.
AppDynamics is an Application Performance Management (APM) solution that monitors, troubleshoots, and diagnoses problems in mission-critical applications.
By integrating WebLOAD scripts with AppDynamics you will be able to identify slow or problematic transactions of scripts run by WebLOAD test sessions. The integration consists of two tasks:
- In WebLOAD – Specifying that a WebLOAD script should add a line in all transaction headers which will identify them as WebLOAD transactions. Refer to
Configuring WebLOAD Scripts for AppDynamics .
- In AppDynamics – Configuring AppDynamics to enable it to read the headers. The additional line enables AppDynamics to identify the corresponding transactions as WebLOAD transactions. Refer to Configuring AppDynamics to Recognize WebLOAD.
Configuring WebLOAD Scripts for AppDynamics
To enable WebLOAD for AppDynamics:
- Add the line
wlGlobals.AddWebLoadHeader=true
in the JavaScript code of the script.
This causes WebLOAD to send extra data upon every request of the script. The extra data identifies the request as a WebLOAD request, lists the name of the currently running script, and lists the name of the corresponding transaction.
Configuring AppDynamics to Recognize WebLOAD Transactions
This section describes how to configure AppDynamics Lite and AppDynamics Pro to read WebLOAD transaction headers.
Configuring AppDynamics Lite to Recognize WebLOAD Transactions
To configure AppDynamics Lite to recognize WebLOAD transactions:
-
In AppDynamics Lite, select Configure > Transaction Detection.
-
In the Servlet transaction type:
- Check the option Enabled.
- Check the option Discover Transactions automatically for all Servlet requests, and name them by their URI.
-
Click Configure Naming (adjacent to Discover Transactions automatically for all Servlet requests, and name them by their URI).
The Servlet Transaction Naming Configuration window appears.
-
In the Servlet Transaction Naming Configuration window, specify the WebLOAD naming convention by performing the following:
- Select Use the full URI or Use a part of the URI.
- Select Name Transactions dynamically using part of the request.
- Select Use a header value in Transaction names.
-
In the Header Name field, enter WebLOAD-TransactionName.
- Click Save.
When you run a WebLOAD test, AppDynamics displays the WebLOAD transactions in its Business Transactions list, as described in *Viewing WebLOAD Performance in AppDynamics.
Configuring AppDynamics Pro to Recognize WebLOAD Transactions
In AppDynamics Pro, in addition to configuring AppDynamics to recognize WebLOAD transactions, you can also configure AppDynamics to add a "WebLOAD- TransactionName" prefix to each transaction name.
To configure AppDynamics Pro to recognize WebLOAD transactions:
Note: As a prerequisite, you must first create an account in AppDynamics. In the example shown below, the account name is called WebLOADTest.
-
In AppDynamics Pro, access the Applications menu and select the WebLOAD application.
-
Select Configure > Instrumentation > Transaction Detection.
-
In the Transaction Detection page, select the WebLOAD node (called WebLOADTest in our example) and select Use Custom Configuration for this Tier.
-
In Custom Rules, click the green + (plus) icon.
-
In the Select the Entry Point Type for this Rule window that appears, select Servlet and click Next.
A New Business Transaction Match Rule – Servlet window appears, for defining a new rule.
-
Select the Transaction Match Criteria tab.
-
In the Transaction Match Criteria tab:
- In URI, select Is Not Empty.
- In Header:
- Select Check for parameter existence.
- In Parameter Name, enter WebLOAD-TransactionName.
- Click Create Custom Match Rule.
-
Select the new rule in the Custom Rules list.
-
In the Business Transaction Match Rule window that appears, select the Split Transactions Using Request Data tab.
-
In the Split Transactions Using Request Data tab:
- Check the option Split Transactions using request data.
- Select the option Use a header value in Transaction names and enter
WebLOAD-TransactionName
as the Header Name.
When you run a WebLOAD test, AppDynamics displays the WebLOAD transactions in its Business Transactions list, as described in Viewing WebLOAD Performance in AppDynamics.
Viewing WebLOAD Performance in AppDynamics
After AppDynamics and WebLOAD are configured so AppDynamics can recognize WebLOAD transactions, running a load test in WebLOAD displays the corresponding business transactions in AppDynamics. You can view the WebLOAD transactions in AppDynamics to determine their health.
To view WebLOAD transactions in AppDynamics:
- In AppDynamics, click Business Transactions to display the full list of top business transactions and their metrics.
The below image shows a load session execution in the WebLOAD Recorder, and the corresponding view in AppDynamics Lite.
Note that in AppDynamics Pro, the name of each WebLOAD application is prefaced with WebLOAD-TransactionName.
The external statistics are imported into the report.