ThousandEyes Network Metrics in Mobile RUM

When you integrate ThousandEyes with Mobile RUM, network metrics (packet loss, latency, and jitter) and network alerts are ingested from the following ThousandEyes tests into Splunk AppDynamics:

  • agent-to-server
  • HTTP server
  • page load
  • transaction

To ingest network metrics and network alerts from ThousandEyes, add the ThousandEyes API credentials in Splunk AppDynamics. You need:

  • SaaS Controller >= 23.11.0
  • A minimum of one mobile application to sync the data from ThousandEyes.
Note: You must have an active subscription for

ThousandEyes Network and Application Synthetics

in addition to your Splunk AppDynamics license to use Customer Digital Experience Monitoring. If you choose to use Customer Digital Experience Monitoring, your data may get transferred and processed in the United States. Please refer to your ThousandEyes ordering documentation and the ThousandEyes Privacy Data Sheet for more information.

Before You Begin

  • The ThousandEyes user whose credentials are used in Splunk AppDynamics for the integration must have ThousandEyes administrator privilege for ingesting the data into Splunk AppDynamics.
  • If you added the ThousandEyes bearer token in Splunk AppDynamics before May 2, 2023, then add and save the bearer token again.

  • If you are using Browser RUM already, you need not save the authorization token again for the Mobile RUM integration.

Obtain OAuth Bearer Token from ThousandEyes

You can obtain the token from ThousandEyes using the following steps:

  1. Click your username on the top-right corner, and then click Profile.
  2. Under User API Tokens, click Create to generate an OAuth Bearer Token. The user should have access to all the account groups in ThousandEyes to ingest the network metrics and network alerts from All accounts groups.
  3. Copy or make a note of the token.
    Note: From May 10, 2024, you can use the same ThousandEyes bearer token in multiple Splunk AppDynamics accounts. You can also use the existing ThousandEyes bearer tokens in new integrations.

Add ThousandEyes API Credentials in Splunk AppDynamics

  1. Click the gear icon at the top-right corner of the Home page and select Administration. Or, Navigate to User Experience > Mobile Apps > Connect to ThousandEyes, and click Integration: ThousandEyes. You need administration permission to access this page.
  2. Under Integrations > ThousandEyes, turn on the Enable ThousandEyes Integration option.You must agree to the terms and conditions and click Save to continue with the integration.
  3. Specify a bearer token under Authorization Token. See Obtain OAuth Bearer Token from ThousandEyes.
  4. Click Save.
    Note: If you are using Browser RUM already, then on the Mobile Apps list page, Sync with ThousandEyes button is displayed instead of Connect with ThousandEyes.
For creating ThousandEyes tests, see ThousandEyes Documentation.

View ThousandEyes Network Metrics

Add User Role Permissions

  1. Click the gear icon at the top-right corner of the Home page and select Administration.
  2. Under Roles, click Analytics > Events.
  3. Select Mobile Requests and Sessions from the dropdown.
  4. Select Can view browser requests data from all App Keys. Or, Click Add, and add the relevant App Key and Application to the role.
    Note:

    The following table describes the user permissions required to sync ThousandEyes tests and domains and view the network data:

    PermissionDescription
    Account Owner (Default)The administrator user with this permission can save ThousandEyes tokens.
    Analytics Administrator (Default) and Account Owner (Default)

    The Sync with ThousandEyes button will be enabled for the administrator.

    The administrator can complete the sync with the ThousandEyes workflow.

    Edit, View, and Analytics permissions to Browser ApplicationsNon-administrator users must have these permissions to complete the sync with ThousandEyes workflow.

Add the ThousandEyes Widget

To view ThousandEyes network metrics in the context of mobile application metrics, perform the following steps:

  1. On Splunk AppDynamics Controller, navigate to User Experience > Mobile Apps > Sync with ThousandEyes .
    Note:

    When you click Sync with ThousandEyes for the first time:

    • The fully qualified domains and target URLs of ThousandEyes tests are compared with the domains of each mobile application.
    • If the domains from ThousandEyes tests match with the domains in the mobile application, ThousandEyes network metrics and network alerts get ingested into the application.

    Only the new tests get synced when you click Sync with ThousandEyes subsequently.

    Note:
    • If you have more than 200 ThousandEyes tests, the syncing process takes longer and runs in the background. ThousandEyes data appears on the dashboard in 5-10 minutes.
    • Splunk AppDynamics supports syncing up to 10000 ThousandEyes tests.
  2. Select <application-name> . This displays the Mobile App Dashboard page.
  3. Under Overview, click +.
  4. Under Widgets, click ThousandEyes Network Insights.The ThousandEyes network metrics are displayed on the ThousandEyes widget in the mobile application dashboard.
    FieldDescription
    ThousandEyes Tests

    Click Show TE Tests to view the list of ThousandEyes tests from where the network metrics are ingested into Splunk AppDynamics.

    DomainsClick the domains dropdown to view the list of domains for which ThousandEyes network tests are configured.
    LocationsClick the locations dropdown to view the list of agent locations from where the domains are monitored.

Match ThousandEyes Tests Manually

If all the ThousandEyes tests are not synced, you can add specific ThousandEyes tests manually.

  1. Navigate to User Experience > Mobile Apps, and select <application-name> . This displays the Mobile App Dashboard page.
  2. Under Network Monitoring, click Manually Match ThoudsandEyes Tests.
  3. Select the tests that you want to add.
  4. Click Match and ingest data.

ThousandEyes Data Ingestion

When the Ingestion Limit is reached or the license expires, the ThousandEyes data ingestion into Splunk AppDynamics stops. Each unit of Real User Monitoring (SaaS) - Peak Edition or Mobile Real User Monitoring (SaaS) - Peak Edition can ingest up to 9 million network metrics.

For example, if you are provisioned with 10 unit licenses of Real User Monitoring (SaaS) - Peak Edition, the data ingestion limit is 90 million network metrics.

On the License > Account Usage page, you can view the ThousandEyes measurement count under ThousandEyes Network Monitoring.

Note: For the Controller 23.11 release, the License > Account Usage page displays only RUM Peak licenses.

Once you renew the license, the ThousandEyes data ingestion resumes automatically, and the ThousandEyes network metrics are visible on the widgets. For detailed information, see License Entitlements and Restrictions.

If you no longer want to ingest data for a ThousandEyes test of a particular domain, uncheck the domain. This stops the data ingestion from the ThousandEyes test for that domain:

  1. Navigate to User Experience > Mobile Apps, and select <appliaction-name> . This displays the Mobile App Dashboard page.
  2. Under Network Monitoring, click Manually Match ThoudsandEyes Tests.
  3. Deselect the ThousandEyes test for which you want to stop data ingestion, and click Match and ingest data.