How to Delete the Application Monitoring vCenter to Cloud Proxy Mapping Via API

Products

• VMware Aria Suite

Issue/Introduction

The first time you use the Aria Operations UI to install a telegraf on any VM in a vCenter, a VMware Aria Operations Application Monitoring Adapter is created that maps the relationship of the vCenter to a cloud proxy or HA enabled collector group for all future agent lifecycle management.

• For more information, see step 4 of the documentation Install an Agent from the UI

Once created, the mapping can only be deleted via API if it needs to be changed. The steps in the Resolution section enable you to delete the mapping and recreate it using a different cloud proxy or HA enabled collector group.

Environment

VMware Aria Operations 8.18.x

Resolution

Identify the vCenter ID

1. Navigate to Administration > Integrations
2. Click the vertical three dots button next to the vCenter adapter whose mapping you would like to delete and select Edit
3. Expand Advanced Settings
4. Note the value for vCenter ID
   Tip: You can double click the value and use CTRL+C to copy it to your clipboard

 

Delete vCenterMapping

1. Navigate to Home > Launchpad > Developer Center and click the API documentation link
   • Note: This will open a new browser tab to the Swagger UI interface for the VMware Aria Operations API
2. Click the Authorize button and provide a username and password with administrative privileges
   • Note: If the Available authorizations dialog contains a previous opsToken that is expired, click Logout to refresh the token
3. Click Authorize and then click Close
4. Type vccp into the Search box
5. Click Applications /api/applications to expand
6. Click DELETE /api/applications/vccpmappings to expand
7. Click the Try it out button
8. Replace the sample payload with the following payload in the request body

   { "uuids" : [ "########-####-####-####-############" ] }

   Note: Replace ########-####-####-####-############ with the vCenter ID found in the previous section
9. Click Execute
10. Verify the Code in the Server response is 204

 

Create New vCenterMapping

1. Return to the Aria Operations UI and Navigate to Operations > Applications > Manage Telegraf Agents
2. Click the vertical 3 dots button next to the desired VM and select Install
   • You are presented with the Installing Telegraf Agent dialog where the vCenter can be mapped to a cloud proxy or HA enabled collector group
      
     
3. Select the desired Application Monitoring Availability radio button
4. Use the Select assignment here dropdown menu to choose the desired cloud proxy or collector group and click Done
   • Note: You can cancel the agent installation at this point and the vCenterMapping will persist.

Additional Information

• Existing telegraf agents that were installed using the previous mapping will continue to work reporting metrics to the previously mapped cloud proxy or HA enabled collector group.
• To change the existing telegraf agents to use the newly mapped cloud proxy or HA enabled collector group, it is required to uninstall the telegraf agent and install it again.
• If the previously mapped cloud proxy or HA collector group is no longer present in the system, you will need to manually uninstall the telegraf agent from the VM before you can install it again using the new mapping. See Manually Remove Telegraf Agents from Endpoints