Table of Contents
1 VMware monitoring item keys
Item keys
The table provides details on the simple checks that can be used to monitor VMware environments.
| Key | ||||
|---|---|---|---|---|
| Description | Return value | Parameters | Comments | |
| vmware.cluster.discovery[<url>] | ||||
| Discovery of VMware clusters. | JSON object | url - VMware service URL | ||
| vmware.cluster.status[<url>, <name>] | ||||
| VMware cluster status. | Integer: 0 - gray; 1 - green; 2 - yellow; 3 - red |
url - VMware service URL name - VMware cluster name |
||
| vmware.eventlog[<url>] | ||||
| VMware event log. | Log | url - VMware service URL | ||
| vmware.fullname[<url>] | ||||
| VMware service full name. | String | url - VMware service URL | ||
| vmware.hv.cluster.name[<url>,<uuid>] | ||||
| VMware hypervisor cluster name. | String | url - VMware service URL uuid - VMware hypervisor host name |
||
| vmware.hv.cpu.usage[<url>,<uuid>] | ||||
| VMware hypervisor processor usage (Hz). | Integer | url - VMware service URL uuid - VMware hypervisor host name |
||
| vmware.hv.datastore.discovery[<url>,<uuid>] | ||||
| Discovery of VMware hypervisor datastores. | JSON object | url - VMware service URL uuid - VMware hypervisor host name |
||
| vmware.hv.datastore.read[<url>,<uuid>,<datastore>,<mode>] | ||||
| Average amount of time for a read operation from the datastore (milliseconds). | Integer 2 | url - VMware service URL uuid - VMware hypervisor host name datastore - datastore name mode - latency (default) |
||
| vmware.hv.datastore.write[<url>,<uuid>,<datastore>,<mode>] | ||||
| Average amount of time for a write operation to the datastore (milliseconds). | Integer 2 | url - VMware service URL uuid - VMware hypervisor host name datastore - datastore name mode - latency (default) |
||
| vmware.hv.discovery[<url>] | ||||
| Discovery of VMware hypervisors. | JSON object | url - VMware service URL | ||
| vmware.hv.fullname[<url>,<uuid>] | ||||
| VMware hypervisor name. | String | url - VMware service URL uuid - VMware hypervisor host name |
||
| vmware.hv.hw.cpu.freq[<url>,<uuid>] | ||||
| VMware hypervisor processor frequency (Hz). | Integer | url - VMware service URL uuid - VMware hypervisor host name |
||
| vmware.hv.hw.cpu.model[<url>,<uuid>] | ||||
| VMware hypervisor processor model. | String | url - VMware service URL uuid - VMware hypervisor host name |
||
| vmware.hv.hw.cpu.num[<url>,<uuid>] | ||||
| Number of processor cores on VMware hypervisor. | Integer | url - VMware service URL uuid - VMware hypervisor host name |
||
| vmware.hv.hw.cpu.threads[<url>,<uuid>] | ||||
| Number of processor threads on VMware hypervisor. | Integer | url - VMware service URL uuid - VMware hypervisor host name |
||
| vmware.hv.hw.memory[<url>,<uuid>] | ||||
| VMware hypervisor total memory size (bytes). | Integer | url - VMware service URL uuid - VMware hypervisor host name |
||
| vmware.hv.hw.model[<url>,<uuid>] | ||||
| VMware hypervisor model. | String | url - VMware service URL uuid - VMware hypervisor host name |
||
| vmware.hv.hw.uuid[<url>,<uuid>] | ||||
| VMware hypervisor BIOS UUID. | String | url - VMware service URL uuid - VMware hypervisor host name |
||
| vmware.hv.hw.vendor[<url>,<uuid>] | ||||
| VMware hypervisor vendor name. | String | url - VMware service URL uuid - VMware hypervisor host name |
||
| vmware.hv.memory.size.ballooned[<url>,<uuid>] | ||||
| VMware hypervisor ballooned memory size (bytes). | Integer | url - VMware service URL uuid - VMware hypervisor host name |
||
| vmware.hv.memory.used[<url>,<uuid>] | ||||
| VMware hypervisor used memory size (bytes). | Integer | url - VMware service URL uuid - VMware hypervisor host name |
||
| vmware.hv.network.in[<url>,<uuid>,<mode>] | ||||
| VMware hypervisor network input statistics (bytes per second). | Integer 2 | url - VMware service URL uuid - VMware hypervisor host name mode - bps (default) |
Starting with Zabbix 2.4.4 bps mode value is correctly reported in bytes per second instead of kilobytes per second as it was before. | |
| vmware.hv.network.out[<url>,<uuid>,<mode>] | ||||
| VMware hypervisor network output statistics (bytes per second). | Integer 2 | url - VMware service URL uuid - VMware hypervisor host name mode - bps (default) |
Starting with Zabbix 2.4.4 bps mode value is correctly reported in bytes per second instead of kilobytes per second as it was before. | |
| vmware.hv.perfcounter[<url>,<uuid>,<path>,<instance>] | ||||
| VMware hypervisor performance counter value. | Integer 2 | url - VMware service URL uuid - VMware hypervisor host name path - performance counter path 1 instance - performance counter instance. Use empty instance for aggregate values (default) |
Available since Zabbix versions 2.2.9, 2.4.4 | |
| vmware.hv.status[<url>,<uuid>] | ||||
| VMware hypervisor status. | Integer: 0 - gray; 1 - green; 2 - yellow; 3 - red |
url - VMware service URL uuid - VMware hypervisor host name |
||
| vmware.hv.uptime[<url>,<uuid>] | ||||
| VMware hypervisor uptime (seconds). | Integer | url - VMware service URL uuid - VMware hypervisor host name |
||
| vmware.hv.version[<url>,<uuid>] | ||||
| VMware hypervisor version. | String | url - VMware service URL uuid - VMware hypervisor host name |
||
| vmware.hv.vm.num[<url>,<uuid>] | ||||
| Number of virtual machines on VMware hypervisor. | Integer | url - VMware service URL uuid - VMware hypervisor host name |
||
| vmware.version[<url>] | ||||
| VMware service version. | String | url - VMware service URL | ||
| vmware.vm.cluster.name[<url>,<uuid>] | ||||
| VMware virtual machine name. | String | url - VMware service URL uuid - VMware virtual machine host name |
||
| vmware.vm.cpu.num[<url>,<uuid>] | ||||
| Number of processors on VMware virtual machine. | Integer | url - VMware service URL uuid - VMware virtual machine host name |
||
| vmware.vm.cpu.usage[<url>,<uuid>] | ||||
| VMware virtual machine processor usage (Hz). | Integer | url - VMware service URL uuid - VMware virtual machine host name |
||
| vmware.vm.discovery[<url>] | ||||
| Discovery of VMware virtual machines. | JSON object | url - VMware service URL | ||
| vmware.vm.hv.name[<url>,<uuid>] | ||||
| VMware virtual machine hypervisor name. | String | url - VMware service URL uuid - VMware virtual machine host name |
||
| vmware.vm.memory.size[<url>,<uuid>] | ||||
| VMware virtual machine total memory size (bytes). | Integer | url - VMware service URL uuid - VMware virtual machine host name |
||
| vmware.vm.memory.size.ballooned[<url>,<uuid>] | ||||
| VMware virtual machine ballooned memory size (bytes). | Integer | url - VMware service URL uuid - VMware virtual machine host name |
||
| vmware.vm.memory.size.compressed[<url>,<uuid>] | ||||
| VMware virtual machine compressed memory size (bytes). | Integer | url - VMware service URL uuid - VMware virtual machine host name |
||
| vmware.vm.memory.size.private[<url>,<uuid>] | ||||
| VMware virtual machine private memory size (bytes). | Integer | url - VMware service URL uuid - VMware virtual machine host name |
||
| vmware.vm.memory.size.shared[<url>,<uuid>] | ||||
| VMware virtual machine shared memory size (bytes). | Integer | url - VMware service URL uuid - VMware virtual machine host name |
||
| vmware.vm.memory.size.swapped[<url>,<uuid>] | ||||
| VMware virtual machine swapped memory size (bytes). | Integer | url - VMware service URL uuid - VMware virtual machine host name |
||
| vmware.vm.memory.size.usage.guest[<url>,<uuid>] | ||||
| VMware virtual machine guest memory usage (bytes). | Integer | url - VMware service URL uuid - VMware virtual machine host name |
||
| vmware.vm.memory.size.usage.host[<url>,<uuid>] | ||||
| VMware virtual machine host memory usage (bytes). | Integer | url - VMware service URL uuid - VMware virtual machine host name |
||
| vmware.vm.net.if.discovery[<url>,<uuid>] | ||||
| Discovery of VMware virtual machine network interfaces. | JSON object | url - VMware service URL uuid - VMware virtual machine host name |
||
| vmware.vm.net.if.in[<url>,<uuid>,<instance>,<mode>] | ||||
| VMware virtual machine network interface input statistics (bytes/packets per second). | Integer 2 | url - VMware service URL uuid - VMware virtual machine host name instance - network interface instance mode - bps (default)/pps - bytes/packets per second |
Starting with Zabbix 2.4.4 bps mode value is correctly reported in bytes per second instead of kilobytes per second as it was before. | |
| vmware.vm.net.if.out[<url>,<uuid>,<instance>,<mode>] | ||||
| VMware virtual machine network interface output statistics (bytes/packets per second). | Integer 2 | url - VMware service URL uuid - VMware virtual machine host name instance - network interface instance mode - bps (default)/pps - bytes/packets per second |
Starting with Zabbix 2.4.4 bps mode value is correctly reported in bytes per second instead of kilobytes per second as it was before. | |
| vmware.vm.perfcounter[<url>,<uuid>,<path>,<instance>] | ||||
| VMware virtual machine performance counter value. | Integer 2 | url - VMware service URL uuid - VMware virtual machine host name path - performance counter path 1 instance - performance counter instance. Use empty instance for aggregate values (default) |
Available since Zabbix versions 2.2.9, 2.4.4 | |
| vmware.vm.powerstate[<url>,<uuid>] | ||||
| VMware virtual machine power state. | Integer: 0 - poweredOff; 1 - poweredOn; 2 - suspended |
url - VMware service URL uuid - VMware virtual machine host name |
||
| vmware.vm.storage.committed[<url>,<uuid>] | ||||
| VMware virtual machine committed storage space (bytes). | Integer | url - VMware service URL uuid - VMware virtual machine host name |
||
| vmware.vm.storage.uncommitted[<url>,<uuid>] | ||||
| VMware virtual machine uncommitted storage space (bytes). | Integer | url - VMware service URL uuid - VMware virtual machine host name |
||
| vmware.vm.storage.unshared[<url>,<uuid>] | ||||
| VMware virtual machine unshared storage space (bytes). | Integer | url - VMware service URL uuid - VMware virtual machine host name |
||
| vmware.vm.uptime[<url>,<uuid>] | ||||
| VMware virtual machine uptime (seconds). | Integer | url - VMware service URL uuid - VMware virtual machine host name |
||
| vmware.vm.vfs.dev.discovery[<url>,<uuid>] | ||||
| Discovery of VMware virtual machine disk devices. | JSON object | url - VMware service URL uuid - VMware virtual machine host name |
||
| vmware.vm.vfs.dev.read[<url>,<uuid>,<instance>,<mode>] | ||||
| VMware virtual machine disk device read statistics (bytes/operations per second). | Integer 2 | url - VMware service URL uuid - VMware virtual machine host name instance - disk device instance mode - bps (default)/ops - bytes/operations per second |
Starting with Zabbix 2.4.4 bps mode value is correctly reported in bytes per second instead of kilobytes per second as it was before. | |
| vmware.vm.vfs.dev.write[<url>,<uuid>,<instance>,<mode>] | ||||
| VMware virtual machine disk device write statistics (bytes/operations per second). | Integer 2 | url - VMware service URL uuid - VMware virtual machine host name instance - disk device instance mode - bps (default)/ops - bytes/operations per second |
Starting with Zabbix 2.4.4 bps mode value is correctly reported in bytes per second instead of kilobytes per second as it was before. | |
| vmware.vm.vfs.fs.discovery[<url>,<uuid>] | ||||
| Discovery of VMware virtual machine file systems. | JSON object | url - VMware service URL uuid - VMware virtual machine host name |
VMware Tools must be installed on the guest virtual machine. | |
| vmware.vm.vfs.fs.size[<url>,<uuid>,<fsname>,<mode>] | ||||
| VMware virtual machine file system statistics (bytes/percentages). | Integer | url - VMware service URL uuid - VMware virtual machine host name fsname - file system name mode - total/free/used/pfree/pused |
VMware Tools must be installed on the guest virtual machine. | |
Footnotes
1 The VMware performance counter path has the group/counter[rollup] format where:
group- the performance counter group, for example cpucounter- the performance counter name, for example usagemhzrollup- the peformance counter rollup type, for example average
So the above example would give the following counter path: cpu/usagemhz[average]
The performance counter group descriptions, counter names and rollup types can be found in VMware documentation.
2 Since Zabbix 2.4.4, the value of these items is obtained from VMware performance counters and the VMwarePerfFrequency parameter is used to refresh their data in Zabbix VMware cache:
- vmware.hv.datastore.read
- vmware.hv.datastore.write
- vmware.hv.network.in
- vmware.hv.network.out
- vmware.hv.perfcounter
- vmware.vm.net.if.in
- vmware.vm.net.if.out
- vmware.vm.perfcounter
- vmware.vm.vfs.dev.read
- vmware.vm.vfs.dev.write
More info
See Virtual machine monitoring for detailed information how to configure Zabbix to monitor VMware environments.