AppDynamics

AppDynamics integration allows you to link DXA session replays with AppDynamics Browser Real User Monitoring (RUM).

Use cases

• Access session replays directly in AppDynamics Browser RUM to better understand user behaviors in sessions
• Explore DXA data metrics, such as DXS, from AppDynamics

Prerequisites

The DXA browser extension must be installed on Google Chrome or Mozilla Firefox.

Enabling AppDynamics integration

1. In AppDynamics, go to User Experience and click the browser app you want to integrate with DXA.
2. Go to Configuration > Configure JavaScript Agent.
3. Click the Switch to advanced settings toggle.
4. In Configure custom settings (optional), enter the following code:

   (function (config) {
      (function (info) {
          if (sessionStorage && sessionStorage.getItem('_da_da_sessionId')) {
              var d_sid = 'di-xxxxx-' +
   sessionStorage.getItem('_da_da_sessionId');
              info.PageView = function () {
                  return {
                      userData: {
                          decibelSessionID: d_sid
                      }
                  }
              }
          }
      })(config.userEventInfo || (config.userEventInfo = {}))
   })(window['adrum-config'] || (window['adrum-config'] = {})

5. In the fourth line of the code, replace "xxxxx" with the DXA property ID, maintaining the hyphens on either side of the number. For example, di-12345-.
   
   Note: To find the property ID, on the navigation bar, go to Settings > Property Settings > Tracking code.
6. Click Save.
   An HTML snippet is generated under GENERATE HTML SNIPPET on the right.
   
7. Click Copy.
8. Update the deployment.

AppDynamics integration with DXA is enabled. Allow at least 30 minutes for AppDynamics to capture new session data.

Accessing DXA session replays in AppDynamics

1. Ensure you are logged in to the DXA portal in a browser tab.
2. In a new tab, open AppDynamics.
3. In AppDynamics, on the navigation bar, click User Experience.
4. On the side bar, under REAL USERS, click Sessions.
5. In the Fields pane, under User Data, select decibelSessionID.

A list of sessions appears. The DXA session IDs appear to the right. The DXA browser extension will create hyperlinks for each session ID providing direct access to the session replays in the DXA portal.

Troubleshooting

Why do some of my sessions in AppDynamics not have a session ID?

Sessions with only one pageview will not have a session ID in session storage and will, therefore, not be linked by AppDynamics. In most cases, AppDynamics loads before DXA. Once DXA has loaded, it will put a session ID into session storage, which AppDynamics picks up on the second pageview.

Why don't I see any session IDs in AppDynamics?

• Ensure you have completed the implementation steps outlined above.
• Ensure both DXA and AppDynamics are deployed on your website.

Why is the session ID not hyperlinking?

• Ensure you have the DXA extension installed and that you are logged into DXA in another browser tab.
• Double check the property ID you added in Configure JavaScript Agent.