mirror of
https://github.com/librenms/librenms.git
synced 2024-10-07 16:52:45 +00:00
0ae58d1883
* Update f5-ltm.inc.php Remove filter for ignore = 0 * Update f5-ltm-currconns.inc.php Remove filter for ignore = 0 * Update f5-gtm.inc.php Remove filter for ignore = 0 * Update ltm_vs.inc.php Change component filter from 'ignore' to 'disabled' * Update ltm_pool.inc.php Change component filter from 'ignore' to 'disabled' * Update ltm_bwc.inc.php Change component filter from 'ignore' to 'disabled' * Update gtm_wide.inc.php Change component filter from 'ignore' to 'disabled' * Update f5-cert.inc.php Change component filter from 'ignore' to 'disabled' * Update gtm_pool.inc.php Change component filter from 'ignore' to 'disabled'
259 lines
13 KiB
PHP
259 lines
13 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 = [];
|
|
$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'] = ['=', 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 = [];
|
|
$types = ['f5-ltm-vs', 'f5-ltm-bwc', 'f5-ltm-pool', 'f5-ltm-poolmember', 'f5-cert'];
|
|
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 (! empty($components)) {
|
|
// Let's gather the stats..
|
|
$f5_stats['f5-cert'] = snmpwalk_group($device, '.1.3.6.1.4.1.3375.2.1.15.1.2.1.5', 'F5-BIGIP-SYSTEM-MIB');
|
|
|
|
$f5_stats['ltmVirtualServStatEntryPktsin'] = snmpwalk_array_num($device, '.1.3.6.1.4.1.3375.2.2.10.2.3.1.6', 0);
|
|
$f5_stats['ltmVirtualServStatEntryPktsout'] = snmpwalk_array_num($device, '.1.3.6.1.4.1.3375.2.2.10.2.3.1.8', 0);
|
|
$f5_stats['ltmVirtualServStatEntryBytesin'] = snmpwalk_array_num($device, '.1.3.6.1.4.1.3375.2.2.10.2.3.1.7', 0);
|
|
$f5_stats['ltmVirtualServStatEntryBytesout'] = snmpwalk_array_num($device, '.1.3.6.1.4.1.3375.2.2.10.2.3.1.9', 0);
|
|
$f5_stats['ltmVirtualServStatEntryTotconns'] = snmpwalk_array_num($device, '.1.3.6.1.4.1.3375.2.2.10.2.3.1.11', 0);
|
|
|
|
$f5_stats['ltmBwcEntryPktsin'] = snmpwalk_array_num($device, '.1.3.6.1.4.1.3375.2.2.13.1.3.1.7', 0);
|
|
$f5_stats['ltmBwcEntryBytesin'] = snmpwalk_array_num($device, '.1.3.6.1.4.1.3375.2.2.13.1.3.1.4', 0);
|
|
$f5_stats['ltmBwcEntryBytesDropped'] = snmpwalk_array_num($device, '.1.3.6.1.4.1.3375.2.2.13.1.3.1.6', 0);
|
|
$f5_stats['ltmBwcEntryBytesPassed'] = snmpwalk_array_num($device, '.1.3.6.1.4.1.3375.2.2.13.1.3.1.5', 0);
|
|
|
|
$f5_stats['ltmPoolMemberStatEntryPktsin'] = snmpwalk_array_num($device, '.1.3.6.1.4.1.3375.2.2.5.4.3.1.5', 0);
|
|
$f5_stats['ltmPoolMemberStatEntryPktsout'] = snmpwalk_array_num($device, '.1.3.6.1.4.1.3375.2.2.5.4.3.1.7', 0);
|
|
$f5_stats['ltmPoolMemberStatEntryBytesin'] = snmpwalk_array_num($device, '.1.3.6.1.4.1.3375.2.2.5.4.3.1.6', 0);
|
|
$f5_stats['ltmPoolMemberStatEntryBytesout'] = snmpwalk_array_num($device, '.1.3.6.1.4.1.3375.2.2.5.4.3.1.8', 0);
|
|
$f5_stats['ltmPoolMemberStatEntryTotconns'] = snmpwalk_array_num($device, '.1.3.6.1.4.1.3375.2.2.5.4.3.1.10', 0);
|
|
|
|
// and check the status
|
|
$f5_stats['ltmVsStatusEntryState'] = snmpwalk_array_num($device, '1.3.6.1.4.1.3375.2.2.10.13.2.1.2', 0);
|
|
$f5_stats['ltmVsStatusEntryMsg'] = snmpwalk_array_num($device, '1.3.6.1.4.1.3375.2.2.10.13.2.1.5', 0);
|
|
|
|
$f5_stats['ltmPoolMbrStatusEntryState'] = snmpwalk_array_num($device, '1.3.6.1.4.1.3375.2.2.5.6.2.1.5', 0);
|
|
$f5_stats['ltmPoolMbrStatusEntryAvail'] = snmpwalk_array_num($device, '1.3.6.1.4.1.3375.2.2.5.6.2.1.6', 0);
|
|
$f5_stats['ltmPoolMbrStatusEntryMsg'] = snmpwalk_array_num($device, '1.3.6.1.4.1.3375.2.2.5.6.2.1.8', 0);
|
|
|
|
$f5_stats['ltmPoolEntryMinup'] = snmpwalk_array_num($device, '1.3.6.1.4.1.3375.2.2.5.1.2.1.4', 0);
|
|
$f5_stats['ltmPoolEntryMinupstatus'] = snmpwalk_array_num($device, '1.3.6.1.4.1.3375.2.2.5.1.2.1.5', 0);
|
|
$f5_stats['ltmPoolEntryMinupaction'] = snmpwalk_array_num($device, '1.3.6.1.4.1.3375.2.2.5.1.2.1.6', 0);
|
|
$f5_stats['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 = [$type, $label, $hash];
|
|
|
|
if ($type == 'f5-cert') {
|
|
$CERT_BASE_OID_NAME = 'sysCertificateFileObjectExpirationDate';
|
|
$CERT_THRESHOLD_WARNING = 30; // If Cert expires in less than this value (in days) => status = warning
|
|
$CERT_THRESHOLD_CRITICAL = 10; // If Cert expires in less than this value (in days) => status = critical
|
|
|
|
// expiration value from snmpwalk is in seconds since 01.01.1970
|
|
// we substract the current time, to get the time left until expiration
|
|
// and convert it into days, for better human readability
|
|
$array['daysLeft'] = intval(($f5_stats['f5-cert'][$UID][$CERT_BASE_OID_NAME] - getdate()[0]) / (3600 * 24));
|
|
$array['raw'] = $f5_stats['f5-cert'][$UID][$CERT_BASE_OID_NAME];
|
|
|
|
// Let's log some debugging
|
|
d_echo("\n\nComponent: " . $key . "\n");
|
|
d_echo(' Type: ' . $type . "\n");
|
|
d_echo(' Label: ' . $label . "\n");
|
|
d_echo(' Days until expiration: ' . $array['daysLeft'] . "\n");
|
|
d_echo(' RAW: ' . $array['raw'] . "\n");
|
|
|
|
//let's check when the cert expires
|
|
if ($array['daysLeft'] <= 0) {
|
|
$array['status'] = 2;
|
|
$array['error'] = 'CRITICAL: Certificate is expired!';
|
|
} elseif ($array['daysLeft'] <= $CERT_THRESHOLD_CRITICAL) {
|
|
$array['status'] = 2;
|
|
$array['error'] = 'CRITICAL: Certificate is about to expire in ' . $array['daysLeft'] . ' days!';
|
|
} elseif ($array['daysLeft'] <= $CERT_THRESHOLD_WARNING) {
|
|
$array['status'] = 1;
|
|
$array['error'] = 'WARNING: Certificate is about to expire in ' . $array['daysLeft'] . ' days!';
|
|
} else {
|
|
$array['status'] = 0;
|
|
$array['error'] = '';
|
|
}
|
|
} elseif ($type == 'f5-ltm-bwc') {
|
|
$rrd_def = RrdDefinition::make()
|
|
->addDataset('pktsin', 'COUNTER', 0)
|
|
->addDataset('bytesin', 'COUNTER', 0)
|
|
->addDataset('bytesdropped', 'COUNTER', 0)
|
|
->addDataset('bytespassed', 'COUNTER', 0);
|
|
|
|
$fields = [
|
|
'pktsin' => $f5_stats['ltmBwcEntryPktsin']['1.3.6.1.4.1.3375.2.2.13.1.3.1.7.' . $UID],
|
|
'bytesin' => $f5_stats['ltmBwcEntryBytesin']['1.3.6.1.4.1.3375.2.2.13.1.3.1.4.' . $UID],
|
|
'bytesdropped' => $f5_stats['ltmBwcEntryBytesDropped']['1.3.6.1.4.1.3375.2.2.13.1.3.1.6.' . $UID],
|
|
'bytespassed' => $f5_stats['ltmBwcEntryBytesPassed']['1.3.6.1.4.1.3375.2.2.13.1.3.1.5.' . $UID],
|
|
];
|
|
|
|
// Let's print some debugging info.
|
|
d_echo("\n\nComponent: " . $key . "\n");
|
|
d_echo(' Type: ' . $type . "\n");
|
|
d_echo(' Label: ' . $label . "\n");
|
|
} elseif ($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 = [
|
|
'pktsin' => $f5_stats['ltmVirtualServStatEntryPktsin']['1.3.6.1.4.1.3375.2.2.10.2.3.1.6.' . $UID],
|
|
'pktsout' => $f5_stats['ltmVirtualServStatEntryPktsout']['1.3.6.1.4.1.3375.2.2.10.2.3.1.8.' . $UID],
|
|
'bytesin' => $f5_stats['ltmVirtualServStatEntryBytesin']['1.3.6.1.4.1.3375.2.2.10.2.3.1.7.' . $UID],
|
|
'bytesout' => $f5_stats['ltmVirtualServStatEntryBytesout']['1.3.6.1.4.1.3375.2.2.10.2.3.1.9.' . $UID],
|
|
'totconns' => $f5_stats['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'] = $f5_stats['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'] = $f5_stats['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'] = $f5_stats['ltmPoolEntryMinup']['1.3.6.1.4.1.3375.2.2.5.1.2.1.4.' . $UID];
|
|
$array['minupstatus'] = $f5_stats['ltmPoolEntryMinupstatus']['1.3.6.1.4.1.3375.2.2.5.1.2.1.5.' . $UID];
|
|
$array['currentup'] = $f5_stats['ltmPoolEntryCurrentup']['1.3.6.1.4.1.3375.2.2.5.1.2.1.8.' . $UID];
|
|
$array['minupaction'] = $f5_stats['ltmPoolEntryMinupaction']['1.3.6.1.4.1.3375.2.2.5.1.2.1.6.' . $UID];
|
|
|
|
$fields = [
|
|
'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'] = $f5_stats['ltmPoolMbrStatusEntryState']['1.3.6.1.4.1.3375.2.2.5.6.2.1.5.' . $UID];
|
|
$array['available'] = $f5_stats['ltmPoolMbrStatusEntryAvail']['1.3.6.1.4.1.3375.2.2.5.6.2.1.6.' . $UID];
|
|
|
|
$fields = [
|
|
'pktsin' => $f5_stats['ltmPoolMemberStatEntryPktsin']['1.3.6.1.4.1.3375.2.2.5.4.3.1.5.' . $UID],
|
|
'pktsout' => $f5_stats['ltmPoolMemberStatEntryPktsout']['1.3.6.1.4.1.3375.2.2.5.4.3.1.7.' . $UID],
|
|
'bytesin' => $f5_stats['ltmPoolMemberStatEntryBytesin']['1.3.6.1.4.1.3375.2.2.5.4.3.1.6.' . $UID],
|
|
'bytesout' => $f5_stats['ltmPoolMemberStatEntryBytesout']['1.3.6.1.4.1.3375.2.2.5.4.3.1.8.' . $UID],
|
|
'totconns' => $f5_stats['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: ' . $f5_stats['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
|
|
|
|
unset($f5_stats);
|
|
|
|
// 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,
|
|
$error_poolaction,
|
|
$keep
|
|
);
|