VMWare ESX guest status checks

VMWare_ESX_guest_status_checks

These checks are written in perl and use snmp (via perl Net::SNMP module) to query the VMWare ESX server for different aspects of the guest OS's.
These plugins were developed by Altinity as part of Opsview software (http://www.opsview.org). Plugin development was sponsored by GotVMail (http://www.gotvmail.com).

Usage check_snmp_vmware_cpu

Checks the CPU usage on a VMware ESX host


./Usage check_snmp_vmware_cpu.pl -H < hostname > -C < community > [...]

Options

Flag Description
-H Hostname or IP address
-C SNMP community string
-t SNMP timeout (in seconds)
-w Warning threshold for CPU usage (%)
-c Critical threshold for CPU usage (%)
-v Report CPU usage of this VM only

Note

This plugin returns the CPU usage of one VM, or all VMs on the specified ESX host.

Usage check_snmp_vmware_gueststatus

Checks the power and OS status of guest VMs


 ./check_snmp_vmware_gueststatus.pl -H < hostname > -C < community > [...]

Options

Flag Description
-H Hostname or IP address
-C SNMP community string
-t SNMP timeout (in seconds)
-n Guest name to check state for. If you omit this option, the check will provide a summary instead.
-p Check power switch state, not OS state
-w Warning threshold for VMs powered on
-c Critical threshold for VMs powered on
-x Warning threshold for VMs running
-d Critical threshold for VMs running

Note

'Powered on' refers to the power 'switch' state in VMware 'Running' refers to the OS (VMware tools) state

Usage check_snmp_vmware_memory

Checks the memory usage of a VMware ESX host


./check_snmp_vmware_memory.pl -H < hostname > -C < community > [...]

Options

Flag Description
-H Hostname or IP address
-C SNMP community string
-t SNMP timeout (in seconds)
-w Warning threshold for free memory (MB)
-c Critical threshold for free memory (MB)
-a Report the total VM memory allocation, rather than actual memory utilization as reported by VMware (due to transparent page sharing)
-v Report memory usage of this VM only
-p Return performance data in percent

Note

This plugin returns the total memory used allocated to all virtual machines, including the service console.

Usage check_snmp_vmware_netio

Reports the network throughput on a specified VMware interface


./check_snmp_vmware_netio.pl -H < hostname > -C < community > [-t < timeout >] ...

Options

Flag Description
-H Hostname or IP address
-C SNMP community string
-t SNMP timeout (in seconds)
-v VM name (alternatively, specify MAC)
-m MAC address
-w Warning threshold (KB/sec)
-c Critical threshold (KB/sec)

Note

Using the VM name is fine when you only have one interface on that VM, but you should use the MAC address otherwise.

Usage check_snmp_vmware_vmkernel

Checks whether or not the ESX VM Kernel is loaded


check_snmp_vmware_vmkernel.pl -H < hostname > -c < community > [-t < timeout >]

Options

Flag Description
-H Hostname or IP address
-C SNMP community string
-t SNMP timeout (in seconds)