Archived - Configuring Endpoint Agent Setup

The ThousandEyes Endpoint Agent is an application that is installed on Windows or Mac OS X machines to collect network and application performance data when users access specific websites from within monitored networks. The Endpoint Agent installer contains a built-in ThousandEyes account key, allowing performance data collected by the Endpoint Agent to be routed to the correct Account Group in ThousandEyes. This document outlines the basic setup process for an Endpoint Agent.

Adding an Endpoint Agent

To add an Endpoint Agent, navigate to Endpoint Agents > Agent Settings and click Add New Endpoint Agent. To download the Endpoint Agent Installer, your account must have a role with the Download Endpoint Agents permission (such as the built-in Account Admin or Organization Admin roles). Download the appropriate installer file based on your operating system architecture. The Allow anyone with the link to download option reveals links to each installer file.

For installation instructions, see Endpoint Agent Installation.

Once the installation completes, the new Endpoint Agent will be listed under Endpoint Agents > Agent Settings.

Collecting Data Using an Endpoint Agent

After installing the Endpoint Agent on a supported system, configuring the Endpoint Agent setup has two steps:

  1. Configure monitored networks: Enable automatic data collection when Endpoint Agents reside inside defined networks.

  2. Configure monitored domains: Collect data automatically when browsing websites within defined domains.

Adding a Monitored Network

  1. In Endpoint Agents > Browser Session Settings, on the Monitored Networks tab, click Add New Network.

  2. Enter a network in CIDR format (e.g. or an IP address range (e.g. If you enter an IP address, the longest matching address block will be looked up. Below the field, a network block containing your current public IP address will be shown.

    RFC 1918 networks (,, cannot be added. Use the network providing the public IP address for the client when it makes connections to the Internet.

    IPv6 addresses cannot be used at this time.

  3. Choose the name for your new network entry.

  4. Select a Monitored Domain Set that should be applied to your new monitored network.

  5. To complete the process, click the Add button.

Repeat the process above to define multiple monitored networks. Configured networks and their corresponding monitored domain sets will be listed under Monitored Networks tab:

Optionally, to configure data collection regardless of agent's current public IP address, click Add New Network and enter the IP address range This will add a built-in Network entry All other networks. To delete a monitored network, click the corresponding Trash icon on the right-hand side of the network list.

Defining a Monitored Domain Set

  1. In Endpoint Agents > Browser Session Settings, on the Monitored Domains tab, click Add New Monitored Domain Set.

  2. Name your new monitored domain set.

  3. Add one or more domain names into the Monitored Domains field. Don't wildcard your entries - enter the domain suffix only (ie. "", rather than "*").

  4. If desired, uncheck the Periodically collect network topology data to disable local network measurements.

  5. Click Add button to conclude the creation process.

    No data collection occurs against non-monitored domains.

Managing Endpoint Agents

Once you've started collecting data, you can control which machines collect data and send it to ThousandEyes for analysis. Go to Endpoint Agents > Agent Settings Endpoint Agents. This screen allows you to search for existing agents, using either agent name (which defaults to [user name] - [host name]), or by hostname directly.

Disabling an Endpoint Agent

An Endpoint Agent can be either enabled or disabled. When enabled and when inside a monitored network, the Endpoint Agent collects performance information for monitored domains. When disabled, the Endpoint Agent still checks in with ThousandEyes every 15 minutes for configuration changes and Endpoint Agent updates. No other information is collected while an Endpoint Agent is disabled. A newly enabled agent's state is reflected in the list immediately, but the agent will receive the updated configuration within 15 minutes (the next time it checks in).

To disable an Endpoint Agent, find the agent in the list, expand it and click the Disable button (on the lower left of the expanded Endpoint Agent details panel):

Once disabled, the agent's list entry will show the word "Disabled" in the Last Contact column and the aforementioned Disable button will become an Enable button. This change takes effect immediately.

Deleting an Endpoint Agent

To delete an Endpoint Agent, navigate to Endpoint Agents > Agent Settings.

  1. Click Delete. If the Delete option is not available, then your ThousandEyes user account may not have permission to delete Endpoint Agents.

  2. Once deleted an Endpoint Agent can be recovered upto 7 days.

Deleting an Endpoint Agent will prevent it from checking in and committing data to our backend services. Normally, administrators should delete Endpoint Agents only to block machines that should not be connecting and sending data to your ThousandEyes account.

Reinstalling an Endpoint Agent

If an Endpoint Agent requires reinstallation to address an issue, simply rerun the Endpoint Agent installer, without deleting the existing installation. The most common scenario requiring reinstallation occurs when the Endpoint Agent cannot auto-update itself. Rerunning the installation using the latest installer will update the Endpoint Agent without generating a new agent instance. Such an upgrade will not affect the data continuity.

However, if you do uninstall an Endpoint Agent and then reinstall it again (or select the Repair option when running the installer again), the Endpoint Agent will register with the ThousandEyes platform using a new unique Agent ID. Data collected from the new Endpoint Agent instance will not be continuous with the data collected from the older Endpoint Agent instance. Also, Endpoint Agents > Agent Settings > Endpoint Agents will display two Endpoint Agent entries with the same name.

Last updated