Endpoint Agents
The ThousandEyes Endpoint Agent is an application that is installed on Windows or macOS machines to collect network- and application-layer performance data when users access specific websites from within monitored networks.

Introduction to Endpoint Agents

Endpoint Agents allow customers to leverage regular end-user desktops and laptops as test devices for measuring internal and external application performance. As Endpoint Agents can be deployed on and off-premise to readily available machines in any location or network, performance measurements can be run from almost every possible user environment.
Deploying Endpoints gives you the ability to identify and diagnose end-user issues in near real-time. Unlike Enterprise Agents, Endpoint Agents run natively on Windows and Mac OSX operating systems and can be deployed on mass using standard automated deployment tools. Figure 1 below shows a typical example of deployment locations for Endpoint, Enterprise and Cloud Agents.
Figure 1. Example Endpoint, Enterprise and Cloud Agent deployment locations
Endpoint Agents include the following features that are responsible for measuring the application performance:
  • Scheduled Tests - Scheduled tests run from Endpoint Agents at regularly scheduled intervals. These tests run withour user interaction and can be deployed on Network (agent-to-server tests) and Web (HTTP server tests) layers.
  • Automated Session Tests - Automated Session Tests are similar to Scheduled Tests but, in addition they allow you to configure an Endpoint Agent to dynamically create tests to IP addresses and ports it detects, when an application opens a connection.
  • Browser Sessions - Endpoint Agents record in-browser and network performance metrics whenever users navigate to monitored domains from monitored networks.
  • Network Access - This feature records the performance of the Endpoint's physical wired or wireless connections, gateways, VPNs, proxies, and DNS servers.
You have full control of when and under what conditions the tests (scheduled and automated session) run or Browser Sessions are recorded. For example, a Scheduled Test deployed to a laptop can be switched on or off as it (the laptop) transits through different locations, wireless and wired networks, VPNs and proxies. Similarly, the Browser Session recordings will only occur when the Endpoint Agent is on a specified network and also limited by configured target domains.
All the collected data and metrics are displayed in one intuitive Endpoint Agent > Views page. The Views page separates Scheduled Tests, Automated Session Tests, Browser Sessions and Network Access data by layers and the interactive timeline presents performance data that can be used to rapidly search through historical data. An example of the Views page, the interactive timeline, layers, metrics and filters can be seen in Figure 2 below. With your Endpoint Agent data you can create proactive alerts, email regular feature-rich reports and create highly customizable dashboards. All Endpoint Agent data is available via our API.
Figure 2. An example of just one of the many ways interactive data is presented: Endpoint Agent > Views
There are two types of Endpoint Agents: Endpoint Agent and Endpoint Agent Pulse. The key difference between the two is that Endpoint Agent Pulse does not include the browser sessions feature. Throughout this article and the subsequent articles, all topics discussed apply to both products unless explicitly mentioned.
This article further explains: where and how to deploy Endpoint Agents, configuration options, how to run tests, end-user tools and experience, how to navigate your way through the UI and the layers of test views, how to create reports and dashboards, how to troubleshoot deployments and operations, managing licenses, user permissions and much more.

Deploying Endpoint Agents

Typically, organizations have multiple teams that manage their IT estate so to assist in the deployment and planning stages and to ensure the right teams are involved do check the pre-deployment requirements. It’s important the teams who manage functions such as software deployments, end-user access control, VPN-access, proxies and anti-virus systems are involved as early as possible, so the Endpoint deployment runs smoothly. Use the following links for detailed instructions on how to install Endpoint Agents.

Endpoint HTTP proxy support

We currently support the use of HTTP proxies for both types of Endpoint Agents. If you need HTTPS proxy support please contact our Customer Engineering Team. The network performance from an Endpoint Agent to a proxy will be automatically measured during Scheduled Tests or Browser Sessions recordings. The network performance tests consist of a hop-by-hop path trace and end-end latency, loss and jitter tests. Network tests are unable to reach the final target when a proxy is in use (Figure 3 below shows a proxy in use and the Network layer tests unable to reach the final target), therefore, all network tests are performed to the proxy instead. If you need network layer performance measurements beyond a proxy then please reach out to the Customer Engineering Team for assistance.

Browser Sessions proxy

The proxy used by Browser Sessions is not configurable but automatically detected from the host system. See Figures 3 and 4 below for examples of how we present proxy data.
Figure 3. Details view showing proxy measurements: Endpoint Agents > Views > Browser Sessions > Visited Pages > Session
Figure 4. Endpoint proxy displayed in Path Visualisation view: Endpoint Agents > Views > Browser Sessions > Network > Path Visualization

Scheduled Tests proxy

You can configure and store multiple proxy configurations and apply them to all tests or set a unique per test proxy. The proxy configuration supports static assignments, PAC files and Basic and NTLM proxy authentication methods. To apply a saved proxy configuration for all scheduled tests use the settings on the Endpoint Agent > Agent Settings page or for a per test proxy scenario apply a proxy configuration on the Endpoint Agent > Test Settings page. This was mentioned previously but as a reminder here it is again: we currently only support HTTP proxies and if you need to use Endpoint with an HTTPS proxy get in touch with our Customer Engineering Team for further assistance.
For detailed instructions on proxy configurations and options see the Proxy Configuration article. For more details on how to navigate through the Views page to see your proxy measurements head to the Test, Browser Sessions and Network Access Views and metrics section.

Endpoint Agent updates

We usually ship Endpoint Agent updates every 2 weeks for both the Windows and Mac OSX operating systems. The Endpoint applications have auto-update process that runs at regular intervals to check, download and install package updates. The Chrome browser extension automatically updates whenever a new Endpoint version is published in the Chrome Store. For full details on how the Endpoint Agent update process works see the How does the Endpoint Agent work article.

Endpoint Agent permissions

We have several Endpoint related permissions for user and user group management. For full details on how to create custom roles with Endpoint permissions see the Role-based Access Control article.

Endpoint Agent licensing

With the Endpoint Agent licensing model there is no distinction between the two agent types: A single Endpoint Agent license can be used to deploy an Endpoint Enterprise or an Endpoint Pulse Agent.
An Endpoint Agent license allows you to use all Endpoint Agent features such as scheduled tests and browser sessions. All trial accounts receive 25 licenses by default, whereas prepaid organizations must purchase licenses to access the Endpoint Agent.
Endpoint Agents consume licenses upon registration (first run after the installation) into the ThousandEyes platform. If you reach your license limit, all subsequent Endpoint Agents registered are shown as disabled on the Endpoint Agents > Agent Settings page. The following section explains how to transfer and reclaim licenses. If you need your license plan modified, contact your ThousandEyes Account Manager or the Customer Engineering Team for further assistance.

Viewing, transferring and re-claiming licenses

Endpoint Agent licenses are assigned to the organization and can be transferred between your organizations' account-groups. The total number of licenses available in your Plan, Currently Active licenses and licenses used in each Account Group is shown in the Plan Usage, Endpoint Agent Licenses section on the Account Settings > Usage and Billing page. See Figure 5 below for an example of the Endpoint Agent licensing data shown on the Account Settings > Usage and Billing page.
To free up a license you can disable an Endpoint Agent or delete it. The Currently Active licenses shown on page Account Settings > Usage and Billing is a tally of all licenses used within a billing cycle. If you disable or delete an Endpoint Agent within a billing cycle the reduction of the Currently Active licenses will not appear until the following billing cycle. Removing the Endpoint Agent software package from an end-user machine will not free up a license until it is deleted from the Endpoint Agents > Agent Settings page.
You can automatically manage and handle the statuses of the agents to make the optimum use of the available license.
Figure 5. Endpoint Agent licensing information on the Account Settings > Usage and Billing page.

Introduction to the Endpoint Agent Capabilities

Scheduled Tests

Endpoint Agent and Pulse both run web-layer HTTP-server and network-layer Agent-to-Server Scheduled Tests types, both test types are IPv4 and IPv6 compatible. Scheduled tests can run at set intervals from a minimum of 1 minute to a maximum of 1 hour. All scheduled tests perform network-layer end-end and path trace tests. If a proxy is being used the network layer tests will target the proxy and not the end target. Scheduled Tests can be configured to run several types of checks against your target e.g. verify SSL, page content or HTTP response codes.
Endpoint Agent in conjunction with its web-browser plugin can be configured to monitor end-users web Browser Sessions automatically or end-users can manually start recording their Browser Sessions using their browser extension. When recording Browser Sessions the agent will also perform network-layer end-end and path trace tests and collect Network Access data.

Endpoint Agent labels and test distribution and configuration

Both Endpoint Agent and Endpoint Pulse can be assigned a maximum of 10 Scheduled Tests, so your total test capacity increases with the number of Endpoints deployed. You have two options to distribute tests to your Endpoint Agents and both options begin with creating an Agent Label. An Agent Label is simply a named group of Endpoint Agents that all share a common property such as a gateway device, wireless SSID, proxy address, subnet, agent name or IP address. The Agent Label is assigned to a test and as Endpoints match or un-match the label’s criteria the test will be added or removed from Endpoint Agents. The more dynamic the agent property used for the Agent Label criteria the greater the test distribution activity. Some Endpoint properties are static, so it is possible to create Agent Labels with no dynamic test distribution activity. If Endpoints do not check-in for 1 hour, they are removed from the agent label pool. For full details on scheduled test configuration options and configuring labels see the Creating Scheduled Tests on Endpoint Agents article.

Browser Sessions and settings

Browser Sessions recordings can be started manually using the browser extension or configured to automatically collect data by specifying groups of Monitored Networks and Target Domains. There is no limit to the number of Browser Sessions you can record. For instructions on how to use the browser extension to manually record a Browser Session see the Endpoint Agent end-user experience article and for instructions on configuring automatic Browser Sessions monitoring see the Configuring automatic data collection article.

Network Access

The Network Access data can be used for troubleshooting errors seen in Browser Sessions recordings or it can be used to proactively track how your Endpoint Agents' local network services are performing. The Network Access layer has two parts, Network Topology and Wireless. Network Topology visualises the devices in use by Endpoint Agents for Browser Session recordings and Wireless displays a table of information about wireless data such as SSID, signal strength, channel and much more. Network Access data is continuously collected whilst an Endpoint Agent is online and on a configured monitored network (Browser Session Settings > Monitored Network). The devices in the Network Access topology include Endpoint Agents' gateway devices, DNS servers and proxy or VPN servers.

Automated Session Tests

Automated Session Tests collect data from applications that are developed on Unified communications as a service (UCaaS) platform; for example, Webex or Zoom. These tests are dynamic in nature, so they execute only when a user uses an application on their device (therefore, the system and network resources utilization is optimal). The data collected from these tests can be used for troubleshooting issues faced by the user while using the application. For instructions on how to configure and manage the Automated Session Tests see the Configuring Automated Session article.

Working with Endpoint Agent Views

The Endpoint Agent > Views page has four layers: Scheduled Tests, Automated Session Tests, Browser Sessions, and Network Access. Each layer contains a menu of sub-layers, a timeline, options to display data in tables and data filters. Depending on the Views layer you have selected you also get geographical maps, network topology diagrams, path visualizations and sliders that scroll into view when table data is selected. There is a lot of information being presented in a very organized and easy to follow format. From the current moment in time, the timeline holds up to 31 days of data. If you wish to keep your data for longer than 31 days then you can run a regular Reports or you have the option to create Snapshots. Snapshots let you share test data with anyone, regardless of whether they subscribe to the ThousandEyes platform or not.
The following sub-sections contain screenshots and article links, the articles explain how to navigate and leverage the features of the Views layers, for example they show you how to select tests, sift through the timeline, select metrics and what your metrics mean, apply filters (e.g. find data on an Endpoint Agent), find proxy performance data, check page load page waterfall data, use the path visualizations, check wireless strength and display session or Visited Page details.

Views, Scheduled Tests

  • Views - Scheduled Tests: HTTP Server and Network type tests, Path Visualizations, Maps and Tables
Figure 6. Scheduled test results view: Endpoint Agent > Views > Scheduled Tests > HTTP Server

Views, Browser Sessions

If a Visited Page and Session is selected a detailed slide-out window appears.
  • Views - Browser Sessions > Visited Pages: Web pages recorded manually with the browser extension or automatically via a Monitored Network and Domain groupset.
  • Views - Browser Sessions > Sessions: Web sessions recorded manually with the browser extension or automatically via a Monitored Network and Domain groupset.

Views, Network Access

Views, Automated Session Tests

Figure 9. Automated Session Test results view: Endpoint Agent > Views > Automated Session Tests > Network

Dashboards and Reports of Endpoint Data

Dashboards and Reports are simple to use and fully customizable to display your Endpoint Agent data in a style suited for your target audience. Reports can be run on-demand or scheduled to automatically generate reports at regular intervals. Check out these helpful articles on the topics below:

Alerting

For your Scheduled Tests, you can customize your Alert Rules. Simply put, alerting is configured out of the box to alert you when you need information about tests which are failing. If you need to get more granular or change some of the notification rules, check out the How Alerts Work article for more information on fine-tuning and managing alerts.

API

You can access the API to consume the results and data captured by an Endpoint Agent. To know more about the Endpoint API articles, follow this link.

Endpoint data collection and metrics

The Data collected by Endpoint Agent article describes what data is generated and collected when running your Endpoint Agent, Scheduled Tests, Browser Sessions and by the Network Access layer.

Reference articles

Copy link
On this page
Introduction to Endpoint Agents
Deploying Endpoint Agents
Endpoint HTTP proxy support
Browser Sessions proxy
Scheduled Tests proxy
Endpoint Agent updates
Endpoint Agent permissions
Endpoint Agent licensing
Viewing, transferring and re-claiming licenses
Introduction to the Endpoint Agent Capabilities
Scheduled Tests
Browser Sessions and settings
Network Access
Automated Session Tests
Working with Endpoint Agent Views
Dashboards and Reports of Endpoint Data
Alerting
API
Endpoint data collection and metrics
Reference articles