References > Component Monitor Types > VMware Performance Counter monitor

VMware Performance Counter monitor

The VMware Performance Counter monitor reads VMware performance counter data using the VMware vSphere Web Services API.

The currently used vSphere Web Services API version is 4.0, which supports vSphere 4.0 servers and also is compatible with previous releases of ESX/ESXi and VirtualCenter Server, including the following:

  • ESX/ESXi 3.5.x or later
  • VirtualCenter Server 2.5 and VirtualCenter Server 2.0.x.
  • The vSphere Web Services SDK package includes WSDL files for vSphere API 4.0, which is a superset of API versions starting with API 2.5, and for VI API 2.0.

Statistic

The statistic for this component monitor is the value of the performance counter data retrieved by the VMware API.

Optionally, the statistic may be set as the difference in retrieved values between polling cycles by checking the option for Count statistic as difference.

The Count statistic as difference option is applicable only for monitors whose counter value increases consistently during each polling interval. Examples of when this option is not applicable include cases such as the following:

  • Counter values sometimes increase and sometimes decrease from one polling interval to another (typical behavior for many counters)
  • Counter values consistently decrease from one polling interval to another

In these cases where the option is not applicable, negative statistic data values will be replaced with zero (0), and the counter monitor will show 0 as the statistic data value in resources and 0 as the value on statistic data charts for this interval.

Field Description

Description

This field provides a default description of the monitor. You have the ability to override the default description by adding to or replacing the text, which will then be automatically saved. The variable to access this field is ${UserDescription}.

Component Type

Identifies the component type as a VMware Performance Counter Monitor.

Enable Component

Determines whether the component is enabled. Disabling the component leaves it in the application in a deactivated state not influencing either SolarWinds SAM application availability or status.

Credential for Monitoring

Select a VMware credential that can access the VMware API. This is typically a vCenter/ESX Server administrator-level credential. If the credential you need is not already present in the credentials list, use the Quick Credentials section to add a new credential.

Read-Only credentials are sufficient since VMware objects are accessed solely in read-only mode.

Port Number

Port number to use for VMware API. The default is 443.

Url

URL to use for connecting to the VMware API.

Count Statistic as Difference

Changes the statistic to be the difference in query values between polling cycles.

Entity Type

Select one of the following:

Cluster Compute Resource - Only applicable if you are monitoring VirtualCenter Server – Data object that aggregates the computation resources of its associated Host System objects into one single computation resource for use by virtual machines. The cluster services such as HA (High Availability), DRS (Distributed Resource Scheduling), and EVC (Enhanced vMotion Compatibility), enhance the usefulness of this single computation resource. This Entity Type is specific to vCenter systems.

Host System – Managed object type that provides access to a virtualization host platform.

  • Resource Pool – Represents a set of physical resources which may be a single host, a subset of a host's resources, or resources spanning multiple hosts. You can subdivide Resource pools by creating child resource pools. In order to run, a virtual machine must be associated as a child of a resource pool. In a parent/child hierarchy of resource pools and virtual machines, the root resource pool is the single resource pool that has no parent pool.
  • Virtual Machine – Managed object type for manipulating virtual machines, including templates that can be repeatedly deployed as new virtual machines. This object type provides methods for configuring and controlling a virtual machine.

Entity Name

Specifies the VMware entity name to monitor, for example VirtualMachine1. For VMs, you can view these values using the VMware console.

This field may contain the special ${VMWARE_ENTITY_NAME} variable. When the monitor runs, this variable will be resolved to the first available entity on a target host with the desired Entity Type (for example, the first Host System).

Group

Specifies the VMware group to which the counter belongs, for example: CPU, memory, and so forth.

Counter

Specifies the VMware counter to fetch, for example: coreUtilization, and so forth.

Click Component Monitor Wizard on the SAM Settings page to browse the counters available for monitoring, including their groups, rollup types, and instance names. Then select one of the following component monitor types, depending on what you want to monitor:

  • VMware ESX Performance Counter Monitor – monitors performance counters for ESX servers
  • VMware vCenter Performance Counter Monitor – monitors performance counters for vCenter servers

Rollup Type

Specifies the way to roll up the VMware counter data, for example: average, latest, summation, and so forth.

Instance

Specifies the instance to be fetched, for example: 0, 1, 2, and so forth.

Convert Value

Checking the Convert Value check box opens the Formula box. From here, you have the ability to manipulate the returned value with a variety of mathematical possibilities. You can choose common functions from the drop down lists to manipulate the returned value, or you can select the Custom Conversion option.

Statistic Threshold

This field allows you to specify when a threshold that indicates a warning or critical level has been breached. Logical operators are in the drop down followed by a blank field for you to enter the value of this threshold. For example: Less than 15 for warning, Less than 5 for critical.

User Notes

This field allows you to add notes for easy reference. You can access this field by using the variable, ${UserNotes}.