Onboarding ThousandEyes Agent and Onboarding Tests

Feature History for Simplified Onboarding of Cisco ThousandEyes Agent

This table describes the developments of this feature, by release.

Table 1. Feature History

Feature Name

Release Information

Feature Description

Simplified Workflow for Onboarding Cisco ThousandEyes Agent and Configuring Tests

Cisco IOS XE Catalyst SD-WAN Release 17.16.1a

Cisco 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.

Simplified workflow for onboarding Cisco ThousandEyes agents and configuring tests

The workflow simplifies the process of onboarding Cisco ThousandEyes agents and configuration of tests in 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 these steps:

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

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

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

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

Create an IP Pool for the Cisco ThousandEyes Agents

This section describes the procedure of onboarding Cisco ThousandEyes agent

Procedure


Step 1

From the menu, choose Configuration > Network Hierarchy.

Note

 

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

Step 2

Click Pools.

Step 3

Click Add Pool.

Step 4

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

Step 5

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

Step 6

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

Step 7

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

Step 8

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

Step 9

Click Add.


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.

Prerequisites for simplified workflow

You must complete the tasks in this section 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

Restrictions for simplified workflow

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

Editing limitations for deployed ThousandEyes Agent Sites

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

Workflow only supports devices with configuration groups

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

Workflow only supports one device in a site

The simplified workflow supports only devices associated 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 simplified workflow

This section describes the procedure of onboarding Cisco ThousandEyes agents and configuring monitoring tests directly from the SD-WAN Manager.

Before you begin

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

  • 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.

  • Create an IP pool in the global node of Network Hierarchy Manager, see Create an IP Pool for the Cisco ThousandEyes Agents.

Procedure


Step 1

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

Step 2

Start the Configure ThousandEyes workflow.

Step 3

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

Step 4

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

Step 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.

  • 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

You can monitor the status of Cisco ThousandEyes agents and configured tests in the SD-WAN Manager.

Before you begin

Ensure you are on release Cisco Catalyst SD-WAN Manager Release 20.16.1 and Cisco IOS XE Catalyst SD-WAN Release 17.16.1a.

Procedure


Step 1

To monitor the status of Cisco ThousandEyes agents and configured tests in the 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.

Step 2

In the monitoring dashboard, review these sections:

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

  • Agents: View 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 with the option to enable, disable, or delete a Cisco ThousandEyes agent.


Troubleshoot Cisco ThousandEyes agent on edge device

Before you begin

Ensure you are on release Cisco Catalyst SD-WAN Manager Release 20.16.1 and Cisco IOS XE Catalyst SD-WAN Release 17.16.1a.

Procedure


Step 1

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

Step 2

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