Manage Endpoint Agent Settings
Existing Endpoint Agents can be reviewed and managed from the Endpoint Agents > Agent Settings page of the ThousandEyes web application:
To add a new Endpoint Agent, see the Installation documentation.
The following information about each agent is provided in the main table:
Field Name
Description
Name
The name of the agent, followed by the username of the most recent user with Endpoint Agent to log into the system.
Agent Labels
A chevron will appear to the right of the agent name for each Agent Label currently assigned to the agent. Hover over the chevrons to display a tooltip with the names of the Agent Labels. If no Agent Labels are assigned, this space is blank.
Agent Version
The version of the Endpoint Agent software (not the same as the version of the Browser Extension). A yellow dot indicates a version that is not the current version. Hover over the dot to view the current version.
Browser extension
Indicates the state of browser extensions. Extension icons for Chrome, Internet Explorer, and Edge appear once the extension is installed. Icons display a green dot for an active extension and a yellow dot for inactive extension. Icons are grey if the extension has been uninstalled.
Current location
The location of the agent at the time of last contact, based on geolocation information such as client IP address.
Last Contact
Time elapsed since last contact with the ThousandEyes application.
Last Modified
The date when the agent's configuration or software was last modified.
To see detailed information about a single agent, click on the relevant entry in the table to open the Endpoint Agent Settings side panel.
The side panel contains the following information about the agent. Some details can be edited/configured, and are marked clearly below.
Configuration Option
Description
Agent Name
The agent's name (configurable via a text field).
Proxy
The proxy the agent uses for scheduled tests (configurable via a drop-down menu. See [proxies](https://docs.thousandeyes.com/product-documentation/global-vantage-points/endpoint-agents/configuring/endpoint-agent-proxy-configuration-for-scheduled-tests)).
Current Lables
The list of currently applied Endpoint Agent labels (see [labels](https://docs.thousandeyes.com/product-documentation/global-vantage-points/endpoint-agents/configuring/configure-endpoint-agent-labels) for configuration options).
Assigned Scheduled Tests
A 24 hour timeline of scheduled tests assigned/running on the agent.
Tests
A list of all tests running/assigned on the agent.
If any changes are made to the Endpoint Agent, click Save Changes, or Cancel to revert the changes.
To see more details about the agent and the system on which the agent is installed, click the Show Agent Details link in the top right corner of the panel.
This panel extension shows the following information:
Field Name
Description
Created
The date when the agent was created.
Hostname
The hostname of the system on which the agent is installed.
OS Version
The operating system and version on which the agent is installed.
Memory
The physical memory of the system on which the agent installed.
Manufacturer
The manufacturer of the system on which the agent installed.
Model
The model number of the system on which the agent installed.
Users
Usernames of users who have one or more browser extensions installed in their profile.

Disabling an Endpoint Agent

An Endpoint Agent can be can disabled from the ThousandEyes application's Endpoint Agent Settings page. To disable an Endpoint Agent, click the agent's row to display the details panel then click the Disable button in the lower left corner of the panel:
Disabling an agent will immediately display "Disabled" in the agent's Last Contact field on the Endpoint Agent Settings page:
While disabled, the Endpoint Agent collects no test data but does check in with ThousandEyes every 15 minutes for configuration changes and software updates.
The Endpoint Agent browser extension is updated separately from the Chrome Web Store (Chrome extension) or the Microsoft Add-ons Store (Internet Explorer or Edge extension).

Re-enabling a disabled Endpoint Agent

A disabled Endpoint Agent can be enabled from the ThousandEyes application's Endpoint Agent Settings page. To enable an Endpoint Agent, click the agent's row to display the details panel then click the Enable button in the lower left corner of the panel.
Re-enabling an agent will immediately update the agent's Last Contact field, but the agent will receive new configuration at the next check-in, which will occur within 15 minutes.

Systems with Disabled Agents

Disabling an Endpoint Agent from the ThousandEyes application also affects the browsers with the Endpoint Agent extension installed. Systems with agents disabled from the application display a greyed-out ThousandEyes icon in each browser with the Endpoint Agent extension installed. Hovering over the icon will display a tooltip with a message indicating that the agent is disabled:
The disabled icon is displayed upon first check-in after the Agent is disabled from the application.

Status of the Endpoint Agent Browser Extension

You can view the status of the Browser Extensions installed per agent in the Endpoint Agents > Agent Settings page of the ThousandEyes web application:
Hovering over the extension icon shows its status and version:
The browser icons can be two colors: green or amber:
  • The icon is green if the agent detects the extension as enabled (regardless of whether the extension is active or inactive).
    In some cases the agent cannot detect whether the extension is enabled. In such cases the icon is green only when the extension is active, which in turn means that the agent has seen data from that extension within the last 24 hours.
  • The amber color means that the extension is installed (and most likely enabled) but is inactive, which in turn means that the user has not navigated to a matching domain within browser session settings or used the browser recorder.
    In scenarios where the agent cannot find an extension installed on a browser; the icon of the corresponding browser is faded and is marked with amber color.

Auto - manage the status for Endpoint Agents

The Agent Status Settings located on the top right of the Agent Settings page, provides you with configuration options to automatically manage and handle the statuses of endpoint agents.
These options allow you to configure the number of days after which the agents can be disabled or deleted, thereby utilising the liceneses optimally. You can also configure the number of days in which an active but disabled agent can be re-enabled.
For example, you can auto-disable agents that were inactive for 10 days, as the end-users may be on vacation, and free up their corresponding licenses. Similarly, you can configure the number of days (say 20 days) in which the disabled agents get re-enabled, if they show some activity.
The Agent Status Settings provide the following three options:
  • Auto-disable - This setting allows you to configure the number of days after which an inactive agent can be disabled. If selected, this setting gets applied instantaneously to the exisitng agents and lists all the affected agents in the right-hand column.
Once applied, this setting will continue monitoring the existing agents periodically and disable the agents that meet the configured condition. You can find these impacted agents in the activity log.
  • Auto-delete - This setting allows you to configure the number of days after which a disabled agent can be deleted. If selected, this setting gets applied instantaneously to the existing agents and lists all the affected agents in the right-hand column.
Once applied, this setting will continue monitoring the existing agents periodically and delete the disabled agents that meet the configured condition. You can find these impacted agents in the activity log.
  • Auto-enable - This setting allows you to configure the number in which a disabled agent can be enabled if it shows some activity. If selected, this setting gets applied instantaneously to the existing agents and lists all the affected agents in the right-hand column.
Once applied, this setting will continue monitoring the existing agents periodically and enable the disabled agents that meet the configured condition. You can find these impacted agents in the activity log.
The number of days configured to auto-enable the disabled agents must be less than the number of days configured to auto-delete the disabled agents.

Transfer Ownership of an Endpoint Agent.

When you transfer ownership of an Endpoint Client Agent to another account group, the history of the device is retained in the original account group. Endpoint Client Agents should not be rapidly moved between multiple account groups.
To transfer owndership of an Endpoint Agent Client to another Account Group:
  1. 1.
    Navigate to the the Endpoint Agents > Agent Settings page of the ThousandEyes web application:
  1. 1.
    In the Endpoint Agents > Agent Settings page, identify the desired agent, either by scrolling down the list, searching for the agent with the search function, or using the available filters to focus the list of agents shown.
  2. 2.
    Click the three dots icon at the end of the agent row.
  3. 3.
    Click Transfer Ownership. The Transfer Agent Ownership pop-up will open.
  4. 4.
    Select the desired Account Group from the drop-down and click Transfer to confirm.
Copy link
Outline
Disabling an Endpoint Agent
Re-enabling a disabled Endpoint Agent
Systems with Disabled Agents
Status of the Endpoint Agent Browser Extension
Auto - manage the status for Endpoint Agents
Transfer Ownership of an Endpoint Agent.