Uninstall or Delete an Endpoint Agent
When an Endpoint Agent is installed on a device, the agent registers with the ThousandEyes platform and is then listed on the Endpoint Agents > Agent Settings page, under the relevant account group (the account group the Endpoint Agent installer was downloaded from).
This article covers the processes to either delete or uninstall the Endpoint Agent.
Data that has been uploaded to the ThousandEyes platform by the agent will remain in the platform, regardless of whether the agent that generated the data is deleted from the platform, the device the agent was installed on, or both.
Delete an Endpoint Agent from the Platform
When an agent is deleted from the platform, either manually or via Agent Status Settings, the agent remains on the host device, but it will only check in with the platform during startup and will stop submitting data thereafter.
To delete an Endpoint Agent:
In the ThousandEyes web application, navigate to Endpoint Agents > Agent Settings.
Expand the relevant agent tab.
Note: To retain the current agent, while deleting prior instances, use the Last Contact time from the Endpoint Agents table to
Click the elipsis icon.
Select Delete.
Click Delete to confirm.
Deleted Endpoint Agents are recoverable within seven days from the trashcan icon. The trashcan icon does not appear on the Agent Settings page if no Endpoint Agents are available to be recovered.
Uninstall the Endpoint Agent
If an agent is uninstalled from the host device, it continues to stay in the platform until it gets manually deleted, or automatically cleaned up via Agent Status Settings.
macOS
GUI
To uninstall the Endpoint Agent from a macOS device:
On the device, open the Applications folder.
Drag the ThousandEyes Endpoint Agent application to the trash, or right click on the application and select Move to Trash.
Remove the extension from Google Chrome:
a. In a Google Chrome browser, locate the Endpoint Agent button in the browser toolbar. b. Right click on the button and select Remove from Chrome….
You need to have administrative privileges to remove the extension from Chrome. If the enterprise is managing Chrome then you will see a message (greyed-out) saying that the extension is "Installed by your Administrator".
Remove the Endpoint Agent from the ThousandEyes web application:
a. Navigate to Settings -> Agents -> Endpoint Agents. b. Expand the relevant agent tab. c. Click the elipsis icon. d. Select Delete. e. Click Delete to confirm.
Once the Endpoint Agent has been removed, no more data will be collected.
Command Line
To uninstall the Endpoint Agent via the command line, use the following command:
rm -fr /Applications/ThousandEyes\ Endpoint\ Agent.app/
Windows
GUI
To uninstall the Endpoint Agent from a Windows device:
Close any open Google Chrome, Internet Explorer, or Microsoft Edge browser windows.
Open Add/Remove Programs.
Find the ThousandEyes Agent entry on the list and click Uninstall.
Acknowledge that you are uninstalling the Endpoint Agent.
If you have Google Chrome installed, and the extension is enabled there, you will be prompted to confirm removal of the extension from Google Chrome. Acknowledge this prompt. A reboot may be required.
Remove the Endpoint Agent from the ThousandEyes web application:
a. In the ThousandEyes web application, navigate to Endpoint Agents > Agent Settings. b. Expand the relevant agent tab. c. Click the elipsis icon. d. Select Delete. e. Click Delete to confirm.
Once the Endpoint Agent has been removed, no more data will be collected.
Command Line
To uninstall the Endpoint Agent via the command line, you need to know the Product Code (GUID) of the currently installed agent to execute an uninstall. The Product Code gets changed with every release.
You can check if Endpoint Agent is installed on the machine (and its version) by checking the following standard registry keys: "HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\ThousandEyes\Endpoint Agent" (on Windows 64-bit) or "HKEY_LOCAL_MACHINE\SOFTWARE\ThousandEyes\Endpoint Agent" (on Windows 32-bit).
To get the Product Code (GUID), run the following command in powershell:
PS C:\> Get-WMIObject -Query "SELECT * FROM Win32_Product WHERE Name='ThousandEyes Endpoint Agent'" |Format-List IdentifyingNumber,Name,Version,Vendor
After obtaining the GUID (which is the Identifying Number) from the above script, run the following command to uninstall the agent:
msiexec.exe /x {GUID} /norestart /quiet
Last updated