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) |