AppDynamics Integration

The ThousandEyes platform integrates with the popular application performance monitoring system AppDynamics. When an alert is raised in ThousandEyes, an alert notification can be sent to an AppDynamics instance for a specific application. You can set up multiple integrations to the same instance, targeting different applications or severity levels.

The AppDynamics integration is currently only supported for Cloud and Enterprise Agent and BGP alert types.

Configuring Your AppDynamics Integration

To integrate ThousandEyes alerts with your AppDynamics instance, do the following:

A. In the ThousandEyes app, go to Alert Settings.

B. Expand the alert rule you want to integrate into AppDynamics, and click the Notifications tab.

C. Click Configure Integrations > Add New Integration to open the popup window below. If you already have one or more integration services configured, click Edit Integrations > Add New Integration.

Figure 1: AppDynamics Integration in ThousandEyes
  1. Type: Choose the system you want to integrate ThousandEyes alerts with.

  2. Name: Enter the name of your integration.

    This is a name for use within the ThousandEyes platform. Use a human-readable string that distinguishes this integration from any other integrations you may have configured.

  3. AppDynamics Instance: Enter your specific AppDynamics instance in the form of protocol://hostname:[port]. For example,

    The ThousandEyes platform appends /controller/rest/applications/%s/events to the URL. If these values are included in what you enter here, the platform strips them.

  4. Application Name: Enter the specific AppDynamics application name. You can create multiple integrations that target different applications in the same instance.

  5. AppDynamics Username: Enter your AppDynamics username. Note: This username must be formatted as your AppDynamics [email protected] without .com added. Additionally, the AppDynamics user must have the "Create Events" permission enabled under "Application Permissions" and "Roles" inside of AppDynamics.

  6. AppDynamics Password: Enter your AppDynamics password.

  7. Severity: Choose your desired AppDynamics severity for this alert: Info, Warning, or Error.

  8. Tier: This is an optional field that matches a tier inside AppDynamics. If you use the Tier field, the value you enter here must match the tier listed in AppDynamics for the specified application.

  9. Node: This is an optional field that matches a node inside AppDynamics. If you use the Node field, the value you enter here must match the node listed in AppDynamics for the specified application.

  10. Business Transaction: This is an optional field that matches a business transaction inside AppDynamics. If you use the Business Transaction field, the value you enter here must match the business transaction listed in AppDynamics for the specified application.

  11. Learn more about the AppDynamics integration This link takes you to the documentation for the AppDynamics integration.

  12. Cancel / Test / Add New Integration: Either cancel your integration; test your integration by sending a sample alert to your instance; or, once all fields are finalized, add the new integration you have just configured.

A configured AppDynamics integration example is shown below:

Figure 2: Properly Configured AppDynamics Integration

Next Steps within AppDynamics

Now when an alert is triggered or cleared, the alert details will be posted as a custom event within the specific AppDynamics instance and application, as shown below.

All alert clear events will be displayed with a severity of level Info. It is important that you remove any filters on the AppDynamics side, as custom events are often auto-filtered out of the Events tab:

Figure 3: Alert Details in AppDynamics

To see more details, click the alert. ThousandEyes also passes the following alert properties in the custom event:

  • alertId

  • alertState

    (Clear or Triggered)

  • alertType

    (Options are: BrowserBot, Http, Network, OneWayNetwork, Voice, DnspDomain, DnspNameServer, DnsServer, DnsTrace, Dnssec, Transaction, WebTransaction, Bgp, PathTrace, Ftp, Sip)

  • ruleName

  • testName

This allows you to correlate trigger events with clear events, and to create policies in AppDynamics based on these specific properties:

Figure 4: Summary in AppDynamics

The custom event's Comments tab provides specific details on the alert. Click the View in ThousandEyes link to open the ThousandEyes app at the Views screen for the alert start time.

Figure 5: Comments Section in AppDynamics