Documentos de Académico
Documentos de Profesional
Documentos de Cultura
This document supports the version of each product listed and supports all subsequent versions until the document is replaced by a new edition. To check for more recent editions of this document, see http://www.vmware.com/support/pubs.
EN-000912-02
You can find the most up-to-date technical documentation on the VMware Web site at: http://www.vmware.com/support/ The VMware Web site also provides the latest product updates. If you have comments about this documentation, submit your feedback to: docfeedback@vmware.com
Copyright 2013 VMware, Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws. VMware products are covered by one or more patents listed at http://www.vmware.com/go/patents. VMware is a registered trademark or trademark of VMware, Inc. in the United States and/or other jurisdictions. All other marks and names mentioned herein may be trademarks of their respective companies.
VMware, Inc.
Contents
How the Adapter Creates Resources 9 Data that the Adapter Collects 9 Using the VM Entity Status Resource Tag 10 Installation and Configuration Requirements 10 vCenter Adapter Resource Identification 11
Install the Adapter in a Standalone Installation Install the Adapter in a vApp Installation 16 vCenter Adapter Folders and Files 16
15
Add a Credential 19 Add an Adapter Instance 20 Reducing the Number of Collected Metrics 20
Troubleshooting a vCenter Adapter Instance 21 View Collection Information 21 Viewing System Log Files 23
VMware, Inc.
Web Server Metrics 72 Replication Server Metrics 74 Database Metrics 74 Host Operating System Metrics
75
Index 77
VMware, Inc.
The VMware vCenter Adapter Installation and Configuration Guide describes how to install and configure the vCenter adapter for vCenter Operations Manager.
Intended Audience
This information is intended for anyone who needs to install or configure the vCenter adapter.
VMware, Inc.
VMware, Inc.
Updated Information
The VMware vCenter Adapter Installation and Configuration Guide is updated with each release of the product or when necessary. This table provides the update history of the VMware vCenter Adapter Installation and Configuration Guide.
Revision EN-000912-02 Description
n n n n
Updated the list of compatible vSphere versions in Installation and Configuration Requirements, on page 10. Added Reducing the Number of Collected Metrics, on page 20. Added the datastore | notshared metric to Virtual Machine Metrics, on page 48. Added Chapter 6, Metrics for vCenter Operations Manager Components, on page 65. Changed the product name to reflect the new licensing model for the 5.6 release. Added vCenter Adapter Folders and Files, on page 16. Added information about configuring the adapter in a 5.6 or later vApp installation to Chapter 3, Configuring the vCenter Adapter, on page 19. Added View Collection Information, on page 21. Added metrics to Chapter 5, Metrics for vCenter Server Components, on page 25
EN-000912-01
n n n n n
EN-000912-00
The vCenter Adapter Technical Note is now the VMware vCenter Adapter Installation and Configuration Guide. The vCenter Adapter Technical Note was the initial release of this document.
VMware, Inc.
VMware, Inc.
The vCenter adapter is an embedded adapter for vCenter Operations Manager. The adapter collects metrics from vCenter Server. This chapter includes the following topics:
n n n n n
How the Adapter Creates Resources, on page 9 Data that the Adapter Collects, on page 9 Using the VM Entity Status Resource Tag, on page 10 Installation and Configuration Requirements, on page 10 vCenter Adapter Resource Identification, on page 11
VMware, Inc.
n n
Datastore Folder
For information about the metrics that the adapter collects for these objects, see Chapter 5, Metrics for vCenter Server Components, on page 25.
You can select the PoweredOff or PoweredOn tag value to filter host system and virtual machine resources based on their running state. You can select the NotExisting tag value to locate resources that no longer exist in the vCenter Server inventory and remove them from the Custom user interface. When objects are removed from the vCenter Server inventory, they remain available in the user interface until you remove them.
Credential Requirements
You must provide a vCenter Server user name and password when you create a credential for a vCenter adapter instance. The vCenter Server privileges assigned to this user account determine the scope of the data that the vCenter adapter can collect and the visibility of that data in vCenter Operations Manager. The adapter calculates metric values based on the visibility that the user account has to the vCenter Server inventory. If certain objects are not visible, vCenter Operations Manager does not consider the values for these objects when it calculates metrics for their container objects.
10
VMware, Inc.
At a minimum, the user account must have Read privileges and the Read privileges must be assigned at the Datacenter or vCenter Server level. If the Read privileges are assigned to selected ESX hosts or individual virtual machines, vCenter Operations Manager cannot show metrics for their parent objects. For example, if the user account has Read privileges only for an ESX host, you cannot view metrics for the parent datastore, cluster, or datacenter of that ESX host in vCenter Operations Manager.
Adapter Kind
The adapter kind for the vCenter adapter is VMware Adapter and the identifier key is VMWARE.
VMEntityVCID
Yes
VC ID
VMware, Inc.
11
VMEntityVCID
Yes
VC ID
VMEntityVCID
Yes
VC ID
VMEntityVCID
Yes
VC ID
VMEntityVCID
Yes
VC ID
12
VMware, Inc.
VMEntityVCID
Yes
VC ID
VMEntityVCID DataStorePath
Yes No
VC ID Datastore Path
to-element-in-storagesystem.
VMware, Inc.
13
VC ID Values
For vCenter Server 4.0 and later, the VC ID is set to the VC UUID. For version 2.5, the VC ID is set to the vCenter Server host name.
14
VMware, Inc.
How you install the vCenter adapter depends on whether you have a standalone or vApp installation. This chapter includes the following topics:
n n n
Install the Adapter in a Standalone Installation, on page 15 Install the Adapter in a vApp Installation, on page 16 vCenter Adapter Folders and Files, on page 16
Download the adapter installation TGZ file anonymously from ftp://ftp.integrien.com/. Make a note of the build number in the TGZ file name. The build number appears after the adapter name, for example, adaptername-buildnumber.tgz. Read the release notes that are included with the TGZ file.
Procedure 1 2 3 4 5 Open the TGZ file and extract the TAR file to a temporary folder on your vCenter Operations Manager server. In the temporary folder, open the TAR file and extract and run the installer for your operating system platform. Log in to the Custom user interface as an administrator. Select Admin > Support. On the Info tab, find the Adapters Info pane and click the Describe icon ( ). The Describe icon is located at the top right of the Adapters Info pane. 6 Click Yes to start the describe process and click OK. The Custom user interface finds the adapter files, gathers information about the abilities of the adapter, and updates the user interface with information about the adapter. If you have remote collectors, it installs the adapter on the remote collectors. The describe process might take several minutes. When the describe process is finished, the adapter appears in the Adapters Info pane. The build number is in the Adapter Version column.
VMware, Inc.
15
Verify that the build number in the Adapter Version column for the adapter matches the build number in the TGZ file that you downloaded.
Download the adapter installation PAK file anonymously from ftp://ftp.integrien.com. Make a note of the build number in the PAK file name. The build number appears after the adapter name, for example, adaptername-buildnumber.pak. Read the release notes that are included with the PAK file.
Procedure 1 2 Save the PAK file in a temporary folder. Log in to the Admin user interface as the admin user. For example: https://ipaddress/admin/ 3 4 On the Update tab, click Browse to locate the temporary folder and select the PAK file. Click Update and click OK to confirm the update. The Admin user interface uploads the PAK file. The upload might take several minutes. 5 6 Read and accept the EULA and click OK. Click OK to confirm and start the update process. The update might take several minutes. Status information appears on the Update tab when the update is finished. 7 Log in to the Custom user interface as an administrator. For example: https://ipaddress/vcops-custom/ 8 9 Select Admin > Support. On the Info tab, find the Adapters Info pane and click the Describe icon ( ). The Describe icon is located at the top right of the Adapters Info pane. 10 Click Yes to start the describe process and click OK. The Custom user interface finds the adapter files, gathers information about the abilities of the adapter, and updates the user interface with information about the adapter. The describe process might take several minutes. When the describe process is finished, the adapter appears in the Adapters Info pane. The build number is in the Adapter Version column. 11 Verify that the build number in the Adapter Version column for the adapter matches the build number in the PAK file that you uploaded.
16
VMware, Inc.
VMware, Inc.
17
18
VMware, Inc.
For pre-5.6 releases, you configure the vCenter adapter by adding a credential and an adapter instance in the Custom user interface. For 5.6 and later releases, you add a credential and an adapter instance in the Custom user interface only if you have a standalone installation. If you have a 5.6 or later vApp installation, you manage the vCenter adapter from vCenter Operations Manager Administration. You define adapter settings for a vCenter server system in the vCenter Server Registration pane on the Registration tab. For more information, see the vCenter Operations Manager Administration online help. This chapter includes the following topics:
n n n
Add a Credential, on page 19 Add an Adapter Instance, on page 20 Reducing the Number of Collected Metrics, on page 20
Add a Credential
You must use the Custom user interface to create a credential for a vCenter adapter instance if you have a 5.6 or later standalone installation or a pre-5.6 standalone or vApp installation. You use a vCenter Server user name and password to create a credential for the adapter instance. You can add the credential before you create the adapter instance and select the correct credential when you define the adapter instance, or you can add the credential when you define the adapter instance. Prerequisites
n n
Install or upgrade the vCenter adapter. See Chapter 2, Installing the vCenter Adapter, on page 15. Verify that the user name and password meet the credential requirements. See Credential Requirements, on page 10.
Procedure 1 2 3 4 5 6 Log in to the Custom user interface as an administrator. Select Environment > Configuration > Credentials. Select VMware Adapter from the Adapter Kind drop-down menu. Select Principal Credential from the Credential Kind drop-down menu. At the top of the list of credentials, next to Action, click Add. Type a unique name for the credential instance in the Instance name text box.
VMware, Inc.
19
7 8
Type the user name and password combination in the User name and Password text boxes. Click OK to add the credential for the adapter kind.
Install or upgrade the vCenter adapter. See Chapter 2, Installing the vCenter Adapter, on page 15. Create a credential, or, if you plan to create a credential when you add the adapter instance, become familiar with creating credentials. See Add a Credential, on page 19.
Procedure 1 2 3 Log in to the Custom user interface as an administrator. Select Environment > Configuration > Adapter Instances. Select the collector to use from the Collector drop-down menu. Unless you added additional collectors, the only available collector is vCenter Operations Server. You can change the name of this collector when you install the standalone version. 4 5 6 7 8 Select VMware Adapter from the Adapter Kind drop-down menu. Click the Add New Adapter Instance icon. Type a name for the adapter in the Adapter Instance Name text box. Type the IP address or host name of the vCenter Server host in the VC Host text box. Select true or false from the Auto Discovery drop-down menu to enable or disable auto-discovery. If you enable auto-discovery, the data collection process discovers new resources and creates the resources for you. If you disable auto-discovery, you must use manual discovery to create resources. Manual discovery is useful for restricing the resources that the adapter adds. You typically enable auto-discovery for the vCenter adapter. 9 10 11 Select true or false from the Process Change Events drop-down menu to configure whether the adapter instance processes change events. Select the credential to use to sign on to the data source from the Credential drop-down menu, or click Add to add a new credential. Click OK to save your configuration.
20
VMware, Inc.
Known troubleshooting information can help you diagnose and correct common problems with the vCenter adapter. This chapter includes the following topics:
n n n
Troubleshooting a vCenter Adapter Instance, on page 21 View Collection Information, on page 21 Viewing System Log Files, on page 23
VMware, Inc.
21
Point to the icon in the Collection Status column to see whether vCenter Operations Manager is receiving data through the adapter instance. The collection status and a collection status message appear in a pop-up window. If vCenter Operations Manager is receiving data through the adapter instance, the collection status is Data Receiving. In vCenter Operations Manager 5.6 and later, the vCenter adapter generates a collection time status message whenever a host system or virtual machine receives raw data from vCenter Server, for example, Message: Last successful collection time is "Fri May 11 11:44:09 PDT 2012".
Collection States
The resource collection state indicates whether vCenter Operations Manager should be collecting data for the resource. The resource collection state appears in a pop-up window when you point to an icon in the Collection State column in the resource list on the Environment Overview page. If vCenter Operations Manager collects data for a resource through more than one adapter instance, a separate icon appears for each adapter instance. Table 4-1. Collection States
State Collecting Not Collecting Starting Stopping Updating Failed In Maintenance In Maintenance (Manual) Removing Description Resource is set to collect data. Resource is set to not collect data. Collection is starting. Collection is stopping. Resource is being updated. Resource configuration problem. Resource is in scheduled maintenance. Resource is in manual maintenance. Resource is being deleted.
If you click an icon in the Collection State column, detailed information appears in a pop-up window. Table 4-2. Detailed Collection State Information
Field Adapter Instance Collector Last Heartbeat Status Last Collection Time Last Collection Duration Metric Sparklines Description Name of the adapter instance. Name of the collector that the adapter instance uses. Amount of time since vCenter Operations Manager received a heartbeat message from the adapter. A long period of time might indicate a connection problem. Status message from the collector. Amount of time since the end of the last collection cycle and the number of metrics that the adapter collected during that cycle. Length of time of the last collection cycle. Graphical representations of the last collection cycle duration and the number of metrics and resources that the adapter collected during that cycle.
22
VMware, Inc.
NOTE Some adapter instances write customized status and messages. These messages typically provide more information about data collection problems.
VMware, Inc.
23
24
VMware, Inc.
The vCenter adapter collects metrics from vCenter Server and uses formulas to derive statistics from those metrics. This chapter includes the following topics:
n n n n n n n n n
vCenter Server Metrics, on page 25 Datacenter Metrics, on page 28 Cluster Compute Resource Metrics, on page 30 Resource Pool Metrics, on page 35 Host System Metrics, on page 37 Virtual Machine Metrics, on page 48 Datastore Metrics, on page 55 Capacity Planning Metrics, on page 59 Badge Metrics, on page 63
VMware, Inc.
25
Disk Metrics
Disk metrics provide information about disk use. Table 5-2. Disk Metrics
Metric Key disk | commandsAveraged_average disk | totalLatency_average Metric Name Commands per second Disk Command Latency (ms) Description Average number of commands issued per second during the collection cycle. Average amount of time taken for a command from the perspective of the guest operating system. This metric is the sum of the Kernal Device Command Latency and Physical Device Command Latency metrics. Average of the sum of the data read and written for all of the disk instances of the host or virtual machine. Percent workload.
Memory Metrics
Memory metrics provide information about memory use and allocation. Table 5-3. Memory Metrics
Metric Key mem | host_contentionPct mem | host_demand mem | workload mem | host_provisioned mem | reservedCapacity_average mem | host_usable mem | host_usage mem | host_usagePct mem | host_contention Metric Name Contention (%) Machine Demand (KB) Overall Workload (%) Provisioned Memory (KB) Reserved Capacity (KB) Usable Memory (KB) Usage (KB) Usage/Usable (%) Contention (KB) Description Percent host memory contention. Host memory demand in kilobytes. Percent memory workload. Provisioned host memory in kilobytes. Sum of the reservation properties of the immediate children of the host's root resource pool. Usable host memory in kilobytes. Host memory use in kilobytes. Percent host memory used. Host contention in kilobytes.
Network Metrics
Network metrics provide information about network performance.
26
VMware, Inc.
Summary Metrics
Summary metrics provide information about overall performance. Table 5-5. Summary Metrics
Metric Key summary | capacity summary | number_running_hosts summary | number_running_vms summary | total_number_clusters summary | total_number_datastores summary | total_number_hosts summary | total_number_vms summary | version summary | workload summary | workload_indicator summary | total_number_datacenters summary | number_powered_on_cores summary | number_running_vcpus summary | avg_vm_density summary | vcuuid summary | vc_query_time summary | derived_metrics_comp_time Metric Name Capacity (%) Number of Running Hosts Number of Running VMs Total Number of Clusters Total Number of Datastores Total Number of Hosts Total Number of VMs Version Workload (%) Workload Indicator (%) Total Number of Datacenters Number of Cores on Powered On Hosts Number VCPUs on Powered on VMs Average Running VM Count per Running Host VirtualCenter ID VC Query Time (ms) Derived Metrics Computation Time (ms) Description Percent capacity. Number of running hosts. Number of running virtual machines. Total number of clusters. Total number of datastores. Total number of hosts. Total number of virtual machines. vCenter Server version. Percent workload. Percent workload indicator. Total number of datacenters. Number of cores on powered-on hosts. Number of virtual CPUs on powered-on virtual machines. Average running virtual machine count per running host. vCenter Server ID. vCenter Server query time in milliseconds. Derived metrics computation time in milliseconds. Available only in 5.6 and later releases. Number of objects. Available only in 5.6 and later releases.
summary | number_objs
Number of objects
VMware, Inc.
27
summary | number_sms_metrics
summary | collector_mem_usage
Datacenter Metrics
The vCenter adapter collects CPU usage, disk, memory, network, storage, disk space, and summary metrics for datacenters.
28
VMware, Inc.
disk | usage_average
net | usage_capacity
VMware, Inc.
29
30
VMware, Inc.
VMware, Inc.
31
Table 5-16. CPU Usage Metrics for Cluster Compute Resources (Continued)
Metric Key cpu | demandPct cpu | demandmhz cpu | iowait cpu | numpackages cpu | capacity_contention cpu | capacity_provisioned cpu | corecount_provisioned cpu | reservedCapacity_average cpu | wait cpu | workload cpu | usagemhz_average cpu | total_capacity Metric Name Demand (%) Demand (MHz) IO Wait (ms) Number of CPU Sockets Overall CPU Contention (ms) Provisioned Capacity (MHz) Provisioned CPU Cores Reserved Capacity (MHz) Wait (ms) Workload (%) Usage (MHz) Total Capacity (MHz) Description Percent demand. Demand in megahertz. IO wait time in milliseconds. Number of CPU sockets. Overall CPU contention in milliseconds. Provisioned CPU capacity in megahertz. Number of provisioned CPU cores. Reserved capacity in megahertz. Wait time in milliseconds. Percent workload. CPU use in megahertz. Total CPU capacity in megahertz.
disk | totalReadLatency_average
disk | totalWriteLatency_average
Workload (%) Write Rate (KBps) Writes per second Read Requests
32
VMware, Inc.
mem | swapused_average
VMware, Inc.
33
34
VMware, Inc.
summary | avg_vm_cpu
Average Provisioned Capacity (MHz) per Running VM Average Provsioned Memory (KB) per Running VM
summary | avg_vm_mem
VMware, Inc.
35
36
VMware, Inc.
mem | swapoutRate_average mem | swapped_average mem | usage_average mem | zero_average mem | zipped_latest mem | swapin_average mem | swapout_average mem | swapused_average mem | guest_provisioned
swapoutRate_average Swapped (KB) Usage (%) Zero (KB) Zipped (KB) Swap In (KB) Swap Out (KB) Swap Used (KB) Guest Configured Memory (KB)
VMware, Inc.
37
38
VMware, Inc.
Average run time for the CPU over the past minute, past five minutes, past15 minutes, and at oneminute, five-minute, and 15-minute peak times.
Scheduling limit over the past minute, past five minutes, and past 15 minutes Group CPU sample count. Group CPU sample period in milliseconds.
VMware, Inc.
39
datastore | oio datastore | totalLatency datastore | usage datastore | demand datastore | datastoreIops_average datastore | numberReadAveraged_average datastore | numberWriteAveraged_average datastore | read_average datastore | sizeNormalizedDatastoreLatency_average datastore | totalReadLatency_average datastore | totalWriteLatency_average datastore | write_average
Number of Outstanding IO Operations Total Latency (ms) Usage Rate (KBps) Demand Storage I/O Control aggregated IOPS Reads per second Writes per second Read Rate (KBps) Storage I/O Control normalized latency (ms) Read Latency (ms) Write Latency (ms) Write Rate (KBps)
disk | totalLatency_average
disk | numberReadAveraged_average
40
VMware, Inc.
disk | oio disk | queued disk | demand disk | numberRead_summation disk | numberWrite_summation disk | read_average disk | write_average disk | busResets_summation disk | commands_summation disk | commandsAborted_summation disk | deviceReadLatency_average disk | kernelReadLatency_average disk | totalReadLatency_average disk | queueReadLatency_average disk | deviceWriteLatency_average disk | kernelWriteLatency_average disk | totalWriteLatency_average disk | queueWriteLatency_average disk | deviceLatency_average disk | kernelLatency_average disk | queueLatency_average disk | maxQueueDepth_average
Number of Outstanding IO Operations Queued Operations Demand Read Rate (KBps) Write Rate (KBps) Read Requests Write Requests Bus Resets Commands Issued Commands Aborted Physical Device Read Latency (ms) Kernel Disk Read Latency (ms) Disk Read Latency (ms) Queue Read Latency (ms) Physical Device Write Latency (ms) Kernel Disk Write Latency (ms) Disk Write Latency (ms) Queue Write Latency (ms) Physical Device Command Latency (ms) Kernel Disk Command Latency (ms) Queue Command Latency (ms) Max Queue Depth
VMware, Inc.
41
mem | host_systemUsage mem | active_average mem | consumed_average mem | granted_average mem | heap_average mem | heapFree_average mem | overhead_average mem | reservedCapacity_average mem | shared_average mem | sharedcommon_average mem | swapin_average mem | swapout_average mem | swapused_average mem | unreserved_average mem | vmmemctl_average
VMkernel Usage (KB) Guest Active (KB) Consumed (KB) Granted (KB) Heap (KB) Heap Free (KB) VM Overhead (KB) Reserved Capacity (KB) Shared (KB) Shared Common (KB) Swap In (KB) Swap Out KB) Swap Used (KB) Unreserved (KB) Balloon (KB)
Usage (KB) Usage/Usable (%) Swap In Rate (KBps) Swap Out Rate (KBps)
42
VMware, Inc.
VMware, Inc.
43
Uptime (seconds) Disk Usage (%) Resource CPU Usage (MHz) Resource CPU Active (%) (1 min. average) Resource CPU Active (%) (5 min. average) Resource CPU Alloc Max (MHz) Resource CPU Alloc Min (MHz) Resource CPU Alloc Shares Resource CPU Max Limited (%) (1 min. average) Resource CPU Max Limited (%) (5 min. average)
sys | resourceCpuAct5_latest
sys | resourceCpuMaxLimited5_latest
sys | resourceCpuRun1_latest sys | resourceCpuRun5_latest sys | resourceMemAllocMax_latest sys | resourceMemAllocMin_latest sys | resourceMemAllocShares_latest sys | resourceMemCow_latest sys | resourceMemMapped_latest sys | resourceMemOverhead_latest sys | resourceMemShared_latest sys | resourceMemSwapped_latest sys | resourceMemTouched_latest sys | resourceMemZero_latest sys | build
Resource CPU Run1 (%) Resource CPU Run5 (%) Resource Memory Alloc Max (KB) Resource Memory Alloc Min (KB) Resource Memory Alloc Shares Resource Memory Cow (KB) Resource Memory Mapped (KB) Resource Memory Overhead (KB) Resource Memory Shared (KB) Resource Memory Swapped (KB) Resource Memory Touched (KB) Resource Memory Zero (KB) Build Number
44
VMware, Inc.
VMware, Inc.
45
46
VMware, Inc.
VMware, Inc.
47
48
VMware, Inc.
Percent CPU throttled time during various intervals. Group CPU sample count. Group CPU sample period in milliseconds.
VMware, Inc.
49
50
VMware, Inc.
VMware, Inc.
51
52
VMware, Inc.
VMware, Inc.
53
54
VMware, Inc.
Datastore Metrics
The vCenter adapter collects capacity, device, and summary metrics for datastores.
VMware, Inc.
55
devices | totalReadLatency_average
devices | totalWriteLatency_average
devices | kernelLatency_average devices | kernelReadLatency_average devices | kernelWriteLatency_average devices | number_running_hosts devices | number_running_vm devices | deviceLatency_average devices | deviceReadLatency_average devices | queueLatency_average devices | queueReadLatency_average devices | queueWriteLatency_average devices | read_average devices | numberRead_summation devices | numberReadAveraged_average
Kernel Disk Command Latency (ms) Kernel Disk Read Latency (ms) Kernel Disk Write Latency (ms) Number of Running Hosts Number of Running VMs Physical Device Command Latency (ms) Physical Device Read Latency (ms) Queue Command Latency (ms) Queue Read Latency (ms) Queue Write Latency (ms) Read Rate (KBps) Read Requests Reads per second
56
VMware, Inc.
Commands Average Queue Read Latency (ms) Physical Device Write Latency (ms)
VMware, Inc.
57
58
VMware, Inc.
VMware, Inc.
59
Density Metrics
Table 5-67. Density Metrics
Metric Key density | ratio | vcpu2pcpu density | ratio | vm2host density | ratio | vmem2pmem density | ratioOptimal | vcpu2pcpu density | ratioOptimal | vm2host desnity | ratioOptiomal | vmem2pmem Metric Name Ratio - vCPU to pCPU Ratio - VM to Host Ratio - vMemory to pMemory Ratio Optimal - vCPU to pCPU Ratio Optimal - VM to Host Ratio Optimal - vMemory to pMemory Description Virtual CPU to physical CPU ratio. Virtual machine to host ratio. Virtual memory to physical memory ratio. Optimal virtual CPU to physical CPU ratio. Optimal virtual machine to host ratio. Optimal virtual memory to physical memory ratio.
Deployed Metrics
Table 5-68. Deployed Metrics
Metric Key deployed | count | vm deployed | countDistinct | vm Metric Name Count - VM Count Distinct - VM Description Number of deployed virtual machines. Number of distinct deployed virtual machines.
Optimal Metrics
Table 5-69. Optimal Metrics
Metric Key optimal | countDistinct | vm Metric Name Count Distinct - VM Description Distinct virtual machines.
Planning Metrics
Table 5-70. Planning Metrics
Metric Key planning | capacityProvisioned | diskSpace planning | capacityProvisioned | mem planning | capacityProvisioned | vcpu planning | capacityUsable | diskSpace planning | capacityUsable | mem Metric Name Capacity Provisioned - Disk Space Capacity Provisioned - Memory Capacity Provisioned - vCPU Capacity Usable - Disk Space Capacity Usable - Memory Description Provisioned disk space. Provisioned memory. Provisioned virtual CPU. Usable disk space. Usable memory.
60
VMware, Inc.
Powered On Metrics
Table 5-71. Powered On Metrics
Metric Key powered | count | vm powered | countDistinct | vm Metric Name Count - VM Count Distinct - VM Description Number of powered-on virtual machines. Number of distinct powered-on virtual machines.
Stress Metrics
Table 5-72. Stress Metrics
Metric Key stress | countDistinct | saHostsAndClusters stress | countDistinct | vm Metric Name Count Distinct - SA Hosts and Clusters Count Distinct - VM Description Number of distinct SA hosts and clusters. Number of distinct virtual machines.
VMware, Inc.
61
Waste Metrics
Table 5-74. Waste Metrics
Metric Key waste | countDistinct | templateUnused waste | countDistinct | vmIdleOrOversized waste | countDistinct | vmIdle waste | countDistinct | vmOversized waste | countDistinct | vmPoweredOff waste | countDistinct | vm waste | countDistinct | vmOversized | cpu waste | countDistinct | vmOversized | mem waste | diskSpace | total waste | percent | diskSpace waste | percent | mem Metric Name Count Distinct - Template Unused Count Distinct - VM Idle or Oversized Count Distinct - VM Idle Count Distinct - VM Oversized Count Distinct - VM Powered Off Count Distinct - VM Count Distinct - VM Oversized - CPU Count Distinct - VM Oversized Memory Disk Space - Total Percent - Disk Space Percent - Memory Description Unused templates. Idle or oversized virtual machines. Idle virtual machines. Oversized virtual machines. Powered-off virtual machines. Number of virtual machines. Oversized virtual machine CPUs. Oversized virtual machine memory. Total disk space. Percent disk space. Percent memory.
62
VMware, Inc.
Badge Metrics
Badge metrics provide information for badges in the user interface. Table 5-76. Badge Metrics
Metric Key badge | alert_count_critical badge | alert_count_immediate badge | alert_count_info badge | alert_count_warning badge | anomaly badge | capacityRemaining badge | compliance badge | density badge | efficiency badge | fault badge | health badge | risk badge | stress badge | timeRemaining badge | timeRemainingStandard badge | waste badge | workload Metric Name Alert Count Critical Alert Count Immediate Alert Count Info Alert Count Warning Anomaly Capacity Remaining Compliance Density Efficiency Fault Health Risk Stress Time Remaining - Planning, Cyclical Time Remaining - Real Time Waste Workload (%) Description Critical alert count. Immediate alert count. Information alert count. Warning alert count. Anomalies. Remaining capacity. Compliance score. Density score. Efficiency score. Fault score. Health score. Risk score. Stress score. Planning and cynclical time remaining. Real-time time remaining. Waste score. Percent workload.
VMware, Inc.
63
64
VMware, Inc.
The vCenter Operations adapter monitors vCenter Operations Manager. In vCenter Operations Manager 5.6 and later releases, the vCenter Operations adapter collects metrics for certain vCenter Operations Manager components. These self-monitoring metrics are useful for diagnosing problems with vCenter Operations Manager. This chapter includes the following topics:
n n n n n n n
Analytics Metrics, on page 65 Collector Metrics, on page 70 ActiveMQ Service Metrics, on page 71 Web Server Metrics, on page 72 Replication Server Metrics, on page 74 Database Metrics, on page 74 Host Operating System Metrics, on page 75
Analytics Metrics
The vCenter Operations adapter collects metrics for the vCenter Operations Manager Analytics service, including replication server, data receiver, threshold checker, alarm, alert, dynamic threshold, FSDB, database connection, and garbage collector metrics. Table 6-1. Analytics Metrics
Metric Key ConfiguredResources VCConfiguredResources ActiveAlarms ActiveAlerts FingerprintThreads resourceCacheLoadTime Metric Name Configured Resources VC Configured Resources Active Alarms Active Alerts Fingerprint Threads Resource Cache Load Time (ms) Description Configured resources. Configured vCenter resources. Active alarms. Active alerts. Fingerprint threads. Resource cache load time. Available only in 5.7 and later releases. Attribute cache load time. Available only in 5.7 and later releases. Current heap size.
attributeCacheLoadTime
CurrentHeapSize
VMware, Inc.
65
66
VMware, Inc.
Table 6-3. Metric Data Receiver Metrics for the Analytics Service
Metric Key metricDataReceiver | state Metric Name Metric Receiver State Description Metric data receiver state. 0 for connecting, 1 for waitForMQ, 2 for processMsg, 3 for waitForHiearchy, and 4 for waitForThresholdChecking. Time spent waiting for data from the message queue during the last collection interval. Time spent waiting for hierarchy metric threshold checking at a cycle end check point during the last collection interval. Time spent waiting for the outstanding threshold checking work item count to drop below the maximum allowed value during the last collection interval. Processed message count during the last collection interval. Processed message count rate during the last collection interval. Average message count rate. Storage thread pool size. Cycle computation time.
metricDataReceiver | waitForMQTime
metricDataReceiver | waitForHierarchyTime
metricDataReceiver | waitforThresholdCheckTime
metricDataReceiver | processedMessageCount metricDataReceiver | processedMessageCountRate metricDataReceiver | processedMessageCountRateAvg metricDataReceiver | storageThreadPoolSize metricDataReceiver | cycleCompTime
Processed Message Count Processed Message Count Rate Processed Message Count Rate Average Storage Thread Pool Size Cycle Computation Time (ms)
Alarm Metrics
These metrics are available only in 5.7 and later releases.
VMware, Inc.
67
alarm | canceledAlarmOpTime
Alert Metrics
These metrics are available only in 5.7 and later releases. Table 6-6. Alert Metrics for the Analytics Service
Metric Key alert | newAlertOpTime alert | newalertOpTimeAvg alert | newfingerPrintGenerationAlertCount alert | newFingerPrintGenerationAlertOpTime alert | canceledAlertOptime Metric Name New Alert Count Op Time (ms) New Alert Count Op Time Average (ms) New Finger Print Generation Alert Count New Finger Print Generation Alert Count Op Time (ms) New Canceled Alert Count Op Time (ms) Description New alert count during the last collection interval. Average time spent creating new alerts. New fingerprint alert count during the last collection interval. Time spent creating fingerprint alerts during the last collection interval. Time spent canceling alerts during the last collection interval.
DT Processor Count Resource Count FSDB Read Time (ms) DT Object Save Time (ms) DT History Save Time (ms)
68
VMware, Inc.
Table 6-7. Dynamic Threshold Metrics for the Analytics Service (Continued)
Metric Key dt | dtRunTime Metric Name DT Run Time (ms) Description Dynamic threshold run time. Available only in 5.7 and later releases. Cached object count since the start time of the current dynamic threshold run. Available only in 5.7 and later releases. Time spent calculating dynamic thresholds since the start of the current dynamic threshold run. Available only in 5.7 and later releases.
dt | cachedDTObjectCount
dt | dtCalcTime
FSDB Metrics
These metrics are available only in 5.7 and later releases. Table 6-8. FSDB Metrics for the Analytics Service
Metric Key fsdb | savedObservationCount fsdb | saveObservationOpTime Metric Name Saved Observation count Save Observation Op Time (ms) Description Saved observation count during the last collection interval. Time spent saving the observation count during the last collection interval. Average time spent saving the observation count.
fsdb | saveObservationOpTimeAvg
VMware, Inc.
69
Collector Metrics
The vCenter Operations adapter collects metrics for the vCenter Operations Manager Collector service, including collection statistic and garbage collector metrics. Table 6-11. Collector Metrics
Metric Key ThreadpoolThreadsCount CurrentHeapSize MaxHeapsize CommittedMemory FreePhysicalMemory UsedMemory CPUUsage Threads Metric Name Pool Threads Count Current heap size (MB) Max heap size (MB) Committed memory (MB) Free physical memory Used physical memory CPU usage (%) Threads Description Number of pool threads. Current heap size. Maximum heap size. Amount of committed memory. Free physical memory. Used physical memory. Percent CPU use. Number of threads.
70
VMware, Inc.
Queue Metrics
Table 6-15. Queue Metrics for the ActiveMQ Service
Metric Key Queues | MemoryPercentUsage Queues | MemoryLimit Queues | EnqueueCount Queues | DispatchCount Queues | DequeueCount Queues | ConsumerCount Queues | QueueSize Queues | CursorMemoryUsage Queues | CursorFull Metric Name Used Memory Percentage Memory Limit Enqueue Count Dispatch Count Dequeue Count Consumer Count Queue Size Cursor memory usage Cursor Full Description Percent used memory. Memory limit. Enqueue count. Dispatch count. Dequeue count. Consumer count. Queue size. Cursor memory use. If the cursor reached its memory limit for paged messages. Available only in 5.7 and later releases. Average amount of time, in milliseconds, that messages remained in the destination before being consumed. Available only in 5.7 and later releases. Number of producers connected to the destination. Available only in 5.7 and later releases.
Queues | AverageEnqueueTime
Queues | ProductCount
Producer Count
VMware, Inc.
71
Broker Metrics
Table 6-16. Broker Metrics for the ActiveMQ Service
Metric Key Broker | TotalEnqueueCount Broker | TotalDequeueCount Broker | TotalConsumerCount Broker | TotalMessageCount Broker | MemoryPercentUsage Broker | MemoryLimit Metric Name Total Enqueue Count Total Dequeue Count Total Consumers Count Total Messages Count Total used memory Total memory limit Description Total enqueue count. Total dequeue count. Total consumers count. Total messages count. Total used memory. Total memory limit.
Database Metrics
NOTE These metrics are available only in 5.7 and later releases. Table 6-17. Database Metrics for the ActiveMQ Service
Metric Key kahaDB | fileCount kahaDB | fileSize Metric Name File Count File Size (MB) Description Total kahaDB log file count. Total size of the log files in the /data/activemq/data/kahadb folder.
72
VMware, Inc.
globalRequest | processingtimeAvg
globalRequest | requestCountRateAvg
CIQ Metrics
These metrics are available only in 5.7 and later releases. Table 6-21. CIQ Metrics for the Web Server Component
Metric Key ciq | CiqPreCompTime Metric Name Pre Computation Time (ms) Description Time spent precomputing metrics in CIQ during the last collection interval. Time spent computing single-value metrics during the last collection interval.
ciq | CiqSingleVaueMetricCompTime
VMware, Inc.
73
Database Metrics
In a vApp installation, the vCenter Operations adapter collects metrics for the Postgres database instance. These metrics are available only in 5.7 and later releases. Table 6-25. Database Metrics
Metric Key postgres | memConsumption Metric Name Memory Consumption (KB) Description Memory that Postgres uses.
74
VMware, Inc.
Disk IO Metrics
Table 6-28. Disk IO Metrics
Metric Key diskIO | numberReadAvg diskIO | numberWriteAvg diskIO | readAvg diskIO | writeAvg Metric Name Reads per second Writes per second Read Rate (KBps) Write Rate (KBps) Description Number of read requests issued to the device per second. Number of write requests issued to the device per second. Number of kilobytes read from the device per second. Average time, in milliseconds, for IO requests issued to the device to be served. Includes the time requests spend in the queue and the time spent servicing the requests in the queue. Average time, in milliseconds, for IO requests to be served. Includes the time that requests spend in the queue and the time spent servicing the requests in the queue. Percentage of CPU time during which IO requests were issued to the device (bandwidth utilization for the device). Device saturation occurs when this value is close to 100 percent.
diskIO | await
diskIO | utilPercent
VMware, Inc.
75
76
VMware, Inc.
Index
A
ActiveMQ metrics 71 adapter instances 20 analytics metrics 65 audience information 5 auto-discovery 9
R
reducing metrics collected 20 Replication server metrics 74 requirements 10 resource identifiers 11 Resource Pool metrics 35
B
badge metrics 63 Balanced profile 20
S
self-monitoring metrics 65
T
troubleshooting steps 21
C
capacity planning metrics 59 Cluster Compute Resource metrics 30 collection states 22 collection status values 23 Collector metrics 70 configuration steps 19 credentials 19
U
updated information 7
V
vCenter Operations Manager metrics 65 vCenter Server metrics 25 vcenter_adapter3 folder 16 viewing collection information 21 Virtual Machine metrics 48 VM Entity status tag 10
D
data collection 9 Datacenter resource metrics 28 Datastore metrics 55
W
Web server metrics 72
H
host operating system metrics 75 Host System metrics 37
I
installing the adapter 15, 16 introduction 9
L
log files 23
M
manual discovery 9 metrics 25 metrics profiles 20
P
Postgres database metrics 74
VMware, Inc.
77
78
VMware, Inc.