centreon-plugins/centreon/common/aruba/snmp/mode/apssidstatistics.pm

264 lines
11 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 centreon::common::aruba::snmp::mode::apssidstatistics;
use base qw(centreon::plugins::templates::counter);
use strict;
use warnings;
sub set_counters {
my ($self, %options) = @_;
$self->{maps_counters_type} = [
{ name => 'ap', type => 3, cb_prefix_output => 'prefix_output_ap', cb_long_output => 'long_output',
message_multiple => 'All AP BSSID are ok', indent_long_output => ' ',
group => [
{ name => 'global', type => 0 },
{ name => 'essid', display_long => 1, cb_prefix_output => 'prefix_output_essid',
message_multiple => 'All ESSID are ok', type => 1 },
{ name => 'bssid', display_long => 1, cb_prefix_output => 'prefix_output_bssid',
message_multiple => 'All BSSID are ok', type => 1 },
]
}
];
$self->{maps_counters}->{global} = [
{ label => 'stations-associated', nlabel => 'stations.associated.count', set => {
key_values => [ { name => 'total' } ],
output_template => 'Stations Associated: %d',
perfdatas => [
{ value => 'total', template => '%d', min => 0 },
],
}
},
];
$self->{maps_counters}->{essid} = [
{ label => 'essid-stations-associated', nlabel => 'essid.stations.associated.count', set => {
key_values => [ { name => 'wlanAPEssidNumAssociatedStations' }, { name => 'wlanAPESSID' } ],
output_template => 'Associated Stations: %d',
perfdatas => [
{ value => 'wlanAPEssidNumAssociatedStations', template => '%d',
label_extra_instance => 1 },
],
}
},
];
$self->{maps_counters}->{bssid} = [
{ label => 'bssid-stations-associated', nlabel => 'bssid.stations.associated.count', set => {
key_values => [ { name => 'wlanAPBssidNumAssociatedStations' }, { name => 'wlanAPBSSID' },
{ name => 'wlanAPESSID' } ],
output_template => 'Associated Stations: %d',
perfdatas => [
{ value => 'wlanAPBssidNumAssociatedStations', template => '%d',
label_extra_instance => 1 },
],
}
},
{ label => 'channel-noise', nlabel => 'bssid.channel.noise.count', set => {
key_values => [ { name => 'apChannelNoise' }, { name => 'wlanAPBSSID' },
{ name => 'wlanAPESSID' } ],
output_template => 'Channel Noise: %d',
perfdatas => [
{ value => 'apChannelNoise', template => '%d',
label_extra_instance => 1 },
],
}
},
{ label => 'signal-noise-ratio', nlabel => 'bssid.signal.noise.ratio.count', set => {
key_values => [ { name => 'apSignalToNoiseRatio' }, { name => 'wlanAPBSSID' },
{ name => 'wlanAPESSID' } ],
output_template => 'Signal To Noise Ratio: %d',
perfdatas => [
{ value => 'apSignalToNoiseRatio', template => '%d',
label_extra_instance => 1 },
],
}
},
];
}
sub prefix_output_ap {
my ($self, %options) = @_;
return "AP '" . $options{instance_value}->{wlanAPName} . "' [Mac: " . $options{instance_value}->{wlanAPMacAddress} . "] ";
}
sub prefix_output_essid {
my ($self, %options) = @_;
return "ESSID '" . $options{instance_value}->{wlanAPESSID} . "' ";
}
sub prefix_output_bssid {
my ($self, %options) = @_;
return "BSSID '" . $options{instance_value}->{wlanAPBSSID} . "' [ESSID: " .
$options{instance_value}->{wlanAPESSID} . "][Protocol: " . $options{instance_value}->{wlanAPBssidPhyType} . "] ";
}
sub long_output {
my ($self, %options) = @_;
return "Checking AP '" . $options{instance_value}->{wlanAPName} . "' [Mac: " . $options{instance_value}->{wlanAPMacAddress} . "] ";
}
sub new {
my ($class, %options) = @_;
my $self = $class->SUPER::new(package => __PACKAGE__, %options, force_new_perfdata => 1);
bless $self, $class;
$options{options}->add_options(arguments => {
"filter-ap:s" => { name => 'filter_ap' },
"filter-essid:s" => { name => 'filter_essid' },
"filter-protocol:s" => { name => 'filter_protocol' },
"filter-bssid:s" => { name => 'filter_bssid' },
});
return $self;
}
my %map_type = (
1 => '802.11a', 2 => '802.11b', 3 => '802.11g',
4 => '802.11ag', 5 => 'wired'
);
my $oid_wlsxSwitchAccessPointTable = '.1.3.6.1.4.1.14823.2.2.1.1.3.3.1';
my $mapping_switch = {
apChannelNoise => { oid => '.1.3.6.1.4.1.14823.2.2.1.1.3.3.1.13' },
apSignalToNoiseRatio => { oid => '.1.3.6.1.4.1.14823.2.2.1.1.3.3.1.14' },
};
my $oid_wlsxWlanAPBssidTable = '.1.3.6.1.4.1.14823.2.2.1.5.2.1.7.1';
my $mapping_wlan = {
wlanAPESSID => { oid => '.1.3.6.1.4.1.14823.2.2.1.5.2.1.7.1.2' },
wlanAPBssidPhyType => { oid => '.1.3.6.1.4.1.14823.2.2.1.5.2.1.7.1.5', map => \%map_type },
wlanAPBssidUpTime => { oid => '.1.3.6.1.4.1.14823.2.2.1.5.2.1.7.1.9' },
wlanAPBssidInactiveTime => { oid => '.1.3.6.1.4.1.14823.2.2.1.5.2.1.7.1.10' },
wlanAPBssidNumAssociatedStations => { oid => '.1.3.6.1.4.1.14823.2.2.1.5.2.1.7.1.12' },
};
my $oid_wlanAPName = '.1.3.6.1.4.1.14823.2.2.1.5.2.1.4.1.3';
sub manage_selection {
my ($self, %options) = @_;
my $snmp_result = $options{snmp}->get_multiple_table(
oids => [
{ oid => $oid_wlsxSwitchAccessPointTable,
start => $mapping_switch->{apChannelNoise}->{oid},
end => $mapping_switch->{apSignalToNoiseRatio}->{oid} },
{ oid => $oid_wlsxWlanAPBssidTable,
start => $mapping_wlan->{wlanAPESSID}->{oid},
end => $mapping_wlan->{wlanAPBssidNumAssociatedStations}->{oid} },
{ oid => $oid_wlanAPName },
],
nothing_quit => 1
);
$self->{ap} = {};
foreach my $oid (keys %{$snmp_result->{$oid_wlsxWlanAPBssidTable}}) {
next if ($oid !~ /^$mapping_wlan->{wlanAPESSID}->{oid}\.(.*)/);
my $instance = $1;
my $result = $options{snmp}->map_instance(
mapping => $mapping_wlan,
results => $snmp_result->{$oid_wlsxWlanAPBssidTable},
instance => $instance
);
my @digits = split /\./, $instance;
$result->{wlanAPMacAddress} = join(':', unpack("(A2)*", unpack('H*', pack('C*', @digits[0..5]))));
$result->{wlanAPBSSID} = join(':', unpack("(A2)*", unpack('H*', pack('C*', @digits[7..12]))));
$result->{wlanAPName} = $snmp_result->{$oid_wlanAPName}->{$oid_wlanAPName . '.' . join('.', @digits[0..5])};
$result->{apChannelNoise} = $snmp_result->{$oid_wlsxSwitchAccessPointTable}->{$mapping_switch->{apChannelNoise}->{oid} . '.' . join('.', @digits[7..12])};
$result->{apSignalToNoiseRatio} = $snmp_result->{$oid_wlsxSwitchAccessPointTable}->{$mapping_switch->{apSignalToNoiseRatio}->{oid} . '.' . join('.', @digits[7..12])};
if (defined($self->{option_results}->{filter_ap}) && $self->{option_results}->{filter_ap} ne '' &&
$result->{wlanAPName} !~ /$self->{option_results}->{filter_ap}/) {
$self->{output}->output_add(long_msg => "skipping '" . $result->{wlanAPName} . "': no matching filter name.", debug => 1);
next;
}
if (defined($self->{option_results}->{filter_essid}) && $self->{option_results}->{filter_essid} ne '' &&
$result->{wlanAPESSID} !~ /$self->{option_results}->{filter_essid}/) {
$self->{output}->output_add(long_msg => "skipping '" . $result->{wlanAPESSID} . "': no matching filter essid.", debug => 1);
next;
}
if (defined($self->{option_results}->{filter_bssid}) && $self->{option_results}->{filter_bssid} ne '' &&
$result->{wlanAPBSSID} !~ /$self->{option_results}->{filter_bssid}/) {
$self->{output}->output_add(long_msg => "skipping '" . $result->{wlanAPESSID} . "': no matching filter bssid.", debug => 1);
next;
}
if (defined($self->{option_results}->{filter_protocol}) && $self->{option_results}->{filter_protocol} ne '' &&
$result->{wlanAPBssidPhyType} !~ /$self->{option_results}->{filter_protocol}/) {
$self->{output}->output_add(long_msg => "skipping '" . $result->{wlanAPBssidPhyType} . "': no matching filter protocol.", debug => 1);
next;
}
$self->{ap}->{$result->{wlanAPName}}->{global}->{total} += $result->{wlanAPBssidNumAssociatedStations};
$self->{ap}->{$result->{wlanAPName}}->{wlanAPName} = $result->{wlanAPName};
$self->{ap}->{$result->{wlanAPName}}->{wlanAPMacAddress} = $result->{wlanAPMacAddress};
$self->{ap}->{$result->{wlanAPName}}->{essid}->{$result->{wlanAPESSID}}->{wlanAPEssidNumAssociatedStations} += $result->{wlanAPBssidNumAssociatedStations};
$self->{ap}->{$result->{wlanAPName}}->{essid}->{$result->{wlanAPESSID}}->{wlanAPESSID} = $result->{wlanAPESSID};
$self->{ap}->{$result->{wlanAPName}}->{bssid}->{$result->{wlanAPBSSID}} = { %{$result} };
}
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 ESSID and BSSID statistics (WLSX-WLAN-MIB, WLSX-SWITCH-MIB).
=over 8
=item B<--warning-*>
Threshold warning.
Can be: 'stations-associated' (ESSID and BSSID),
'channel-noise', 'signal-noise-ratio' (BSSID).
=item B<--critical-*>
Threshold critical.
Can be: 'stations-associated' (ESSID and BSSID),
'channel-noise', 'signal-noise-ratio' (BSSID).
=item B<--filter-*>
Filter by 'ap', 'essid', 'protocol', 'bssid' (regexp can be used).
=back
=cut