Cannot uninstall telegraf agent from Windows client machine after Cloud Proxy decommission

Products

• VMware Aria Suite

Issue/Introduction

Unable to uninstall Telegraf agents both from UI and CLI.

Environment

VMware Aria Operations 8.x

Cause

• When a telegraf agent is configured, it gets associated with the cloud proxy. 
• When the original cloud proxy is decommissioned and replaced by a new cloud proxy, the association is not updated between agent VM and cloud proxy.

Resolution

Steps to Remove Old vCenter Mapping and Uninstall Telegraf Agent

1. Connect to Suite API

   • Access the Suite API using the following URL:
     https://<vrops-fqdn>/suite-api/doc/swagger-ui.html

2. Retrieve Existing vCenter Mapping

   • Use the API call:
     POST /api/applications/vccpmappings/query
   • Provide the following empty payload in the request body to retrieve the list of existing vCCP mappings:

{
  "collectorUUIDs": [],
  "collectorGroupIds": [],
  "vCenterIds": []
}

    3. Verify Cloud Proxies

• • Review the output of the above API call. Ensure that the cloud proxies listed are the old, decommissioned proxies.

    4. Delete vCenter Mapping

• • Use the API call:
    DELETE /api/applications/vccpmappings
  • Provide the following payload in the request body to delete the specific vCenter mapping:

{

  "uuids" : [ "<vCenter-UUID>" ]

}

1. • Replace <vCenter-UUID> with the UUID of the vCenter mapping you want to delete.

2. Uninstall the Telegraf Agent

   • From the vROPS UI, attempt to uninstall the Telegraf agent on the client machine.

 

 

Additional Information

If the Telegraf agent continues to fail during the uninstallation process, a manual cleanup of the Telgraf agent service on Windows machines may be required.

The manual cleanup process is as follows:

 

• Understand the Installed Services

  The Telegraf agent is installed as a service on Windows machines. To uninstall the Telegraf agent, it is necessary to remove the following three services:

  • Application Remote Collector Minion
  • Application Remote Collector Salt Minion
  • Application Remote Collector Telegraf

• Stop and Delete the Services

  Use the following commands to stop and delete these services:

  • sc stop <Service-name>
  • sc delete <service-name>

Replace <Service-Name> with the actual name of each service listed above.