Integrations > AppDynamics

AppDynamics Integration

AppDynamics is an application performance monitoring solution for Java, .NET, PHP and Node.js applications. AlertSite UXM integrates with AppDynamics to provide server-side transaction snapshots for your monitored web applications and APIs. The snapshots include diagnostic information like time spent in various backend areas, slowest methods and SQL queries, exception stack traces and more.

The integration means that AppDynamics collects snapshots for all transactions triggered by your AlertSite monitors. The monitor run results in AlertSite include links to these snapshots for better visibility into your application performance.

In This Topic

Requirements

Supported Monitor Types

AppDynamics transaction tracing is supported for the following monitor types:

Monitors that run on Private Node Server and InSite locations are also supported.

Note that DéjàClick monitors that use Internet Explorer do not integrate with AppDynamics. To use AppDynamics transaction tracing, re-upload your DéjàClick script and set it to use Firefox or Chrome.

Configure AppDynamics

Configure HTTP Request Data Collector

First, you need to configure AppDynamics data collector to capture transactions triggered by AlertSite monitors. For example, you can adjust the Default HTTP Request Data Collector that AppDynamics uses for all transactions.

  1. Log in to AppDynamics Controller UI as an administrator or account owner.
  2. On the Home screen, click the application you are monitoring with AlertSite.
  3. On the left, select Configure > Instrumentation.
  4. Switch to the Data Collectors tab. If you do not see it, click >> in the top menu and select Data Collectors.
  5. In the lower table, select Default HTTP Request Data Collector, and click Edit.

    AppDynamics: Data Collectors

  6. In the Headers text box, append X-SmartbearReqID at the end.

    AppDynamics: HTTP Request Data Collector Configuration

  7. Click Save.

Note: It may take up to 1 hour for the changes to propagate to all AppDynamics Agents on your application servers.

Create a Read-Only User (Optional)

To connect to AppDynamics, AlertSite needs an AppDynamics username and password. AlertSite only needs read-only access to AppDynamics. So, you can use any user account, but for security purposes you may want to create a read-only AppDynamics user.

To create a read-only user:

  1. From AppDynamics top menu, select Settings > Administration.
  2. Switch to the Users tab.
  3. Click + above the user list.
  4. Enter the Username, Name, Email and Password for the user.

    Note: The username must not include these characters: & @ : \ / " [ ] | < > + = ; , ? * ' tab space

  5. In the Roles table, select Read Only User (Default) and unselect other roles.

    AppDynamics: Creating a read-only user

  6. (Optional) In the Groups table, select a group for the user.
  7. Click Save.

Configure AlertSite UXM

  1. Log in to AlertSite UXM as an Admin or Co-Admin user.
  2. Select Settings > Manage Integrations from the top menu.
  3. Click AppDynamics.
  4. In the wizard, specify the AppDynamics connection settings:

    AppDynamics Connection Settings

    SettingDescription
    TypeYour AppDynamics Controller type:

    SaaS – hosted by AppDynamics.

    On premise – hosted on your company-owned server.

    URLThe URL you use to access AppDynamics Controller UI in a browser. Typical values:

    SaaS:

    http://<account>.saas.appdynamics.com/controller

    On-Premise:

    http://<controller-host>:<controller-port>/controller

    Note: Use the https:// prefix if the Controller has SSL enabled.

    AccountOnly for SaaS Controllers. Your AppDynamics account name.
    User and PasswordThe user name and password to connect to AppDynamics. This can be a read-only AppDynamics user you created for integration (see above).

    Notes:

    • This account must be indicated in the Settings > Administration > Users section in AppDynamics. LDAP and SAML accounts are not supported. If you use LDAP or SAML authentication, create an AppDynamics user account for integration.
    • The username should not contain these characters: & @ : \ / " [ ] | < > + = ; , ? * ' tab space
    AppDynamics Tab ModeAlertSite opens AppDynamics transaction snapshot in another browser tab. This option controls how many tabs to open:

    Reuse tab – Open all snapshots in the same browser tab, so that a newly opened snapshot replaces the previously opened snapshot.

    New tab per event – Open each snapshot in a separate browser tab.

  5. Click Next.
  6. Select the monitors where you want AppDynamics providing transaction screenshots.

    Selecting monitors for AppDynamics transaction tracing

    Note: AppDynamics Agent must be installed and running on the application servers where these applications are hosted.

  7. Click Finish.

View AppDynamics Transaction Snapshots

When you are viewing results in the Monitor Runs dashboard in AlertSite, click the AppDynamics icon to open the AppDynamics transaction snapshot for the selected step.

To access the snapshots:

  1. In AlertSite UXM, go to Monitors > Runs.
  2. Select the monitor from the list at the top.
  3. Expand a run. For DéjàClick and API monitors – expand it further down to a specific event or test step.

  4. Click the + or Event Details button next to a step.

    This opens the HTTP request waterfall chart for that step. Requests that have AppDynamics transaction snapshots are marked with the AppDynamics icon.

    Accessing transaction snapshots

  5. Click AppDynamics to view the snapshot. It will open in a new browser tab.

    Note: If you are not already logged in to AppDynamics, you will need to enter your AppDynamics username and password.

By default, the snapshot shows the Call Graph of all server-side method calls initiated by the transaction and the time spent on each method.

Transaction snapshot - call graph

To view the slowest methods, switch to the Hot Spots section.

Transaction snapshot - hot spots

To view the most time-consuming SQL queries, switch to the SQL Calls section.

Transaction snapshot - SQL calls

For more information about these snapshots, see Transaction Snapshots in AppDynamics documentation.

Enable or Disable AppDynamics Integration

Once the integration is set up, you can change the AlertSite monitors where you want to AppDynamics to collect transaction snapshots.

For one monitor

For multiple monitors

For all monitors

Disable AppDynamics integration completely

Frequently Asked Questions

Does AppDynamics integration consume measurement credits in AlertSite?

AppDynamics integration is free for all users of AlertSite and AppDynamics, and does not consume any measurement credits.

Can I see AppDynamics snapshots for monitor runs from before the integration?

No. Only runs that occurred after you configured the integration have links to AppDynamics snapshots, and only for those monitors that you selected for AppDynamics transaction tracing.

Does AppDynamics collect snapshots for monitors that are not selected for transaction tracing?

Yes and no. By default, AppDynamics captures snapshots only for slow and failed transactions – whether real user transactions or transactions triggered by AlertSite monitors. You can see these default snapshots on the Transaction Snapshots Snapshots tab of your application dashboard in AppDynamics. You cannot view them from AlertSite though.

Troubleshooting

If you have just configured the integration, wait for at least 1 hour to start seeing AppDynamics snapshot links in the monitor run results. Note that only runs, which occurred after the integration starts working, have snapshot links.


If your monitor run results do not include links to AppDynamics snapshots:

You can also check if a snapshot exists in AppDynamics:

  1. In AlertSite’s Monitor Runs dashboard, expand latest run results and note the request URLs and timestamps.
  2. In AppDynamics:
    1. Open the Business Transactions dashboard for your application.
    2. Select a transaction ran by your monitor and click View Dashboard, then Transaction Snapshots.
    3. See if there is a snapshot with the timestamp that matches the monitor run.

      Note: : You may need to select a longer time range for the dashboard.

    4. If there is no matching snapshot, double-check the data collector configuration.
    5. If a snapshot exists:
      • Select it and click View Transaction Snapshot, then Drill Down.
      • Switch to the HTTP Params tab. It should show the Header-X-SmartbearReqID header.
      • If the header is not there, double-check the data collector configuration.

If these tips do not help resolve your issue, contact SmartBear Support.

© 2017 SmartBear Software. All rights reserved.      Terms of Use · Privacy Policy