Cisco Enterprise Agent: Comprehensive Network Monitoring and Analysis Tool (EN)

Prerequisites for the ThousandEyes Enterprise Agent

ThousandEyes Enterprise Agent ThousandEyes Enterprise Agent is an enterprise network-monitoring tool that provides you an end-to-end view across networks and services that impact your business. This module describes how to download and install the Enterprise Agent.

Prerequisites for the ThousandEyes Enterprise Agent, on page 1 Information About ThousandEyes Enterprise Agent, on page 2 How to Install the ThousandEyes Enterprise Agent, on page 5 Configuration Examples for ThousandEyes Enterprise Agent, on page 10 Additional References, on page 14 Feature Information for ThousandEyes Enterprise Agent, on page 14 Prerequisites for the ThousandEyes Enterprise Agent • The ThousandEyes Enterprise Agent image available at the ThousandEyes site must be signed by the same certificate authority (CA) that is used by www.cisco.com for HTTPS downloads; without an username or a password.

• Installation of the Enterprise Agent requires Internet connectivity, or a proxy server. For more information, see the ThousandEyes documentation at: https://docs.thousandeyes.com/product-documentation/ enterprise-agents . • The Enterprise Agent application can only be used after the user’s license privileges are validated. • Only Docker-based applications are supported. • 1:1 stack mode is a must for ThousandEyes Stateful Switchover (SSO) support. 1:1 mode is when the active and standby roles are assigned to specific devices in a stack. This overrides the traditional N+1 role selection algorithm, where any device in the stack can be the active or the standby.

ThousandEyes Enterprise Agent 1

Стр. 1

Resources Required for the ThousandEyes Enterprise Agent

Information About ThousandEyes Enterprise Agent ThousandEyes Enterprise Agent Overview ThousandEyes Enterprise Agent is an enterprise network-monitoring tool that provides you an end-to-end view across networks and services that impact your business. It monitors the network traffic paths across internal, external, carrier, and Internet networks in real time, to provide network performance data. Enterprise Agents are commonly installed in branch sites and data centers to provide a detailed understanding of WAN and Internet connectivity. In previous Cisco IOS XE releases, ThousandEyes was supported as a third-party Kernel-based Virtual Machine (KVM) appliance on the SSD.

In Cisco IOS XE Amsterdam 17.3.3, a new version of the ThousandEyes Enterprise Agent, Version 3.0 is introduced. This is an embedded Docker-based application that runs on Cisco devices using the application-hosting capability. The Enterprise Agent is available on both the SSD and bootflash, and it supports all tests except browser tests (page load and transaction). The browser tests are available in Cisco IOS XE Bengaluru 17.6.1 and later releases with Enterprise Agent Version 4.0. The ThousandEyes Enterprise Agent provides the following: • Benchmarking the performance of networks and applications. • Detailed hop-by-hop metrics.

• End-to-end path visualization from branch or campus to data center or cloud. • Outage detection and resolution. • User-experience analysis. • Visualization of the traffic-flow pattern. ThousandEyes Enterprise Agent Version 4.0 available in Cisco IOS XE Bengaluru 17.6.1, supports the following additional features that are not available in the ThousandEyes Agent Version 3.0: • BrowserBot support when back-panel SSD is available. • DNAC app icon and description. • Docker health monitoring. • The app-hosting upgrade URL command to upgrade the ThousandEyes Enterprise Agent.

Resources Required for the ThousandEyes Enterprise Agent This table describes the required resources for installing the ThousandEyes Enterprise Agent: ThousandEyes Enterprise Agent Information About ThousandEyes Enterprise Agent ThousandEyes Enterprise Agent 2

Стр. 2

ThousandEyes Enterprise Agent Download

Table 1: Resources Required for the ThousandEyes Enterprise Agent In Cisco IOS XE Bengaluru 17.6.1, add-on mode is supported on Cisco Catalyst 9300, 9300L, and 9300X Series Switches, and Cisco Catalyst 9400 Series Switches. ThousandEyes Enterprise Agent Download BrownField and GreenField are two types of ThousandEyes Enterprise Agents. For existing devices, you can download the Brownfield version from the ThousandEyes website. However, new devices are shipped with the Greenfield application loaded in the bootflash. This table lists the download options available for the agents.

ThousandEyes Enterprise Agent ThousandEyes Enterprise Agent Download App Media Maximum Resource Supported Release SSD Note Only 120G SSD is supported. • CPU: 2 vCPU • Memory: 2G RAM • Storage: No limit on SSD Cisco IOS XE Amsterdam 17.3.3 • Cisco Catalyst 9300 and 9300L Series Switches Cisco IOS XE Bengaluru 17.5.1 • Cisco Catalyst 9400 Series Switches Cisco IOS XE Bengaluru 17.6.1 • Cisco Catalyst 9300X Series Switches Flash • CPU: 2 vCPU • Memory: 2G RAM • Storage: 1G for persistent logging by applications, out of the 4G partition in the flash file system. The storage is shared with the IOx metadata.

Cisco IOS XE Amsterdam 17.3.3 • Cisco Catalyst 9300 and 9300L Series Switches Cisco IOS XE Bengaluru 17.5.1 • Cisco Catalyst 9400 Series Switches Cisco IOS XE Bengaluru 17.6.1 • Cisco Catalyst 9300X Series Switches ThousandEyes Enterprise Agent 3

Стр. 3

ThousandEyes BrowserBot

Table 2: ThousandEyes Enterprise Agent Download Options This section describes the maximum resources required for the agent to run: • CPU: 2 vCPUs • Memory: 2G • Storage: 1G for persistent logging by applications, out of the 4G partition in the flash file system. This storage is shared by the IOx metadata. • Media storage: • 120G SSD for Cisco Catalyst 9300 and Cat9300 L Series Switches in Cisco IOS XE Amsterdam 17.3.3. • 240/480/960GB M2-SATA-HDD for Cisco Catalyst 9400 Series Switches in Cisco IOS XE Bengaluru 17.5.1.

After the download of the Enterprise Agent, it initiates a call to create a secure channel to the ThousandEyes cloud-based portal that provides the required application configuration, and gathers application data. The link to the TE portal is https://app.thousandeyes.com . ThousandEyes BrowserBot ThousandEyes Enterprise Agent Version 4.0 provides a BrowserBot for transaction scripting test. The BrowserBot is a component of the Enterprise Agent that manages page load and transaction tests. The BrowserBot allows you to enable customized JavaScript tests which mimic the actions of your web browser on the ThousandEyes Cloud Portal.

To protect the host operating system from any errant JavaScript operations, the ThousandEyes agent creates sandbox containers to run your JavaScript. If an unrestricted disk is used by the application, the ThousandEyes agent will dynamically install the BrowserBot package during initialization that permits portal transaction scripting tests to be configured. The BrowserBot support is not available in ThousandEyes Agent Version 3.0. Note BrowserBot consumes a large amount of hardware resources. 2GB system memory and 2 VCPU loads are the maximum IOx system memory and CPU load allocated for all IOx apps.

To allow multiple apps to concurrently run in the bootflash, lower the default package.yaml BrowserBot resources before activating the agent. Use the app-resource profile custom command to override the default package.yaml settings: ThousandEyes Enterprise Agent ThousandEyes BrowserBot BrownField GreenField • Download the file from the Installing Enterprise Agents on Cisco Switches with Docker page. The file is signed by the same certificate authority (CA) that is used by www.cisco.com for HTTPS downloads; without an username or a password. • Use the install command to download and deploy the application. • Available in the bootflash under the /apps folder. Shipped with the device.

• Use the install command to download and deploy the application. ThousandEyes Enterprise Agent 4

Стр. 4