VMware vCenter Server
Integrate VMware vCenter with Cloudaware to inventory ESXi hosts, clusters, virtual machines, datastores, networks, and related vSphere resources in the Cloudaware CMDB.
- Audience: Cloudaware administrators, VMware administrators, virtualization teams, cloud engineers, operation and security teams
- Outcome: VMware vCenter environments are connected to Cloudaware for vSphere inventory, configuration, and hybrid cloud reporting
Capabilities
The integration supports:
- Read-only discovery of core vSphere inventory: vCenter management servers, datacenters, clusters, hosts, virtual machines, etc.
- Relationship mapping between VMware infrastructure, applications, and assets
- Optional correlation with Breeze Agent data using the vCenter Service Instance UUID
- Search, reporting, and coverage analysis for VMware resources using CMDB Navigator, CMDB list views, and reports
Prerequisites
Before you begin, make sure you have:
- Access to a Cloudaware account.
- A user with access to the Admin Console and permissions to manage cloud accounts, organizations, and integrations (Cloudaware Administrator).
- A supported VMware vCenter environment.
- vCenter access details:
- vCenter Management Server hostname or FQDN
- Dedicated vCenter username and password
- Read-only permissions for the objects Cloudaware must inventory
- For private vCenter environments, a TunHub gateway deployed and configured.
- Optional: To allow Cloudaware to collect vCenter custom attributes, add the
System.Viewpermission using a custom role. - Optional: vCenter Service Instance UUID (
instanceUuid) for Breeze Agent correlation.
Add a VMware vCenter Server Integration
To connect VMware vCenter Server to Cloudaware:
- In Cloudaware, go to Admin (Admin Console).
- Select vCenter Management Server.
- Click + ADD.
- Enter the following values:
- Name: A display name for the vCenter integration
- URL: The direct vCenter URL or the TunHub URL for private connectivity
- Hostname: The vCenter Management Server hostname
- Username: The vCenter username dedicated to Cloudaware
- Password: The password for that vCenter user
- Service Instance UUID: optional; the
instanceUuidvalue used for Breeze Agent - Trust Certificate: Enable when required for TunHub or private certificate scenarios
- Click SAVE.
- Confirm that the integration status indicator is green.
Allow the initial discovery cycle to complete after enabling the integration. In private TunHub scenarios, initial connection and sync may take up to 24-48 hours.
View VMware Data in CMDB
To browse discovered VMware resources:
- In Cloudaware, open CMDB Navigator.
- In the left pane, select VMWARE.
- Open an object list, e.g., vCenter Virtual Machines, to view records.
Use CMDB list views and reports to analyze vSphere inventory, relationships, and coverage.
Supported Objects
Cloudaware ingests the following vCenter objects:
| VMware vCenter Object | CMDB Object API Name |
|---|---|
| vCenter Cluster | CA10V__CaVCenterCluster__c |
| vCenter Custom Attribute Definition | CA10V__CaVCenterCustomAttributeDefinition__c |
| vCenter Datacenter | CA10V__CaVCenterDatacenter__c |
| vCenter Datastore | CA10V__CaVCenterDatastore__c |
| vCenter Folder | CA10V__CaVCenterFolder__c |
| vCenter Host | CA10V__CaVCenterHost__c |
| vCenter K8s Cluster | CA10V__CaVCenterKubernetesCluster__c |
| vCenter K8s Cluster Config Map | CA10V__CaVCenterK8sClusterConfigMap__c |
| vCenter K8s Cluster Daemon Set | CA10V__CaVCenterK8sClusterDaemonSet__c |
| vCenter K8s Cluster Deployment | CA10V__CaVCenterK8sClusterDeployment__c |
| vCenter K8s Cluster Endpoint | CA10V__CaVCenterK8sClusterEndpoint__c |
| vCenter K8s Cluster HPA | CA10V__CaVCenterK8sClusterHpa__c |
| vCenter K8s Cluster Ingress | CA10V__CaVCenterK8sClusterIngress__c |
| vCenter K8s Cluster Limit Range | CA10V__CaVCenterK8sClusterLimitRange__c |
| vCenter K8s Cluster Namespace | CA10V__CaVCenterK8sClusterNamespace__c |
| vCenter K8s Cluster Network Policy | CA10V__CaVCenterK8sClusterNetworkPolicy__c |
| vCenter K8s Cluster Network Policy Rule | CA10V__CaVCenterK8sClusterNetworkPolicyRule__c |
| vCenter K8s Cluster Node | CA10V__CaVCenterK8sClusterNode__c |
| vCenter K8s Cluster Node Address | CA10V__CaVCenterK8sClusterNodeAddress__c |
| vCenter K8s Cluster Pod | CA10V__CaVCenterK8sClusterPod__c |
| vCenter K8s Cluster Pod Container | CA10V__CaVCenterK8sClusterPodContainer__c |
| vCenter K8s Cluster Pod Disruption Budget | CA10V__CaVCenterK8sClusterPodDisruptionBudget__c |
| vCenter K8s Cluster Replica Set | CA10V__CaVCenterK8sClusterReplicaSet__c |
| vCenter K8s Cluster Resource Quota | CA10V__CaVCenterK8sClusterResourceQuota__c |
| vCenter K8s Cluster Role | CA10V__CaVCenterK8sClusterRole__c |
| vCenter K8s Cluster Role Binding | CA10V__CaVCenterK8sClusterRoleBinding__c |
| vCenter K8s Cluster Secret | CA10V__CaVCenterK8sClusterSecret__c |
| vCenter K8s Cluster Service | CA10V__CaVCenterK8sClusterService__c |
| vCenter K8s Cluster Service Acc Secret | CA10V__CaVCenterK8sClusterServiceAccSecret__c |
| vCenter K8s Cluster Service Account | CA10V__CaVCenterK8sClusterServiceAccount__c |
| vCenter K8s Cluster Stateful Set | CA10V__CaVCenterK8sClusterStatefulSet__c |
| vCenter K8s Cluster Storage Class | CA10V__CaVCenterK8sClusterStorageClass__c |
| vCenter Management Server | CA10V__CaVCenterManagementServer__c |
| vCenter Network | CA10V__CaVCenterNetwork__c |
| vCenter Resource Pool | CA10V__CaVCenterResourcePool__c |
| vCenter Supervisor Cluster | CA10V__CaVCenterSupervisorCluster__c |
| vCenter Supervisor Cluster Namespace | CA10V__CaVCenterNamespace__c |
| vCenter Virtual Machine | CA10V__CaVCenterVirtualMachine__c |
| vCenter Virtual Machine Disk | CA10V__CaVCenterVirtualMachineDisk__c |
| vCenter Virtual Machine Ethernet Adapter | CA10V__CaVCenterVirtualMachineEthernetAdapter__c |
| vCenter Virtual Machine Fact | CA10V__CaVCenterVirtualMachineFact__c |
| vCenter Virtual Machine Mount Point | CA10V__CaVCenterVirtualMachineMountPoint__c |
Troubleshooting
Initial data collection may take time to complete.
Authentication or Permission Errors
- Confirm the vCenter user can sign in to vCenter directly.
- Verify that the account is not locked or expired.
- Confirm that the account has read-only access to the required vCenter inventory scope.
- Re-enter the credentials by editing the integration in Cloudaware.
Connectivity or SSL Errors
- Verify that Cloudaware can reach the vCenter endpoint directly or through TunHub.
- Confirm firewall rules allow traffic to the vCenter endpoint.
- If using TunHub, verify that the route and gateway are healthy.
- Enable Trust Certificate when required for the certificate presented through the private route.
No VMware Data Appears After Setup
- Allow the initial discovery cycle to complete.
- Confirm that the integration status indicator is green.
- In CMDB Navigator, verify that you are viewing the VMWARE section.
- Check that the vCenter account has access to the datacenters, clusters, hosts, and virtual machines you expect Cloudaware to collect.
Still stuck? Contact Cloudaware Support at support@cloudaware.com with the integration name and a brief description of the issue.
Reconfigure or Remove the Integration
To rotate credentials, edit the existing integration instead of deleting and re-creating it.
Update Credentials or Connection Settings
- Go to Admin.
- Select vCenter Management Server.
- Select the specific integration.
- Open the three-dot menu (⋮), then click Edit.
- Update the required fields.
- Click Save.
Remove the Integration from Cloudaware
- Go to Admin.
- Select vCenter Management Server.
- Select the specific integration.
- Open the three-dot menu (⋮), then click Delete.
- Confirm the deletion if prompted.
Security Notes
- Use a dedicated vCenter account with the minimum required read-only access.
- Rotate the vCenter password according to your organization's credential-rotation policy.
- Limit network access to the vCenter endpoint to trusted Cloudaware or TunHub routes.
- Credentials are stored securely and are only visible to Cloudaware administrators.