Integrate APM with Aternity User Journey Intelligence

This article explains how to integrate Aternity APM with Aternity UJI (User Journey Intelligence powered by Blue Triangle) and how to switch between them.

Aternity UJI complements Aternity's APM no-sampling backend view with the web Real User Monitoring (RUM) and synthetic tests capabilities.

Note

To use Aternity User Journey Intelligence you need to purchase the license. Please contact your account manager for more information.

Switch to Aternity UJI for complete view of the business impact of performance. You will be able to use aggregate performance waterfalls, web page filmstrips, and screenshots from synthetic tests to help you fine-tune the loading order of all your first and third-party content before you deploy changes.
Troubleshoot a slow backend time by drilling down to Aternity APM

You can switch to Aternity UJI from APM Transaction Details page using either the site ID, to do an aggregate site performance analysis, or the transaction ID, to search for every page view for a particular user session.

Before you begin

You can only follow the transaction from the backend to the frontend (browser perspective) if you have all the following in place:
  • You must be able to sign in to both Aternity APM and Aternity UJI.

  • The application must have Aternity UJI’s page tag (snippet) on the desired pages.

  • Aternity APM does not communicate directly with Aternity UJI, but rather offers a URL to view the transaction there. Therefore, you do not need a direct port open between Aternity APM and Aternity UJI.

  • On the Aternity UJI side, make sure that the application has Aternity UJI’s page tag (snippet) on the desired pages.

    • Access to the site configuration page and write down somewhere for further use:

      • Site ID (this will be used on the Aternity APM side)

      • custom variable carrying tracing.id (this will be used on the Aternity APM side, User Journey Intelligence Configuration Page)

      • custom variable carrying the page.id (this will be used on the Aternity APM side, User Journey Intelligence Configuration Page)

  • On the Aternity APM side, make sure that the application has Aternity APM’s JavaScript Snippet on the desired pages and the JavaScript Instrumentation (JSI) configuration includes the ujisid (Aternity UJI site ID).
    Tip

    JavaScript Snippet is a snippet in Aternity APM that users insert into your web application. The snippet collects data from the web page and sends it over to the APM Analysis Server.

Procedure

  1. Step 1 Open a browser and sign in to the Aternity UJI, access the site configuration page and take the note of:
    • Site ID

    • custom variable carrying tracing.id

    • custom variable carrying the page.id

      Note

      if you have not defined custom variables to keep track of tracing.id and pageload.id, contact Riverbed Support Team.

  2. Step 2 Open a browser and sign in to the Aternity APM.
  3. Step 3 In the Define a Configuration page, Data Collection Settings section, edit the JavaScript snippet for the configuration of the corresponding application and add the ujisid with the side ID.
    Define a configuration
  4. Step 4 In the User Journey Intelligence Configuration page, select the custom variables corresponding to the tracing.id and pageload.id.
    Define custom variables
  5. Step 5 Drill down to Aternity UJI for complete view of waterfall view and the business impact analysis.
    1. a Identify a transaction with the corresponding site ID, pageload.id, and tracing.id.
    2. b Select View to drill down and view the aggregate performance metrics on User Journey Intelligence Performance Details page.
    3. c Select Search to drill down and view every page for the user of the transaction on User Journey Intelligence Session Lookup page.
      Field Description

      You can switch to Aternity UJI from the Aternity APM

      In the Overview for the specific transaction, users are able to get redirected to Aternity UJI from the Details screen by clicking on the (View) or (Search) next to the Site ID, pageload.id, and tracing.id.
      Note

      This will only show up if a UJI Site ID exists in the transaction. The links for (Search) will only show up if there is a pageload.id or tracing.id and the configuration on the User Journey Intelligence page is set up properly.

      Drill down to Aternity UJI
      You can always switch back from Aternity UJI to Aternity APM.
      Field Description

      You can drill down to Aternity APM for further analysis right from inside Aternity User Journey Intelligence application (powered by Blue Triangle).

      There are several ways to switch to Aternity APM:
      • In the Real User Monitoring (RUM) Performance Detail for the specific site, select Search Transactions at the bottom of the Performance Measurement Details screen to drill down to Aternity APM.
        Drill down to Aternity APM to trace transactions
      • In the Real User Monitoring Performance Overview, you can find Aternity links at the bottom of the screen:
        Drill down to Aternity APM