Reset the "Uninstall Failed" status in the Manage Telegraf Agents page when manually removing telegraf agents
search cancel

Reset the "Uninstall Failed" status in the Manage Telegraf Agents page when manually removing telegraf agents

book

Article ID: 413844

calendar_today

Updated On:

Products

VCF Operations/Automation (formerly VMware Aria Suite)

Issue/Introduction

  • Removing the Product Managed Telegraf agents via the Operations > Applications > Manage Telegraf Agents page or via script results in Uninstall Failed.
  • Reviewing the failure reason shows  "Failed to update VM bootstrap property. Error code: 400".
  • Needing exact internal API URL to execute to set any Resources' Bootstrap Status to "bootstrapStatus":  "NOT_INSTALLED_AND_AGENT_UNINSTALL_SUCCESS"
  • Log entries like below are seen in telegraf-utils log
10/7/2025 3:56:10 PM    ERROR    Failed to update VM bootstrap status. Error code: 400
10/7/2025 3:56:10 PM    ERROR    StatusDescription:
10/7/2025 3:56:10 PM    INFO    Updating the bootstrap status using url : https://##.##.##.##/suite-api/internal/resources/bootstrapStatus and request body : {
    "resourcesBootstrapStatuses":  [
                                       {
                                           "resourceId":  "",
                                           "bootstrapStatus":  "NOT_INSTALLED_AND_AGENT_UNINSTALL_SUCCESS"
                                       }
                                   ]
}

Environment

VMware Aria Operations 8.18.x

Cause

The referenced resourceId used when removing the agent is blank.

Resolution

Use the Aria Operations Internal API to reset the bootstrapStatus for the VM

  1. Log in to Aria Operations and navigate to Operations > Configurations > Inventory Management
  2. Filter for the VM object that has the Uninstall Failed status in the Manage Telegraf Agents page
  3. Right click the ID column and select Copy Cell

    Note: If the ID column is not visible, use the Show Columns button in the status bar at the bottom of the screen to enable it.
  4. Navigate to Home >  Launchpad > Developer Center and click API Documentation
  5. In the SwaggerUI header bar, use the Select a definition dropdown to select Internal APIs
  6. Click the green Authorize button

    Note: If you are presented with an Available authorizations dialog, click Logout to remove the expired previous authorization.
  7. Provide the Username and Password of a user with administrative API privileges and click Authorize and then click Close
  8. Type bootstrapStatus in the Search... field
  9. Click on Internal Resources to expand
  10. Click on PUT ​/internal​/resources​/bootstrapStatus to expand
  11. Click Try it out
  12. Review the Description for the X-Ops-API-use-unsupported boolean header and set to true
  13. Replace the JSON in the resourceBootstrapStatuses field with the following content
    {
      "resourcesBootstrapStatuses" : [ {
        "resourceId" : "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "bootstrapStatus" : "NOT_INSTALLED_AND_AGENT_UNINSTALL_SUCCESS"
      } ]
    }

    Note: Replace xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx with the ID copied in step 3
  14. Click Execute
  15. Scroll down to Server response and verify Code 200 is shown
  16. Return to the Aria Operations product UI and navigate to Operations > Applications > Manage Telegraf Agents
  17. Verify that the Agent Status column for the VM has updated to Agent Not Installed

    Note: You may need to click the Refresh button (circled arrow icon) in the top right corner to update the current status
  18. Manually remove the telegraf agent from the endpoint VM using steps from Manually Remove Telegraf Agents from Endpoints