AppDynamics Integration

AppDynamics Integration

Accelerate time-to-detect and identify the root cause of performance problems
with embedded snapshots from AppDynamics.

Accelerate IT and Digital Performance Issue Resolution

When problems occur having diagnostic data at your fingertips helps reduce mean time to resolution. AppDynamics snapshots help you quickly correlate internal application metrics with synthetic test runs within Catchpoint. Deeplinking to snapshots from AppDynamics enables data sharing and faster problem resolution when it matters most.

Contextualize Data

Links to AppDynamic snapshots from waterfalls and tooltips to get a complete view.

Centralize Information

Correlate Catchpoint data with internal application metrics from a single interface.

Reduce MTTR

Quickly view application diagnostics to improve incident response times.

AppDynamics Integration Guide

Instructions

AppDynamics Setup

In the Applications tab under "Configuration" select "Data Collectors". Add an HTTP Request Data Collector called "Catchpoint".  Fill the required fields to match the screenshot below. In the headers section, add
"appdynamicssnapshotenabled,cpguid". appdynamicssnapshotenabled will be used to initiate snapshots via Catchpoint synthetic tests. cpguid will be used for linking the Catchpoint test to the AppDynamics snapshot. This header name can be
changed as long as it matches the header sent by Catchpoint (shown later in this guide).
When using on premise deployments of AppDynamics, please make sure any firewalls allow traffic from the IP block 64.79.149.0/24.

Then make sure the Business Transactions you wish to capture snapshots for are properly configured under "Configure Transactions using this Data Collector".

You may also need to enable transaction detection for the appropriate apps and tiers.

Catchpoint Setup

Account Setup 

In the Setting menu, the page "Integrations" provides the ability to specify the AppDynamics account information. This is required so that Catchpoint can utilize the AppDynamics API to get snapshot links.

  • Account Name: The domain used for the AppDynamics controller. Include the protocol to indicate if http vs https should be used to access the controller.
  • Username: The username should be followed by"@" and the customer name for multi-tenant environments. For single tenant, the customer name is not required.
  • Password: The password corresponding with the username specified above.
  • Default Application: The application name can be specified at the test level, but it will default to this if not specified in the test.

Test Setup 

In order to instruct Catchpoint which tests should link to AppDynamics snapshots, the tests require specific HTTP request headers. This can be done at the Product, Folder, or Test level. 

  • appdynamicssnapshotenabled: Setting this header value to true will instruct AppDynamics to capture a snapshot for the test run.
  • cpguid: This header key can be changed, but it must match the header key set in the AppDynamics data collector. The value should be a guid which can be generated by the Catchpoint using the macro ${randomguid}. 
  • cp_integration: (optional) this can be used for specifying the Application name if you wish to use something other than the default application, and the account name if you are using multiple AppD instances. The value should be a valid json with the key "appDName" for the application name and "acName" for the account name, such as: {"appDName":"blog", "acName":"prod"}. This header is not read by AppDynamics, so nothing needs to be configured in AppDynamics to recognize the header since it is strictly used by Catchpoint to store the app name with the test results to use when querying the AppDynamics API for the snapshot link. 

Multiple Accounts
Catchpoint can be configured to use multiple instances of AppDynamics for the integration. For example, one account might be used for production and another for QA. Configuring this, per the bullet "cp_integration" in the above section, requires the use of the "acName" parameter to associate the synthetic test with the proper AppDynamics account.

Accessing AppDynamics Snapshots via Catchpoint
Once a test with the necessary headers has run, the test results will include a link for the AppDynamics snapshot. The link will be present in the following locations:

Waterfall

Waterfall Interstitial

Error Tooltip

After clicking the link, you will be directed to the corresponding AppDynamics snapshot, which should look similar to this:

AppDynamics is a registered trademark of AppDynamics, Inc. This content has not been sponsored or otherwise endorsed by AppDynamics. All other product and company names herein may be trademarks of their registered owners.

WordPress Image Lightbox Plugin