# # 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 network::ruckus::zonedirector::snmp::mode::accesspoints; use base qw(centreon::plugins::templates::counter); use strict; use warnings; use Digest::MD5 qw(md5_hex); use centreon::plugins::templates::catalog_functions qw(catalog_status_threshold catalog_status_calc); sub custom_status_output { my ($self, %options) = @_; return sprintf('zone directory connection status is %s', $self->{result_values}->{zd_connection_status} ); } sub ap_long_output { my ($self, %options) = @_; return "checking access point '" . $options{instance_value}->{display} . "'"; } sub prefix_ap_output { my ($self, %options) = @_; return "access point '" . $options{instance_value}->{display} . "' "; } sub custom_usage_output { my ($self, %options) = @_; return sprintf( 'ram total: %s %s used: %s %s (%.2f%%) free: %s %s (%.2f%%)', $self->{perfdata}->change_bytes(value => $self->{result_values}->{total}), $self->{perfdata}->change_bytes(value => $self->{result_values}->{used}), $self->{result_values}->{prct_used}, $self->{perfdata}->change_bytes(value => $self->{result_values}->{free}), $self->{result_values}->{prct_free} ); } sub set_counters { my ($self, %options) = @_; $self->{maps_counters_type} = [ { name => 'accesspoints', type => 3, cb_prefix_output => 'prefix_ap_output', cb_long_output => 'ap_long_output', indent_long_output => ' ', message_multiple => 'All access points are ok', group => [ { name => 'status', type => 0, skipped_code => { -10 => 1 } }, { name => 'cpu', type => 0, skipped_code => { -10 => 1 } }, { name => 'memory', type => 0, skipped_code => { -10 => 1 } }, { name => 'connection', type => 0, skipped_code => { -10 => 1 } }, { name => 'traffic', type => 0, skipped_code => { -10 => 1 } } ] } ]; $self->{maps_counters}->{status} = [ { label => 'status', threshold => 0, set => { key_values => [ { name => 'zd_connection_status' }, { name => 'display' } ], closure_custom_calc => \&catalog_status_calc, closure_custom_output => $self->can('custom_status_output'), closure_custom_perfdata => sub { return 0; }, closure_custom_threshold_check => \&catalog_status_threshold } } ]; $self->{maps_counters}->{cpu} = [ { label => 'cpu-utilization', nlabel => 'accesspoint.cpu.utilization.percentage', set => { key_values => [ { name => 'cpu_util' }, { name => 'display' } ], output_template => 'cpu usage: %.2f%%', perfdatas => [ { template => '%.2f', unit => '%', min => 0, max => 100, label_extra_instance => 1, instance_use => 'display' } ] } } ]; $self->{maps_counters}->{memory} = [ { label => 'memory-usage', nlabel => 'accesspoint.memory.usage.bytes', set => { key_values => [ { name => 'used' }, { name => 'free' }, { name => 'prct_used' }, { name => 'prct_free' }, { name => 'total' }, { name => 'display' } ], closure_custom_output => $self->can('custom_usage_output'), perfdatas => [ { template => '%d', min => 0, max => 'total', unit => 'B', cast_int => 1, label_extra_instance => 1, instance_use => 'display' } ] } }, { label => 'memory-usage-free', display_ok => 0, nlabel => 'accesspoint.memory.free.bytes', set => { key_values => [ { name => 'free' }, { name => 'used' }, { name => 'prct_used' }, { name => 'prct_free' }, { name => 'total' }, { name => 'display' } ], closure_custom_output => $self->can('custom_usage_output'), perfdatas => [ { template => '%d', min => 0, max => 'total', unit => 'B', cast_int => 1, label_extra_instance => 1, instance_use => 'display' } ] } }, { label => 'memory-usage-prct', display_ok => 0, nlabel => 'accesspoint.memory.usage.percentage', set => { key_values => [ { name => 'prct_used' }, { name => 'display' } ], output_template => 'ram used: %.2f %%', perfdatas => [ { template => '%.2f', min => 0, max => 100, label_extra_instance => 1, instance_use => 'display' } ] } } ]; $self->{maps_counters}->{connection} = [ { label => 'connection-accesspoints', nlabel => 'accesspoint.connection.accesspoints.count', set => { key_values => [ { name => 'ap' }, { name => 'display' } ], output_template => 'access points connections: %d', perfdatas => [ { template => '%d', min => 0 } ] } }, { label => 'connection-client-devices-authorized', nlabel => 'accesspoint.connection.client.devices.authorized.count', set => { key_values => [ { name => 'authorized_clients' }, { name => 'display' } ], output_template => 'client devices authorized connections: %d', perfdatas => [ { template => '%d', min => 0, label_extra_instance => 1, instance_use => 'display' } ] } }, { label => 'connection-rogue-devices', nlabel => 'accesspoint.connection.rogue.devices.count', display_ok => 0, set => { key_values => [ { name => 'rogues' }, { name => 'display' } ], output_template => 'rogue devices connections: %d', perfdatas => [ { template => '%d', min => 0, label_extra_instance => 1, instance_use => 'display' } ] } } ]; $self->{maps_counters}->{traffic} = [ { label => 'traffic-in', nlabel => 'accesspoint.traffic.in.bitspersecond', set => { key_values => [ { name => 'traffic_in', per_second => 1 }, { name => 'display' } ], output_template => 'traffic in: %s%s/s', output_change_bytes => 2, perfdatas => [ { template => '%s', min => 0, unit => 'b/s', label_extra_instance => 1, instance_use => 'display' } ] } }, { label => 'traffic-out', nlabel => 'accesspoint.traffic.out.bitspersecond', set => { key_values => [ { name => 'traffic_out', per_second => 1 }, { name => 'display' } ], output_template => 'traffic in: %s%s/s', output_change_bytes => 2, perfdatas => [ { template => '%s', min => 0, unit => 'b/s', label_extra_instance => 1, instance_use => 'display' } ] } } ]; } sub new { my ($class, %options) = @_; my $self = $class->SUPER::new(package => __PACKAGE__, %options, statefile => 1, force_new_perfdata => 1); bless $self, $class; $options{options}->add_options(arguments => { 'filter-name:s' => { name => 'filter_name' }, 'unknown-status:s' => { name => 'unknown_status', default => '' }, 'warning-status:s' => { name => 'warning_status', default => '' }, 'critical-status:s' => { name => 'critical_status', default => '' } }); return $self; } sub check_options { my ($self, %options) = @_; $self->SUPER::check_options(%options); $self->change_macros(macros => ['unknown_status', 'warning_status', 'critical_status']); } my $map_zd_connection_status = { 0 => 'disconnected', 1 => 'connected', 2 => 'approvalPending', 3 => 'upgradingFirmware', 4 => 'provisioning' }; my $mapping = { zd_connection_status => { oid => '.1.3.6.1.4.1.25053.1.2.2.1.1.2.1.1.3', map => $map_zd_connection_status }, # ruckusZDWLANAPStatus cpu_util => { oid => '.1.3.6.1.4.1.25053.1.2.2.1.1.2.1.1.29' }, # ruckusZDWLANAPCPUUtil memory_used => { oid => '.1.3.6.1.4.1.25053.1.2.2.1.1.2.1.1.27' }, # ruckusZDWLANAPMemUtil (% or KB) memory_size => { oid => '.1.3.6.1.4.1.25053.1.2.2.1.1.2.1.1.28' }, # ruckusZDWLANAPMemTotal (KB) ap => { oid => '.1.3.6.1.4.1.25053.1.2.2.1.1.2.1.1.14' }, # ruckusZDWLANAPNumVAP authorized_clients => { oid => '.1.3.6.1.4.1.25053.1.2.2.1.1.2.1.1.15' }, # ruckusZDWLANAPNumSta rogues => { oid => '.1.3.6.1.4.1.25053.1.2.2.1.1.2.1.1.16' }, # ruckusZDWLANAPNumRogues traffic_in => { oid => '.1.3.6.1.4.1.25053.1.2.2.1.1.2.1.1.21' }, # ruckusZDWLANAPLANStatsRXByte traffic_out => { oid => '.1.3.6.1.4.1.25053.1.2.2.1.1.2.1.1.25' } # ruckusZDWLANAPLANStatsTXByte }; sub manage_selection { my ($self, %options) = @_; my $oid_ruckusZDWLANAPDescription = '.1.3.6.1.4.1.25053.1.2.2.1.1.2.1.1.2'; my $oid_ruckusZDWLANAPSerialNumber = '.1.3.6.1.4.1.25053.1.2.2.1.1.2.1.1.5'; my $snmp_result = $options{snmp}->get_multiple_table( oids => [ { oid => $oid_ruckusZDWLANAPDescription }, { oid => $oid_ruckusZDWLANAPSerialNumber } ], return_type => 1, nothing_quit => 1 ); $self->{accesspoints} = {}; foreach (keys %$snmp_result) { next if (! /^$oid_ruckusZDWLANAPDescription\.(.*)/); my $instance = $1; my $name = defined($snmp_result->{$_}) && $snmp_result->{$_} ne '' ? $snmp_result->{$_} : $snmp_result->{$oid_ruckusZDWLANAPSerialNumber . '.' . $instance}; if (defined($self->{option_results}->{filter_name}) && $self->{option_results}->{filter_name} ne '' && $name !~ /$self->{option_results}->{filter_name}/) { $self->{output}->output_add(long_msg => "skipping access point '" . $name . "'.", debug => 1); next; } $self->{accesspoints}->{$instance} = { display => $name, status => { display => $name }, cpu => { display => $name }, memory => { display => $name }, connection => { display => $name }, traffic => { display => $name } }; } return if (scalar(keys %{$self->{accesspoints}}) <= 0); $options{snmp}->load( oids => [ map($_->{oid}, values(%$mapping)) ], instances => [ keys %{$self->{accesspoints}} ], instance_regexp => '^(.*)$' ); $snmp_result = $options{snmp}->get_leef(); foreach (keys %{$self->{accesspoints}}) { my $result = $options{snmp}->map_instance(mapping => $mapping, results => $snmp_result, instance => $_); $self->{accesspoints}->{$_}->{status}->{zd_connection_status} = $result->{zd_connection_status}; $self->{accesspoints}->{$_}->{cpu}->{cpu_util} = $result->{cpu_util}; my $memory_total = $result->{memory_size} * 1024; my $memory_used = $result->{memory_used} <= 100 ? ($result->{memory_used} * $memory_total / 100) : $result->{memory_used} * 1024; my $memory_used_prct = $result->{memory_used} <= 100 ? $result->{memory_used} : ($memory_used * 100 / $memory_total); $self->{accesspoints}->{$_}->{memory}->{used} = $memory_used; $self->{accesspoints}->{$_}->{memory}->{free} = $memory_total - $memory_used; $self->{accesspoints}->{$_}->{memory}->{prct_used} = $memory_used_prct; $self->{accesspoints}->{$_}->{memory}->{prct_free} = 100 - $memory_used_prct; $self->{accesspoints}->{$_}->{memory}->{total} = $memory_total; $self->{accesspoints}->{$_}->{connection}->{ap} = $result->{ap}; $self->{accesspoints}->{$_}->{connection}->{authorized_clients} = $result->{authorized_clients}; $self->{accesspoints}->{$_}->{connection}->{rogues} = $result->{rogues}; $self->{accesspoints}->{$_}->{traffic}->{traffic_in} = $result->{traffic_in} * 8; $self->{accesspoints}->{$_}->{traffic}->{traffic_out} = $result->{traffic_out} * 8; } $self->{cache_name} = 'ruckus_zd_' . $options{snmp}->get_hostname() . '_' . $options{snmp}->get_port() . '_' . $self->{mode} . '_' . (defined($self->{option_results}->{filter_counters_block}) ? md5_hex($self->{option_results}->{filter_counters_block}) : md5_hex('all')) . '_' . (defined($self->{option_results}->{filter_counters}) ? md5_hex($self->{option_results}->{filter_counters}) : md5_hex('all')) . '_' . (defined($self->{option_results}->{filter_name}) ? md5_hex($self->{option_results}->{filter_name}) : md5_hex('all')) } 1; __END__ =head1 MODE Check access points. =over 8 =item B<--filter-name> Filter by access point name (can be a regexp). =item B<--unknown-status> Set unknown threshold for status. Can used special variables like: %{zd_connection_status} =item B<--warning-status> Set warning threshold for status. Can used special variables like: %{zd_connection_status} =item B<--critical-status> Set critical threshold for status. Can used special variables like: %{zd_connection_status} =item B<--warning-*> B<--critical-*> Thresholds. Can be: 'memory-usage', 'memory-usage-free', 'memory-usage-prct', 'traffic-in', 'traffic-out', 'cpu-utilization', 'connection-accesspoints', 'connection-client-devices-authorized', 'connection-rogue-devices'. =back =cut