centreon-plugins/apps/vmware/connector/custom/connector.pm

313 lines
11 KiB
Perl

#
# Copyright 2018 Centreon (http://www.centreon.com/)
#
# Centreon is a full-fledged industry-strength solution that meets
# the needs in IT infrastructure and application monitoring for
# service performance.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#
package apps::vmware::connector::custom::connector;
use strict;
use warnings;
use JSON;
use ZMQ::LibZMQ4;
use ZMQ::Constants qw(:all);
use UUID;
sub new {
my ($class, %options) = @_;
my $self = {};
bless $self, $class;
# $options{options} = options object
# $options{output} = output object
# $options{exit_value} = integer
# $options{noptions} = integer
if (!defined($options{output})) {
print "Class Custom: Need to specify 'output' argument.\n";
exit 3;
}
if (!defined($options{options})) {
$options{output}->add_option_msg(short_msg => "Class Custom: Need to specify 'options' argument.");
$options{output}->option_exit();
}
if (!defined($options{noptions})) {
$options{options}->add_options(arguments =>
{
"connector-hostname:s@" => { name => 'connector_hostname' },
"connector-port:s@" => { name => 'connector_port' },
"vsphere-address:s@" => { name => 'vsphere_address' },
"vsphere-username:s@" => { name => 'vsphere_username' },
"vsphere-password:s@" => { name => 'vsphere_password' },
"container:s@" => { name => 'container' },
"timeout:s@" => { name => 'timeout' },
"sampling-period:s@" => { name => 'sampling_period' },
"time-shift:s@" => { name => 'time_shift' },
});
}
$options{options}->add_help(package => __PACKAGE__, sections => 'CONNECTOR OPTIONS', once => 1);
$self->{output} = $options{output};
$self->{mode} = $options{mode};
$self->{json_send} = {};
return $self;
}
# Method to manage multiples
sub set_options {
my ($self, %options) = @_;
# options{options_result}
$self->{option_results} = $options{option_results};
}
# Method to manage multiples
sub set_defaults {
my ($self, %options) = @_;
# options{default}
# Manage default value
foreach (keys %{$options{default}}) {
if ($_ eq $self->{mode}) {
for (my $i = 0; $i < scalar(@{$options{default}->{$_}}); $i++) {
foreach my $opt (keys %{$options{default}->{$_}[$i]}) {
if (!defined($self->{option_results}->{$opt}[$i])) {
$self->{option_results}->{$opt}[$i] = $options{default}->{$_}[$i]->{$opt};
}
}
}
}
}
}
sub check_options {
my ($self, %options) = @_;
# return 1 = ok still hostname
# return 0 = no hostname left
$self->{connector_hostname} = (defined($self->{option_results}->{connector_hostname})) ? shift(@{$self->{option_results}->{connector_hostname}}) : undef;
$self->{connector_port} = (defined($self->{option_results}->{connector_port})) ? shift(@{$self->{option_results}->{connector_port}}) : 5700;
$self->{container} = (defined($self->{option_results}->{container})) ? shift(@{$self->{option_results}->{container}}) : 'default';
$self->{timeout} = (defined($self->{option_results}->{timeout})) ? shift(@{$self->{option_results}->{timeout}}) : undef;
$self->{vsphere_address} = (defined($self->{option_results}->{vsphere_address})) ? shift(@{$self->{option_results}->{vsphere_address}}) : undef;
$self->{vsphere_username} = (defined($self->{option_results}->{vsphere_username})) ? shift(@{$self->{option_results}->{vsphere_username}}) : undef;
$self->{vsphere_password} = (defined($self->{option_results}->{vsphere_password})) ? shift(@{$self->{option_results}->{vsphere_password}}) : undef;
$self->{sampling_period} = (defined($self->{option_results}->{sampling_period})) ? shift(@{$self->{option_results}->{sampling_period}}) : undef;
$self->{time_shift} = (defined($self->{option_results}->{sampling_period})) ? shift(@{$self->{option_results}->{time_shift}}) : 0;
$self->{connector_port} = 5700 if ($self->{connector_port} eq '');
$self->{container} = 'default' if ($self->{container} eq '');
if (!defined($self->{connector_hostname}) || $self->{connector_hostname} eq '') {
$self->{output}->add_option_msg(short_msg => "Please set option --connector-hostname.");
$self->{output}->option_exit();
}
if (defined($self->{timeout}) && $self->{timeout} =~ /^\d+$/ &&
$self->{timeout} > 0) {
$self->{timeout} = $self->{timeout};
} else {
$self->{timeout} = 50;
}
if (!defined($self->{connector_hostname}) ||
scalar(@{$self->{option_results}->{connector_hostname}}) == 0) {
return 0;
}
return 1;
}
sub set_discovery {
my ($self, %options) = @_;
$self->{discovery} = 1;
}
sub add_params {
my ($self, %options) = @_;
$self->{json_send}->{command} = $options{command} if (defined($options{command}));
foreach (keys %{$options{params}}) {
$self->{json_send}->{$_} = $options{params}->{$_};
}
}
sub connector_response {
my ($self, %options) = @_;
if (!defined($options{response})) {
$self->{output}->add_option_msg(short_msg => "Cannot read response: $!");
$self->{output}->option_exit();
}
my $data = zmq_msg_data($options{response});
if ($data !~ /^RESPSERVER (.*)/msi) {
$self->{output}->add_option_msg(short_msg => "Response not formatted: $data");
$self->{output}->option_exit();
}
my $json = $1;
my $result;
eval {
$result = JSON->new->utf8->decode($json);
};
if ($@) {
$self->{output}->add_option_msg(short_msg => "Cannot decode json result: $@");
$self->{output}->option_exit();
}
foreach my $output (@{$result->{plugin}->{outputs}}) {
if ($output->{type} == 1) {
$self->{output}->output_add(severity => $output->{exit},
short_msg => $output->{msg});
} elsif ($output->{type} == 2) {
$self->{output}->output_add(long_msg => $output->{msg});
}
}
foreach my $perf (@{$result->{plugin}->{perfdatas}}) {
$self->{output}->perfdata_add(label => $perf->{label}, unit => $perf->{unit},
value => $perf->{value},
warning => $perf->{warning},
critical => $perf->{critical},
min => $perf->{min}, max => $perf->{max});
}
}
sub run {
my ($self, %options) = @_;
# Build request
my $uuid;
UUID::generate($uuid);
$self->{uuid} = $uuid;
$self->{json_send}->{identity} = 'client-' . unpack('H*', $self->{uuid});
$self->{json_send}->{connector_hostname} = $self->{connector_hostname};
$self->{json_send}->{connector_port} = $self->{connector_port};
$self->{json_send}->{container} = $self->{container};
$self->{json_send}->{vsphere_address} = $self->{vsphere_address};
$self->{json_send}->{vsphere_username} = $self->{vsphere_username};
$self->{json_send}->{vsphere_password} = $self->{vsphere_password};
$self->{json_send}->{sampling_period} = $self->{sampling_period};
$self->{json_send}->{time_shift} = $self->{time_shift};
# Init
my $context = zmq_init();
$self->{requester} = zmq_socket($context, ZMQ_DEALER);
if (!defined($self->{requester})) {
$self->{output}->add_option_msg(short_msg => "Cannot create socket: $!");
$self->{output}->option_exit();
}
my $flag = ZMQ_NOBLOCK | ZMQ_SNDMORE;
zmq_setsockopt($self->{requester}, ZMQ_IDENTITY, "client-" . $self->{uuid});
zmq_setsockopt($self->{requester}, ZMQ_LINGER, 0); # we discard
zmq_connect($self->{requester}, 'tcp://' . $self->{connector_hostname} . ':' . $self->{connector_port});
zmq_sendmsg($self->{requester}, "REQCLIENT " . JSON->new->utf8->encode($self->{json_send}), ZMQ_NOBLOCK);
my @poll = (
{
socket => $self->{requester},
events => ZMQ_POLLIN,
callback => sub {
my $response = zmq_recvmsg($self->{requester});
zmq_close($self->{requester});
$self->connector_response(response => $response);
# We need to remove xml output
if (defined($self->{output}->{option_results}->{output_xml})) {
delete $self->{output}->{option_results}->{output_xml};
}
if (!defined($self->{discovery})) {
$self->{output}->display();
} else {
$self->{output}->display(nolabel => 1, force_ignore_perfdata => 1, force_long_output => 1);
}
$self->{output}->exit();
},
},
);
zmq_poll(\@poll, $self->{timeout} * 1000);
zmq_close($self->{requester});
$self->{output}->output_add(severity => 'UNKNOWN',
short_msg => sprintf("Cannot get response (timeout received)"));
$self->{output}->display();
$self->{output}->exit();
}
1;
__END__
=head1 NAME
VMWare connector library
=head1 SYNOPSIS
my vmware connector
=head1 CONNECTOR OPTIONS
=over 8
=item B<--connector-hostname>
Connector hostname (required).
=item B<--connector-port>
Connector port (default: 5700).
=item B<--container>
Container to use (it depends of the connector configuration).
=item B<--vsphere-address>
Address of vpshere/ESX to connect.
=item B<--vsphere-username>
Username of vpshere/ESX connection (with --vsphere-address).
=item B<--vsphere-password>
Password of vpshere/ESX connection (with --vsphere-address).
=item B<--timeout>
Set global execution timeout (Default: 50)
=item B<--sampling-period>
Choose the sampling period (can change the default sampling for counters).
Should be not different than 300 or 20.
=item B<--time-shift>
Can shift the time. We the following option you can average X counters values (default: 0).
=back
=head1 DESCRIPTION
B<custom>.
=cut