Files
librenms-librenms/includes/discovery/sensors/state/apc.inc.php
KodApa85 8ec2476036 Added support for APC AP9810 zone contacts (#9967)
* device: Added support for APC AP9810 zone contacts

* fix: disconnected sensors been detected. And iemConfigProbesTable certainly does get used and it reference

* fix: load is VA, not to be confused with watts. This could be different per device though...
Apparent Power unit = VA
Real Power unit = Watts

And Keeping codeclimate happy

* feature: updated APC MIB

* feature: added test data for APC Smart UPS SMX750i and AP9810 with contact switches
2019-03-22 00:10:20 +01:00

193 lines
8.4 KiB
PHP

<?php
/*
* LibreNMS
*
* Copyright (c) 2016 Søren Friis Rosiak <sorenrosiak@gmail.com>
* This program is free software: you can redistribute it and/or modify it
* under the terms of the GNU General Public License as published by the
* Free Software Foundation, either version 3 of the License, or (at your
* option) any later version. Please see LICENSE.txt at the top level of
* the source code distribution for details.
*/
$temp = snmp_get($device, "upsAdvBatteryReplaceIndicator.0", "-Ovqe", "PowerNet-MIB");
$cur_oid = '.1.3.6.1.4.1.318.1.1.1.2.2.4.0';
$index = '0';
if (is_numeric($temp)) {
//Create State Index
$state_name = 'upsAdvBatteryReplaceIndicator';
$states = [
['value' => 1, 'generic' => 0, 'graph' => 0, 'descr' => 'noBatteryNeedsReplacing'],
['value' => 2, 'generic' => 2, 'graph' => 0, 'descr' => 'batteryNeedsReplacing'],
];
create_state_index($state_name, $states);
$descr = 'UPS Battery Replacement Status';
//Discover Sensors
discover_sensor($valid['sensor'], 'state', $device, $cur_oid, $index, $state_name, $descr, 1, 1, null, null, null, null, $temp, 'snmp', $index);
//Create Sensor To State Index
create_sensor_to_state_index($device, $state_name, $index);
}
$cooling_status = snmpwalk_cache_oid($device, 'coolingUnitStatusDiscreteEntry', [], 'PowerNet-MIB');
foreach ($cooling_status as $index => $data) {
$cur_oid = '.1.3.6.1.4.1.318.1.1.27.1.4.2.2.1.4.' . $index;
$state_name = $data['coolingUnitStatusDiscreteDescription'];
$tmp_states = explode(',', $data['coolingUnitStatusDiscreteIntegerReferenceKey']);
$states = [];
foreach ($tmp_states as $k => $ref) {
preg_match('/([\w]+)\\(([\d]+)\\)/', $ref, $matches);
$nagios_state = get_nagios_state($matches[1]);
$states[] = ['value' => 0, 'generic' => $nagios_state, 'graph' => 0, $matches[2], 'descr' => $matches[1]];
}
create_state_index($state_name, $states);
discover_sensor($valid['sensor'], 'state', $device, $cur_oid, $cur_oid, 'apc', $state_name, 1, 1, null, null, null, null, $data['coolingUnitStatusDiscreteValueAsInteger']);
create_sensor_to_state_index($device, $state_name, $index);
}
unset($cooling_status);
$cooling_unit = snmpwalk_cache_oid($device, 'coolingUnitExtendedDiscreteEntry', [], 'PowerNet-MIB');
foreach ($cooling_unit as $index => $data) {
$cur_oid = '.1.3.6.1.4.1.318.1.1.27.1.6.2.2.1.4.' . $index;
$state_name = $data['coolingUnitExtendedDiscreteDescription'];
$tmp_states = explode(',', $data['coolingUnitExtendedDiscreteIntegerReferenceKey']);
$states = [];
foreach ($tmp_states as $k => $ref) {
preg_match('/([\w]+)\\(([\d]+)\\)/', $ref, $matches);
$nagios_state = get_nagios_state($matches[1]);
$states[] = ['value' => 0, 'generic' => $nagios_state, 'graph' => 0, $matches[2], 'descr' => $matches[1]];
}
create_state_index($state_name, $states);
discover_sensor($valid['sensor'], 'state', $device, $cur_oid, $cur_oid, 'apc', $state_name, 1, 1, null, null, null, null, $data['coolingUnitExtendedDiscreteValueAsInteger']);
create_sensor_to_state_index($device, $state_name, $index);
}
unset($cooling_unit);
$relays = snmpwalk_cache_oid($device, 'emsOutputRelayControlEntry', [], 'PowerNet-MIB');
foreach ($relays as $index => $data) {
$cur_oid = '.1.3.6.1.4.1.318.1.1.10.3.2.1.1.3.' . $index;
$state_name = $data['emsOutputRelayControlOutputRelayName'];
$states = [
['value' => 1, 'generic' => 2, 'graph' => 0, 'descr' => 'immediateCloseEMS'],
['value' => 2, 'generic' => 0, 'graph' => 0, 'descr' => 'immediateOpenEMS'],
];
create_state_index($state_name, $states);
$current = apc_relay_state($data['emsOutputRelayControlOutputRelayCommand']);
if (is_numeric($current)) {
discover_sensor($valid['sensor'], 'state', $device, $cur_oid, $cur_oid, $state_name, $state_name, 1, 1, null, null, null, null, $current);
create_sensor_to_state_index($device, $state_name, $cur_oid);
}
}
unset(
$relays,
$index,
$data
);
$switched = snmpwalk_cache_oid($device, 'emsOutletControlEntry', [], 'PowerNet-MIB');
foreach ($switched as $index => $data) {
$cur_oid = '.1.3.6.1.4.1.318.1.1.10.3.3.1.1.3.' . $index;
$state_name = $data['emsOutletControlOutletName'];
$states = [
['value' => 1, 'generic' => 2, 'graph' => 0, 'descr' => 'immediateOnEMS'],
['value' => 2, 'generic' => 0, 'graph' => 0, 'descr' => 'immediateOffEMS'],
];
create_state_index($state_name, $states);
$current = apc_relay_state($data['emsOutletControlOutletCommand']);
if (is_numeric($current)) {
discover_sensor($valid['sensor'], 'state', $device, $cur_oid, $cur_oid, $state_name, $state_name, 1, 1, null, null, null, null, $current);
create_sensor_to_state_index($device, $state_name, $cur_oid);
}
}
unset(
$switched,
$index,
$data
);
foreach ($pre_cache['mem_sensors_status'] as $index => $data) {
if ($data['memSensorsCommStatus']) {
$cur_oid = '.1.3.6.1.4.1.318.1.1.10.4.2.3.1.7.' . $index;
$state_name = 'memSensorsCommStatus';
$states = [
['value' => 1, 'generic' => 1, 'graph' => 0, 'descr' => 'notInstalled'],
['value' => 2, 'generic' => 0, 'graph' => 0, 'descr' => 'commsOK'],
['value' => 3, 'generic' => 2, 'graph' => 0, 'descr' => 'commsLost'],
];
create_state_index($state_name, $states);
$current = $data['memSensorsCommStatus'];
}
$descr = $data['memSensorsStatusSensorName'] . ' - ' . $data['memSensorsStatusSensorLocation'];
$divisor = 1;
$multiplier = 1;
if (is_numeric($current)) {
discover_sensor($valid['sensor'], 'state', $device, $cur_oid, $state_name . '.' . $index, $state_name, $state_name, 1, 1, null, null, null, null, $current);
create_sensor_to_state_index($device, $state_name, $state_name . '.' . $index);
}
if ($data['memSensorsAlarmStatus']) {
$cur_oid = '.1.3.6.1.4.1.318.1.1.10.4.2.3.1.8.' . $index;
$state_name = 'memSensorsAlarmStatus';
$states = [
['value' => 1, 'generic' => 0, 'graph' => 0, 'descr' => 'memNormal'],
['value' => 2, 'generic' => 1, 'graph' => 0, 'descr' => 'memWarning'],
['value' => 3, 'generic' => 2, 'graph' => 0, 'descr' => 'memCritical'],
];
create_state_index($state_name, $states);
$current = $data['memSensorsAlarmStatus'];
}
$descr = $data['memSensorsStatusSensorName'] . ' - ' . $data['memSensorsStatusSensorLocation'];
$divisor = 1;
$multiplier = 1;
if (is_numeric($current)) {
discover_sensor($valid['sensor'], 'state', $device, $cur_oid, $state_name . '.' . $index, $state_name, $state_name, 1, 1, null, null, null, null, $current);
create_sensor_to_state_index($device, $state_name, $state_name . '.' . $index);
}
}
// Monitor contact switches via the UIO ports.
$apcContactData = snmpwalk_cache_oid($device, 'iemConfigContactsTable', [], 'PowerNet-MIB', null, '-OQUse');
$apcContactData = snmpwalk_cache_oid($device, 'iemStatusContactsTable', $apcContactData, 'PowerNet-MIB', null, '-OQUse');
foreach (array_keys($apcContactData) as $index) {
// APC disabled (1), enabled (2)
if ($apcContactData[$index]['iemConfigContactEnable'] == 2) {
$current = $apcContactData[$index]['iemStatusContactStatus'];
$sensorType = 'apc';
$cur_oid = '.1.3.6.1.4.1.318.1.1.10.2.3.4.1.3.' . $index;
$severity = $apcContactData[$index]['iemConfigContactSeverity'];
// APC critical (1), warning (2)
// LibreNMS warning (1), critical (2)
$faultGeneric = 1;
if ($severity == 1) {
$faultGeneric = 2;
} elseif ($severity == 2) {
$faultGeneric = 1;
}
$state_name = $apcContactData[$index]['iemConfigContactName'];
$states = [
['value' => 1, 'generic' => 0, 'graph' => 0, 'descr' => 'noFault'],
['value' => 2, 'generic' => $faultGeneric, 'graph' => 1, 'descr' => 'fault'],
['value' => 3, 'generic' => 0, 'graph' => 0, 'descr' => 'disabled'],
];
create_state_index($state_name, $states);
discover_sensor($valid['sensor'], 'state', $device, $cur_oid, $state_name.'.'.$index, $state_name, $state_name, 1, 1, null, null, null, null, $current);
create_sensor_to_state_index($device, $state_name, $state_name . '.' . $index);
}
}