Uninstall or Delete an Endpoint Agent

Due to recent platform-wide naming, navigation, and URL changes in the ThousandEyes product, you may notice some discrepancies between the product and the screenshots displayed in our technical documentation. The instructions and actual pages in the product are still valid and haven’t changed. Please bear with us as we update our screenshots to better match the in-product experience. See the full scope of changes on Naming and Navigation Menu changes - Summary List.

When an Endpoint Agent is installed on a device, the agent registers with the ThousandEyes platform and is then listed on the Endpoint Experience > 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:

1. In the ThousandEyes web application, navigate to Endpoint Experience > Agent Settings.

2. 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

3. Click the elipsis icon.

4. Select Delete.

5. 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:

1. On the device, open the Applications folder.

2. Drag the ThousandEyes Endpoint Agent application to the trash, or right click on the application and select Move to Trash.

3. 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".

1. Remove the Endpoint Agent from the ThousandEyes web application:

   a. Navigate to Endpoint Experience > 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, use the following command:

rm -fr /Applications/ThousandEyes\ Endpoint\ Agent.app/

Windows

GUI

To uninstall the Endpoint Agent from a Windows device:

1. Close any open Google Chrome, Internet Explorer, or Microsoft Edge browser windows.

2. Open Add/Remove Programs.

3. Find the ThousandEyes Agent entry on the list and click Uninstall.

4. 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.

1. Remove the Endpoint Agent from the ThousandEyes web application:

   a. In the ThousandEyes web application, navigate to Endpoint Experience > 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