# # 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::athonet::epc::snmp::mode::interfaceslte; use base qw(centreon::plugins::templates::counter); use strict; use warnings; use centreon::plugins::templates::catalog_functions qw(catalog_status_threshold_ng); use Digest::MD5 qw(md5_hex); sub custom_status_output { my ($self, %options) = @_; return sprintf( 'sctp status: %s [s1ap status: %s]', $self->{result_values}->{sctp_status}, $self->{result_values}->{s1ap_status} ); } sub custom_attach_req_output { my ($self, %options) = @_; return sprintf( 'attach requests total: %s success: %s (%.2f%%)', $self->{result_values}->{attach_req_total}, $self->{result_values}->{attach_req_success}, $self->{result_values}->{prct_success} ); } sub custom_attach_req_calc { my ($self, %options) = @_; $self->{result_values}->{attach_req_total} = $options{new_datas}->{$self->{instance} . '_attach_req_total'} - $options{old_datas}->{$self->{instance} . '_attach_req_total'}; $self->{result_values}->{attach_req_success} = $options{new_datas}->{$self->{instance} . '_attach_req_success'} - $options{old_datas}->{$self->{instance} . '_attach_req_success'}; $self->{result_values}->{prct_success} = 100; if ($self->{result_values}->{attach_req_total} > 0) { $self->{result_values}->{prct_success} = $self->{result_values}->{attach_req_success} * 100 / $self->{result_values}->{attach_req_total}; } return 0; } sub custom_pdn_req_output { my ($self, %options) = @_; return sprintf( 'pdn context activation requests total: %s success: %s (%.2f%%)', $self->{result_values}->{pdn_context_total}, $self->{result_values}->{pdn_context_success}, $self->{result_values}->{prct_success} ); } sub custom_pdn_req_calc { my ($self, %options) = @_; $self->{result_values}->{pdn_context_total} = $options{new_datas}->{$self->{instance} . '_pdn_context_total'} - $options{old_datas}->{$self->{instance} . '_pdn_context_total'}; $self->{result_values}->{pdn_context_success} = $options{new_datas}->{$self->{instance} . '_pdn_context_success'} - $options{old_datas}->{$self->{instance} . '_pdn_context_success'}; $self->{result_values}->{prct_success} = 100; if ($self->{result_values}->{pdn_context_total} > 0) { $self->{result_values}->{prct_success} = $self->{result_values}->{pdn_context_success} * 100 / $self->{result_values}->{pdn_context_total}; } return 0; } sub prefix_interface_output { my ($self, %options) = @_; return sprintf( "Lte interface '%s' [eNodeB ID: %s] ", $options{instance_value}->{name}, $options{instance_value}->{enbid} ); } sub interface_long_output { my ($self, %options) = @_; return sprintf( "checking lte interface '%s' [eNodeB ID: %s]", $options{instance_value}->{name}, $options{instance_value}->{enbid} ); } sub prefix_pdn_rej_output { my ($self, %options) = @_; return 'pdn context requests reject '; } sub set_counters { my ($self, %options) = @_; $self->{maps_counters_type} = [ { name => 'global', type => 0 }, { name => 'interfaces', type => 3, cb_prefix_output => 'prefix_interface_output', cb_long_output => 'interface_long_output', indent_long_output => ' ', message_multiple => 'All lte interfaces are ok', group => [ { name => 'global_status', type => 0, skipped_code => { -10 => 1 } }, { name => 'global_traffic', type => 0, skipped_code => { -10 => 1 } }, { name => 'global_users', type => 0, skipped_code => { -10 => 1 } }, { name => 'global_attach_req', type => 0, skipped_code => { -10 => 1 } }, { name => 'global_pdn_req', type => 0, skipped_code => { -10 => 1 } }, { name => 'global_ue', type => 0, skipped_code => { -10 => 1 } }, { name => 'global_pdn_rej', type => 0, cb_prefix_output => 'prefix_pdn_rej_output', skipped_code => { -10 => 1 } } ] } ]; $self->{maps_counters}->{global} = [ { label => 'total', nlabel => 'lte.interfaces.total.count', display_ok => 0, set => { key_values => [ { name => 'total' } ], output_template => 'total interfaces: %s', perfdatas => [ { template => '%s', min => 0 } ] } } ]; $self->{maps_counters}->{global_status} = [ { label => 'status', type => 2, critical_default => '%{sctp_status} =~ /down/i || %{s1ap_status} =~ /down/i', set => { key_values => [ { name => 'sctp_status' }, { name => 's1ap_status' }, { name => 'name' } ], 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_traffic} = [ { label => 'traffic-in', nlabel => 'lte.interface.traffic.in.bytespersecond', set => { key_values => [ { name => 'traffic_in', per_second => 1 } ], output_template => 'traffic in: %.2f %s/s', output_change_bytes => 1, perfdatas => [ { template => '%.2f', unit => 'B/s', min => 0, label_extra_instance => 1 } ] } }, { label => 'traffic-out', nlabel => 'lte.interface.traffic.out.bytespersecond', set => { key_values => [ { name => 'traffic_out', per_second => 1 } ], output_template => 'traffic out: %.2f %s/s', output_change_bytes => 1, perfdatas => [ { template => '%.2f', unit => 'B/s', min => 0, label_extra_instance => 1 } ] } } ]; $self->{maps_counters}->{global_users} = [ { label => 'users-connected', nlabel => 'lte.interface.users.connected.count', set => { key_values => [ { name => 'users_connected' } ], output_template => 'connected users: %s', perfdatas => [ { template => '%s', min => 0, label_extra_instance => 1 } ] } }, { label => 'users-idle', nlabel => 'lte.interface.users.idle.count', set => { key_values => [ { name => 'users_idle' } ], output_template => 'idle users: %s', perfdatas => [ { template => '%s', min => 0, label_extra_instance => 1 } ] } }, { label => 'sessions-active', nlabel => 'lte.interface.sessions.active.count', set => { key_values => [ { name => 'sessions_active' } ], output_template => 'active sessions: %s', perfdatas => [ { template => '%s', min => 0, label_extra_instance => 1 } ] } } ]; $self->{maps_counters}->{global_attach_req} = [ { label => 'requests-attach-success', nlabel => 'lte.interface.requests.attach.success.count', set => { key_values => [ { name => 'attach_req_success', diff => 1 }, { name => 'attach_req_total', diff => 1 } ], closure_custom_calc => $self->can('custom_attach_req_calc'), closure_custom_output => $self->can('custom_attach_req_output'), perfdatas => [ { template => '%s', min => 0, max => 'attach_req_total', label_extra_instance => 1 } ] } }, { label => 'requests-attach-success-prct', nlabel => 'lte.interface.requests.attach.success.percentage', display_ok => 0, set => { key_values => [ { name => 'attach_req_success', diff => 1 }, { name => 'attach_req_total', diff => 1 } ], closure_custom_calc => $self->can('custom_attach_req_calc'), closure_custom_output => $self->can('custom_attach_req_output'), threshold_use => 'prct_success', perfdatas => [ { value => 'prct_success', template => '%s', min => 0, max => 100, unit => '%', label_extra_instance => 1 } ] } } ]; $self->{maps_counters}->{global_pdn_req} = [ { label => 'requests-pdn-context-activation', nlabel => 'lte.interface.requests.pdn_context.activations.success.count', set => { key_values => [ { name => 'pdn_context_success', diff => 1 }, { name => 'pdn_context_total', diff => 1 } ], closure_custom_calc => $self->can('custom_pdn_req_calc'), closure_custom_output => $self->can('custom_pdn_req_output'), perfdatas => [ { template => '%s', min => 0, max => 'pdn_context_total', label_extra_instance => 1 } ] } }, { label => 'requests-pdn-context-activation-prct', nlabel => 'lte.interface.requests.pdn_context.activations.success.percentage', display_ok => 0, set => { key_values => [ { name => 'pdn_context_success', diff => 1 }, { name => 'pdn_context_total', diff => 1 } ], closure_custom_calc => $self->can('custom_pdn_req_calc'), closure_custom_output => $self->can('custom_pdn_req_output'), threshold_use => 'prct_success', perfdatas => [ { value => 'prct_success', template => '%s', min => 0, max => 100, unit => '%', label_extra_instance => 1 } ] } } ]; $self->{maps_counters}->{global_ue} = [ { label => 'requests-ue-context-release-total', nlabel => 'lte.interface.requests.ue_context_release.total.count', set => { key_values => [ { name => 'ue_release_req', diff => 1 } ], output_template => 'ue context release requests: %s', perfdatas => [ { template => '%s', min => 0, label_extra_instance => 1 } ] } }, { label => 'requests-ue-context-release-radio-lost', nlabel => 'lte.interface.requests.ue_context_release.radio_lost.count', set => { key_values => [ { name => 'ue_release_req_radio_lost', diff => 1 } ], output_template => 'ue context release with radio lost requests: %s', perfdatas => [ { template => '%s', min => 0, label_extra_instance => 1 } ] } } ]; $self->{maps_counters}->{global_pdn_rej} = [ { label => 'requests-pdn-context-rej-insufres', nlabel => 'lte.interface.requests.pdn_context.reject.insufficent_resources.count', set => { key_values => [ { name => 'pdn_rej_insuf_res', diff => 1 } ], output_template => 'insufficent resources: %s', perfdatas => [ { template => '%s', min => 0, label_extra_instance => 1 } ] } }, { label => 'requests-pdn-context-rej-noapn', nlabel => 'lte.interface.requests.pdn_context.reject.no_apn.count', set => { key_values => [ { name => 'pdn_rej_no_apn', diff => 1 } ], output_template => 'missing or unknown apn: %s', perfdatas => [ { template => '%s', min => 0, label_extra_instance => 1 } ] } }, { label => 'requests-pdn-context-rej-nosub', nlabel => 'lte.interface.requests.pdn_context.reject.not_subscribed.count', set => { key_values => [ { name => 'pdn_rej_no_sub', diff => 1 } ], output_template => 'not subscribed: %s', perfdatas => [ { template => '%s', min => 0, label_extra_instance => 1 } ] } } ]; } 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' } }); return $self; } my $map_status = { 0 => 'down', 1 => 'up' }; my $mapping = { sctp_status => { oid => '.1.3.6.1.4.1.35805.10.2.2.99.1.3', map => $map_status }, # iLteSCTPState s1ap_status => { oid => '.1.3.6.1.4.1.35805.10.2.2.99.1.4', map => $map_status }, # iLteS1APState traffic_in => { oid => '.1.3.6.1.4.1.35805.10.2.2.99.1.5' }, # iLteLoadPktIn traffic_out => { oid => '.1.3.6.1.4.1.35805.10.2.2.99.1.6' }, # iLteLoadPktOut users_connected => { oid => '.1.3.6.1.4.1.35805.10.2.2.99.1.7' }, # iLteConnectedUsers users_idle => { oid => '.1.3.6.1.4.1.35805.10.2.2.99.1.8' }, # iLteIdleUsers sessions_active => { oid => '.1.3.6.1.4.1.35805.10.2.2.99.1.9' }, # iLteActiveSessions attach_req_total => { oid => '.1.3.6.1.4.1.35805.10.2.2.99.1.11' }, # iLteTotalAttachReq attach_req_success => { oid => '.1.3.6.1.4.1.35805.10.2.2.99.1.12' }, # iLteSuccesfullAttach pdn_context_total => { oid => '.1.3.6.1.4.1.35805.10.2.2.99.1.14' }, # iLteTotalPDNActReq pdn_context_success => { oid => '.1.3.6.1.4.1.35805.10.2.2.99.1.15' }, # iLteActivatedPDNContext ue_release_req => { oid => '.1.3.6.1.4.1.35805.10.2.2.99.1.23' }, # iLteUERelReq ue_release_req_radio_lost => { oid => '.1.3.6.1.4.1.35805.10.2.2.99.1.24' }, # iLteUERelReqRadioLost pdn_rej_insuf_res => { oid => '.1.3.6.1.4.1.35805.10.2.2.99.1.25' }, # iLtePDNRejInsufRes pdn_rej_no_apn => { oid => '.1.3.6.1.4.1.35805.10.2.2.99.1.26' }, # iLtePDNRejNoApn pdn_rej_no_sub => { oid => '.1.3.6.1.4.1.35805.10.2.2.99.1.27' } # iLtePDNRejNoSubscribed }; my $mapping_name = { name => { oid => '.1.3.6.1.4.1.35805.10.2.2.99.1.28' }, # iLteHumanName enbid => { oid => '.1.3.6.1.4.1.35805.10.2.2.99.1.29' } # iLteENBId }; sub manage_selection { my ($self, %options) = @_; $self->{cache_name} = 'athonet_epc_' . $self->{mode} . '_' . $options{snmp}->get_hostname() . '_' . $options{snmp}->get_port() . '_' . (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')); my $oid_lteInterfacesEntry = '.1.3.6.1.4.1.35805.10.2.2.99.1'; my $snmp_result = $options{snmp}->get_table( oid => $oid_lteInterfacesEntry, start => $mapping_name->{name}->{oid}, end => $mapping_name->{enbid}->{oid}, nothing_quit => 1 ); $self->{interfaces} = {}; foreach (keys %$snmp_result) { next if (! /^$mapping_name->{name}->{oid}\.(.*)$/); my $instance = $1; my $result = $options{snmp}->map_instance(mapping => $mapping_name, results => $snmp_result, instance => $instance); next if (defined($self->{interfaces}->{ $result->{name} })); if (defined($self->{option_results}->{filter_name}) && $self->{option_results}->{filter_name} ne '' && $result->{name} !~ /$self->{option_results}->{filter_name}/) { $self->{output}->output_add(long_msg => "skipping '" . $result->{name} . "': no matching filter.", debug => 1); next; } $self->{interfaces}->{ $result->{name} } = { %$result, instance => $instance }; } $self->{global} = { total => scalar(keys %{$self->{interfaces}}) }; return if (scalar(keys %{$self->{interfaces}}) <= 0); $options{snmp}->load(oids => [ map($_->{oid}, values(%$mapping)) ], instances => [map($_->{instance}, values(%{$self->{interfaces}}))], instance_regexp => '^(.*)$' ); $snmp_result = $options{snmp}->get_leef(nothing_quit => 1); foreach (keys %{$self->{interfaces}}) { my $result = $options{snmp}->map_instance(mapping => $mapping, results => $snmp_result, instance => $self->{interfaces}->{$_}->{instance}); $self->{interfaces}->{$_}->{global_status} = { name => $self->{interfaces}->{$_}->{name}, sctp_status => $result->{sctp_status}, s1ap_status => $result->{s1ap_status} }; $self->{interfaces}->{$_}->{global_traffic} = { packets_in => $result->{packets_in}, packets_out => $result->{packets_out} }; $self->{interfaces}->{$_}->{global_users} = { users_connected => $result->{users_connected}, users_idle => $result->{users_idle}, sessions_active => $result->{sessions_active} }; $self->{interfaces}->{$_}->{global_attach_req} = { attach_req_total => $result->{attach_req_total}, attach_req_success => $result->{attach_req_success} }; $self->{interfaces}->{$_}->{global_pdn_req} = { pdn_context_total => $result->{pdn_context_total}, pdn_context_success => $result->{pdn_context_success} }; $self->{interfaces}->{$_}->{global_ue} = { ue_release_req => $result->{ue_release_req}, ue_release_req_radio_lost => $result->{ue_release_req_radio_lost} }; $self->{interfaces}->{$_}->{global_pdn_rej} = { pdn_rej_insuf_res => $result->{pdn_rej_insuf_res}, pdn_rej_no_apn => $result->{pdn_rej_no_apn}, pdn_rej_no_sub => $result->{pdn_rej_no_sub} }; } } 1; __END__ =head1 MODE Check lte interfaces. =over 8 =item B<--filter-counters> Only display some counters (regexp can be used). Example: --filter-counters='users' =item B<--filter-name> Filter interfaces by name (can be a regexp). =item B<--unknown-status> Set unknown threshold for status. Can used special variables like: %{sctp_status}, %{s1ap_status}, %{name} =item B<--warning-status> Set warning threshold for status. Can used special variables like: %{sctp_status}, %{s1ap_status}, %{name} =item B<--critical-status> Set critical threshold for status (Default: '%{sctp_status} =~ /down/i || %{s1ap_status} =~ /down/i'). Can used special variables like: %{sctp_status}, %{s1ap_status}, %{name} =item B<--warning-*> B<--critical-*> Thresholds. Can be: 'total', 'users-connected', 'users-idle', 'sessions-active', 'traffic-in', 'traffic-out', 'requests-ue-context-release-total', 'requests-ue-context-release-radio-lost', 'requests-attach-success', 'requests-attach-success-prct', 'requests-pdn-context-activation', 'requests-pdn-context-activation-prct', 'requests-pdn-context-rej-insufres', 'requests-pdn-context-rej-noapn', 'requests-pdn-context-rej-nosub'. =back =cut