centreon-plugins/hardware/ups/apc/snmp/mode/batterystatus.pm

385 lines
14 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 hardware::ups::apc::snmp::mode::batterystatus;
use base qw(centreon::plugins::templates::counter);
use strict;
use warnings;
use DateTime;
use centreon::plugins::templates::catalog_functions qw(catalog_status_threshold_ng);
sub custom_battery_status_output {
my ($self, %options) = @_;
return sprintf(
"battery status is '%s' [battery needs replace: %s] [last replace date: %s]",
$self->{result_values}->{status},
$self->{result_values}->{replace},
$self->{result_values}->{last_replace_date}
);
}
sub custom_status_calc {
my ($self, %options) = @_;
$self->{result_values}->{status} = $options{new_datas}->{$self->{instance} . '_upsBasicBatteryStatus'};
$self->{result_values}->{replace} = $options{new_datas}->{$self->{instance} . '_upsAdvBatteryReplaceIndicator'};
$self->{result_values}->{last_replace_date} = $options{new_datas}->{$self->{instance} . '_upsBasicBatteryLastReplaceDate'};
return 0;
}
sub custom_status_output {
my ($self, %options) = @_;
return sprintf(
"status is '%s'",
$self->{result_values}->{status}
);
}
sub bpack_long_output {
my ($self, %options) = @_;
return "checking battery pack '" . $options{instance_value}->{display} . "'";
}
sub prefix_bpack_output {
my ($self, %options) = @_;
return "battery pack '" . $options{instance_value}->{display} . "' ";
}
sub prefix_cartridge_output {
my ($self, %options) = @_;
return "cartridge '" . $options{instance_value}->{display} . "' ";
}
sub set_counters {
my ($self, %options) = @_;
$self->{maps_counters_type} = [
{ name => 'global', type => 0, skipped_code => { -10 => 1 } },
{ name => 'bpacks', type => 3, cb_prefix_output => 'prefix_bpack_output', cb_long_output => 'bpack_long_output', indent_long_output => ' ', message_multiple => 'All battery packs are ok',
group => [
{ name => 'bpack_global', type => 0, skipped_code => { -10 => 1 } },
{ name => 'cartridges', display_long => 1, cb_prefix_output => 'prefix_cartridge_output', message_multiple => 'cartridges are ok', type => 1, skipped_code => { -10 => 1 } }
]
}
];
$self->{maps_counters}->{global} = [
{
label => 'status',
type => 2,
unknown_default => '%{status} =~ /unknown/i',
warning_default => '%{status} =~ /batteryLow/i',
critical_default => '%{replace} =~ /yes/i',
set => {
key_values => [
{ name => 'upsBasicBatteryStatus' },
{ name => 'upsAdvBatteryReplaceIndicator' },
{ name => 'upsBasicBatteryLastReplaceDate' }
],
closure_custom_calc => $self->can('custom_status_calc'),
closure_custom_output => $self->can('custom_battery_status_output'),
closure_custom_perfdata => sub { return 0; },
closure_custom_threshold_check => \&catalog_status_threshold_ng
}
},
{ label => 'load', nlabel => 'battery.charge.remaining.percent', set => {
key_values => [ { name => 'upsAdvBatteryCapacity' } ],
output_template => 'remaining capacity: %s %%',
perfdatas => [
{ label => 'load', template => '%s', min => 0, max => 100, unit => '%' }
]
}
},
{ label => 'time', nlabel => 'battery.charge.remaining.minutes', set => {
key_values => [ { name => 'upsAdvBatteryRunTimeRemaining' } ],
output_template => 'remaining time: %.2f minutes',
perfdatas => [
{ label => 'load_time', template => '%.2f', min => 0, unit => 'm' }
]
}
},
{ label => 'current', nlabel => 'battery.current.ampere', set => {
key_values => [ { name => 'upsAdvBatteryCurrent' } ],
output_template => 'current: %s A',
perfdatas => [
{ label => 'current', template => '%s', min => 0, unit => 'A' }
]
}
},
{ label => 'voltage', nlabel => 'battery.voltage.volt', set => {
key_values => [ { name => 'upsAdvBatteryActualVoltage' } ],
output_template => 'voltage: %s V',
perfdatas => [
{ label => 'voltage', template => '%s', unit => 'V' }
]
}
},
{ label => 'temperature', nlabel => 'battery.temperature.celsius', set => {
key_values => [ { name => 'upsAdvBatteryTemperature' } ],
output_template => 'temperature: %s C',
perfdatas => [
{ label => 'temperature', template => '%s', unit => 'C'}
]
}
},
{ label => 'replace-lasttime', nlabel => 'battery.replace.lasttime.seconds', display_ok => 0, set => {
key_values => [ { name => 'last_replace_time' } ],
output_template => 'replace last time: %s s',
perfdatas => [
{ label => 'replace_last_time', template => '%s', unit => 's'}
]
}
}
];
$self->{maps_counters}->{bpack_global} = [
{ label => 'battery-pack-status', type => 2, critical_default => '%{status} ne "OK"', set => {
key_values => [ { name => 'status' }, { name => 'display' } ],
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}->{cartridges} = [
{ label => 'cartridge-status', type => 2, critical_default => '%{status} ne "OK"', set => {
key_values => [ { name => 'status' }, { name => 'display' } ],
closure_custom_output => $self->can('custom_status_output'),
closure_custom_perfdata => sub { return 0; },
closure_custom_threshold_check => \&catalog_status_threshold_ng
}
}
];
}
sub new {
my ($class, %options) = @_;
my $self = $class->SUPER::new(package => __PACKAGE__, %options);
bless $self, $class;
$options{options}->add_options(arguments => {
});
return $self;
}
my $map_battery_status = {
1 => 'unknown', 2 => 'batteryNormal', 3 => 'batteryLow'
};
my $map_replace_status = {
1 => 'no', 2 => 'yes'
};
my $mapping = {
upsBasicBatteryStatus => { oid => '.1.3.6.1.4.1.318.1.1.1.2.1.1', map => $map_battery_status },
upsBasicBatteryTimeOnBattery => { oid => '.1.3.6.1.4.1.318.1.1.1.2.1.2' },
upsBasicBatteryLastReplaceDate => { oid => '.1.3.6.1.4.1.318.1.1.1.2.1.3' }
};
my $mapping2 = {
upsAdvBatteryCapacity => { oid => '.1.3.6.1.4.1.318.1.1.1.2.2.1' },
upsAdvBatteryTemperature => { oid => '.1.3.6.1.4.1.318.1.1.1.2.2.2' },
upsAdvBatteryRunTimeRemaining => { oid => '.1.3.6.1.4.1.318.1.1.1.2.2.3' },
upsAdvBatteryReplaceIndicator => { oid => '.1.3.6.1.4.1.318.1.1.1.2.2.4', map => $map_replace_status },
upsAdvBatteryActualVoltage => { oid => '.1.3.6.1.4.1.318.1.1.1.2.2.8' },
upsAdvBatteryCurrent => { oid => '.1.3.6.1.4.1.318.1.1.1.2.2.9' }
};
my $oid_upsBasicBattery = '.1.3.6.1.4.1.318.1.1.1.2.1';
my $oid_upsAdvBattery = '.1.3.6.1.4.1.318.1.1.1.2.2';
my $oid_upsHighPrecBatteryPackOnlyStatus = '.1.3.6.1.4.1.318.1.1.1.2.3.10.4.1.5';
my $oid_upsHighPrecBatteryPackCartridgeStatus = '.1.3.6.1.4.1.318.1.1.1.2.3.10.2.1.10';
my $map_battery_pack_status = {
0 => 'disconnected', 1 => 'overvoltage',
2 => 'needsReplacement', 3 => 'overtemperatureCritical',
4 => 'charger', 5 => 'temperatureSensor',
6 => 'busSoftStart', 7 => 'overtemperatureWarning',
8 => 'generalError', 9 => 'communication',
10 => 'disconnectedFrame', 11 => 'firmwareMismatch'
};
sub add_battery_pack {
my ($self, %options) = @_;
$self->{bpacks} = {};
foreach my $oid (keys %{$options{snmp_result}->{$oid_upsHighPrecBatteryPackOnlyStatus}}) {
next if ($options{snmp_result}->{$oid_upsHighPrecBatteryPackOnlyStatus}->{$oid} eq '');
$oid =~ /^$oid_upsHighPrecBatteryPackOnlyStatus\.(\d+)/;
my $pack_index = $1;
$self->{bpacks}->{$pack_index} = {
display => $pack_index,
bpack_global => {
display => $pack_index,
status => 'OK'
},
cartridges => {}
};
my $status = '';
my ($i, $append) = (0, '');
foreach my $bit (split //, $options{snmp_result}->{$oid_upsHighPrecBatteryPackOnlyStatus}->{$oid}) {
if ($bit) {
$status .= $append . $map_battery_pack_status->{$i};
$append = ',';
}
$i++;
}
$self->{bpacks}->{$pack_index}->{bpack_global}->{status} = $status if ($status ne '');
}
foreach my $oid (keys %{$options{snmp_result}->{$oid_upsHighPrecBatteryPackCartridgeStatus}}) {
next if ($options{snmp_result}->{$oid_upsHighPrecBatteryPackCartridgeStatus}->{$oid} eq '');
$oid =~ /^$oid_upsHighPrecBatteryPackCartridgeStatus\.(\d+)\.\d+\.(\d+)/;
my ($pack_index, $cartridge_index) = ($1, $2);
if (!defined($self->{bpacks}->{$pack_index})) {
$self->{bpacks}->{$pack_index} = {
display => $pack_index,
cartridges => {}
};
}
$self->{bpacks}->{$pack_index}->{cartridges}->{$cartridge_index} = {
display => $cartridge_index,
status => 'OK'
};
my $status = '';
my ($i, $append) = (0, '');
foreach my $bit (split //, $options{snmp_result}->{$oid_upsHighPrecBatteryPackCartridgeStatus}->{$oid}) {
if ($bit) {
$status .= $append . $map_battery_pack_status->{$i};
$append = ',';
}
$i++;
}
$self->{bpacks}->{$pack_index}->{cartridges}->{$cartridge_index}->{status} = $status if ($status ne '');
}
}
sub manage_selection {
my ($self, %options) = @_;
my $snmp_result = $options{snmp}->get_multiple_table(
oids => [
{ oid => $oid_upsBasicBattery },
{ oid => $oid_upsAdvBattery, end => $mapping2->{upsAdvBatteryCurrent}->{oid} },
{ oid => $oid_upsHighPrecBatteryPackCartridgeStatus },
{ oid => $oid_upsHighPrecBatteryPackOnlyStatus }
],
nothing_quit => 1
);
$self->{global} = {};
my $result = $options{snmp}->map_instance(mapping => $mapping, results => $snmp_result->{$oid_upsBasicBattery}, instance => '0');
my $result2 = $options{snmp}->map_instance(mapping => $mapping2, results => $snmp_result->{$oid_upsAdvBattery}, instance => '0');
$result2->{upsAdvBatteryRunTimeRemaining} = sprintf("%.0f", $result2->{upsAdvBatteryRunTimeRemaining} / 100 / 60)
if (defined($result2->{upsAdvBatteryRunTimeRemaining}));
$self->{global} = { %$result, %$result2 };
if (defined($result->{upsBasicBatteryLastReplaceDate}) && $result->{upsBasicBatteryLastReplaceDate} =~ /(\d{2})\/(\d{2})\/(\d{4})/) {
my $dt = DateTime->new(year => $3, month => $1, day => $2, hour => 0, minute => 0, second => 0);
$self->{global}->{last_replace_time} = time() - $dt->epoch;
}
$self->add_battery_pack(snmp_result => $snmp_result);
}
1;
__END__
=head1 MODE
Check battery status and battery charge remaining.
=over 8
=item B<--filter-counters>
Only display some counters (regexp can be used).
Example: --filter-counters='^status|load$'
=item B<--unknown-status>
Set unknown threshold for status (Default: '%{status} =~ /unknown/i').
Can used special variables like: %{status}, %{replace}
=item B<--warning-status>
Set warning threshold for status (Default: '%{status} =~ /batteryLow/i').
Can used special variables like: %{status}, %{replace}
=item B<--critical-status>
Set critical threshold for status (Default: '%{replace} =~ /yes/i').
Can used special variables like: %{status}, %{replace}
=item B<--unknown-battery-pack-status>
Set unknown threshold for status.
Can used special variables like: %{status}
=item B<--warning-battery-pack-status>
Set warning threshold for status.
Can used special variables like: %{status}
=item B<--critical-battery-pack-status>
Set critical threshold for status (Default: '%{status} ne "OK"').
Can used special variables like: %{status}
=item B<--unknown-cartridge-status>
Set unknown threshold for status.
Can used special variables like: %{status}
=item B<--warning-cartridge-status>
Set warning threshold for status.
Can used special variables like: %{status}
=item B<--critical-cartridge-status>
Set critical threshold for status (Default: '%{status} ne "OK"').
Can used special variables like: %{status}
=item B<--warning-*> B<--critical-*>
Thresholds.
Can be: 'load', 'voltage', 'current',
'temperature', 'time', 'replace-lasttime'.
=back
=cut