centreon-plugins/apps/pvx/restapi/mode/networktraffic.pm

239 lines
8.5 KiB
Perl

#
# Copyright 2020 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::pvx::restapi::mode::networktraffic;
use base qw(centreon::plugins::templates::counter);
use strict;
use warnings;
sub set_counters {
my ($self, %options) = @_;
$self->{maps_counters_type} = [
{ name => 'global', type => 0, cb_init => 'skip_global' },
{ name => 'instances', type => 1, cb_prefix_output => 'prefix_instances_output', message_multiple => 'All traffic usage are ok' },
];
$self->{maps_counters}->{global} = [
{ label => 'total-traffic', set => {
key_values => [ { name => 'total_traffic' } ],
output_template => 'Total Traffic: %.2f %s/s',
output_change_bytes => 2,
perfdatas => [
{ label => 'total_traffic', template => '%d', min => 0, unit => 'b/s' }
]
}
},
{ label => 'total-server-traffic', set => {
key_values => [ { name => 'total_server_traffic' } ],
output_template => 'Total Server Traffic: %.2f %s/s',
output_change_bytes => 2,
perfdatas => [
{ label => 'total_server_traffic', template => '%d', min => 0, unit => 'b/s' }
]
}
},
{ label => 'total-client-traffic', set => {
key_values => [ { name => 'total_client_traffic' } ],
output_template => 'Total Client Traffic: %.2f %s/s',
output_change_bytes => 2,
perfdatas => [
{ label => 'total_client_traffic', template => '%d', min => 0, unit => 'b/s' }
]
}
}
];
$self->{maps_counters}->{instances} = [
{ label => 'traffic', set => {
key_values => [ { name => 'traffic' }, { name => 'key' }, { name => 'instance_label' } ],
output_template => 'Traffic: %.2f %s/s',
output_change_bytes => 2,
perfdatas => [
{ label => 'traffic', template => '%d',
min => 0, unit => 'b/s', label_extra_instance => 1, instance_use => 'key' }
]
}
},
{ label => 'server-traffic', set => {
key_values => [ { name => 'server_traffic' }, { name => 'key' }, { name => 'instance_label' } ],
output_template => 'Server Traffic: %.2f %s/s',
output_change_bytes => 2,
perfdatas => [
{ label => 'server_traffic', template => '%d',
min => 0, unit => 'b/s', label_extra_instance => 1, instance_use => 'key' }
]
}
},
{ label => 'client-traffic', set => {
key_values => [ { name => 'client_traffic' }, { name => 'key' }, { name => 'instance_label' } ],
output_template => 'Client Traffic: %.2f %s/s',
output_change_bytes => 2,
perfdatas => [
{ label => 'client_traffic', template => '%d',
min => 0, unit => 'b/s', label_extra_instance => 1, instance_use => 'key' }
]
}
}
];
}
sub skip_global {
my ($self, %options) = @_;
scalar(keys %{$self->{instances}}) > 1 ? return(0) : return(1);
}
sub prefix_instances_output {
my ($self, %options) = @_;
return $options{instance_value}->{instance_label} . " '" . $options{instance_value}->{key} . "' ";
}
sub new {
my ($class, %options) = @_;
my $self = $class->SUPER::new(package => __PACKAGE__, %options);
bless $self, $class;
$options{options}->add_options(arguments => {
'instance:s' => { name => 'instance', default => 'layer' },
'top:s' => { name => 'top' },
'filter:s' => { name => 'filter' },
'from:s' => { name => 'from' },
});
return $self;
}
sub check_options {
my ($self, %options) = @_;
$self->SUPER::check_options(%options);
if (!defined($self->{option_results}->{from}) || $self->{option_results}->{from} eq '') {
$self->{output}->add_option_msg(short_msg => "Need to specify --from option as a PVQL object.");
$self->{output}->option_exit();
}
if (!defined($self->{option_results}->{instance}) || $self->{option_results}->{instance} eq '') {
$self->{output}->add_option_msg(short_msg => "Need to specify --instance option as a PVQL object.");
$self->{output}->option_exit();
}
$self->{pvql_timeframe} = defined($self->{option_results}->{timeframe}) ? $self->{option_results}->{timeframe} : 900;
}
sub manage_selection {
my ($self, %options) = @_;
my $instance_label = $self->{option_results}->{instance};
$instance_label =~ s/\./ /g;
$instance_label =~ s/(\w+)/\u\L$1/g;
$self->{instances} = {};
my $apps;
if ($self->{option_results}->{instance} =~ /application/) {
my $results = $options{custom}->get_endpoint(url_path => '/get-configuration');
$apps = $results->{applications};
}
my $results = $options{custom}->query_range(
query => 'traffic, server.traffic, client.traffic',
instance => $self->{option_results}->{instance},
top => $self->{option_results}->{top},
filter => $self->{option_results}->{filter},
from => $self->{option_results}->{from},
timeframe => $self->{pvql_timeframe},
);
foreach my $result (@{$results}) {
next if (!defined(${$result->{key}}[0]));
my $instance;
$instance = ${$result->{key}}[0]->{value} if (defined(${$result->{key}}[0]->{value}));
$instance = ${$result->{key}}[0]->{status} if (defined(${$result->{key}}[0]->{status}));
$self->{instances}->{$instance}->{key} = $instance;
$self->{instances}->{$instance}->{key} = $apps->{$instance}->{name} if (defined($apps->{$instance}->{name}) && $self->{option_results}->{instance} =~ /application/);
$self->{instances}->{$instance}->{traffic} = ${$result->{values}}[0]->{value} * 8 / $self->{pvql_timeframe};
$self->{instances}->{$instance}->{server_traffic} = ${$result->{values}}[1]->{value} * 8 / $self->{pvql_timeframe};
$self->{instances}->{$instance}->{client_traffic} = ${$result->{values}}[2]->{value} * 8 / $self->{pvql_timeframe};
$self->{instances}->{$instance}->{instance_label} = $instance_label;
$self->{global}->{total_traffic} += ${$result->{values}}[0]->{value} * 8 / $self->{pvql_timeframe};
$self->{global}->{total_server_traffic} += ${$result->{values}}[1]->{value} * 8 / $self->{pvql_timeframe};
$self->{global}->{total_client_traffic} += ${$result->{values}}[2]->{value} * 8 / $self->{pvql_timeframe};
}
if (scalar(keys %{$self->{instances}}) <= 0) {
$self->{output}->add_option_msg(short_msg => "No instances or results found.");
$self->{output}->option_exit();
}
}
1;
__END__
=head1 MODE
Check instances traffic usage.
=over 8
=item B<--instance>
Filter on a specific instance (Must be a PVQL object, Default: 'layer')
(Object 'application' will be mapped with applications name)
=item B<--filter>
Add a PVQL filter (Example: --filter='application = "mysql"')
=item B<--from>
Add a PVQL from clause to filter on a specific layer (Example: --from='tcp')
=item B<--top>
Only search for the top X results (top is made on 'traffic').
=item B<--warning-*>
Threshold warning.
Can be: 'total-traffic', 'total-client-traffic', 'total-server-traffic',
'traffic', 'client-traffic', 'server-traffic'.
=item B<--critical-*>
Threshold critical.
Can be: 'total-traffic', 'total-client-traffic', 'total-server-traffic',
'traffic', 'client-traffic', 'server-traffic'.
=item B<--filter-counters>
Only display some counters (regexp can be used).
Example: --filter-counters='total-traffic'
=back
=cut