mirror of
https://github.com/librenms/librenms.git
synced 2024-10-07 16:52:45 +00:00
fad5aca1b7
* feature: Allow customisation of rrd step/heartbeat when creating new rrd files * revert defaults * added docs + webui config option * Move RrdDefinition to an Object to make them easier to create and remove the possibility of typos. * Fix style/lint issues and missing use statements * 3 more missing use statements * updated doc + moved schema file
194 lines
9.0 KiB
PHP
194 lines
9.0 KiB
PHP
<?php
|
|
/*
|
|
* LibreNMS module to display F5 LTM Details
|
|
*
|
|
* Copyright (c) 2016 Aaron Daniels <aaron@daniels.id.au>
|
|
*
|
|
* 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.
|
|
*/
|
|
|
|
use LibreNMS\RRD\RrdDefinition;
|
|
|
|
// Define some error messages
|
|
$error_poolaction = array();
|
|
$error_poolaction[0] = "Unused";
|
|
$error_poolaction[1] = "Reboot";
|
|
$error_poolaction[2] = "Restart";
|
|
$error_poolaction[3] = "Failover";
|
|
$error_poolaction[4] = "Failover and Restart";
|
|
$error_poolaction[5] = "Go Active";
|
|
$error_poolaction[6] = "None";
|
|
|
|
$component = new LibreNMS\Component();
|
|
$options['filter']['disabled'] = array('=',0);
|
|
$options['filter']['ignore'] = array('=',0);
|
|
$components = $component->getComponents($device['device_id'], $options);
|
|
|
|
// We only care about our device id.
|
|
$components = $components[$device['device_id']];
|
|
|
|
// We extracted all the components for this device, now lets only get the LTM ones.
|
|
$keep = array();
|
|
$types = array('f5-ltm-vs', 'f5-ltm-pool', 'f5-ltm-poolmember');
|
|
foreach ($components as $k => $v) {
|
|
foreach ($types as $type) {
|
|
if ($v['type'] == $type) {
|
|
$keep[$k] = $v;
|
|
}
|
|
}
|
|
}
|
|
$components = $keep;
|
|
|
|
// Only collect SNMP data if we have enabled components
|
|
if (count($components > 0)) {
|
|
// Let's gather the stats..
|
|
$ltmVirtualServStatEntryPktsin = snmpwalk_array_num($device, '.1.3.6.1.4.1.3375.2.2.10.2.3.1.6', 0);
|
|
$ltmVirtualServStatEntryPktsout = snmpwalk_array_num($device, '.1.3.6.1.4.1.3375.2.2.10.2.3.1.8', 0);
|
|
$ltmVirtualServStatEntryBytesin = snmpwalk_array_num($device, '.1.3.6.1.4.1.3375.2.2.10.2.3.1.7', 0);
|
|
$ltmVirtualServStatEntryBytesout = snmpwalk_array_num($device, '.1.3.6.1.4.1.3375.2.2.10.2.3.1.9', 0);
|
|
$ltmVirtualServStatEntryTotconns = snmpwalk_array_num($device, '.1.3.6.1.4.1.3375.2.2.10.2.3.1.11', 0);
|
|
|
|
$ltmPoolMemberStatEntryPktsin = snmpwalk_array_num($device, '.1.3.6.1.4.1.3375.2.2.5.4.3.1.5', 0);
|
|
$ltmPoolMemberStatEntryPktsout = snmpwalk_array_num($device, '.1.3.6.1.4.1.3375.2.2.5.4.3.1.7', 0);
|
|
$ltmPoolMemberStatEntryBytesin = snmpwalk_array_num($device, '.1.3.6.1.4.1.3375.2.2.5.4.3.1.6', 0);
|
|
$ltmPoolMemberStatEntryBytesout = snmpwalk_array_num($device, '.1.3.6.1.4.1.3375.2.2.5.4.3.1.8', 0);
|
|
$ltmPoolMemberStatEntryTotconns = snmpwalk_array_num($device, '.1.3.6.1.4.1.3375.2.2.5.4.3.1.10', 0);
|
|
|
|
// and check the status
|
|
$ltmVsStatusEntryState = snmpwalk_array_num($device, '1.3.6.1.4.1.3375.2.2.10.13.2.1.2', 0);
|
|
$ltmVsStatusEntryMsg = snmpwalk_array_num($device, '1.3.6.1.4.1.3375.2.2.10.13.2.1.5', 0);
|
|
|
|
$ltmPoolMbrStatusEntryState = snmpwalk_array_num($device, '1.3.6.1.4.1.3375.2.2.5.6.2.1.5', 0);
|
|
$ltmPoolMbrStatusEntryAvail = snmpwalk_array_num($device, '1.3.6.1.4.1.3375.2.2.5.6.2.1.6', 0);
|
|
$ltmPoolMbrStatusEntryMsg = snmpwalk_array_num($device, '1.3.6.1.4.1.3375.2.2.5.6.2.1.8', 0);
|
|
|
|
$ltmPoolEntryMinup = snmpwalk_array_num($device, '1.3.6.1.4.1.3375.2.2.5.1.2.1.4', 0);
|
|
$ltmPoolEntryMinupstatus = snmpwalk_array_num($device, '1.3.6.1.4.1.3375.2.2.5.1.2.1.5', 0);
|
|
$ltmPoolEntryMinupaction = snmpwalk_array_num($device, '1.3.6.1.4.1.3375.2.2.5.1.2.1.6', 0);
|
|
$ltmPoolEntryCurrentup = snmpwalk_array_num($device, '1.3.6.1.4.1.3375.2.2.5.1.2.1.8', 0);
|
|
|
|
// Loop through the components and extract the data.
|
|
foreach ($components as $key => &$array) {
|
|
$type = $array['type'];
|
|
$UID = $array['UID'];
|
|
$label = $array['label'];
|
|
$hash = $array['hash'];
|
|
$rrd_name = array($type, $label, $hash);
|
|
|
|
if ($type == 'f5-ltm-vs') {
|
|
$rrd_def = RrdDefinition::make()
|
|
->addDataset('pktsin', 'COUNTER', 0)
|
|
->addDataset('pktsout', 'COUNTER', 0)
|
|
->addDataset('bytesin', 'COUNTER', 0)
|
|
->addDataset('bytesout', 'COUNTER', 0)
|
|
->addDataset('totconns', 'COUNTER', 0);
|
|
|
|
$fields = array(
|
|
'pktsin' => $ltmVirtualServStatEntryPktsin['1.3.6.1.4.1.3375.2.2.10.2.3.1.6.'.$UID],
|
|
'pktsout' => $ltmVirtualServStatEntryPktsout['1.3.6.1.4.1.3375.2.2.10.2.3.1.8.'.$UID],
|
|
'bytesin' => $ltmVirtualServStatEntryBytesin['1.3.6.1.4.1.3375.2.2.10.2.3.1.7.'.$UID],
|
|
'bytesout' => $ltmVirtualServStatEntryBytesout['1.3.6.1.4.1.3375.2.2.10.2.3.1.9.'.$UID],
|
|
'totconns' => $ltmVirtualServStatEntryTotconns['1.3.6.1.4.1.3375.2.2.10.2.3.1.11.'.$UID],
|
|
);
|
|
|
|
// Let's print some debugging info.
|
|
d_echo("\n\nComponent: ".$key."\n");
|
|
d_echo(" Type: ".$type."\n");
|
|
d_echo(" Label: ".$label."\n");
|
|
|
|
// Let's check the status.
|
|
$array['state'] = $ltmVsStatusEntryState['1.3.6.1.4.1.3375.2.2.10.13.2.1.2.'.$UID];
|
|
if (($array['state'] == 2) || ($array['state'] == 3)) {
|
|
// The Virtual Server is unavailable.
|
|
$array['status'] = 2;
|
|
$array['error'] = $ltmVsStatusEntryMsg['1.3.6.1.4.1.3375.2.2.10.13.2.1.5.'.$UID];
|
|
} else {
|
|
// All is good.
|
|
$array['status'] = 0;
|
|
$array['error'] = '';
|
|
}
|
|
} elseif ($type == 'f5-ltm-pool') {
|
|
$rrd_def = RrdDefinition::make()
|
|
->addDataset('minup', 'GAUGE', 0)
|
|
->addDataset('currup', 'GAUGE', 0);
|
|
|
|
$array['minup'] = $ltmPoolEntryMinup['1.3.6.1.4.1.3375.2.2.5.1.2.1.4.'.$UID];
|
|
$array['minupstatus'] = $ltmPoolEntryMinupstatus['1.3.6.1.4.1.3375.2.2.5.1.2.1.5.'.$UID];
|
|
$array['currentup'] = $ltmPoolEntryCurrentup['1.3.6.1.4.1.3375.2.2.5.1.2.1.8.'.$UID];
|
|
$array['minupaction'] = $ltmPoolEntryMinupaction['1.3.6.1.4.1.3375.2.2.5.1.2.1.6.'.$UID];
|
|
|
|
$fields = array(
|
|
'minup' => $array['minup'],
|
|
'currup' => $array['currentup'],
|
|
);
|
|
|
|
// Let's print some debugging info.
|
|
d_echo("\n\nComponent: ".$key."\n");
|
|
d_echo(" Type: ".$type."\n");
|
|
d_echo(" Label: ".$label."\n");
|
|
|
|
// If we have less pool members than the minimum, we should error.
|
|
if ($array['currentup'] < $array['minup']) {
|
|
// Danger Will Robinson... We dont have enough Pool Members!
|
|
$array['status'] = 2;
|
|
$array['error'] = "Minimum Pool Members not met. Action taken: ".$error_poolaction[$array['minupaction']];
|
|
} else {
|
|
// All is good.
|
|
$array['status'] = 0;
|
|
$array['error'] = '';
|
|
}
|
|
} elseif ($type == 'f5-ltm-poolmember') {
|
|
$rrd_def = RrdDefinition::make()
|
|
->addDataset('pktsin', 'COUNTER', 0)
|
|
->addDataset('pktsout', 'COUNTER', 0)
|
|
->addDataset('bytesin', 'COUNTER', 0)
|
|
->addDataset('bytesout', 'COUNTER', 0)
|
|
->addDataset('totconns', 'COUNTER', 0);
|
|
|
|
$array['state'] = $ltmPoolMbrStatusEntryState['1.3.6.1.4.1.3375.2.2.5.6.2.1.5.'.$UID];
|
|
$array['available'] = $ltmPoolMbrStatusEntryAvail['1.3.6.1.4.1.3375.2.2.5.6.2.1.6.'.$UID];
|
|
|
|
$fields = array(
|
|
'pktsin' => $ltmPoolMemberStatEntryPktsin['1.3.6.1.4.1.3375.2.2.5.4.3.1.5.'.$UID],
|
|
'pktsout' => $ltmPoolMemberStatEntryPktsout['1.3.6.1.4.1.3375.2.2.5.4.3.1.7.'.$UID],
|
|
'bytesin' => $ltmPoolMemberStatEntryBytesin['1.3.6.1.4.1.3375.2.2.5.4.3.1.6.'.$UID],
|
|
'bytesout' => $ltmPoolMemberStatEntryBytesout['1.3.6.1.4.1.3375.2.2.5.4.3.1.8.'.$UID],
|
|
'totalconns' => $ltmPoolMemberStatEntryTotconns['1.3.6.1.4.1.3375.2.2.5.4.3.1.10.'.$UID],
|
|
);
|
|
|
|
// Let's print some debugging info.
|
|
d_echo("\n\nComponent: ".$key."\n");
|
|
d_echo(" Type: ".$type."\n");
|
|
d_echo(" Label: ".$label."\n");
|
|
|
|
// If available and bad state
|
|
// 0 = None, 1 = Green, 2 = Yellow, 3 = Red, 4 = Blue
|
|
if (($array['available'] == 1) && ($array['state'] == 3)) {
|
|
// Warning Alarm, the pool member is down.
|
|
$array['status'] = 1;
|
|
$array['error'] = "Pool Member is Down: ".$ltmPoolMbrStatusEntryMsg['1.3.6.1.4.1.3375.2.2.5.6.2.1.8.'.$UID];
|
|
} else {
|
|
// All is good.
|
|
$array['status'] = 0;
|
|
$array['error'] = '';
|
|
}
|
|
} else {
|
|
d_echo("Type is unknown: ".$type."\n");
|
|
continue;
|
|
}
|
|
|
|
$tags = compact('rrd_name', 'rrd_def', 'type', 'hash', 'label');
|
|
data_update($device, $type, $tags, $fields);
|
|
} // End foreach components
|
|
|
|
// Write the Components back to the DB.
|
|
$component->setComponentPrefs($device['device_id'], $components);
|
|
} // end if count components
|
|
|
|
// Clean-up after yourself!
|
|
unset($type, $components, $component, $options);
|