nicolas/librenms
1
0
Fork 0
mirror of https://github.com/stylersnico/librenms.git synced 2026-07-28 00:24:21 +02:00
Code Issues Packages Projects Releases Wiki Activity

Added configuration examples and descriptions for mib based poller

Browse Source
This commit is contained in:
awlx
2016-02-03 10:19:07 +01:00
parent a81776e77b
commit 1b6662448f
1 changed files with 53 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
doc/Extensions/MIB-based-polling.md
+53
View File
@@ -144,6 +144,59 @@ graph.
can follow the above process, then use the resultant data collected by
LibreNMS in the RRD files or the database tables `device_oids`
## Configuration
### Discovery
You need to add your desired MIBs to `/opt/librenms/mibs` folder. Afterwards you need to register your MIBs to the discovery function.
#### Example
`/opt/librenms/includes/discovery/os/f5.inc.php`
```
<?php
if (!$os || $os === 'linux') {
$f5_sys_parent = '1.3.6.1.4.1.3375.2.1';
if (strpos($sysObjectId, $f5_sys_parent)) {
$os = 'f5';
}
}
### MIB definition as an array
$f5_mibs = array(
"ltmVirtualServStatEntry" => "F5-BIGIP-LOCAL-MIB",
);
### Actual registering of the MIB
register_mibs($device, $f5_mibs, "includes/discovery/os/f5.inc.php");
```
The important thing is the array $f5_mibs where you define which parts (ltmVirtualServStatEntry) of the MIB (F5-BIGIP-LOCAL-MIB) you are going to add. The registering is also important, otherwise poller cannot make use of the MIB.
### Poller
Next step is to add the MIBs to the poller.
#### Example
`/opt/librenms/includes/polling/os/f5.inc.php`
```
<?php
$version = trim(snmp_get($device, '.1.3.6.1.4.1.3375.2.1.4.2.0', '-OQv', '', ''), '"');
### MIB definition as an array
$f5_mibs = array(
"ltmVirtualServStatEntry" => "F5-BIGIP-LOCAL-MIB",
);
### Poll those MIBs
poll_mibs($f5_mibs, $device, $graphs);
```
You define the MIBs which you want to poll here and start the actual polling with `poll_mibs()`.
## TODO ##