From f76ecb2206041ff3eefe56b6018c93e9f0c7982a Mon Sep 17 00:00:00 2001 From: garnier-quentin Date: Tue, 13 Oct 2020 16:33:43 +0200 Subject: [PATCH] add cisco cts snmp --- hardware/devices/cisco/cts/snmp/mode/calls.pm | 367 ++++++++++++++++++ .../cisco/cts/snmp/mode/peripherals.pm | 163 ++++++++ hardware/devices/cisco/cts/snmp/plugin.pm | 49 +++ .../cisco/callmanager/snmp/mode/phoneusage.pm | 2 +- 4 files changed, 580 insertions(+), 1 deletion(-) create mode 100644 hardware/devices/cisco/cts/snmp/mode/calls.pm create mode 100644 hardware/devices/cisco/cts/snmp/mode/peripherals.pm create mode 100644 hardware/devices/cisco/cts/snmp/plugin.pm diff --git a/hardware/devices/cisco/cts/snmp/mode/calls.pm b/hardware/devices/cisco/cts/snmp/mode/calls.pm new file mode 100644 index 000000000..0992bfb9f --- /dev/null +++ b/hardware/devices/cisco/cts/snmp/mode/calls.pm @@ -0,0 +1,367 @@ +# +# 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 hardware::devices::cisco::cts::snmp::mode::calls; + +use base qw(centreon::plugins::templates::counter); + +use strict; +use warnings; +use Digest::MD5 qw(md5_hex); + +sub custom_traffic_calc { + my ($self, %options) = @_; + + if (!defined($options{delta_time})) { + $self->{error_msg} = 'Buffer creation'; + return -1; + } + + my $total_bytes = 0; + foreach (keys %{$options{new_datas}}) { + if (/\Q$self->{instance}\E_.*_bytes/) { + my $new_bytes = $options{new_datas}->{$_}; + next if (!defined($options{old_datas}->{$_})); + my $old_bytes = $options{old_datas}->{$_}; + my $bytes = $new_bytes - $old_bytes; + $bytes = $new_bytes if ($bytes < 0); + + $total_bytes += $bytes; + } + } + + $self->{result_values}->{display} = $options{new_datas}->{$self->{instance} . '_display'}; + $self->{result_values}->{traffic_per_seconds} = ($total_bytes * 8) / $options{delta_time}; + return 0; +} + +sub custom_jitter_calc { + my ($self, %options) = @_; + + my $max_jitter = 0; + foreach (keys %{$options{new_datas}}) { + if (/\Q$self->{instance}\E_.*_maxjitter/) { + $max_jitter = $options{new_datas}->{$_} if ($options{new_datas}->{$_} > $max_jitter); + } + } + + $self->{result_values}->{display} = $options{new_datas}->{$self->{instance} . '_display'}; + $self->{result_values}->{max_jitter} = $max_jitter; + return 0; +} + +sub custom_loss_calc { + my ($self, %options) = @_; + + my ($total_loss, $total_pkts) = (0, 0); + foreach (keys %{$options{new_datas}}) { + if (/\Q$self->{instance}\E_.*_loss_$options{extra_options}->{label_ref}/) { + my $new_loss = $options{new_datas}->{$_}; + next if (!defined($options{old_datas}->{$_})); + my $old_loss = $options{old_datas}->{$_}; + my $loss = $new_loss - $old_loss; + $loss = $new_loss if ($loss < 0); + + $total_loss += $loss; + } elsif (/\Q$self->{instance}\E_.*_packets_$options{extra_options}->{label_ref}/) { + my $new_pkts = $options{new_datas}->{$_}; + next if (!defined($options{old_datas}->{$_})); + my $old_pkts = $options{old_datas}->{$_}; + my $pkts = $new_pkts - $old_pkts; + $pkts = $new_pkts if ($pkts < 0); + + $total_pkts += $pkts; + } + } + + $self->{result_values}->{label} = $options{extra_options}->{label_ref}; + $self->{result_values}->{display} = $options{new_datas}->{$self->{instance} . '_display'}; + $self->{result_values}->{packets_loss} = $total_loss; + $self->{result_values}->{packets_loss_prct} = 0; + $self->{result_values}->{packets} = $total_pkts; + if ($total_pkts > 0) { + $self->{result_values}->{packets_loss_prct} = ($total_loss * 100) / $total_pkts; + } + + return 0; +} + +sub custom_loss_output { + my ($self, %options) = @_; + + return sprintf( + "packets %s loss: %.2f%% (%s on %s)", + $self->{result_values}->{label}, + $self->{result_values}->{packets_loss_prct}, + $self->{result_values}->{packets_loss}, + $self->{result_values}->{packets} + ); +} + +sub prefix_global_output { + my ($self, %options) = @_; + + return 'Calls '; +} + +sub set_counters { + my ($self, %options) = @_; + + $self->{maps_counters_type} = [ + { name => 'global', type => 0, cb_prefix_output => 'prefix_global_output' }, + { name => 'streams_active', type => 1, cb_prefix_output => 'prefix_stream_active_output', message_multiple => 'All active call streams are ok', skipped_code => { -10 => 1 } } + ]; + + $self->{maps_counters}->{global} = [ + { label => 'dummy', threshold => 0, display_ok => 0, set => { + key_values => [ { name => 'calls_instance_finished' } ], + output_template => 'none', + perfdatas => [] + } + }, + { label => 'active', nlabel => 'calls.active.count', set => { + key_values => [ { name => 'active' } ], + output_template => 'active: %s', + perfdatas => [ + { template => '%s', min => 0 } + ] + } + }, + { label => 'total', nlabel => 'calls.total.count', display_ok => 0, set => { + key_values => [ { name => 'total' } ], + output_template => 'total: %s', + perfdatas => [ + { template => '%s', min => 0 } + ] + } + } + ]; + + my @map = ( + ['total-unknown', 'unknown: %s', 'unknown'], + ['total-other', 'other: %s', 'other'], + ['total-internal-error', 'internal error: %s', 'internal.error'], + ['total-local-disconnected', 'local disconnected: %s', 'local.disconnected'], + ['total-remote-disconnected', 'remote disconnected: %s', 'remote.disconnected'], + ['total-network-congestion', 'network congestion: %s', 'network.congestion'], + ['total-media-negotiation-failure', 'media negotiation failure: %s', 'media.negotiation.failure'], + ['total-security-config-mismatched', 'security config mismatched: %s', 'security.config.mismatched'], + ['total-incompatible-remote-endpoint', 'incompatible remote endpoint: %s', 'incompatible.remote.endpoint'], + ['total-service-unavailable', 'service unaivalable: %s', 'service.unavailable'], + ['total-remote-terminated-error', 'remote terminated with error: %s', 'remote.terminated.error'] + ); + foreach (@map) { + push @{$self->{maps_counters}->{global}}, { label => $_->[0], nlabel => 'calls.total.' . $_->[2] . '.count', display_ok => 0, set => { + key_values => [ { name => $_->[2] } ], + output_template => $_->[1], + perfdatas => [ + { template => '%s', min => 0 } + ] + } + }; + } + + $self->{maps_counters}->{streams_active} = [ + { label => 'streams-active-maxjitter', nlabel => 'calls.streams.active.maxjitter.milliseconds', set => { + key_values => [], + manual_keys => 1, + closure_custom_calc => $self->can('custom_jitter_calc'), + output_template => 'max jitter: %s ms', + output_use => 'max_jitter', threshold_use => 'max_jitter', + perfdatas => [ + { value => 'max_jitter', template => '%d', + unit => 'ms', min => 0, label_extra_instance => 1, instance_use => 'display' } + ] + } + } + ]; + + foreach (('in', 'out')) { + push @{$self->{maps_counters}->{streams_active}}, + { label => 'streams-active-traffic-' . $_, nlabel => 'calls.streams.active.traffic.' . $_ . '.bytes', set => { + key_values => [], + manual_keys => 1, + closure_custom_calc => $self->can('custom_traffic_calc'), closure_custom_calc_extra_options => { label_ref => $_ }, + output_template => 'traffic ' . $_ . ': %s %s/s', + output_change_bytes => 1, + output_use => 'traffic_per_seconds', threshold_use => 'traffic_per_seconds', + perfdatas => [ + { value => 'traffic_per_seconds', template => '%d', + unit => 'B/s', min => 0, label_extra_instance => 1, instance_use => 'display' } + ] + } + }, + { label => 'streams-active-packetloss-' . $_, nlabel => 'calls.streams.active.packetloss.' . $_ . '.count', set => { + key_values => [], + manual_keys => 1, + closure_custom_calc => $self->can('custom_loss_calc'), closure_custom_calc_extra_options => { label_ref => $_ }, + closure_custom_output => $self->can('custom_loss_output'), + threshold_use => 'packets_loss', + perfdatas => [ + { value => 'packets_loss', template => '%d', + min => 0, label_extra_instance => 1, instance_use => 'display' } + ] + } + }, + { label => 'streams-active-packetloss-' . $_ . '-prct', nlabel => 'calls.streams.active.packetloss.' . $_ . '.percentage', display_ok => 0, set => { + key_values => [], + manual_keys => 1, + closure_custom_calc => $self->can('custom_loss_calc'), closure_custom_calc_extra_options => { label_ref => $_ }, + closure_custom_output => $self->can('custom_loss_output'), + threshold_use => 'packets_loss_prct', + perfdatas => [ + { value => 'packets_loss_prct', template => '%.2f', + unit => '%', min => 0, max => 100, label_extra_instance => 1, instance_use => 'display' } + ] + } + }; + } +} + +sub prefix_stream_active_output { + my ($self, %options) = @_; + + return "Stream '" . $options{instance_value}->{display} . "' "; +} + +sub new { + my ($class, %options) = @_; + my $self = $class->SUPER::new(package => __PACKAGE__, %options, force_new_perfdata => 1, statefile => 1); + bless $self, $class; + + $self->{version} = '1.0'; + $options{options}->add_options(arguments => { + }); + + return $self; +} + +my $map_term_reason = { + 1 => 'unknown', 2 => 'other', 3 => 'internal.error', + 4 => 'local.disconnected', 5 => 'remote.disconnected', + 6 => 'network.congestion', 7 => 'media.negotiation.failure', + 8 => 'security.config.mismatched', 9 => 'incompatible.remote.endpoint', + 10 => 'service.unavailable', 11 => 'remote.terminated.error', + 12 => 'incall' +}; +my $map_stream_type = { + 1 => 'video', 2 => 'audio', 3 => 'content' +}; +my $oid_ctpcCallTermReason = '.1.3.6.1.4.1.9.9.644.1.4.8.1.17'; + +my $mapping = { + traffic_out => { oid => '.1.3.6.1.4.1.9.9.644.1.4.10.1.3' }, # ctpcTxTotalBytes + packets_out => { oid => '.1.3.6.1.4.1.9.9.644.1.4.10.1.4' }, # ctpcTxTotalPackets + packets_lost_out => { oid => '.1.3.6.1.4.1.9.9.644.1.4.10.1.5' }, # ctpcTxLostPackets + traffic_in => { oid => '.1.3.6.1.4.1.9.9.644.1.4.10.1.11' }, # ctpcRxTotalBytes + packets_in => { oid => '.1.3.6.1.4.1.9.9.644.1.4.10.1.12' }, # ctpcRxTotalPackets + packets_lost_in => { oid => '.1.3.6.1.4.1.9.9.644.1.4.10.1.13' }, # ctpcRxLostPackets + maxjitter => { oid => '.1.3.6.1.4.1.9.9.644.1.4.10.1.25' }, # ctpcMaxCallJitter +}; + +sub manage_selection { + my ($self, %options) = @_; + + $self->{cache_name} = 'cisco_cts_' . $options{snmp}->get_hostname() . '_' . $options{snmp}->get_port() . '_' . $self->{mode} . '_' . + (defined($self->{option_results}->{filter_counters}) ? md5_hex($self->{option_results}->{filter_counters}) : md5_hex('all')); + my $calls_instance_finished = $self->read_statefile_key(key => 'global_calls_instance_finished'); + $calls_instance_finished = {} if (!defined($calls_instance_finished)); + my $calls_instance_finished_new = {}; + + my $active_calls = {}; + $self->{global} = { active => 0, total => 0 }; + foreach (values %$map_term_reason) { + $self->{global}->{$_} = 0; + } + + my $snmp_result = $options{snmp}->get_table( + oid => $oid_ctpcCallTermReason + ); + foreach (keys %$snmp_result) { + /^$oid_ctpcCallTermReason\.(\d+)/; + my $instance = $1; + if ($map_term_reason->{ $snmp_result->{$_} } eq 'incall') { + $active_calls->{$instance} = 1; + $self->{global}->{active}++; + } else { + $calls_instance_finished_new->{$instance} = 1; + next if (defined($calls_instance_finished->{$instance})); + $self->{global}->{total}++; + $self->{global}->{ $map_term_reason->{ $snmp_result->{$_} } }++; + } + } + + $snmp_result = $options{snmp}->get_multiple_table( + oids => [ + map({ oid => $_->{oid} }, values(%$mapping)) + ], + return_type => 1 + ); + + $self->{streams_active} = {}; + foreach (('audio', 'video', 'content')) { + $self->{streams_active}->{$_} = { display => $_ }; + } + + foreach my $oid (keys %$snmp_result) { + next if ($oid !~ /^$mapping->{traffic_out}->{oid}\.(\d+)\.(\d+)\.(\d+)/); + my ($index, $type, $source) = ($1, $2, $3); + my $instance = $index . '.' . $type . '.' . $source; + + my $result = $options{snmp}->map_instance(mapping => $mapping, results => $snmp_result, instance => $instance); + my $stream_type = $map_stream_type->{$type}; + if (defined($active_calls->{$index})) { + $self->{streams_active}->{$stream_type}->{$instance . '_traffic_in'} = defined($result->{traffic_in}) ? $result->{traffic_in} : 0; + $self->{streams_active}->{$stream_type}->{$instance . '_traffic_out'} = defined($result->{traffic_out}) ? $result->{traffic_out} : 0; + $self->{streams_active}->{$stream_type}->{$instance . '_loss_in'} = defined($result->{packets_lost_in}) ? $result->{packets_lost_in} : 0; + $self->{streams_active}->{$stream_type}->{$instance . '_packets_in'} = defined($result->{packets_in}) ? $result->{packets_in} : 0; + $self->{streams_active}->{$stream_type}->{$instance . '_loss_out'} = defined($result->{packets_lost_out}) ? $result->{packets_lost_out} : 0; + $self->{streams_active}->{$stream_type}->{$instance . '_packets_out'} = defined($result->{packets_out}) ? $result->{packets_out} : 0; + $self->{streams_active}->{$stream_type}->{$instance . '_maxjitter'} = defined($result->{maxjitter}) ? $result->{maxjitter} : 0; + } + } + + $self->{global}->{calls_instance_finished} = $calls_instance_finished_new; +} + +1; + +__END__ + +=head1 MODE + +Check call stream (real-time and history) + +=over 8 + +=item B<--warning-*> B<--critical-*> + +Thresholds. +Can be: 'active', 'total', 'total-unknown', +'total-other', 'total-internal-error', 'total-local-disconnected', 'total-remote-disconnected', +'total-network-congestion', 'total-media-negotiation-failure', 'total-security-config-mismatched', +'total-incompatible-remote-endpoint', 'total-service-unavailable', 'total-remote-terminated-error', +'streams-active-maxjitter', +'streams-active-traffic-in', 'streams-active-packetloss-in', 'streams-active-packetloss-in-prct', +'streams-active-traffic-out', 'streams-active-packetloss-out', 'streams-active-packetloss-out-prct'. + +=back + +=cut diff --git a/hardware/devices/cisco/cts/snmp/mode/peripherals.pm b/hardware/devices/cisco/cts/snmp/mode/peripherals.pm new file mode 100644 index 000000000..e2b9103e1 --- /dev/null +++ b/hardware/devices/cisco/cts/snmp/mode/peripherals.pm @@ -0,0 +1,163 @@ +# +# 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 hardware::devices::cisco::cts::snmp::mode::peripherals; + +use base qw(centreon::plugins::templates::counter); + +use strict; +use warnings; +use centreon::plugins::templates::catalog_functions qw(catalog_status_threshold_ng); + +sub custom_status_output { + my ($self, %options) = @_; + + return sprintf( + 'status: %s', + $self->{result_values}->{status} + ); +} + +sub prefix_peripheral_output { + my ($self, %options) = @_; + + return "Peripheral '" . $options{instance_value}->{description} . "' "; +} + +sub set_counters { + my ($self, %options) = @_; + + $self->{maps_counters_type} = [ + { name => 'global', type => 0 }, + { name => 'peripherals', type => 1, cb_prefix_output => 'prefix_peripheral_output', message_multiple => 'All peripherals are ok' } + ]; + + $self->{maps_counters}->{peripherals} = [ + { label => 'status', type => 2, critical_default => '%{status} !~ /noError/i', set => { + key_values => [ { name => 'status' }, { name => 'description' } ], + closure_custom_output => $self->can('custom_status_output'), + closure_custom_perfdata => sub { return 0; }, + closure_custom_threshold_check => \&catalog_status_threshold_ng + } + } + ]; + + $self->{maps_counters}->{global} = [ + { label => 'total', nlabel => 'peripherals.total.count', set => { + key_values => [ { name => 'total' } ], + output_template => 'Total peripherals: %s', + perfdatas => [ + { template => '%s', min => 0 } + ] + } + } + ]; +} + +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-description:s' => { name => 'filter_description' } + }); + + return $self; +} + +my $mapping_status = { + 0 => 'noError', 1 => 'other', 2 => 'cableError', 3 => 'powerError', + 4 => 'mgmtSysConfigError', 5 => 'systemError', 6 => 'deviceError', + 7 => 'linkError', 8 => 'commError', 9 => 'detectionDisabled' +}; + +my $mapping = { + description => { oid => '.1.3.6.1.4.1.9.9.643.1.2.1.1.2' }, # ctpPeripheralDescription + status => { oid => '.1.3.6.1.4.1.9.9.643.1.2.1.1.3', map => $mapping_status } # ctpPeripheralStatus +}; +my $oid_ctpPeripheralStatusEntry = '.1.3.6.1.4.1.9.9.643.1.2.1.1'; + +sub manage_selection { + my ($self, %options) = @_; + + my $snmp_result = $options{snmp}->get_table( + oid => $oid_ctpPeripheralStatusEntry, + start => $mapping->{description}->{oid}, + end => $mapping->{status}->{oid}, + nothing_quit => 1 + ); + + $self->{peripherals} = {}; + foreach my $oid (keys %$snmp_result) { + next if ($oid !~ /^$mapping->{status}->{oid}\.(.*)/); + my $instance = $1; + my $result = $options{snmp}->map_instance(mapping => $mapping, results => $snmp_result, instance => $instance); + + if (defined($self->{option_results}->{filter_description}) && $self->{option_results}->{filter_description} ne '' && + $result->{description} !~ /$self->{option_results}->{filter_description}/) { + $self->{output}->output_add(long_msg => "skipping phone '" . $instance . "': no matching filter.", debug => 1); + next; + } + + $self->{peripherals}->{$instance} = $result; + } + + $self->{global} = { total => scalar(keys %{$self->{peripherals}}) }; +} + +1; + +__END__ + +=head1 MODE + +Check peripherals. + +=over 8 + +=item B<--filter-counters> + +Only display some counters (regexp can be used). +Example: --filter-counters='status' + +=item B<--filter-description> + +Filter peripheral by description (can be a regexp). + +=item B<--warning-status> + +Set warning threshold for status. +Can used special variables like: %{status}, %{description} + +=item B<--critical-status> + +Set critical threshold for status (Default: '%{status} !~ /^registered/'). +Can used special variables like: %{status}, %{description} + +=item B<--warning-*> B<--critical-*> + +Thresholds. + +Can be: 'total'. + +=back + +=cut diff --git a/hardware/devices/cisco/cts/snmp/plugin.pm b/hardware/devices/cisco/cts/snmp/plugin.pm new file mode 100644 index 000000000..4ff1c546b --- /dev/null +++ b/hardware/devices/cisco/cts/snmp/plugin.pm @@ -0,0 +1,49 @@ +# +# 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 hardware::devices::cisco::cts::snmp::plugin; + +use strict; +use warnings; +use base qw(centreon::plugins::script_snmp); + +sub new { + my ($class, %options) = @_; + my $self = $class->SUPER::new(package => __PACKAGE__, %options); + bless $self, $class; + + $self->{version} = '1.0'; + $self->{modes} = { + 'calls' => 'hardware::devices::cisco::cts::snmp::mode::calls', + 'peripherals' => 'hardware::devices::cisco::cts::snmp::mode::peripherals' + }; + + return $self; +} + +1; + +__END__ + +=head1 PLUGIN DESCRIPTION + +Check Cisco Telepresence System (CTS) in SNMP. + +=cut diff --git a/network/cisco/callmanager/snmp/mode/phoneusage.pm b/network/cisco/callmanager/snmp/mode/phoneusage.pm index aa7e279e3..198d3d6ac 100644 --- a/network/cisco/callmanager/snmp/mode/phoneusage.pm +++ b/network/cisco/callmanager/snmp/mode/phoneusage.pm @@ -56,7 +56,7 @@ sub set_counters { $self->{maps_counters}->{phone} = [ { label => 'status', type => 2, critical_default => '%{status} !~ /^registered/', set => { - key_values => [ { name => 'status' }, { name => 'status' }, { name => 'name' } ], + key_values => [ { name => 'status' }, { name => 'description' }, { name => 'name' } ], closure_custom_output => $self->can('custom_status_output'), closure_custom_perfdata => sub { return 0; }, closure_custom_threshold_check => \&catalog_status_threshold_ng