check_vmware_api

please use this fork, very cool!

https://github.com/BaldMansMojo/check_vmware_esx/

plugin does not exist. op5.org not found.

I found this api was timing out.
My College Rod Zadeh fixed it for us.
/dev/random was not returning results on my VM.
Fix:
"
In a nutshell not enough entropy to create a client hash for an outbound SSL connection to the VMWare server. The Net::SSL library accesses /dev/random to get a random number to generate the hash. It should probably use /dev/urandom as this is running on a VM. To fix this I did:

yum install rng-tools
systemctl enable rngd.service
systemctl start rngd.service

~Rod

"

Hi
Please help me out to collect used reservation of CPU and Memory cluster specific... if possible.

Hi I have modified the script to enable it to monitor cluster nodes using the Datacenter (vcenter) because it was restricted to access directly to each node.

The new code is:

#!/usr/bin/perl -w
#
# Nagios plugin to monitor VMware ESX and vSphere servers
#
# License: GPL
# Copyright (c) 2008-2013 op5 AB
# Author: Kostyantyn Hushchyn and op5
#
# Contributors:
#
# Patrick Müller, Jeremy Martin, Eric Jonsson, stumpr,
# John Cavanaugh, Libor Klepac, maikmayers, Steffen Poulsen,
# Mark Elliott, simeg, sebastien.prudhomme, Raphael Schitz,
# Mattias Bergsten
#
# For direct contact with any of the op5 developers, send an email to
# op5-users@lists.op5.com
#
# Discussions are directed to the mailing list op5-users@lists.op5.com,
# see http://lists.op5.com/mailman/listinfo/op5-users
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License version 2 as
# published by the Free Software Foundation.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program. If not, see .
#

package CheckVMwareAPI;
use strict;
use warnings;
use vars qw($PROGNAME $VERSION $output $values $result $defperfargs);
use Monitoring::Plugin::Functions qw(%STATUS_TEXT);
use Monitoring::Plugin;
use File::Basename;
use HTTP::Date;
use Data::Dumper qw(Dumper);
use Net::SSL;
my $perl_module_instructions="
Download the latest version of the vSphere SDK for Perl from VMware.
In this example we use VMware-vSphere-Perl-SDK-5.1.0-780721.x86_64.tar.gz,
but the instructions should apply to other versions as well.

You may need to install additional packages and Perl modules on your server,
see https://kb.op5.com/x/pYEK for
more information and package names for op5 APS / CentOS 6 / RHEL 6.

Upload the .tar.gz file to your op5 Monitor server's /root dir and execute:

cd /root
tar xvzf VMware-vSphere-Perl-SDK-5.1.0-780721.x86_64.tar.gz
cd vmware-vsphere-cli-distrib/
./vmware-install.pl

Follow the on screen instructions, described below:

\"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.\"



\"Read through the License Agreement\"
\"Do you accept? (yes/no)

yes

\"In which directory do you want to install the executable files? [/usr/bin]\"



\"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\"

Note: None of the Perl modules mentioned as \"may be too old\" are needed for check_vmware_api to work.
";

sub main {
$PROGNAME = basename($0);
$VERSION = '0.7.1';

my $np = Monitoring::Plugin->new(
usage => "Usage: %s -D | -H [ -C ] [ -N ] [ -n ]\n"
. " -u -p | -f \n"
. " -l [ -s ] [ -T ] [ -i ]\n"
. " [ -x ] [ -o ]\n"
. " [ -t ] [ -w ] [ -c ]\n"
. ' [ -V ] [ -h ]',
version => $VERSION,
plugin => $PROGNAME,
shortname => uc($PROGNAME),
blurb => 'VMware ESX/vSphere plugin',
extra => "Supported commands(^ - blank or not specified parameter, o - options, T - timeshift value, b - blacklist) :\n"
. " VM specific :\n"
. " * cpu - shows cpu info\n"
. " + usage - CPU usage in percentage\n"
. " + usagemhz - CPU usage in MHz\n"
. " + wait - CPU wait time in ms\n"
. " + ready - CPU ready time in ms\n"
. " ^ all cpu info(no thresholds)\n"
. " * mem - shows mem info\n"
. " + usage - mem usage in percentage\n"
. " + usagemb - mem usage in MB\n"
. " + swap - swap mem usage in MB\n"
. " + swapin - swapin mem usage in MB\n"
. " + swapout - swapout mem usage in MB\n"
. " + overhead - additional mem used by VM Server in MB\n"
. " + overall - overall mem used by VM Server in MB\n"
. " + active - active mem usage in MB\n"
. " + memctl - mem used by VM memory control driver(vmmemctl) that controls ballooning\n"
. " ^ all mem info(except overall and no thresholds)\n"
. " * net - shows net info\n"
. " + usage - overall network usage in KBps(Kilobytes per Second)\n"
. " + receive - receive in KBps(Kilobytes per Second)\n"
. " + send - send in KBps(Kilobytes per Second)\n"
. " ^ all net info(except usage and no thresholds)\n"
. " * io - shows disk I/O info\n"
. " + usage - overall disk usage in MB/s\n"
. " + read - read disk usage in MB/s\n"
. " + write - write disk usage in MB/s\n"
. " ^ all disk io info(no thresholds)\n"
. " * runtime - shows runtime info\n"
. " + con - connection state\n"
. " + cpu - allocated CPU in MHz\n"
. " + mem - allocated mem in MB\n"
. " + state - virtual machine state (UP, DOWN, SUSPENDED)\n"
. " + status - overall object status (gray/green/red/yellow)\n"
. " + consoleconnections - console connections to VM\n"
. " + guest - guest OS status, needs VMware Tools\n"
. " + tools - VMware Tools status\n"
. " + issues - all issues for the host\n"
. " ^ all runtime info(except con and no thresholds)\n"
. " Host specific :\n"
. " * cpu - shows cpu info\n"
. " + usage - CPU usage in percentage\n"
. " o quickstats - switch for query either PerfCounter values or Runtime info\n"
. " + usagemhz - CPU usage in MHz\n"
. " o quickstats - switch for query either PerfCounter values or Runtime info\n"
. " ^ all cpu info\n"
. " o quickstats - switch for query either PerfCounter values or Runtime info\n"
. " * mem - shows mem info\n"
. " + usage - mem usage in percentage\n"
. " o quickstats - switch for query either PerfCounter values or Runtime info\n"
. " + usagemb - mem usage in MB\n"
. " o quickstats - switch for query either PerfCounter values or Runtime info\n"
. " + swap - swap mem usage in MB\n"
. " o listvm - turn on/off output list of swapping VM's\n"
. " + overhead - additional mem used by VM Server in MB\n"
. " + overall - overall mem used by VM Server in MB\n"
. " + memctl - mem used by VM memory control driver(vmmemctl) that controls ballooning\n"
. " o listvm - turn on/off output list of ballooning VM's\n"
. " ^ all mem info(except overall and no thresholds)\n"
. " * net - shows net info\n"
. " + usage - overall network usage in KBps(Kilobytes per Second)\n"
. " + receive - receive in KBps(Kilobytes per Second)\n"
. " + send - send in KBps(Kilobytes per Second)\n"
. " + nic - makes sure all active NICs are plugged in\n"
. " ^ all net info(except usage and no thresholds)\n"
. " * io - shows disk io info\n"
. " + aborted - aborted commands count\n"
. " + resets - bus resets count\n"
. " + read - read latency in ms (totalReadLatency.average)\n"
. " + write - write latency in ms (totalWriteLatency.average)\n"
. " + kernel - kernel latency in ms\n"
. " + device - device latency in ms\n"
. " + queue - queue latency in ms\n"
. " ^ all disk io info\n"
. " * vmfs - shows Datastore info\n"
. " + (name) - free space info for datastore with name (name)\n"
. " o used - output used space instead of free\n"
. " o brief - list only alerting volumes\n"
. " o regexp - whether to treat name as regexp\n"
. " o blacklistregexp - whether to treat blacklist as regexp\n"
. " b - blacklist VMFS's\n"
. " T (value) - timeshift to detemine if we need to refresh\n"
. " ^ all datastore info\n"
. " o used - output used space instead of free\n"
. " o brief - list only alerting volumes\n"
. " o blacklistregexp - whether to treat blacklist as regexp\n"
. " b - blacklist VMFS's\n"
. " T (value) - timeshift to detemine if we need to refresh\n"
. " * runtime - shows runtime info\n"
. " + con - connection state\n"
. " + health - checks cpu/storage/memory/sensor status and propagates worst state\n"
. " o listitems - list all available sensors(use for listing purpose only)\n"
. " o blackregexpflag - whether to treat blacklist as regexp\n"
. " b - blacklist status objects\n"
. " + storagehealth - storage status check\n"
. " o blackregexpflag - whether to treat blacklist as regexp\n"
. " b - blacklist status objects\n"
. " + temperature - temperature sensors\n"
. " o blackregexpflag - whether to treat blacklist as regexp\n"
. " b - blacklist status objects\n"
. " + sensor - threshold specified sensor\n"
. " + maintenance - shows whether host is in maintenance mode\n"
. " o maintwarn - sets warning state when host is in maintenance mode\n"
. " o maintcrit - sets critical state when host is in maintenance mode\n"
. " + list(vm) - list of VMware machines and their statuses\n"
. " + status - overall object status (gray/green/red/yellow)\n"
. " + issues - all issues for the host\n"
. " b - blacklist issues\n"
. " ^ all runtime info(health, storagehealth, temperature and sensor are represented as one value and no thresholds)\n"
. " * service - shows Host service info\n"
. " + (names) - check the state of one or several services specified by (names), syntax for (names):,,...,\n"
. " ^ show all services\n"
. " * storage - shows Host storage info\n"
. " + adapter - list bus adapters\n"
. " b - blacklist adapters\n"
. " + lun - list SCSI logical units\n"
. " b - blacklist LUN's\n"
. " + path - list logical unit paths\n"
. " b - blacklist paths\n"
. " ^ show all storage info\n"
. " * uptime - shows Host uptime\n"
. " o quickstats - switch for query either PerfCounter values or Runtime info\n"
. " * device - shows Host specific device info\n"
. " + cd/dvd - list vm's with attached cd/dvd drives\n"
. " o listall - list all available devices(use for listing purpose only)\n"
. " DC specific :\n"
. " * cpu - shows cpu info\n"
. " + usage - CPU usage in percentage\n"
. " o quickstats - switch for query either PerfCounter values or Runtime info\n"
. " + usagemhz - CPU usage in MHz\n"
. " o quickstats - switch for query either PerfCounter values or Runtime info\n"
. " ^ all cpu info\n"
. " o quickstats - switch for query either PerfCounter values or Runtime info\n"
. " * mem - shows mem info\n"
. " + usage - mem usage in percentage\n"
. " o quickstats - switch for query either PerfCounter values or Runtime info\n"
. " + usagemb - mem usage in MB\n"
. " o quickstats - switch for query either PerfCounter values or Runtime info\n"
. " + swap - swap mem usage in MB\n"
. " + overhead - additional mem used by VM Server in MB\n"
. " + overall - overall mem used by VM Server in MB\n"
. " + memctl - mem used by VM memory control driver(vmmemctl) that controls ballooning\n"
. " ^ all mem info(except overall and no thresholds)\n"
. " * net - shows net info\n"
. " + usage - overall network usage in KBps(Kilobytes per Second)\n"
. " + receive - receive in KBps(Kilobytes per Second)\n"
. " + send - send in KBps(Kilobytes per Second)\n"
. " ^ all net info(except usage and no thresholds)\n"
. " * io - shows disk io info\n"
. " + aborted - aborted commands count\n"
. " + resets - bus resets count\n"
. " + read - read latency in ms (totalReadLatency.average)\n"
. " + write - write latency in ms (totalWriteLatency.average)\n"
. " + kernel - kernel latency in ms\n"
. " + device - device latency in ms\n"
. " + queue - queue latency in ms\n"
. " ^ all disk io info\n"
. " * vmfs - shows Datastore info\n"
. " + (name) - free space info for datastore with name (name)\n"
. " o used - output used space instead of free\n"
. " o brief - list only alerting volumes\n"
. " o regexp - whether to treat name as regexp\n"
. " o blacklistregexp - whether to treat blacklist as regexp\n"
. " b - blacklist VMFS's\n"
. " T (value) - timeshift to detemine if we need to refresh\n"
. " ^ all datastore info\n"
. " o used - output used space instead of free\n"
. " o brief - list only alerting volumes\n"
. " o blacklistregexp - whether to treat blacklist as regexp\n"
. " b - blacklist VMFS's\n"
. " T (value) - timeshift to detemine if we need to refresh\n"
. " * runtime - shows runtime info\n"
. " + list(vm) - list of VMware machines and their statuses\n"
. " + listhost - list of VMware esx host servers and their statuses\n"
. " + listcluster - list of VMware clusters and their statuses\n"
. " + tools - VMware Tools status\n"
. " b - blacklist VM's\n"
. " + status - overall object status (gray/green/red/yellow)\n"
. " + issues - all issues for the host\n"
. " b - blacklist issues\n"
. " ^ all runtime info(except cluster and tools and no thresholds)\n"
. " * recommendations - shows recommendations for cluster\n"
. " + (name) - recommendations for cluster with name (name)\n"
. " ^ all clusters recommendations\n"
. " Cluster specific :\n"
. " * cpu - shows cpu info\n"
. " + usage - CPU usage in percentage\n"
. " + usagemhz - CPU usage in MHz\n"
. " ^ all cpu info\n"
. " * mem - shows mem info\n"
. " + usage - mem usage in percentage\n"
. " + usagemb - mem usage in MB\n"
. " + swap - swap mem usage in MB\n"
. " o listvm - turn on/off output list of swapping VM's\n"
. " + memctl - mem used by VM memory control driver(vmmemctl) that controls ballooning\n"
. " o listvm - turn on/off output list of ballooning VM's\n"
. " ^ all mem info(plus overhead and no thresholds)\n"
. " * cluster - shows cluster services info\n"
. " + effectivecpu - total available cpu resources of all hosts within cluster\n"
. " + effectivemem - total amount of machine memory of all hosts in the cluster\n"
. " + failover - VMware HA number of failures that can be tolerated\n"
. " + cpufairness - fairness of distributed cpu resource allocation\n"
. " + memfairness - fairness of distributed mem resource allocation\n"
. " ^ only effectivecpu and effectivemem values for cluster services\n"
. " * runtime - shows runtime info\n"
. " + list(vm) - list of VMware machines in cluster and their statuses\n"
. " + listhost - list of VMware esx host servers in cluster and their statuses\n"
. " + status - overall cluster status (gray/green/red/yellow)\n"
. " + issues - all issues for the cluster\n"
. " b - blacklist issues\n"
. " ^ all cluster runtime info\n"
. " * vmfs - shows Datastore info\n"
. " + (name) - free space info for datastore with name (name)\n"
. " o used - output used space instead of free\n"
. " o brief - list only alerting volumes\n"
. " o regexp - whether to treat name as regexp\n"
. " o blacklistregexp - whether to treat blacklist as regexp\n"
. " b - blacklist VMFS's\n"
. " T (value) - timeshift to detemine if we need to refresh\n"
. " ^ all datastore info\n"
. " o used - output used space instead of free\n"
. " o brief - list only alerting volumes\n"
. " o blacklistregexp - whether to treat blacklist as regexp\n"
. " b - blacklist VMFS's\n"
. " T (value) - timeshift to detemine if we need to refresh\n"
. "\n\nCopyright (c) 2008-2013 op5",
timeout => 30,
);

$np->add_arg(
spec => 'host|H=s',
help => "-H, --host=\n"
. ' ESX or ESXi hostname.',
required => 0,
);

$np->add_arg(
spec => 'cluster|C=s',
help => "-C, --cluster=\n"
. ' ESX or ESXi clustername.',
required => 0,
);

$np->add_arg(
spec => 'datacenter|D=s',
help => "-D, --datacenter=\n"
. ' Datacenter hostname.',
required => 0,
);

$np->add_arg(
spec => 'name|N=s',
help => "-N, --name=\n"
. ' Virtual machine name.',
required => 0,
);

$np->add_arg(
spec => 'node|n=s',
help => "-n, --name=\n"
. ' cluster Node.',
required => 0,
);

$np->add_arg(
spec => 'username|u=s',
help => "-u, --username=\n"
. ' Username to connect with.',
required => 0,
);

$np->add_arg(
spec => 'password|p=s',
help => "-p, --password=\n"
. ' Password to use with the username.',
required => 0,
);

$np->add_arg(
spec => 'authfile|f=s',
help => "-f, --authfile=\n"
. " Authentication file with login and password. File syntax :\n"
. " username=\n"
. ' password=',
required => 0,
);

$np->add_arg(
spec => 'warning|w=s',
help => "-w, --warning=THRESHOLD\n"
. " Warning threshold. See\n"
. " http://nagiosplug.sourceforge.net/developer-guidelines.html#THRESHOLDFORMAT\n"
. ' for the threshold format. By default, no threshold is set.',
required => 0,
);

$np->add_arg(
spec => 'critical|c=s',
help => "-c, --critical=THRESHOLD\n"
. " Critical threshold. See\n"
. " http://nagiosplug.sourceforge.net/developer-guidelines.html#THRESHOLDFORMAT\n"
. ' for the threshold format. By default, no threshold is set.',
required => 0,
);

$np->add_arg(
spec => 'command|l=s',
help => "-l, --command=COMMAND\n"
. ' Specify command type (CPU, MEM, NET, IO, VMFS, RUNTIME, ...)',
required => 1,
);

$np->add_arg(
spec => 'subcommand|s=s',
help => "-s, --subcommand=SUBCOMMAND\n"
. ' Specify subcommand',
required => 0,
);

$np->add_arg(
spec => 'sessionfile|S=s',
help => "-S, --sessionfile=SESSIONFILE\n"
. ' Specify a filename to store sessions for faster authentication',
required => 0,
);

$np->add_arg(
spec => 'exclude|x=s',
help => "-x, --exclude=\n"
. ' Specify black list',
required => 0,
);

$np->add_arg(
spec => 'options|o=s',
help => "-o, --options= \n"
. ' Specify additional command options (quickstats, ...)',
required => 0,
);

$np->add_arg(
spec => 'timestamp|T=i',
help => "-T, --timestamp= \n"
. ' Timeshift in seconds that could fix issues with "Unknown error". Use values like 5, 10, 20, etc',
required => 0,
);

$np->add_arg(
spec => 'interval|i=s',
help => "-i, --interval= \n"
. " Sampling Period in seconds. Basic historic intervals: 300, 1800, 7200 or 86400. See config for any changes.\n"
. " Supports literval values to autonegotiate interval value: r - realtime interval, h - historical interval specified by position.\n"
. ' Default value is 20 (realtime). Since cluster does not have realtime stats interval other than 20(default realtime) is mandatory.',
required => 0,
);

$np->add_arg(
spec => 'maxsamples|M=s',
help => "-M, --maxsamples= \n"
. " Maximum number of samples to retrieve. Max sample number is ignored for historic intervals.\n"
. ' Default value is 1 (latest available sample). ',
required => 0,
);

$np->add_arg(
spec => 'trace=s',
help => "--trace= \n"
. ' Set verbosity level of vSphere API request/respond trace',
required => 0,
);

$np->add_arg(
spec => 'generate_test=s',
help => "--generate_test= \n"
. ' Generate a test case script from the executed command/subcommand and write it to .'
. ' If is "stdout", the test case script is written to stdout instead.',
default => 0,
required => 0,
);

$np->getopts;

my $host = $np->opts->host;
my $cluster = $np->opts->cluster;
my $datacenter = $np->opts->datacenter;
my $vmname = $np->opts->name;
my $cnode = $np->opts->node;
my $username = $np->opts->username;
my $password = $np->opts->password;
my $authfile = $np->opts->authfile;
my $warning = $np->opts->warning;
my $critical = $np->opts->critical;
my $command = $np->opts->command;
my $subcommand = $np->opts->subcommand;
my $sessionfile = $np->opts->sessionfile;
my $blacklist = $np->opts->exclude;
my $addopts = $np->opts->options;
my $trace = $np->opts->trace;
my $generate_test = $np->opts->generate_test;
my $timeshift = $np->opts->timestamp;
my $interval = $np->opts->interval;
my $maxsamples = $np->opts->maxsamples;
my $timeout = $np->opts->timeout;
my $percw;
my $percc;
if ($generate_test) {
if (uc($generate_test) ne "STDOUT") {
-e $generate_test and die("cowardly refusing to write test case script to existing file ${generate_test}");
}
use LWP::UserAgent;
my $cref = *LWP::UserAgent::request{CODE};
{
no warnings 'redefine';
*LWP::UserAgent::request = sub {
my $r = &{$cref}(@_); #$r is (hopefully) a SOAP response as returned by the VMware WS

if (uc($generate_test) ne "STDOUT") {
open TEST_SCRIPT, ">>", $generate_test;
print TEST_SCRIPT $r->content . "\n!\n"; #print the response content to the target script. separate messages by '!' for easy parsing
} else {
print $r->content . "\n";
}
$r #pass it on
};
}
}


eval {
require VMware::VIRuntime;
} or Monitoring::Plugin::Functions::plugin_exit(UNKNOWN, "Missing perl module VMware::VIRuntime. Download and install \'VMware vSphere SDK for Perl\', available at https://my.vmware.com/group/vmware/downloads\n $perl_module_instructions"); #This is, potentially, a lie. This might just as well fail if a dependency of VMware::VIRuntime is missing (i.e VIRuntime itself requires something which in turn fails).

alarm($timeout) if $timeout;

$output = "Unknown ERROR!";
$result = CRITICAL;

if (defined($subcommand))
{
$subcommand = undef if ($subcommand eq '');
}

if (defined($critical))
{
($percc, $critical) = check_percantage($critical);
$critical = undef if ($critical eq '');
}

if (defined($warning))
{
($percw, $warning) = check_percantage($warning);
$warning = undef if ($warning eq '');
}

$np->set_thresholds(critical => $critical, warning => $warning);

$defperfargs = {};
$defperfargs->{timeshift} = $timeshift if (defined($timeshift));
$defperfargs->{interval} = $interval if (defined($interval));
$defperfargs->{maxsamples} = $maxsamples if (defined($maxsamples));

eval
{
die "Provide either Password/Username or Auth file or Session file\n" if ((!defined($password) || !defined($username) || defined($authfile)) && (defined($password) || defined($username) || !defined($authfile)) && (defined($password) || defined($username) || defined($authfile) || !defined($sessionfile)));
die "Both threshold values must be the same units\n" if (($percw && !$percc && defined($critical)) || (!$percw && $percc && defined($warning)));
if (defined($authfile))
{
open (AUTH_FILE, $authfile) || die "Unable to open auth file \"$authfile\"\n";
while( ) {
if(s/^[ \t]*username[ \t]*=//){
s/^\s+//;s/\s+$//;
$username = $_;
}
if(s/^[ \t]*password[ \t]*=//){
s/^\s+//;s/\s+$//;
$password = $_;
}
}
die "Auth file must contain both username and password\n" if (!(defined($username) && defined($password)));
}

my $host_address;

if (defined($datacenter))
{
$host_address = $datacenter;
}
elsif (defined($host))
{
$host_address = $host;
}
else
{
$np->plugin_exit(CRITICAL, "No Host or Datacenter specified");
}

$host_address .= ":443" if (index($host_address, ":") == -1);
if (not $host_address =~ '^.*://.*$') {
$host_address = "https://" . $host_address . "/sdk/webService";
}

if (defined($sessionfile) and -e $sessionfile)
{
Opts::set_option("sessionfile", $sessionfile);
eval {
Util::connect($host_address, $username, $password);
die "Connected host doesn't match reqested once\n" if (Opts::get_option("url") ne $host_address);
};
if ($@) {
Opts::set_option("sessionfile", undef);
Util::connect($host_address, $username, $password);
}
}
else
{
Util::connect($host_address, $username, $password);
}

if (defined($sessionfile))
{
Vim::save_session(session_file => $sessionfile);
}

if (defined($trace))
{
$Util::tracelevel = $Util::tracelevel;
$Util::tracelevel = $trace if (($trace =~ m/^\d$/) && ($trace >= 0) && ($trace $cnode} if (defined($datacenter));
if ($command eq "CPU")
{
($result, $output) = host_cpu_info($esx, $np, local_uc($subcommand), $addopts);
}
elsif ($command eq "MEM")
{
($result, $output) = host_mem_info($esx, $np, local_uc($subcommand), $addopts);
}
elsif ($command eq "NET")
{
($result, $output) = host_net_info($esx, $np, local_uc($subcommand));
}
elsif ($command eq "IO")
{
($result, $output) = host_disk_io_info($esx, $np, local_uc($subcommand));
}
elsif ($command eq "VMFS")
{
($result, $output) = host_list_vm_volumes_info($esx, $np, $subcommand, $blacklist, $percc || $percw, $addopts);
}
elsif ($command eq "RUNTIME")
{
($result, $output) = host_runtime_info($esx, $np, local_uc($subcommand), $blacklist, $addopts);
}
elsif ($command eq "SERVICE")
{
($result, $output) = host_service_info($esx, $np, $subcommand);
}
elsif ($command eq "STORAGE")
{
($result, $output) = host_storage_info($esx, $np, local_uc($subcommand), $blacklist);
}
elsif ($command eq "UPTIME")
{
($result, $output) = host_uptime_info($esx, $np, $addopts);
}
elsif ($command eq "DEVICE")
{
($result, $output) = host_device_info($esx, $np, $subcommand, $addopts);
}
else
{
$output = "Unknown HOST command\n" . $np->opts->_help;
$result = CRITICAL;
}
}
elsif (defined($vmname))
{
if ($command eq "CPU")
{
($result, $output) = vm_cpu_info($vmname, $np, local_uc($subcommand));
}
elsif ($command eq "MEM")
{
($result, $output) = vm_mem_info($vmname, $np, local_uc($subcommand));
}
elsif ($command eq "NET")
{
($result, $output) = vm_net_info($vmname, $np, local_uc($subcommand));
}
elsif ($command eq "IO")
{
($result, $output) = vm_disk_io_info($vmname, $np, local_uc($subcommand));
}
elsif ($command eq "RUNTIME")
{
($result, $output) = vm_runtime_info($vmname, $np, local_uc($subcommand));
}
else
{
$output = "Unknown HOST-VM command\n" . $np->opts->_help;
$result = CRITICAL;
}
}
elsif (defined($host))
{
my $esx;
$esx = {name => $host} if (defined($datacenter));
if ($command eq "CPU")
{
($result, $output) = host_cpu_info($esx, $np, local_uc($subcommand), $addopts);
}
elsif ($command eq "MEM")
{
($result, $output) = host_mem_info($esx, $np, local_uc($subcommand), $addopts);
}
elsif ($command eq "NET")
{
($result, $output) = host_net_info($esx, $np, local_uc($subcommand));
}
elsif ($command eq "IO")
{
($result, $output) = host_disk_io_info($esx, $np, local_uc($subcommand));
}
elsif ($command eq "VMFS")
{
($result, $output) = host_list_vm_volumes_info($esx, $np, $subcommand, $blacklist, $percc || $percw, $addopts);
}
elsif ($command eq "RUNTIME")
{
($result, $output) = host_runtime_info($esx, $np, local_uc($subcommand), $blacklist, $addopts);
}
elsif ($command eq "SERVICE")
{
($result, $output) = host_service_info($esx, $np, $subcommand);
}
elsif ($command eq "STORAGE")
{
($result, $output) = host_storage_info($esx, $np, local_uc($subcommand), $blacklist);
}
elsif ($command eq "UPTIME")
{
($result, $output) = host_uptime_info($esx, $np, $addopts);
}
elsif ($command eq "DEVICE")
{
($result, $output) = host_device_info($esx, $np, $subcommand, $addopts);
}
else
{
$output = "Unknown HOST command\n" . $np->opts->_help;
$result = CRITICAL;
}
}
elsif (defined($cluster))
{
if ($command eq "CPU")
{
($result, $output) = cluster_cpu_info($cluster, $np, local_uc($subcommand));
}
elsif ($command eq "MEM")
{
($result, $output) = cluster_mem_info($cluster, $np, local_uc($subcommand), $addopts);
}
elsif ($command eq "CLUSTER")
{
($result, $output) = cluster_cluster_info($cluster, $np, local_uc($subcommand));
}
elsif ($command eq "VMFS")
{
($result, $output) = cluster_list_vm_volumes_info($cluster, $np, $subcommand, $blacklist, $percc || $percw, $addopts);
}
elsif ($command eq "RUNTIME")
{
($result, $output) = cluster_runtime_info($cluster, $np, local_uc($subcommand), $blacklist);
}
else
{
$output = "Unknown CLUSTER command\n" . $np->opts->_help;
$result = CRITICAL;
}
}
else
{
if ($command eq "RECOMMENDATIONS")
{
my $cluster_name;
$cluster_name = {name => $subcommand} if (defined($subcommand));
($result, $output) = return_cluster_DRS_recommendations($np, $cluster_name);
}
elsif ($command eq "CPU")
{
($result, $output) = dc_cpu_info($np, local_uc($subcommand), $addopts);
}
elsif ($command eq "MEM")
{
($result, $output) = dc_mem_info($np, local_uc($subcommand), $addopts);
}
elsif ($command eq "NET")
{
($result, $output) = dc_net_info($np, local_uc($subcommand));
}
elsif ($command eq "IO")
{
($result, $output) = dc_disk_io_info($np, local_uc($subcommand));
}
elsif ($command eq "VMFS")
{
($result, $output) = dc_list_vm_volumes_info($np, $subcommand, $blacklist, $percc || $percw, $addopts);
}
elsif ($command eq "RUNTIME")
{
($result, $output) = dc_runtime_info($np, local_uc($subcommand), $blacklist);
}
else
{
$output = "Unknown HOST command\n" . $np->opts->_help;
$result = CRITICAL;
}
}
};
if ($@)
{
if (uc(ref($@)) eq "HASH")
{
$output = $@->{msg};
$result = $@->{code};
}
elsif ($@ =~ /^Error connecting to server at/) {
$output = $@ . "";
$result = UNKNOWN;
}
elsif ($@ =~ /^Error: Cannot complete login/) {
$output = $@ . "";
$result = UNKNOWN;
}
elsif ($@ =~ /^Error: Permission to perform/) {
$output = $@ . "";
$result = UNKNOWN;
}
else
{
$output = $@ . "";
$result = CRITICAL;
}
}

Util::disconnect();
if ($generate_test && uc($generate_test) ne 'STDOUT') {
open TEST_SCRIPT, ">>", $generate_test;
print TEST_SCRIPT "#" . $output . "\n";
print TEST_SCRIPT "-" . $result;
}
$np->plugin_exit($result, $output);
}
main unless defined caller;
#######################################################################################################################################################################

sub get_key_metrices {
my ($perfmgr_view, $group, @names) = @_;

my $perfCounterInfo = $perfmgr_view->perfCounter;
my @counters;

die "Insufficient rights to access perfcounters\n" if (!defined($perfCounterInfo));

foreach (@$perfCounterInfo) {
if ($_->groupInfo->key eq $group) {
my $cur_name = $_->nameInfo->key . "." . $_->rollupType->val;
foreach my $index (0..@names-1)
{

if ($names[$index] =~ /$cur_name/)
{
$names[$index] =~ /(\w+).(\w+):*(.*)/;
$counters[$index] = PerfMetricId->new(counterId => $_->key, instance => $3);
}
}
}
}

return \@counters;
}

sub generic_performance_values {
my ($views, $perfargs, $group, @list) = @_;
my $counter = 0;
my @values = ();
my $amount = @list;
my $perfMgr = $perfargs->{perfCounter};
if (!defined($perfMgr)) {
$perfMgr = Vim::get_view(mo_ref => Vim::get_service_content()->perfManager, properties => [ 'perfCounter' ]);
$perfargs->{perfCounter} = $perfMgr;
}
my $metrices = get_key_metrices($perfMgr, $group, @list);
my $maxsamples = $perfargs->{maxsamples};
my $interval = defined($perfargs->{interval}) ? $perfargs->{interval} : 20;
my $timestamp = $perfargs->{timestamp};

my @perf_query_spec = ();
if (defined($timestamp)) {
my $timeshift = $perfargs->{timeshift};
my ($sec,$min,$hour,$mday,$mon,$year) = gmtime($timestamp - $timeshift);
my $startTime = sprintf("%04d-%02d-%02dT%02d:%02d:%02dZ", $year + 1900, $mon + 1, $mday, $hour, $min, $sec);

($sec,$min,$hour,$mday,$mon,$year) = gmtime($timestamp);
my $endTime = sprintf("%04d-%02d-%02dT%02d:%02d:%02dZ", $year + 1900, $mon + 1, $mday, $hour, $min, $sec);

if ($interval and $interval eq "r") {
foreach (@$views) {
my $summary = $perfMgr->QueryPerfProviderSummary(entity => $_);
die "Realtime interval is not supported or not enabled\n" unless ($summary && $summary->currentSupported);
$interval = $summary->refreshRate;
push(@perf_query_spec, PerfQuerySpec->new(entity => $_, metricId => $metrices, format => 'csv', intervalId => $interval, maxSample => $maxsamples, startTime => $startTime, endTime => $endTime));
}
} elsif ($interval and substr($interval, 0, 1) eq "h") {
my $index = substr($interval, 1, -1);
foreach (@$views) {
my $summary = $perfMgr->QueryPerfProviderSummary(entity => $_);
die "Historical intervals are not supported\n" unless ($summary && $summary->summarySupported);
my $historic_intervals = $perfMgr->historicalInterval;
die "Historical interval [$index] is not present (max value " . @{$historic_intervals} . ")\n" unless (($index >= 0) && ($index enabled);
$interval = $perf_interval->key;
push(@perf_query_spec, PerfQuerySpec->new(entity => $_, metricId => $metrices, format => 'csv', intervalId => $interval, maxSample => $maxsamples, startTime => $startTime, endTime => $endTime));
}
} else {
push(@perf_query_spec, PerfQuerySpec->new(entity => $_, metricId => $metrices, format => 'csv', intervalId => $interval, maxSample => $maxsamples, startTime => $startTime, endTime => $endTime)) foreach (@$views);
}
} else {
if ($interval and $interval eq "r") {
foreach (@$views) {
my $summary = $perfMgr->QueryPerfProviderSummary(entity => $_);
die "Realtime interval is not supported or not enabled\n" unless ($summary && $summary->currentSupported);
$interval = $summary->refreshRate;
push(@perf_query_spec, PerfQuerySpec->new(entity => $_, metricId => $metrices, format => 'csv', intervalId => $interval, maxSample => $maxsamples));
}
} elsif ($interval and substr($interval, 0, 1) eq "h") {
my $index = substr($interval, 1, -1);
foreach (@$views) {
my $summary = $perfMgr->QueryPerfProviderSummary(entity => $_);
die "Historical intervals are not supported\n" unless ($summary && $summary->summarySupported);
my $historic_intervals = $perfMgr->historicalInterval;
die "Historical interval [$index] is not present (max value " . @{$historic_intervals} . ")\n" unless (($index >= 0) && ($index enabled);
$interval = $perf_interval->key;
push(@perf_query_spec, PerfQuerySpec->new(entity => $_, metricId => $metrices, format => 'csv', intervalId => $interval, maxSample => $maxsamples));
}
} else {
push(@perf_query_spec, PerfQuerySpec->new(entity => $_, metricId => $metrices, format => 'csv', intervalId => $interval, maxSample => $maxsamples)) foreach (@$views);
}
}
my $perf_data = $perfMgr->QueryPerf(querySpec => \@perf_query_spec);
$amount *= @$perf_data;

while (@$perf_data)
{
my $unsorted = shift(@$perf_data)->value;
my @host_values = ();

foreach my $id (@$unsorted)
{
foreach my $index (0..@$metrices-1)
{
if ($id->id->counterId == $$metrices[$index]->counterId)
{
$counter++ if (!defined($host_values[$index]));
$host_values[$index] = $id;
}
}
}
push(@values, \@host_values);
}
return undef if ($counter != $amount || $counter == 0);
return \@values;
}

sub return_host_performance_values {
my $values;
my $host_name = shift(@_);
my $perfargs = shift(@_);
my $timeshift = $perfargs->{timeshift};
my $host_view = Vim::find_entity_views(view_type => 'HostSystem', filter => $host_name, properties => (defined($timeshift) ? [ 'name', 'runtime.inMaintenanceMode', 'configManager.dateTimeSystem' ] : [ 'name', 'runtime.inMaintenanceMode']) ); # Added properties named argument.
die "Runtime error\n" if (!defined($host_view));
die "Host \"" . $$host_name{"name"} . "\" does not exist\n" if (!@$host_view);
die {msg => ("NOTICE: \"" . $$host_view[0]->name . "\" is in maintenance mode, check skipped\n"), code => OK} if (uc($$host_view[0]->get_property('runtime.inMaintenanceMode')) eq "TRUE");

# Timestamp is required for some Hosts in vCenter(Datacenter), this could fix 'Unknown error' type of issues
$perfargs->{timestamp} = str2time(Vim::get_view(mo_ref => $$host_view[0]->get_property('configManager.dateTimeSystem'))->QueryDateTime()) if (defined($timeshift));
$values = generic_performance_values($host_view, $perfargs, @_);

return undef if ($@);
return ($host_view, $values);
}

sub return_host_vmware_performance_values {
my $values;
my $vmname = shift(@_);
my $vm_view = Vim::find_entity_views(view_type => 'VirtualMachine', filter => {name => "$vmname"}, properties => [ 'name', 'runtime.powerState' ]);
die "Runtime error\n" if (!defined($vm_view));
die "VMware machine \"" . $vmname . "\" does not exist\n" if (!@$vm_view);
die "VMware machine \"" . $vmname . "\" is not running. Current state is \"" . $$vm_view[0]->get_property('runtime.powerState')->val . "\"\n" if ($$vm_view[0]->get_property('runtime.powerState')->val ne "poweredOn");

my $perfargs = shift(@_);
$perfargs->{timestamp} = time() if (exists($perfargs->{timeshift}));
$values = generic_performance_values($vm_view, $perfargs, @_);

return $@ if ($@);
return ($vm_view, $values);
}

sub return_dc_performance_values {
my $values;
my $host_views = Vim::find_entity_views(view_type => 'HostSystem', properties => [ 'name' ]);
die "Runtime error\n" if (!defined($host_views));
die "Datacenter does not contain any hosts\n" if (!@$host_views);

my $perfargs = shift(@_);
$perfargs->{timestamp} = time() if (exists($perfargs->{timeshift}));
$values = generic_performance_values($host_views, $perfargs, @_);

return undef if ($@);
return ($host_views, $values);
}

sub return_cluster_performance_values {
my $values;
my $cluster_name = shift(@_);
my $cluster_view = Vim::find_entity_views(view_type => 'ClusterComputeResource', filter => { name => "$cluster_name" }, properties => [ 'name' ]); # Added properties named argument.
die "Runtime error\n" if (!defined($cluster_view));
die "Cluster \"" . $cluster_name . "\" does not exist\n" if (!@$cluster_view);

my $perfargs = shift(@_);
die "Since cluster does not have realtime stats interval other than 20(default value) is mandatory\n" if (!exists($perfargs->{interval}));
$perfargs->{timestamp} = time() if (exists($perfargs->{timeshift}));
$values = generic_performance_values($cluster_view, $perfargs, @_);

return undef if ($@);
return $values;
}

# Temporary solution to overcome zeros in network output
sub return_host_temporary_vc_4_1_network_performance_values {
my @values;
my ($host_name, $perfargs, @list) = @_;

my $host_view = Vim::find_entity_views(view_type => 'HostSystem', filter => $host_name, properties => [ 'name', 'runtime.inMaintenanceMode', 'summary.config.product.version', 'configManager.dateTimeSystem' ]); # Added properties named argument.
die "Runtime error\n" if (!defined($host_view));
die "Host \"" . $$host_name{"name"} . "\" does not exist\n" if (!@$host_view);
die {msg => ("NOTICE: \"" . $$host_view[0]->name . "\" is in maintenance mode, check skipped\n"), code => OK} if (uc($$host_view[0]->get_property('runtime.inMaintenanceMode')) eq "TRUE");
my $software_version = $$host_view[0]->get_property('summary.config.product.version');
return undef if (substr($software_version, 0, 4) ne '4.1.');

my $timeshift = $perfargs->{timeshift};
my $interval = $perfargs->{interval};
my $maxsamples = $perfargs->{maxsamples};
my $timestamp = defined($timeshift) ? str2time(Vim::get_view(mo_ref => $$host_view[0]->get_property('configManager.dateTimeSystem'))->QueryDateTime()) : undef;

my $perfMgr = Vim::get_view(mo_ref => Vim::get_service_content()->perfManager, properties => [ 'perfCounter' ]);
my $metrices = get_key_metrices($perfMgr, 'net', @list);

my $amount = @list;
my @perf_query_spec = ();

if (defined($timestamp)) {
my ($sec,$min,$hour,$mday,$mon,$year) = gmtime($timestamp - $timeshift);
my $endTime = sprintf("%04d-%02d-%02dT%02d:%02d:%02dZ", $year + 1900, $mon + 1, $mday, $hour, $min, $sec);
($sec,$min,$hour,$mday,$mon,$year) = gmtime($timestamp - $timeshift);
my $startTime = sprintf("%04d-%02d-%02dT%02d:%02d:%02dZ", $year + 1900, $mon + 1, $mday, $hour, $min, $sec);
push(@perf_query_spec, PerfQuerySpec->new(entity => $_, metricId => $metrices, format => 'csv', intervalId => $interval, startTime => $startTime, endtime => $endTime)) foreach (@$host_view);
} else {
push(@perf_query_spec, PerfQuerySpec->new(entity => $_, metricId => $metrices, format => 'csv', intervalId => $interval, maxSample => $maxsamples)) foreach (@$host_view);
}
my $perf_data = $perfMgr->QueryPerf(querySpec => \@perf_query_spec);
$amount *= @$perf_data;

my $counter = 0;
while (@$perf_data)
{
my $unsorted = shift(@$perf_data)->value;
my @host_values = ();

foreach my $id (@$unsorted)
{
foreach my $index (0..@$metrices-1)
{
if ($id->id->counterId == $$metrices[$index]->counterId)
{
if (!defined($host_values[$index]))
{
$counter++;
$host_values[$index] = bless({ 'value' => '0' }, "PerfMetricSeriesCSV");
}
$host_values[$index]{"value"} += convert_number($id->value) if ($id->id->instance ne '');
}
}
}
push(@values, \@host_values);
}

return undef if ($counter != $amount || $counter == 0 || $@);
return ($host_view, \@values);
}
# Remove as soon as possible

sub local_uc
{
my ($val) = shift(@_);
return defined($val)?uc($val):undef;
}

sub simplify_number
{
my ($number, $cnt) = @_;
$cnt = 2 if (!defined($cnt));
return sprintf("%.${cnt}f", "$number");
}

sub convert_number
{
my @vals = split(/,/, shift(@_));
my $res = 0;

while (@vals) {
my $value = pop(@vals);
$value =~ s/^\s+//;
$value =~ s/\s+$//;
if (defined($value) && $value ne '') {
return $value if ($value >= 0);
$res = $value if ($res == 0);
}
}

return $res;
}

sub check_percantage
{
my ($number) = shift(@_);
my $perc = $number =~ s/\%//;
return ($perc, $number);
}

sub check_health_state
{
my ($state) = shift(@_);
my $res = UNKNOWN;

if (uc($state) eq "GREEN") {
$res = OK
} elsif (uc($state) eq "YELLOW") {
$res = WARNING;
} elsif (uc($state) eq "RED") {
$res = CRITICAL;
}

return $res;
}

sub format_issue {
my ($issue) = shift(@_);

my $output = '';

if (defined($issue->datacenter))
{
$output .= 'Datacenter "' . $issue->datacenter->name . '", ';
}
if (defined($issue->host))
{
$output .= 'Host "' . $issue->host->name . '", ';
}
if (defined($issue->vm))
{
$output .= 'VM "' . $issue->vm->name . '", ';
}
if (defined($issue->computeResource))
{
$output .= 'Compute Resource "' . $issue->computeResource->name . '", ';
}
if (exists($issue->{dvs}) && defined($issue->dvs))
{
# Since vSphere API 4.0
$output .= 'Virtual Switch "' . $issue->dvs->name . '", ';
}
if (exists($issue->{ds}) && defined($issue->ds))
{
# Since vSphere API 4.0
$output .= 'Datastore "' . $issue->ds->name . '", ';
}
if (exists($issue->{net}) && defined($issue->net))
{
# Since vSphere API 4.0
$output .= 'Network "' . $issue->net->name . '" ';
}

$output =~ s/, $/ /;
$output .= ": " . $issue->fullFormattedMessage;
$output .= "(caused by " . $issue->userName . ")" if ($issue->userName ne "");

return $output;
}

sub datastore_volumes_info
{
my ($datastore, $np, $subcommand, $blacklist, $perc, $addopts) = @_;

my $res = OK;
my $output = '';

my $usedflag;
my $briefflag;
my $regexpflag;
my $blackregexpflag;
$usedflag = $addopts =~ m/(^|\s|\t|,)\Qused\E($|\s|\t|,)/ if (defined($addopts));
$briefflag = $addopts =~ m/(^|\s|\t|,)\Qbrief\E($|\s|\t|,)/ if (defined($addopts));
$regexpflag = $addopts =~ m/(^|\s|\t|,)\Qregexp\E($|\s|\t|,)/ if (defined($addopts));
$blackregexpflag = $addopts =~ m/(^|\s|\t|,)\Qblacklistregexp\E($|\s|\t|,)/ if (defined($addopts));

die "Blacklist is supported only in generic check or regexp subcheck\n" if (defined($subcommand) && defined($blacklist) && !defined($regexpflag));

if (defined($regexpflag) && defined($subcommand))
{
eval
{
qr{$subcommand};
};
if ($@)
{
$@ =~ s/ at.*line.*\.//;
die $@;
}
}

my $state;
foreach my $ref_store (@{$datastore})
{
my $store = Vim::get_view(mo_ref => $ref_store, properties => ['summary', 'info']);
my $name = $store->summary->name;
if (!defined($subcommand) || ($name eq $subcommand) || (defined($regexpflag) && $name =~ /$subcommand/))
{
if (defined($blacklist))
{
next if ($blackregexpflag?$name =~ /$blacklist/:$blacklist =~ m/(^|\s|\t|,)\Q$name\E($|\s|\t|,)/);
}

if ($store->summary->accessible)
{
$store->RefreshDatastoreStorageInfo() if ($store->can("RefreshDatastoreStorageInfo") && exists($store->info->{timestamp}) && $defperfargs->{timeshift} && (time() - str2time($store->info->timestamp) > $defperfargs->{timeshift}));
my $value1 = simplify_number(convert_number($store->summary->freeSpace) / 1024 / 1024);
my $value2 = convert_number($store->summary->capacity);
$value2 = simplify_number(convert_number($store->info->freeSpace) / $value2 * 100) if ($value2 > 0);

if ($usedflag)
{
$value1 = simplify_number(convert_number($store->summary->capacity) / 1024 / 1024) - $value1;
$value2 = 100 - $value2;
}

$state = $np->check_threshold(check => $perc?$value2:$value1);
$res = Monitoring::Plugin::Functions::max_state($res, $state);
$np->add_perfdata(label => $name, value => $perc?$value2:$value1, uom => $perc?'%':'MB', threshold => $np->threshold);
$output .= "'$name'" . ($usedflag ? "(used)" : "(free)") . "=". $value1 . " MB (" . $value2 . "%), " if (!$briefflag || $state != OK);
}
else
{
$res = CRITICAL;
$output .= "'$name' is not accessible, ";
}
last if (!$regexpflag && defined($subcommand) && ($name eq $subcommand));
$blacklist .= $blackregexpflag?"|^$name\$":",$name";
}
}

if ($output)
{
chop($output);
chop($output);
$output = "Storages : " . $output;
}
else
{
if ($briefflag)
{
$output = "There are no alerts";
}
else
{
$res = WARNING;
$output = defined($subcommand)?$regexpflag? "No matching volumes for regexp \"$subcommand\" found":"No volume named \"$subcommand\" found":"There are no volumes";
}
}

return ($res, $output);
}

#=====================================================================| HOST |============================================================================#

sub host_cpu_info
{
my ($host, $np, $subcommand, $addopts) = @_;

my $res = CRITICAL;
my $output = 'HOST CPU Unknown error';

my $quickStats;
$quickStats = $addopts =~ m/(^|\s|\t|,)\Qquickstats\E($|\s|\t|,)/ if (defined($addopts));

if (defined($subcommand))
{
if ($subcommand eq "USAGE")
{
my $value;
if (defined($quickStats))
{
my $host_view = Vim::find_entity_view(view_type => 'HostSystem', filter => $host, properties => ['name', 'runtime.inMaintenanceMode', 'summary.hardware', 'summary.quickStats']);
die "Host \"" . $$host{"name"} . "\" does not exist\n" if (!defined($host_view));
die {msg => ("NOTICE: \"" . $host_view->name . "\" is in maintenance mode, check skipped\n"), code => OK} if (uc($host_view->get_property('runtime.inMaintenanceMode')) eq "TRUE");
$values = $host_view->get_property('summary.quickStats');
my $hardinfo = $host_view->get_property('summary.hardware');
$value = simplify_number($values->overallCpuUsage / ($hardinfo->numCpuCores * $hardinfo->cpuMhz) * 100) if exists($values->{overallCpuUsage}) && defined($hardinfo);
}
else
{
$values = return_host_performance_values($host, $defperfargs, 'cpu', ('usage.average'));
$value = simplify_number(convert_number($$values[0][0]->value) * 0.01) if (defined($values));
}
if (defined($value))
{
$np->add_perfdata(label => "cpu_usage", value => $value, uom => '%', threshold => $np->threshold);
$output = "cpu usage=" . $value . " %";
$res = $np->check_threshold(check => $value);
}
}
elsif ($subcommand eq "USAGEMHZ")
{
my $value;
if (defined($quickStats))
{
my $host_view = Vim::find_entity_view(view_type => 'HostSystem', filter => $host, properties => ['name', 'runtime.inMaintenanceMode', 'summary.quickStats']);
die "Host \"" . $$host{"name"} . "\" does not exist\n" if (!defined($host_view));
die {msg => ("NOTICE: \"" . $host_view->name . "\" is in maintenance mode, check skipped\n"), code => OK} if (uc($host_view->get_property('runtime.inMaintenanceMode')) eq "TRUE");
$values = $host_view->get_property('summary.quickStats');
$value = simplify_number($values->overallCpuUsage) if exists($values->{overallCpuUsage});
}
else
{
$values = return_host_performance_values($host, $defperfargs, 'cpu', ('usagemhz.average'));
$value = simplify_number(convert_number($$values[0][0]->value)) if (defined($values));
}
if (defined($value))
{
$np->add_perfdata(label => "cpu_usagemhz", value => $value, uom => '', threshold => $np->threshold);
$output = "cpu usagemhz=" . $value . " MHz";
$res = $np->check_threshold(check => $value);
}
}
else
{
$res = CRITICAL;
$output = "HOST CPU - unknown subcommand\n" . $np->opts->_help;
}
}
else
{
my $value1;
my $value2;
if (defined($quickStats))
{
my $host_view = Vim::find_entity_view(view_type => 'HostSystem', filter => $host, properties => ['name', 'runtime.inMaintenanceMode', 'summary.hardware', 'summary.quickStats']);
die "Host \"" . $$host{"name"} . "\" does not exist\n" if (!defined($host_view));
die {msg => ("NOTICE: \"" . $host_view->name . "\" is in maintenance mode, check skipped\n"), code => OK} if (uc($host_view->get_property('runtime.inMaintenanceMode')) eq "TRUE");
$values = $host_view->get_property('summary.quickStats');
my $hardinfo = $host_view->get_property('summary.hardware');
if (exists($values->{overallCpuUsage}) && defined($hardinfo))
{
$value1 = simplify_number($values->overallCpuUsage);
$value2 = simplify_number($values->overallCpuUsage / ($hardinfo->numCpuCores * $hardinfo->cpuMhz) * 100);
}
}
else
{
$values = return_host_performance_values($host, $defperfargs, 'cpu', ('usagemhz.average', 'usage.average'));
if ($values) {
$value1 = simplify_number(convert_number($$values[0][0]->value));
$value2 = simplify_number(convert_number($$values[0][1]->value) * 0.01);
}
}
if (defined($value1) && defined($value2))
{
$np->add_perfdata(label => "cpu_usagemhz", value => $value1, uom => '', threshold => $np->threshold);
$np->add_perfdata(label => "cpu_usage", value => $value2, uom => '%', threshold => $np->threshold);
$res = OK;
$output = "cpu usage=" . $value1 . " MHz (" . $value2 . "%)";
}
}

return ($res, $output);
}

sub host_mem_info
{
my ($host, $np, $subcommand, $addopts) = @_;

my $res = CRITICAL;
my $output = 'HOST MEM Unknown error';

my $quickStats;
my $outputlist;
$quickStats = $addopts =~ m/(^|\s|\t|,)\Qquickstats\E($|\s|\t|,)/ if (defined($addopts));
$outputlist = $addopts =~ m/(^|\s|\t|,)\Qlistvm\E($|\s|\t|,)/ if (defined($addopts));

if (defined($subcommand))
{
if ($subcommand eq "USAGE")
{
my $value;
if (defined($quickStats))
{
my $host_view = Vim::find_entity_view(view_type => 'HostSystem', filter => $host, properties => ['name', 'runtime.inMaintenanceMode', 'summary.hardware', 'summary.quickStats']);
die "Host \"" . $$host{"name"} . "\" does not exist\n" if (!defined($host_view));
die {msg => ("NOTICE: \"" . $host_view->name . "\" is in maintenance mode, check skipped\n"), code => OK} if (uc($host_view->get_property('runtime.inMaintenanceMode')) eq "TRUE");
$values = $host_view->get_property('summary.quickStats');
my $hardinfo = $host_view->get_property('summary.hardware');
$value = simplify_number($values->overallMemoryUsage / ($hardinfo->memorySize / 1024 / 1024) * 100) if exists($values->{overallMemoryUsage}) && defined($hardinfo);
}
else
{
$values = return_host_performance_values($host, $defperfargs, 'mem', ('usage.average'));
$value = simplify_number(convert_number($$values[0][0]->value) * 0.01) if (defined($values));
}
if (defined($value))
{
$np->add_perfdata(label => "mem_usage", value => $value, uom => '%', threshold => $np->threshold);
$output = "mem usage=" . $value . " %";
$res = $np->check_threshold(check => $value);
}
}
elsif ($subcommand eq "USAGEMB")
{
my $value;
if (defined($quickStats))
{
my $host_view = Vim::find_entity_view(view_type => 'HostSystem', filter => $host, properties => ['name', 'runtime.inMaintenanceMode', 'summary.quickStats']);
die "Host \"" . $$host{"name"} . "\" does not exist\n" if (!defined($host_view));
die {msg => ("NOTICE: \"" . $host_view->name . "\" is in maintenance mode, check skipped\n"), code => OK} if (uc($host_view->get_property('runtime.inMaintenanceMode')) eq "TRUE");
$values = $host_view->get_property('summary.quickStats');
$value = simplify_number($values->overallMemoryUsage) if exists($values->{overallMemoryUsage});
}
else
{
$values = return_host_performance_values($host, $defperfargs, 'mem', ('consumed.average'));
$value = simplify_number(convert_number($$values[0][0]->value) / 1024) if (defined($values));
}
if (defined($value))
{
$np->add_perfdata(label => "mem_usagemb", value => $value, uom => 'MB', threshold => $np->threshold);
$output = "mem usage=" . $value . " MB";
$res = $np->check_threshold(check => $value);
}
}
elsif ($subcommand eq "SWAP")
{
my $host_view;
($host_view, $values) = return_host_performance_values($host, $defperfargs, 'mem', ('swapused.average'));
if (defined($values))
{
my $value = simplify_number(convert_number($$values[0][0]->value) / 1024);
$np->add_perfdata(label => "mem_swap", value => $value, uom => 'MB', threshold => $np->threshold);
$output = "swap usage=" . $value . " MB: ";
$res = $np->check_threshold(check => $value);
if ($res != OK && $outputlist)
{
my $vm_views = Vim::find_entity_views(view_type => 'VirtualMachine', begin_entity => $$host_view[0], properties => ['name', 'runtime.powerState']);
die "Runtime error\n" if (!defined($vm_views));
die "There are no VMs.\n" if (!@$vm_views);
my @vms = ();
foreach my $vm (@$vm_views)
{
push(@vms, $vm) if ($vm->get_property('runtime.powerState')->val eq "poweredOn");
}
$values = generic_performance_values(\@vms, $defperfargs, 'mem', ('swapped.average'));
if (defined($values))
{
foreach my $index (0..@vms-1) {
my $value = simplify_number(convert_number($$values[$index][0]->value) / 1024);
$output .= $vms[$index]->name . " (" . $value . "MB), " if ($value > 0);
}
}
}
chop($output);
chop($output);
}
}
elsif ($subcommand eq "OVERHEAD")
{
$values = return_host_performance_values($host, $defperfargs, 'mem', ('overhead.average'));
if (defined($values))
{
my $value = simplify_number(convert_number($$values[0][0]->value) / 1024);
$np->add_perfdata(label => "mem_overhead", value => $value, uom => 'MB', threshold => $np->threshold);
$output = "overhead=" . $value . " MB";
$res = $np->check_threshold(check => $value);
}
}
elsif ($subcommand eq "OVERALL")
{
$values = return_host_performance_values($host, $defperfargs, 'mem', ('consumed.average', 'overhead.average'));
if (defined($values))
{
my $value = simplify_number((convert_number($$values[0][0]->value) + convert_number($$values[0][1]->value)) / 1024);
$np->add_perfdata(label => "mem_overhead", value => $value, uom => 'MB', threshold => $np->threshold);
$output = "overall=" . $value . " MB";
$res = $np->check_threshold(check => $value);
}
}
elsif ($subcommand eq "MEMCTL")
{
my $host_view;
($host_view, $values) = return_host_performance_values($host, $defperfargs, 'mem', ('vmmemctl.average'));
if (defined($values))
{
my $value = simplify_number(convert_number($$values[0][0]->value) / 1024);
$np->add_perfdata(label => "mem_memctl", value => $value, uom => 'MB', threshold => $np->threshold);
$output = "memctl=" . $value . " MB: ";
$res = $np->check_threshold(check => $value);
if ($res != OK && $outputlist)
{
my $vm_views = Vim::find_entity_views(view_type => 'VirtualMachine', begin_entity => $$host_view[0], properties => ['name', 'runtime.powerState']);
die "Runtime error\n" if (!defined($vm_views));
die "There are no VMs.\n" if (!@$vm_views);
my @vms = ();
foreach my $vm (@$vm_views)
{
push(@vms, $vm) if ($vm->get_property('runtime.powerState')->val eq "poweredOn");
}
$values = generic_performance_values(\@vms, $defperfargs, 'mem', ('vmmemctl.average'));
if (defined($values))
{
foreach my $index (0..@vms-1) {
my $value = simplify_number(convert_number($$values[$index][0]->value) / 1024);
$output .= $vms[$index]->name . " (" . $value . "MB), " if ($value > 0);
}
}
}
chop($output);
chop($output);
}
}
else
{
$res = CRITICAL;
$output = "HOST MEM - unknown subcommand\n" . $np->opts->_help;
}
}
else
{
$values = return_host_performance_values($host, $defperfargs, 'mem', ('consumed.average', 'usage.average', 'overhead.average', 'swapused.average', 'vmmemctl.average'));
if (defined($values))
{
my $value1 = simplify_number(convert_number($$values[0][0]->value) / 1024);
my $value2 = simplify_number(convert_number($$values[0][1]->value) * 0.01);
my $value3 = simplify_number(convert_number($$values[0][2]->value) / 1024);
my $value4 = simplify_number(convert_number($$values[0][3]->value) / 1024);
my $value5 = simplify_number(convert_number($$values[0][4]->value) / 1024);
$np->add_perfdata(label => "mem_usagemb", value => $value1, uom => 'MB', threshold => $np->threshold);
$np->add_perfdata(label => "mem_usage", value => $value2, uom => '%', threshold => $np->threshold);
$np->add_perfdata(label => "mem_overhead", value => $value3, uom => 'MB', threshold => $np->threshold);
$np->add_perfdata(label => "mem_swap", value => $value4, uom => 'MB', threshold => $np->threshold);
$np->add_perfdata(label => "mem_memctl", value => $value5, uom => 'MB', threshold => $np->threshold);
$res = OK;
$output = "mem usage=" . $value1 . " MB (" . $value2 . "%), overhead=" . $value3 . " MB, swapped=" . $value4 . " MB, memctl=" . $value5 . " MB";
}
}

return ($res, $output);
}

sub host_net_info
{
my ($host, $np, $subcommand) = @_;

my $res = CRITICAL;
my $output = 'HOST NET Unknown error';

if (defined($subcommand))
{
if ($subcommand eq "USAGE")
{
$values = return_host_temporary_vc_4_1_network_performance_values($host, $defperfargs, ('received.average:*', 'transmitted.average:*'));
if ($values)
{
$$values[0][0]{"value"} += $$values[0][1]{"value"};
}
else
{
$values = return_host_performance_values($host, $defperfargs, 'net', ('usage.average'));
}
if (defined($values))
{
my $value = simplify_number(convert_number($$values[0][0]->value));
$np->add_perfdata(label => "net_usage", value => $value, uom => '', threshold => $np->threshold);
$output = "net usage=" . $value . " KBps";
$res = $np->check_threshold(check => $value);
}
}
elsif ($subcommand eq "RECEIVE")
{
$values = return_host_temporary_vc_4_1_network_performance_values($host, $defperfargs, ('received.average:*'));
$values = return_host_performance_values($host, $defperfargs, 'net', ('received.average')) if (!$values);
if (defined($values))
{
my $value = simplify_number(convert_number($$values[0][0]->value));
$np->add_perfdata(label => "net_receive", value => $value, uom => '', threshold => $np->threshold);
$output

Thx for this plugin that works perfectly !!
I have just one question, i try to change the return of value on my nagios core interface who always return the state of the plugin
"CHECK_VMWARE_API.PL OK"
"CHECK_VMWARE_API.PL WARNING"
"CHECK_VMWARE_API.PL CRITICAL"
It's possible not to display by modifying the code ?
And if it's possible, where ? because i didn't found after research.
thank you in advance

If you're using CentOS 7, you may need to install perl-Crypt-SSLeay and perl-Net-SSLeay.

[root@CCNAGIOS libexec]# ./check_vmware_api.pl -H 10.240.142.26 -u nagios -p N4g10s2017 -l mem -s usage -w 80 -c 90
Use of inherited AUTOLOAD for non-method XML::LibXML::Document::documentElement() is deprecated at /usr/share/perl5/VMware/VICommon.pm line 554.
CHECK_VMWARE_API.PL CRITICAL - Undefined subroutine &XML::LibXML::Document::documentElement called at /usr/share/perl5/VMware/VICommon.pm line 554

The plugin works great. However, I found one bug. The check, if a machine is in maintenance mode, does not work. It will always return the value you use for querying. E.g. if you add the paramter "mainwarn", it will always return WARNING regardless of the state of the machine.

The fix is quite easy. Just add "&& $runtime->inMaintenanceMode eq "1")" in the if-statements:

2280 if ($addopts eq "maintwarn" && $runtime->inMaintenanceMode eq "1") {
2281 $res = WARNING;
2282 }
2283 elsif ($addopts eq "maintcrit" && $runtime->inMaintenanceMode eq "1") {
2284 $res = CRITICAL;
2285 }

Everything works with:

Ubuntu 14.04
Nagios Core 3.5.1-1ubuntu1
Perl 5.18.2
VMware Perl SDK: VMware-vSphere-Perl-SDK-5.5.0-1384587.x86_64.tar.gz

Path original VICommon.pm manually:

root@st:~/check_vmware_api# diff /usr/share/perl/5.18/VMware/VICommon.pm /usr/share/perl/5.18/VMware/VICommon.pm_orig
448d447
ssl_opts( SSL_verify_mode => 0 );
506c505
$ENV{PERL_NET_HTTPS_SSL_SOCKET_CLASS} = "Net::SSL";
530d528
ssl_opts( SSL_verify_mode => 0 );
2113d2110
ssl_opts( SSL_verify_mode => 0 );
root@st:~/check_vmware_api#




TEST:
Edit file generate_tests.pl:

root@st:~/check_vmware_api# time perl generate_tests.pl
CHECK_VMWARE_API.PL OK - Storages : 'local_datastore_1'(free)=907044.00 MB (95.86%), 'public_images'(free)=134284.75 MB (65.57%), 'vol258'(free)=281717.14 MB (62.34%) | local_datastore_1=907044.00MB;; public_images=134284.75MB;; vol258=281717.14MB;;
CHECK_VMWARE_API.PL UNKNOWN - vmhba0 (unknown); vmhba32 (unknown); vmhba33 (unknown); vmhba34 (unknown); vmhba35 (unknown); vmhba36 (unknown); | adapters=0units;;
CHECK_VMWARE_API.PL OK - Local ATA Disk (t10.ATA_____ST91000640NS________________________________________9XG4X7YW) ; | LUNs=1units;;
CHECK_VMWARE_API.PL OK - sata.vmhba0-sata.0:0-t10.ATA_____ST91000640NS________________________________________9XG4X7YW ; | paths=1units;;
CHECK_VMWARE_API.PL UNKNOWN - 0/6 adapters online, 1/1 LUNs ok, 1/1 paths active | adapters=0units;; LUNs=1units;; paths=1units;;
CHECK_VMWARE_API.PL OK - cpu usage=8.99 % | cpu_usage=8.99%;;
CHECK_VMWARE_API.PL OK - cpu usagemhz=2266.00 MHz | cpu_usagemhz=2266.00MHz;;
CHECK_VMWARE_API.PL OK - cpu usage=2266.00 MHz (8.99%) | cpu_usagemhz=2266.00MHz;; cpu_usage=8.99%;;
CHECK_VMWARE_API.PL OK - net usage=3352.00 KBps | net_usage=3352.00KBps;;
CHECK_VMWARE_API.PL OK - net receive=199.00 KBps | net_receive=199.00KBps;;
CHECK_VMWARE_API.PL OK - net send=3152.00 KBps | net_send=3152.00KBps;;
CHECK_VMWARE_API.PL OK - All 2 NICs are connected | OK_NICs=2;; Bad_NICs=0;;
CHECK_VMWARE_API.PL OK - net receive=199.00 KBps, send=3152.00 KBps, all 2 NICs are connected | net_receive=199.00KBps;; net_send=3152.00KBps;; OK_NICs=2;; Bad_NICs=0;;
CHECK_VMWARE_API.PL OK - connection state=connected
CHECK_VMWARE_API.PL OK - All 132 health checks are GREEN: Logging (3x); temperature (6x); fan (4x); Management Subsystem Health (4x); Memory (1x); CPU (2x); Software Components (87x); voltage (7x); power (6x); system (1x); Watchdog (4x); Battery (1x); Processors (6x); | Alerts=0;;
CHECK_VMWARE_API.PL UNKNOWN - Storage health status unavailable - make sure you have the "Storage Health" tab in your vSphere client | Alerts=0;;
CHECK_VMWARE_API.PL OK - All 6 temperature checks are GREEN: OK : [Device] Other 0 Inlet Temp --- Normal = 23 C, OK : Processor 1 PCH Temp --- Normal = 47 C, OK : Processor 1 DIMM ZONE 2 Temp --- Normal = 31 C, OK : Processor 1 DIMM ZONE 1 Temp --- Normal = 35 C, OK : Processor 1 CPU2 Temp --- Normal = 44 C, OK : Processor 1 CPU1 Temp --- Normal = 48 C | '[Device] Other 0 Inlet Temp --- Normal'=23C;; 'Processor 1 PCH Temp --- Normal'=47C;; 'Processor 1 DIMM ZONE 2 Temp --- Normal'=31C;; 'Processor 1 DIMM ZONE 1 Temp --- Normal'=35C;; 'Processor 1 CPU2 Temp --- Normal'=44C;; 'Processor 1 CPU1 Temp --- Normal'=48C;;
CHECK_VMWARE_API.PL CRITICAL - Provide sensor name as -o argument
Use of uninitialized value $addopts in string eq at ./check_vmware_api.pl line 2277.
Use of uninitialized value $addopts in string eq at ./check_vmware_api.pl line 2280.
CHECK_VMWARE_API.PL OK - maintenance=no
CHECK_VMWARE_API.PL OK - 8/8 VMs up: vpn(OK), vcenter-88-2(OK), XXXXXXXX.com(OK), XXXXXXXX.com(OK), XXXXXXXX.com(OK), XXXXXXXX.com(OK), XXXXXXXX.com(OK), XXXXXXXX.com(OK) | vmcount=8units;;
CHECK_VMWARE_API.PL OK - overall status=green
CHECK_VMWARE_API.PL OK - No config issues
Use of uninitialized value $subcommand in string ne at ./check_vmware_api.pl line 1898.
CHECK_VMWARE_API.PL OK - 8/8 VMs up, overall status=green, connection state=connected, maintenance=no, All 132 health checks are Green, no config issues | vmcount=8units;; health_issues=0;; config_issues=0;;
CHECK_VMWARE_API.PL OK - No VM's with cd/dvd devices | match=0;;
CHECK_VMWARE_API.PL OK - services : DCUI (up), TSM (down), TSM-SSH (up), lbtd (up), lsassd (down), lwiod (down), netlogond (down), ntpd (up), sfcbd-watchdog (up), snmpd (up), vmware-fdm (down), vprobed (down), vpxa (up), xorg (down)
CHECK_VMWARE_API.PL OK - io commands aborted=0 | io_aborted=0;;
CHECK_VMWARE_API.PL OK - io bus resets=0 | io_busresets=0;;
CHECK_VMWARE_API.PL OK - io read latency=0 ms | io_read=0ms;;
CHECK_VMWARE_API.PL OK - io write latency=0 ms | io_write=0ms;;
CHECK_VMWARE_API.PL OK - io kernel latency=0 ms | io_kernel=0ms;;
CHECK_VMWARE_API.PL OK - io device latency=0 ms | io_device=0ms;;
CHECK_VMWARE_API.PL OK - io queue latency=0 ms | io_queue=0ms;;
CHECK_VMWARE_API.PL OK - io commands aborted=0, io bus resets=0, io read latency=0 ms, write latency=0 ms, kernel latency=0 ms, device latency=0 ms, queue latency=0 ms | io_aborted=0;; io_busresets=0;; io_read=0ms;; io_write=0ms;; io_kernel=0ms;; io_device=0ms;; io_queue=0ms;;
CHECK_VMWARE_API.PL OK - mem usage=82.26 % | mem_usage=82.26%;;
CHECK_VMWARE_API.PL OK - mem usage=107788.05 MB | mem_usagemb=107788.05MB;;
CHECK_VMWARE_API.PL OK - swap usage=79.71 MB | mem_swap=79.71MB;;
CHECK_VMWARE_API.PL OK - overhead=1502.64 MB | mem_overhead=1502.64MB;;
CHECK_VMWARE_API.PL OK - overall=109290.69 MB | mem_overhead=109290.69MB;;
CHECK_VMWARE_API.PL OK - memctl=129.01 MB | mem_memctl=129.01MB;;
CHECK_VMWARE_API.PL OK - mem usage=107788.05 MB (82.26%), overhead=1502.64 MB, swapped=79.71 MB, memctl=129.01 MB | mem_usagemb=107788.05MB;; mem_usage=82.26%;; mem_overhead=1502.64MB;; mem_swap=79.71MB;; mem_memctl=129.01MB;;
CHECK_VMWARE_API.PL OK - mem usage=82.25 % | mem_usage=82.25%;;
CHECK_VMWARE_API.PL OK - mem usage=107773.45 MB | mem_usagemb=107773.45MB;;
CHECK_VMWARE_API.PL OK - swap usage=79.71 MB | mem_swap=79.71MB;;
CHECK_VMWARE_API.PL OK - overhead=1502.64 MB | mem_overhead=1502.64MB;;
CHECK_VMWARE_API.PL OK - overall=109290.69 MB | mem_overall=109290.69MB;;
CHECK_VMWARE_API.PL OK - memctl=129.01 MB | mem_memctl=129.01MB;;
CHECK_VMWARE_API.PL OK - mem usage=107788.05 MB (82.26%), overhead=1502.64 MB, swapped=79.71 MB, memctl=129.01 MB | mem_usagemb=107788.05MB;; mem_usage=82.26%;; mem_overhead=1502.64MB;; mem_swap=79.71MB;; mem_memctl=129.01MB;;
CHECK_VMWARE_API.PL OK - io commands aborted=0 | io_aborted=0;;
CHECK_VMWARE_API.PL OK - io bus resets=0 | io_busresets=0;;
CHECK_VMWARE_API.PL OK - io read latency=0 ms | io_read=0ms;;
CHECK_VMWARE_API.PL OK - io write latency=0 ms | io_write=0ms;;
CHECK_VMWARE_API.PL OK - io kernel latency=0 ms | io_kernel=0ms;;
CHECK_VMWARE_API.PL OK - io device latency=0 ms | io_device=0ms;;
CHECK_VMWARE_API.PL OK - io queue latency=0 ms | io_queue=0ms;;
CHECK_VMWARE_API.PL OK - io commands aborted=0, io bus resets=0, io read latency=0 ms, write latency=0 ms, kernel latency=0 ms, device latency=0 ms, queue latency=0 ms | io_aborted=0;; io_busresets=0;; io_read=0ms;; io_write=0ms;; io_kernel=0ms;; io_device=0ms;; io_queue=0ms;;
CHECK_VMWARE_API.PL OK - cpu usage=19.85 % | cpu_usage=19.85%;;
CHECK_VMWARE_API.PL OK - cpu usagemhz=5002.00 MHz | cpu_usagemhz=5002.00MHz;;
CHECK_VMWARE_API.PL OK - cpu usage=5002.00 MHz (19.85%) | cpu_usagemhz=5002.00MHz;; cpu_usage=19.85%;;
CHECK_VMWARE_API.PL CRITICAL - Storages : 'public_images'(free)=134284.80 MB (65.57%), 'local_datastore_1'(free)=907044.00 MB (95.86%), 'local_datastore_2' is not accessible, 'vol258'(free)=281650.31 MB (62.34%) | public_images=134284.80MB;; local_datastore_1=907044.00MB;; vol258=281650.31MB;;
CHECK_VMWARE_API.PL OK - 8/9 VMs up: debian8(DOWN), vcenter-88-2(UP), vpn(UP), XXXXXXXX.com(UP), XXXXXXXX.com(UP), XXXXXXXX.com(UP), XXXXXXXX.com(UP), XXXXXXXX.com(UP), XXXXXXXX.com(UP) | vmcount=8units;;
CHECK_VMWARE_API.PL UNKNOWN - 1/2 Hosts up: XX.XX.XX.XX(UNKNOWN), XX.XX.XX.XX(UP) | hostcount=1units;;
CHECK_VMWARE_API.PL OK - 1/1 Cluster green: cluster#1(GREEN) | clustercount=1units;;
CHECK_VMWARE_API.PL OK - XXXXXXXX.com(Running-Unmanaged), XXXXXXXX.com(Running-Unmanaged), XXXXXXXX.com(Running-Unmanaged), XXXXXXXX.com(Running-Unmanaged), XXXXXXXX.com(Running-Unmanaged), XXXXXXXX.com(Running-Unmanaged), vpn(Not running-Not installed), vcenter-88-2(Running-Unmanaged) | toolsok=0%;;
CHECK_VMWARE_API.PL UNKNOWN - Interxion MAD2 overall status=gray
CHECK_VMWARE_API.PL OK - No config issues | issues=0;;
CHECK_VMWARE_API.PL OK - 8/8 VMs up (1 templates), 1/2 Hosts up, Interxion MAD2 overall status=gray, no config issues | vmcount=8units;; hostcount=1units;; config_issues=0;;
CHECK_VMWARE_API.PL OK - No recommendations | recommendations=0;;
CHECK_VMWARE_API.PL OK - net usage=4352.00 KBps | net_usage=4352.00KBps;;
CHECK_VMWARE_API.PL OK - net receive=111.00 KBps | net_receive=111.00KBps;;
CHECK_VMWARE_API.PL OK - net send=3426.00 KBps | net_send=3426.00KBps;;
CHECK_VMWARE_API.PL OK - net receive=111.00 KBps, send=3426.00 KBps | net_receive=111.00KBps;; net_send=3426.00KBps;;

real 0m38.762s
user 0m29.331s
sys 0m2.007s
root@st:~/check_vmware_api#

# ./check_vmware_api.pl -D IP -u opuser -p ****** -l cpu -s usage -w 92 -c 98
CHECK_VMWARE_API.PL CRITICAL - Server version unavailable at 'https://IP:443/sdk/vimService.wsdl' at /usr/lib/perl5/site_perl/5.8.8/VMware/VICommon.pm line 545.
___

solution:
# cpan -D LWP

I am also getting the Server version unavailable message when running the check but, being a n00b, I don't know how to apply the work around suggested by ginter. Can someone please tell me the steps to make this work correctly?

I have:
Ubuntu 14.04
Nagios Core 4.0.8
Perl 5.18.2
VMware Perl SDK 5.1

Here is a work around for everyone who can't make check_vmware_api work on recent OS with new perl and recent VMware Perl SDK.


Prerequisites:
- Ubuntu 14.04 Server (perl v5.18.2)
- VMware-vSphere-Perl-SDK-5.5.0-2043780
- check_vmware_api.pl 0.7.1


Basic installation:

apt-get install perl-doc libssl-dev libxml-libxml-perl libarchive-zip-perl libcrypt-ssleay-perl libclass-methodmaker-perl libuuid-perl libdata-dump-perl libsoap-lite-perl libio-compress-perl
tar -xf VMware-vSphere-Perl-SDK-5.5.0-2043780.x86_64.tar.gz -C /tmp
cd /tmp/vmware-vsphere-cli-distrib
./vmware-install.pl



Work around for "Server version unavailable":

patch -b /usr/share/perl/5.18/VMware/VICommon.pm new(agent => "VI Perl");
+ $user_agent->ssl_opts( SSL_verify_mode => 0 );
my $cookie_jar = HTTP::Cookies->new(ignore_discard => 1);
$user_agent->cookie_jar($cookie_jar);
$user_agent->protocols_allowed(['http', 'https']);
@@ -502,7 +503,7 @@
sub query_server_version {
BEGIN {
#To remove SSL Warning, switching from IO::Socket::SSL to Net::SSL
- $ENV{PERL_NET_HTTPS_SSL_SOCKET_CLASS} = "Net::SSL";
+ #$ENV{PERL_NET_HTTPS_SSL_SOCKET_CLASS} = "Net::SSL";
#To remove host verification
$ENV{PERL_LWP_SSL_VERIFY_HOSTNAME} = 0;
}
@@ -526,6 +527,7 @@
}
}
my $user_agent = LWP::UserAgent->new(agent => "VI Perl");
+ $user_agent->ssl_opts( SSL_verify_mode => 0 );
my $cookie_jar = HTTP::Cookies->new(ignore_discard => 1);
$user_agent->cookie_jar($cookie_jar);
$user_agent->protocols_allowed(['http', 'https']);
@@ -2108,6 +2110,7 @@
sub new {
my ($class, $url) = @_;
my $user_agent = LWP::UserAgent->new(agent => "VI Perl");
+ $user_agent->ssl_opts( SSL_verify_mode => 0 );
my $cookie_jar = HTTP::Cookies->new(ignore_discard => 1);
$user_agent->cookie_jar( $cookie_jar );
$user_agent->protocols_allowed( ['http', 'https'] );
*****************************************************************

Hello
From what I found, the script takes the standard IO latency vmhba (vmhba0):

  /usr/local/nagios/libexec/check_esx3-0.5.pl D xxxx xxxx H -u nagiosvc p xxxx -l io
CHECK_ESX3-0.5.PL OK - aborted commands io = 0, io bus resets = 0, io = 4 ms read latency, write latency = 0 ms, = 0 ms latency kernel, device = 0 ms latency, queue latency ms = 0 | io_aborted = 0 ;; io_busresets = 0 ;; io_read = 4ms;; io_write = 0ms;; io_kernel = 0ms;; io_device = 0ms;; io_queue = 0ms;;

I have other vmhba, and what matters most is not the 0. You can customize the script to collect another? How can I do?

Grateful!

Great plugin, we use it for years!
Yesterday however I updated our Ubuntu server and the script does not work anymore. Error is:
Server version unavailable at 'https://x.x.x.x:443/sdk/vimService.wsdl' at /usr/lib/perl5/5.18/VMware/VICommon.pm line 545
I narrowed down the offending update to: liblwp-protocol-https-perl, version 6.04-2ubuntu0.1.
I reverted back to our backup and did not install this module, it is working fine again.

Good plugin but the percentage is buggy. For host swap check for instance you have to check against the host total swap usable. For instance I got an alert because my ESX is using 20MB of swap on 1.5GB. This is not exactly 20%.

Does what it says. I was able to setup this plugin without lot of problems for ESXi host. I still cannot create configuration for VM monitoring though. Can anybody help with the configuration I need to perform for monitoring VM cpu and memory parameters?

Working fine but Esxi logs are growing

every check create a Login event and a logout event in the event table of the Esxi.
We get a lot of check (2 check per VM every 5min). That is generating millions of lines in the Esxi database which became very slow. We already reduce the event&task conservation time but not enough.

Does anyone know a way to limit the number of login to Esxi done by the check ?

Regards,
Pradyumna

Great script does everything that I need. One note for people trying to install it. In my instance I am running Nagios on the latest Ubuntu server version.

I experienced the "(Service Check Timed Out)" problem.

I then tried installing the older Net-Http perl module (v 6.3):

perl -MCPAN -e shell
install GAAS/Net-HTTP-6.03.tar.gz

After installing that the Service Check Timed Out error went away, but was replaced with:

"Undefined subroutine &LWP::Protocol::https::Socket::can_read called at /usr/local/share/perl5/LWP/Protocol/http.pm line 22"

A little research (thank you GOOGLE!) found the fix. You also need to re-install Bundle::LWP from an older version, not just Net-HTTP.

perl -MCPAN -e shell
install GAAS/libwww-perl-6.03.tar.gz.

Now the sctipt is working great and does everything that I need.

This plugin does everything you have stated,

I was wondering if it was possible to pull disk statistics from this?

I want to be able to pull the disk iops / read / write latency and I would want to do it at the datastore level. I can retrieve this information when i log into the vcenter and do stats show.

Didn't know if this would be something that was relatively easy to add. Thanks for the plugin!