# # 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 network::cisco::prime::restapi::mode::apusage; use base qw(centreon::plugins::templates::counter); use strict; use warnings; use centreon::plugins::misc; use centreon::plugins::statefile; use centreon::plugins::templates::catalog_functions qw(catalog_status_threshold); sub custom_status_output { my ($self, %options) = @_; my $msg = 'status : ' . $self->{result_values}->{status} . ' (admin: ' . $self->{result_values}->{admin_status} . ')'; return $msg; } sub custom_status_calc { my ($self, %options) = @_; $self->{result_values}->{status} = $options{new_datas}->{$self->{instance} . '_status'}; $self->{result_values}->{name} = $options{new_datas}->{$self->{instance} . '_name'}; $self->{result_values}->{controller} = $options{new_datas}->{$self->{instance} . '_controller'}; $self->{result_values}->{admin_status} = $options{new_datas}->{$self->{instance} . '_admin_status'}; return 0; } sub custom_uptime_output { my ($self, %options) = @_; my $msg = 'uptime started since : ' . centreon::plugins::misc::change_seconds(value => $self->{result_values}->{uptime}); return $msg; } sub custom_lwappuptime_output { my ($self, %options) = @_; my $msg = 'lwapp uptime started since : ' . centreon::plugins::misc::change_seconds(value => $self->{result_values}->{lwapp_uptime}); return $msg; } sub set_counters { my ($self, %options) = @_; $self->{maps_counters_type} = [ { name => 'ctrl', type => 1, cb_prefix_output => 'prefix_controller_output', message_multiple => 'All controllers are ok', , skipped_code => { -11 => 1 } }, { name => 'ap', type => 1, cb_prefix_output => 'prefix_ap_output', message_multiple => 'All access points are ok', , skipped_code => { -11 => 1 } }, ]; $self->{maps_counters}->{ap} = [ { label => 'ap-status', threshold => 0, set => { key_values => [ { name => 'status' }, { name => 'name' }, { name => 'controller' }, { name => 'admin_status' } ], closure_custom_calc => $self->can('custom_status_calc'), closure_custom_output => $self->can('custom_status_output'), closure_custom_perfdata => sub { return 0; }, closure_custom_threshold_check => \&catalog_status_threshold, } }, { label => 'ap-clients', set => { key_values => [ { name => 'client_count' }, { name => 'name' } ], output_template => 'Clients : %s', perfdatas => [ { label => 'ap_clients', value => 'client_count', template => '%s', min => 0, label_extra_instance => 1, instance_use => 'name' }, ], } }, { label => 'ap-uptime', set => { key_values => [ { name => 'uptime' }, { name => 'name' } ], closure_custom_output => $self->can('custom_uptime_output'), perfdatas => [ { label => 'ap_uptime', value => 'uptime', template => '%s', min => 0, unit => 's', label_extra_instance => 1, instance_use => 'name' }, ], } }, { label => 'ap-lwappuptime', set => { key_values => [ { name => 'lwapp_uptime' }, { name => 'name' } ], closure_custom_output => $self->can('custom_lwappuptime_output'), perfdatas => [ { label => 'ap_lwappuptime', value => 'lwapp_uptime', template => '%s', min => 0, unit => 's', label_extra_instance => 1, instance_use => 'name' }, ], } }, ]; $self->{maps_counters}->{ctrl} = [ { label => 'ctrl-ap-count', set => { key_values => [ { name => 'ap_count' }, { name => 'name' } ], output_template => 'Number of access points : %s', perfdatas => [ { label => 'ctrl_ap_count', value => 'ap_count', template => '%s', min => 0, label_extra_instance => 1, instance_use => 'name' }, ], } }, ]; } sub new { my ($class, %options) = @_; my $self = $class->SUPER::new(package => __PACKAGE__, %options); bless $self, $class; $options{options}->add_options(arguments => { "filter-controller:s" => { name => 'filter_controller' }, "filter-ap:s" => { name => 'filter_ap' }, "warning-ap-status:s" => { name => 'warning_ap_status', default => '%{admin_status} =~ /enable/i && %{status} =~ /minor|warning/i' }, "critical-ap-status:s" => { name => 'critical_ap_status', default => '%{admin_status} =~ /enable/i && %{status} =~ /major|critical/i' }, "reload-cache-time:s" => { name => 'reload_cache_time', default => 5 }, }); $self->{statefile_cache_ap} = centreon::plugins::statefile->new(%options); return $self; } sub check_options { my ($self, %options) = @_; $self->SUPER::check_options(%options); $self->{statefile_cache_ap}->check_options(%options); $self->change_macros(macros => ['warning_ap_status', 'critical_ap_status']); } sub prefix_controller_output { my ($self, %options) = @_; return "Controller '" . $options{instance_value}->{name} . "' "; } sub prefix_ap_output { my ($self, %options) = @_; return "Access point '" . $options{instance_value}->{name} . "' "; } sub manage_selection { my ($self, %options) = @_; my $access_points = $options{custom}->cache_ap(statefile => $self->{statefile_cache_ap}, reload_cache_time => $self->{option_results}->{reload_cache_time}); ($self->{ap}, $self->{ctrl}) = ({}, {}); foreach my $ap_name (keys %{$access_points}) { $access_points->{$ap_name}->{controllerName} = 'NotRegistered' if (!defined($access_points->{$ap_name}->{controllerName})); if (defined($self->{option_results}->{filter_ap}) && $self->{option_results}->{filter_ap} ne '' && $ap_name !~ /$self->{option_results}->{filter_ap}/) { $self->{output}->output_add(long_msg => "skipping '" . $ap_name . "': no matching filter.", debug => 1); next; } if (defined($self->{option_results}->{filter_controller}) && $self->{option_results}->{filter_controller} ne '' && $access_points->{$ap_name}->{controllerName} !~ /$self->{option_results}->{filter_controller}/) { $self->{output}->output_add(long_msg => "skipping '" . $access_points->{$ap_name}->{controllerName} . "': no matching filter.", debug => 1); next; } $self->{ap}->{$ap_name} = { name => $ap_name, controller => $access_points->{$ap_name}->{controllerName}, status => $access_points->{$ap_name}->{status}, admin_status => $access_points->{$ap_name}->{adminStatus}, client_count => $access_points->{$ap_name}->{clientCount}, lwapp_uptime => $access_points->{$ap_name}->{lwappUpTime}, uptime => $access_points->{$ap_name}->{upTime}, }; $self->{ctrl}->{$access_points->{$ap_name}->{controllerName}} = { name => $access_points->{$ap_name}->{controllerName}, ap_count => 0 } if (!defined($self->{ctrl}->{$access_points->{$ap_name}->{controllerName}})); $self->{ctrl}->{$access_points->{$ap_name}->{controllerName}}->{ap_count}++; } if (scalar(keys %{$self->{ap}}) <= 0) { $self->{output}->add_option_msg(short_msg => "No AP found."); $self->{output}->option_exit(); } } 1; __END__ =head1 MODE Check AP usages (also the number of access points by controller). =over 8 =item B<--filter-ap> Filter ap name (can be a regexp). =item B<--filter-controller> Filter controller name (can be a regexp). =item B<--filter-counters> Only display some counters (regexp can be used). Example: --filter-counters='^total-error$' =item B<--warning-*> Threshold warning. Can be: 'ap-clients', 'ap-uptime', 'ap-lwappuptime', 'ctrl-ap-count'. =item B<--critical-*> Threshold critical. Can be: 'ap-clients', 'ap-uptime', 'ap-lwappuptime', 'ctrl-ap-count'. =item B<--warning-ap-status> Set warning threshold for status (Default: '%{admin_status} =~ /enable/i && %{status} =~ /minor|warning/i') Can used special variables like: %{name}, %{status}, %{controller}, %{admin_status} =item B<--critical-ap-status> Set critical threshold for status (Default: '%{admin_status} =~ /enable/i && %{status} =~ /major|critical/i'). Can used special variables like: %{name}, %{status}, %{controller}, %{admin_status} =item B<--reload-cache-time> Time in minutes before reloading cache file (default: 5). =back =cut