From 5b75e9ca373d065785113c44246d05ce9867b66e Mon Sep 17 00:00:00 2001 From: Simon Bomm Date: Wed, 4 Aug 2021 11:19:22 +0200 Subject: [PATCH] enh(cisco/wlc): add discovery access points (#3015) --- .../common/airespace/snmp/mode/discovery.pm | 172 ++++++++++++++++++ .../network/cisco/wlc/snmp/plugin.pm | 1 + 2 files changed, 173 insertions(+) create mode 100644 centreon-plugins/centreon/common/airespace/snmp/mode/discovery.pm diff --git a/centreon-plugins/centreon/common/airespace/snmp/mode/discovery.pm b/centreon-plugins/centreon/common/airespace/snmp/mode/discovery.pm new file mode 100644 index 000000000..c9c12c85a --- /dev/null +++ b/centreon-plugins/centreon/common/airespace/snmp/mode/discovery.pm @@ -0,0 +1,172 @@ +# +# Copyright 2021 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 centreon::common::airespace::snmp::mode::discovery; + +use base qw(centreon::plugins::mode); + +use strict; +use warnings; +use JSON::XS; + +sub new { + my ($class, %options) = @_; + my $self = $class->SUPER::new(package => __PACKAGE__, %options); + bless $self, $class; + + $options{options}->add_options(arguments => { + "filter-admin-down" => { name => 'filter_admin_down' }, + "prettify" => { name => 'prettify' }, + }); + + return $self; +} + +sub check_options { + my ($self, %options) = @_; + $self->SUPER::init(%options); +} + +my $map_admin_status = { + 1 => 'enable', + 2 => 'disable' +}; +my $map_operation_status = { + 1 => 'associated', + 2 => 'disassociating', + 3 => 'downloading' +}; + +my $mapping = { + ap_name => { oid => '.1.3.6.1.4.1.14179.2.2.1.1.3' }, # bsnAPName + ap_ipaddr => { oid => '.1.3.6.1.4.1.14179.2.2.1.1.19' }, #bsnApIpAddress +}; +my $mapping2 = { + opstatus => { oid => '.1.3.6.1.4.1.14179.2.2.1.1.6', map => $map_operation_status }, # bsnAPOperationStatus + admstatus => { oid => '.1.3.6.1.4.1.14179.2.2.1.1.37', map => $map_admin_status } # bsnAPAdminStatus +}; + +my $oid_agentInventoryMachineModel = '.1.3.6.1.4.1.14179.1.1.1.3'; + +sub run { + my ($self, %options) = @_; + + my %ap; + my @disco_data; + my $disco_stats; + + $disco_stats->{start_time} = time(); + + my $request = [ { oid => $oid_agentInventoryMachineModel }, + { oid => $mapping->{ap_name}->{oid} }, + { oid => $mapping->{ap_ipaddr}->{oid} } ]; + + my $snmp_result = $options{snmp}->get_multiple_table( + oids => $request, + return_type => 1, + nothing_quit => 1 + ); + + foreach (keys %$snmp_result) { + next if (! /^$mapping->{ap_name}->{oid}\.(.*)/); + my $instance = $1; + + my $result = $options{snmp}->map_instance( + mapping => $mapping, + results => $snmp_result, + instance => $instance); + + $self->{ap}->{ $result->{ap_name} } = { + name => $result->{ap_name}, + instance => $instance, + ip => $result->{ap_ipaddr}, + model => (defined($snmp_result->{$oid_agentInventoryMachineModel . '.0'}) ? + $snmp_result->{$oid_agentInventoryMachineModel . '.0'} : + 'unknown') + }; + } + + $options{snmp}->load( + oids => [ map($_->{oid}, values(%$mapping2)) ], + instances => [ map($_->{instance}, values %{$self->{ap}}) ], + instance_regexp => '^(.*)$' + ); + + $snmp_result = $options{snmp}->get_leef(); + + foreach my $ap_name (keys %{$self->{ap}}) { + my $result = $options{snmp}->map_instance( + mapping => $mapping2, + results => $snmp_result, + instance => $self->{ap}->{ $ap_name }->{instance}); + + $self->{ap}->{ $ap_name }->{admstatus} = $result->{admstatus}; + $self->{ap}->{ $ap_name }->{opstatus} = $result->{opstatus}; + + next if (defined($self->{option_results}->{filter_admin_down}) && $result->{admstatus} eq 'disable'); + push @disco_data, $self->{ap}->{ $ap_name }; + } + + $disco_stats->{end_time} = time(); + $disco_stats->{duration} = $disco_stats->{end_time} - $disco_stats->{start_time}; + $disco_stats->{discovered_items} = @disco_data; + $disco_stats->{results} = \@disco_data; + + my $encoded_data; + eval { + if (defined($self->{option_results}->{prettify})) { + $encoded_data = JSON::XS->new->utf8->pretty->encode($disco_stats); + } else { + $encoded_data = JSON::XS->new->utf8->encode($disco_stats); + } + }; + if ($@) { + $encoded_data = '{"code":"encode_error","message":"Cannot encode discovered data into JSON format"}'; + } + + $self->{output}->output_add(short_msg => $encoded_data); + $self->{output}->display(nolabel => 1, force_ignore_perfdata => 1); + $self->{output}->exit(); +} + +1; + +__END__ + +=head1 MODE + +Cisco WLC/Airspace AP discovery. + +Note: When the IP Address is 0, that means the switch is operating in layer2 mode +Ref: https://cric.grenoble.cnrs.fr/Administrateurs/Outils/MIBS/?oid=1.3.6.1.4.1.14179.2.2.1.1.19 + +=over 8 + +=item B<--prettify> + +Prettify JSON output. + +=item B<--filter-admin-down> + +Exclude administratively down access points from the discovery result + +=back + +=cut diff --git a/centreon-plugins/network/cisco/wlc/snmp/plugin.pm b/centreon-plugins/network/cisco/wlc/snmp/plugin.pm index 321b806e4..ae31c60bf 100644 --- a/centreon-plugins/network/cisco/wlc/snmp/plugin.pm +++ b/centreon-plugins/network/cisco/wlc/snmp/plugin.pm @@ -36,6 +36,7 @@ sub new { 'ap-status' => 'centreon::common::airespace::snmp::mode::apstatus', 'ap-users' => 'centreon::common::airespace::snmp::mode::apusers', 'cpu' => 'centreon::common::airespace::snmp::mode::cpu', + 'discovery' => 'centreon::common::airespace::snmp::mode::discovery', 'hardware' => 'centreon::common::airespace::snmp::mode::hardware', 'interfaces' => 'snmp_standard::mode::interfaces', 'list-groups' => 'centreon::common::airespace::snmp::mode::listgroups',