diff --git a/doc/Extensions/Smokeping.md b/doc/Extensions/Smokeping.md new file mode 100644 index 000000000..713800cac --- /dev/null +++ b/doc/Extensions/Smokeping.md @@ -0,0 +1,45 @@ +# Smokeping integration + +We currently have two ways to use Smokeping with LibreNMS, the first is using the included script generator to generate the config for Smokeping. The +second is to utilise an existing Smokeping setup. + +### Included Smokeping script + +To use this, please add something similar to your smokeping config file: + +```bash +@include /opt/smokeping/etc/librenms.conf +``` + +Then you need to generate the config file (maybe even add a cron to schedule this in and reload smokeping). We've assumed a few locations for smokeping, the config file you want +to call it and where LibreNMS is: + +```bash +cd /opt/librenms/scripts/ +php ./gen_smokeping.php > /opt/smokepgin/etc/librenms.conf +/opt/smokeping/bin/smokeping --reload +``` + +Sample cron: + +```bash +15 0 * * * root cd /opt/librenms/scripts && php ./gen_smokeping.php > /opt/smokepgin/etc/librenms.conf && /opt/smokeping/bin/smokeping --reload >> /dev/null 2>&1 +``` + +Now configure LibreNMS (make sure you point dir to your smokeping data directory: + +```php +$config['smokeping']['dir'] = '/opt/smokeping/data'; +$config['smokeping']['integration'] = true; +``` + +### Standard Smokeping + +This is quite simple, just point your dir at the smokeping data directory - please be aware that all RRD files need to be within this dir and NOT sub dirs: + +```php +$config['smokeping']['dir'] = '/opt/smokeping/data'; +$config['own_hostname'] +``` + +You should now see a new tab in your device page called ping. diff --git a/scripts/gen_smokeping.php b/scripts/gen_smokeping.php new file mode 100755 index 000000000..454e281b6 --- /dev/null +++ b/scripts/gen_smokeping.php @@ -0,0 +1,36 @@ + +* 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. +*/ + +include_once("../config.php"); +include_once("../includes/defaults.inc.php"); +include_once("../includes/definitions.inc.php"); +include_once("../includes/functions.inc.php"); + +?> + +menu = Top +title = Network Latency Grapher + +