Description
Check VMware API is a plugin developed by op5 to primarily be used with op5
Monitor, but can also be used in Naemon or Nagios installations, to monitor
VMware ESX and vSphere servers. You can monitor either a single ESX(i)/vSphere
server or a VMware VirtualCenter/vCenter Server and individual virtual
machines. If you have a VMware cluster you should monitor the data center
(VMware VirtualCenter/vCenter Server) and not the individual ESX/vSphere
servers.
Supports check status of ESX(i) server, vSphere 5.1 up to vSphere 6.5.
Check VMware API alternatives and similar tools
Based on the "Monitoring" category.
Alternatively, view Check VMware API alternatives based on common mentions on social networks and blogs.
-
-
-
-
-
-
-
Healthchecks
Open-source cron job and background task monitoring service, written in Python & Django -
-
Zabbix
Real-time monitoring of IT components and services, such as networks, servers, VMs, applications and the cloud. -
-
-
Vector
DISCONTINUED. Vector is an on-host performance monitoring framework which exposes hand picked high resolution metrics to every engineer’s browser. -
-
-
-
-
-
-
-
-
-
-
-
Statping-ng
An updated drop-in for statping. A Status Page for monitoring your websites and applications with beautiful graphs, analytics, and plugins. Run on any type of environment. -
-
-
-
-
Flapjack
DISCONTINUED. Monitoring notification routing + event processing system. For issues with the Flapjack packages, please see https://github.com/flapjack/omnibus-flapjack/ -
Thruk
Thruk is a multibackend monitoring webinterface for Naemon, Nagios, Icinga and Shinken using the Livestatus API. -
-
-
-
AS-Stats v1.6 (2014-09-12)
A simple tool to generate per-AS traffic graphs from NetFlow/sFlow records -
-
-
Centreon
Centreon is a network, system and application monitoring tool. Centreon is the only AIOps Platform Providing Holistic Visibility to Complex IT Workflows from Cloud to Edge. -
SWMP - Server Web Monitor Page
DISCONTINUED. A responsive, eye-pleasing Linux server statistics dashboard. -
-
-
-
-
Stream - Scalable APIs for Chat, Feeds, Moderation, & Video.
* Code Quality Rankings and insights are calculated and provided by Lumnify.
They vary from L1 to L5 with "L5" being the highest.
Do you think we are missing an alternative of Check VMware API or a related project?
README
This plugin is "Deprecated"
This plugin is deprecated and is unlikely to see any further development. The following fork might be of interest: https://github.com/BaldMansMojo/check_vmware_esx/
Welcome to check VMware API
Check VMware API is a plugin developed by op5 to primarily be used with op5 Monitor, but can also be used in Naemon or Nagios installations, to monitor VMware ESX and vSphere servers. You can monitor either a single ESX(i)/vSphere server or a VMware VirtualCenter/vCenter Server and individual virtual machines. If you have a VMware cluster you should monitor the data center (VMware VirtualCenter/vCenter Server) and not the individual ESX/vSphere servers.
Supports check status of ESX(i) server, vSphere 5.1 up to vSphere 6.5.
Supported features
The supported feature set will differ a bit between vSphere 5 and vSphere 6; please refer to the tables below for reference:
Checks supported for Hosts
| Check | vSphere 5 | vSphere 6 |
|---|---|---|
| CPU | Yes | Yes |
| IO | Yes | Yes |
| Memory | Yes | Yes |
| Network | Yes | Yes |
| Runtime | Yes | Partially: Overview*, Connection state, Health, Maintenance, Status, Storage Health |
| Service | Yes | Yes |
| Uptime | No | Yes |
| Storage | Yes | No |
- Specified in the plugin help text as "all", meaning that the sub command are omitted
Checks supported for Data centers
| Check | vSphere 5 | vSphere 6 |
|---|---|---|
| CPU | Yes | Yes |
| IO | Yes | Yes |
| Memory | Yes | Yes |
| Network | Partially: Overview*, Receive, Send, Usage | Partially: Receive, Send, Usage, Overview* |
| Runtime | Partially: Overview*, Issues, List, Listcluster, Listhost, Status, Tools | Partially: Overview*, List, Listcluster, Tools |
| VMFS | Partially: Overview* | Partially: Free space, Used space |
- Specified in the plugin help text as "all", meaning that the sub command are omitted
Prerequisites
'VMware vSphere SDK for Perl', available at https://code.vmware.com/web/sdk/65/vsphere-perl (requires a free account that you sign up for at the same page)
Installation
This is how to install the plugin on CentOS with VMware vSphere SDK for Perl 5.1.
- Download the latest version of the vSphere SDK for Perl package from VMware support page.
- In this example we use VMware-vSphere-Perl-SDK-5.1.0-780721.x86_64.tar.gz.
- Make sure the following packages are installed.
bash $ sudo yum install openssl-devel perl-Archive-Zip perl-Class-MethodMaker uuid-perl perl-SOAP-Lite perl-XML-SAX perl-XML-NamespaceSupport perl-XML-LibXML perl-MIME-Lite perl-MIME-Types perl-MailTools perl-TimeDate uuid libuuid perl-Data-Dump perl-UUID cpan libxml2-devel perl-libwww-perl perl-Test-MockObject perl-Test-Simple perl-Monitoring-Plugin perl-Class-Accessor perl-Config-Tiny - Upload the file "VMware-vSphere-Perl-SDK*.tar.gz" to your op5 Monitor server’s /root directory. ```bash $ cd /root/ $ tar xvzf VMware-vSphere-Perl-SDK-5.1.0-780721.x86_64.tar.gz $ cd vmware-vsphere-cli-distrib $ export ftp_proxy= $ export http_proxy= $ ./vmware-install.pl
"Creating a new vSphere CLI installer database using the tar4 format.
Installing vSphere CLI 5.1.0 build-780721 for Linux.
You must read and accept the vSphere CLI End User License Agreement to continue. Press enter to display it." "Do you accept? (yes/no)
- Type “yes” and press "enter".
- In which directory do you want to install the executable files?
```bash
[/usr/bin]
- Press Enter ```bash Please wait while copying vSphere CLI files...
The installation of vSphere CLI 5.1.0 build-780721 for Linux completed successfully. You can decide to remove this software from your system at any time by invoking the following command: "/usr/bin/vmware-uninstall-vSphere-CLI.pl".
This installer has successfully installed both vSphere CLI and the vSphere SDK for Perl. The following Perl modules were found on the system but may be too old to work with vSphere CLI: Compress::Zlib 2.037 or newer Compress::Raw::Zlib 2.037 or newer version 0.78 or newer IO::Compress::Base 2.037 or newer IO::Compress::Zlib::Constants 2.037 or newer LWP::Protocol::https 5.805 or newer Enjoy, --the VMware team root@op5-system:~/vmware-vsphere-cli-distrib#
- Note that the the issues with old Perl modules DOES NOT need to be resolved.
This does not impact the plugins functionality.
- Now, clone or download this repository.
- Within the check_vmware_api repository, type `make` to run the test suit.
- Copy the check_vmware_api.pl to a suitable location and make sure it is
exicutable. Will vary between installations.
```bash
$ cp check_vmware_api.pl /opt/plugins/check_vmware_api
$ cd /opt/plugins/
$ chmod 755 check_vmware_api
Usage
Simply run the plugin with:
$ /opt/plugins/check_vmware_api --help
Documentation
- Read the OP5 Monitoring VMware ESX, ESXi, vSphere and vCenter Server (for OP5 Monitor) documentation
Get involved - Contribute to the Check VMware API project
It is easy to get involved in the project and to contribute!
- Start using the plugin and if you like what you see, help by spreading the word on blogs and forums.
- If you find a bug you can create a bug report in the issue tracker here on GitHub. ### Testing
- Unit tests: This plugin is huge and hard to unit test but if pull requests with unit tests are greatly appreciated.
- Integration tests: This plugin is equipped with an option of generating tests (--generate_test). Simply run the plugin with this flag appended at the end of your command followed by a filename with the following format:
___.dat For example: host_runtime_maintenance_maintwarn.dat So running the plugin from command line with the following will generate the integration test: $ ./check_vmware_api -u -p -H -l runtime -s maintenance -o maintwarn --generate_test host_runtime_maintenance_maintwarn.dat You can omit subcommand and/or option from the command and reflect that in the file name. To run all the tests simply run 'make'.
License
See LICENSE.
*Note that all licence references and agreements mentioned in the Check VMware API README section above
are relevant to that project's source code only.