VMware - vCloud Infrastructure extractor
This topic describes how to integrate BMC Helix Continuous Optimization with VMWare vCloud Director to extract vCloud infrastructure data. The ETL imports infrastructure data from VMware vCloud Director.
In the vCloud Infrastructure ETL, the following entities are fetched by Provider vDCs and Organization vDCs:
- For each Provider vDC, related Organization vDCs, Hosts, Resource pools, Datastores and Datastore Clusters are fetched.
- For each Organization vDC, related Resource pools are fetched.
The VMWare infrastructure hierarchy is refreshed every 6 hours. Removing or adding a new datastore into a datastore cluster can take upto 6 hours to reflect in BMC Helix Continuous Optimization, and during this period, no data is lost. Any change in configuration values (for example, total space of the datastore cluster) will reflect in BMC Helix Continuous Optimization in 1 hour.
For more information, refer to the following sections:
Integration steps
To integrate BMC Helix Continuous Optimization with the vCloud infrastructure extractor:
- Navigate to Administration > ETL & SYSTEM TASKS > ETL tasks.
- In the ETL tasks page, click Add > Add ETL under the Last run tab.
In the Add ETL page, set values for the following properties under each expandable tab.
Basic properties
Advanced properties
- Click Save.
You return to the Last run tab under the ETL tasks page. - Validate the results in simulation mode: In the ETL tasks table under ETL tasks > Last run, locate your ETL (ETL task name), click
to run the ETL.
After you run the ETL, the Last exit column in the ETL tasks table will display one of the following values:- OK: The ETL executed without any error in simulation mode.
- WARNING: The ETL execution returned some warnings in simulation mode. Check the ETL log.
- ERROR: The ETL execution returned errors and was unsuccessful. Edit the active Run configuration and try again.
- Switch the ETL to production mode: To do this, perform the following task:
- In the ETL tasks table under ETL tasks > Last run, click the ETL under the Name column.
- In the Run configurations table in the ETL details page, click
to edit the active run configuration.
- In the Edit run configuration page, navigate to the Run configuration expandable tab and set Execute in simulation mode to No.
- Click Save.
- Locate the ETL in the ETL tasks table and click
to Run it, or schedule an ETL run.
After you run the ETL, or schedule the ETL for a run, it will extract the data form the source and transfer it to the BMC Helix Continuous Optimization database.
vCloud infrastructure data metrics
The following BMC Helix Continuous Optimization metrics are populated by the VMware - vCloud Director - Cloud infrastructure extractor ETL.
Legend:
C: Configuration metric
T: Time Series metric
Entity | BMC Helix Continuous Optimization metric | Type* | Dataset | Description | vCloud Metric |
---|---|---|---|---|---|
vCloud | VCLOUD_NAME | C | SYSVMW | Name of the vCloud system | - |
CPU_ALLOCATION | T | SYSVIRGLB | Number of Units that have been allocated to all orgvDCs in the vCloud. | - | |
CPU_TOTAL_MHZ | C | SYSCNF | Total CPU available for vCloud. | - | |
CPU_UTILMHZ | T | SYSGLB | Sum of CPU used by all child Provider vDCs | - | |
CPU_UTIL | T | SYSGLB | Percentage (%) utilization, ratio of CPU_UTILMHZ / CPU_TOTAL_MHZ. | - | |
MEM_ALLOCATION | T | SYSVIRGLB | Number of units that have been allocated to consumers that is all orgvDCs in the vCloud. | - | |
TOTAL_REAL_MEM | C | SYSCNF | Total memory available for PvDC | - | |
MEM_USED | T | SYSGLB | Sum of memory used by all child Org vDCs. | - | |
MEM_UTIL | T | SYSGLB | Percentage (%) utilization, ratio of MEM_USED/TOTAL_REAL_MEM. | - | |
DSTORE_ALLOCATION | T | SYSVIRGLB | Number of Units that have been allocated to consumers that is all orgvDCs in the vCloud. | - | |
TOTAL_DSTORE_SIZE | C | SYSVIRDS | Total storage available for vCloud. | - | |
TOTAL_DSTORE_USED | T | SYSVIRDS | Storage used | - | |
TOTAL_DSTORE_UTIL | T | SYSVIRDS | Percentage (%) utilization, ratio of TOTAL_DSTORE_USED / TOTAL_DSTORE_SIZE. | - | |
Provider vDC | VCLOUD_NAME | C | SYSVMW | Name of the vCloud system. | - |
PROVIDERVDC_NAME | C | SYSVMW | Name of the Provider vDC. | QueryResultVMWProviderVdcRecordType.name | |
CPU_ALLOCATION | T | SYSVIRGLB | Number of Units that have been allocated to all orgVDCs under Provider vDC. | QueryResultVMWProviderVdcRecordType.cpuAllocationMhz | |
CPU_TOTAL_MHZ | C | SYSCNF | Total CPU available for PvDC. | QueryResultVMWProviderVdcRecordType.cpuLimitMhz | |
CPU_UTILMHZ | T | SYSGLB | Sum of CPU reserved by all child Org vDCs. | QueryResultVMWProviderVdcRecordType.cpuUsedMhz | |
CPU_UTIL | T | SYSGLB | Percentage (%) utilization, ratio of CPU_UTILMHZ / CPU_TOTAL_MHZ. | QueryResultVMWProviderVdcRecordType.cpuUsedMhz / | |
MEM_ALLOCATION | T | SYSVIRGLB | Number of Units that have been allocated to all orgVDCs under Provider vDC. | QueryResultVMWProviderVdcRecordType.memoryAllocationMB | |
TOTAL_REAL_MEM | C | SYSCNF | Total memory available for PvDC. | QueryResultVMWProviderVdcRecordType.memoryLimitMB | |
MEM_USED | T | SYSGLB | Sum of memory reserved by all child Org vDCs. | QueryResultVMWProviderVdcRecordType.memoryUsedMB | |
MEM_UTIL | T | SYSGLB | Percentage (%) utilization, ratio of MEM_USED/TOTAL_REAL_MEM. | (QueryResultVMWProviderVdcRecordType.memoryUsedMB/ | |
DSTORE_ALLOCATION | T | SYSVIRGLB | Number of units that have been allocated to consumers that is all orgvDCs under Provider vDC. | QueryResultVMWProviderVdcRecordType.storageAllocationMB | |
TOTAL_DSTORE_SIZE | C | SYSVIRDS | Total storage available for PvDC. | QueryResultVMWProviderVdcRecordType.storageLimitMB | |
TOTAL_DSTORE_USED | T | SYSVIRDS | Storage Used | QueryResultVMWProviderVdcRecordType.storageUsedMB | |
TOTAL_DSTORE_UTIL | T | SYSVIRDS | Percentage (%) utilization, ratio of TOTAL_DSTORE_USED / TOTAL_DSTORE_SIZE. | (QueryResultVMWProviderVdcRecordType.storageUsedMB/ | |
HA_STATUS | C | SYSVMW | Read-only indicator. True if compute capacity is highly available. | VMWProviderVdcType.RootComputeCapacityType.IsHA | |
VDC_STATUS | C | SYSVMW | Status of vCloud Virtual Datacenter | QueryResultVMWProviderVdcRecordType.isEnabled | |
Org vDC | VCLOUD_NAME | C | SYSVMW | Name of the vCloud system | - |
PROVIDERVDC_NAME | C | SYSVMW | Name of the Provider vDC | QueryResultVMWProviderVdcRecordType.name | |
ORGVDC_NAME | C | SYSVMW | Organization vDC Name | QueryResultAdminVdcRecordType .name | |
CPU_LIMIT_MHZ | C | SYSVIRGLB | Maximum amount of CPU available to the virtual machines running within this organization vDC (taken from the supporting provider vDC).
| QueryResultAdminVdcRecordType.cpuLimitMhz | |
CPU_RESERVED_MHZ | C | SYSVIRGLB | Guaranteed Number of Units that have been allocated to org vDC. This is allocation multiplied by the Resource Guaranteed CPU. | QueryResultAdminVdcRecordType.cpuAllocationMhz * | |
CPU_UTILMHZ | T | SYSGLB | CPU Used | QueryResultAdminVdcRecordType.cpuUsedMhz | |
CPU_UTIL | T | SYSGLB | Percentage (%) utilization, ratio of CPU_UTILMHZ / CPU_LIMIT_MHZ | (QueryResultAdminVdcRecordType.cpuUsedMhz/ | |
MEM_LIMIT | C | SYSVIRGLB | Maximum amount of memory available to the virtual machines running within this organization vDC (taken from the supporting provider vDC).
| QueryResultAdminVdcRecordType.memoryLimitMB | |
MEM_RESERVED | C | SYSVIRGLB | Guaranteed Number of Units that have been allocated to org vDC. This is allocation multiplied by the Resource Guaranteed memory. | QueryResultAdminVdcRecordType.memoryAllocationMB * AdminVdcType.ResourceGuaranteedMemory | |
MEM_USED | T | SYSGLB | Memory Used | QueryResultAdminVdcRecordType.memoryUsedMB | |
MEM_UTIL | T | SYSGLB | Percentage (%) utilization, ratio of MEM_USED/MEM_LIMIT. | (QueryResultAdminVdcRecordType.memoryUsedMB / QueryResultAdminVdcRecordType.memoryLimitMB) * 100 | |
DSTORE_LIMIT | C | SYSVIRDS | The maximum amount of Storage available to the virtual machines running within this organization vDC (taken from the supporting provider vDC). | QueryResultAdminVdcRecordType.storageLimitMB | |
TOTAL_DSTORE_SIZE | C | SYSVIRDS | Maximum amount of storage available to the virtual machines running within this organization vDC (taken from the supporting provider vDC). | QueryResultAdminVdcRecordType.storageLimitMB | |
TOTAL_DSTORE_USED | T | SYSVIRDS | Amount of storage used by vAPPs, VMs, templates, media files under this Org vDC. | QueryResultAdminVdcRecordType.storageUsedMB | |
TOTAL_DSTORE_UTIL | T | SYSVIRDS | Percentage (%) utilization, ratio of TOTAL_DSTORE_USED / TOTAL_DSTORE_SIZE | (QueryResultAdminVdcRecordType.storageUsedMB / QueryResultAdminVdcRecordType.storageLimitMB) * 100 | |
ALLOCATION_MODEL | C | SYSVMW | Allocation model used by this vDC. One of:
| AdminVdcType.AllocationModel | |
CPU_COMPUTED_LIMIT_OPT | C | SYSVIRGLB | Maximum optimistic amount of CPU the virtual machines running within this organization vDC can avail.
| - | |
MEM_COMPUTED_LIMIT_OPT | C | SYSVIRGLB | Maximum optimistic amount of memory the virtual machines running within this organization vDC can avail.
| - | |
DSTORE_COMPUTED_LIMIT_OPT | C | SYSVIRDS | Maximum optimistic amount of storage the virtual machines running within this organization vDC can avail.
| - | |
VDC_STATUS | C | SYSVMW | Status of vCloud Virtual Datacenter | QueryResultAdminVdcRecordType.isEnabled |
vCloud Aggregation Hierarchy Rule metrics
The following BMC Helix Continuous Optimization metrics are populated by the vCloud Aggregation Hierarchy Rule
Lookup details
The vCD defines multiple lookup fields for coordinating with other connectors. The following table lists the sequence of field sets for strong lookup and weak lookup.