includes/discovery/sensors/state/apc.inc.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 $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, 'uioInputContact', $apcContactData, 'PowerNet-MIB', null, '-OQUse');
if ($apcContactData['uioInputContactStatusTableSize'] > 0) {
// NMC2/NMC3/etc Universal Input Output
foreach (array_keys($apcContactData) as $index) {
// APC disabled (1), enabled (2)
$current = $apcContactData[$index]['uioInputContactStatusCurrentState'];
// state 4 is "not applicable"
if ($current != 4) {
$sensorType = 'apc';
$cur_oid = '.1.3.6.1.4.1.318.1.1.25.2.2.1.5.' . $index;
$severity = $apcContactData[$index]['uioInputContactStatusAlarmStatus'];
// APC normal (1), warning (2), critical (3), notaplicable (4)
// LibreNMS warning (1), critical (2)
$state_name = $apcContactData[$index]['uioInputContactStatusContactName'];
$states = [
['value' => 1, 'generic' => 0, 'graph' => 0, 'descr' => 'normal'],
['value' => 2, 'generic' => 1, 'graph' => 1, 'descr' => 'warning'],
['value' => 3, 'generic' => 2, 'graph' => 0, 'descr' => 'critical'],
];
create_state_index($state_name, $states);
// universalInputOutput sensor entries all have an sub-index, presumably to allow for multiple sensors in the
// future. Here we remove the sub-index from the first entry, so 1.1 becomes 1, 2.1 becomes 2, etc. However any
// future appearing sub-index will remain untouched, so 1.2 will stay 1.2, 2.2 will stay 2.2, etc.
// The reason that we remove the sub-index from the first entry is to preserve compatibility with sensors
// created by prior versions using the legacy iemConfig and iemStatus tables.
$split_index = explode('.', $index);
if (count($split_index) == 2 && $split_index[1] == 1) {
$index = $split_index[0];
}
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);
}
}
} else {
// NMC1 Integrated Environmental Monitor (legacy)
$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);
}
}
}