add cisco cts snmp

This commit is contained in:
garnier-quentin 2020-10-13 16:33:43 +02:00
parent 15111163ac
commit f76ecb2206
4 changed files with 580 additions and 1 deletions

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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