Simplified Workflow for Onboarding Cisco ThousandEyes Agent and Configuring Tests

Simplified Workflow for Onboarding Cisco ThousandEyes Agent and Configuring Tests

Table 1. Feature History

Feature Name

Release Information

Description

Simplified Workflow for Onboarding Cisco ThousandEyes Agent and Configuring Tests

Cisco IOS XE Catalyst SD-WAN Release 17.16.1aCisco Catalyst SD-WAN Manager Release 20.16.1

A simplified workflow to easily onboard Cisco ThousandEyes agent and configure tests using Cisco SD-WAN Manager.

Information About Simplified Workflow for Onboarding Cisco ThousandEyes Agent and Configuring Tests

Minimum supported release: Cisco IOS XE Catalyst SD-WAN Release 17.16.1a and Cisco Catalyst SD-WAN Manager Release 20.16.1

The workflow simplifies the process of onboarding Cisco ThousandEyes agents and configuration of tests in Cisco SD-WAN Manager. Using the simplified workflow, you can easily onboard Cisco ThousandEyes agents and configure application monitoring tests directly from Cisco SD-WAN Manager in a few steps. The streamlined workflow involves the following steps:

  • Establish a connection to the Cisco ThousandEyes platform through Cisco SD-WAN Manager.

  • Configure tests in Cisco ThousandEyes directly from Cisco SD-WAN Manager.

  • Choose applications, sites, and devices for testing and configure the necessary parameters in Cisco SD-WAN Manager.

  • Monitor the agents and tests from the ThousandEyes Monitoring dashboard in Cisco SD-WAN Manager.

Prerequisites for Simplified Workflow to Onboard Cisco ThousandEyes Agent and Configure Tests using Cisco Catalyst SD-WAN Manager

Minimum supported release: Cisco IOS XE Catalyst SD-WAN Release 17.16.1a and Cisco Catalyst SD-WAN Manager Release 20.16.1

  • Ensure the following before initiating the simplified workflow:

    • You have a Cisco ThousandEyes account before using the simplified workflow to configure a Cisco ThousandEyes agent in Cisco SD-WAN Manager.

      • You must be a user with the Organization Admin role to access the Cisco ThousandEyes account.

    • An appropriate NAT configuration exists to enable the Cisco ThousandEyes Enterprise agent to discover and connect to the Cisco ThousandEyes application. For more information, see NAT Direct Internet Access

    • Create an IP pool in the global node of Network Hierarchy Manager.

  • Complete the following tasks before initiating the simplified workflow.

    Table 2. Tasks Before Running the Simplified Workflow

    Configuration Task

    Information

    Deploy Cisco IOS XE Catalyst SD-WAN devices using the configuration group.

    See Deploy Devices Using the Deploy Configuration Group Workflow

    Upload Cisco ThousandEyes Enterprise agent software.

    Create an IP pool in the global node of Network Hierarchy Manager. When deploying Cisco ThousandEyes agent through the workflow, the Virtual Port Group Interface IP address contains this IP pool.

    See Create an IP Pool for the ThousandEyes Agents

    Add IPv4 DNS server details in the Transport VPN feature of the Configuration Group associated with the device.

    See DNS

Create an IP Pool for the Cisco ThousandEyes Agents

Minimum supported release: Cisco Catalyst SD-WAN Manager Release 20.16.1 and Cisco IOS XE Catalyst SD-WAN Release 17.16.1a

  1. From the menu, choose Configuration > Network Hierarchy.


    Note


    The page displays the site pool and region pool for the Global node.


  2. Click Pools.

  3. Click Add Pool.

  4. In the Pool Name field, enter a name for the pool.

  5. In the Pool Description field, enter a description of the pool.

  6. From the Pool Type drop-down list, choose ThousandEyes.

  7. In the IP Subnet* field, enter an IP address.

  8. In the Prefix Length* field, enter the prefix length of the system IP pool.

  9. Click Add.

Restrictions for Simplified Workflow to Onboard Cisco ThousandEyes Agent and Configure Tests Using Cisco Catalyst SD-WAN Manager

Minimum supported releases: Cisco Catalyst SD-WAN Manager Release 20.16.1 and Cisco IOS XE Catalyst SD-WAN Release 17.16.1a

  • The workflow does not support editing tests or updating agent parameters for sites with deployed Cisco ThousandEyes agents.

  • The simplified workflow supports only devices that are deployed with configuration groups.

  • In the workflow, you can select only one device in a site to deploy the Cisco ThousandEyes Agent and configure tests associated with it. To deploy Cisco ThousandEyes Agent on multiple devices in a site, use the Configuration Group method, see Using Configuration Groups.

Configure Cisco ThousandEyes Agent and Tests Using Workflows

Minimum supported release: Cisco Catalyst SD-WAN Manager Release 20.16.1 and Cisco IOS XE Catalyst SD-WAN Release 17.16.1a

  1. From the Cisco SD-WAN Manager menu, choose Workflows > Workflow Library.

  2. Start the Configure ThousandEyes workflow.

  3. Read the terms and conditions. After accepting the terms and conditions, click Connect ThousandEyes to start the workflow.

  4. When the Cisco ThousandEyes portal opens, log in to your account using your login credentials. The page redirects to Cisco SD-WAN Manager.

  5. Follow the instructions provided in the workflow.


    Note


    In the workflow, select all sites associated with a specific Configuration Group simultaneously. This ensures that the Configuration Group with Cisco ThousandEyes agent applies to all sites associated with the Configuration Group.



Note


The time required to onboard Cisco ThousandEyes agent and configure tests varies based on the size of your network.


What to do next:

  • Monitor the status of agents and enable or disable agents in the ThousandEyes Monitoring dashboard in the Cisco SD-WAN Manager.

  • Launch ThousandEyes Monitoring dashboard to view test results.

Monitor Onboarded Cisco ThousandEyes Agents and Configured Tests

Minimum supported release: Cisco Catalyst SD-WAN Manager Release 20.16.1 and Cisco IOS XE Catalyst SD-WAN Release 17.16.1a

To monitor the status of Cisco ThousandEyes agents and configured tests in the Cisco SD-WAN Manager monitoring dashboard, navigate to Tools > ThousandEyes Monitoring.

You can view the online, offline, and disabled agents, and launch Cisco ThousandEyes from the dashboard.

The monitoring dashboard includes two sections:

  • Tests: Provides information about the tests configured using the simplified workflow.

  • Agents: Provides information about the status of Cisco ThousandEyes agents configured using the simplified workflow. It also provides a list of configured devices and sites for the test, allowing you to enable, disable, or delete a Cisco ThousandEyes agent.

Troubleshoot Cisco ThousandEyes Enterprise Agent on Cisco IOS XE Catalyst SD-WAN Device

Minimum supported release: Cisco IOS XE Catalyst SD-WAN Release 17.16.1a and Cisco Catalyst SD-WAN Manager Release 20.16.1

  1. Review the following log files in Cisco SD-WAN Manager for error messages or relevant information: /var/log/nms/vmanage-server.log and /var/log/nms/vmanage-server-deviceconfig-template.log.

  2. Examine the audit logs to determine if the ThousandEyes test was posted or it failed.