This repository contains plugins we use with Shinken, to check various services, and which are not implemented in the usual plugins packages.
The best way to install these plugins is through your package manager. You can browse all the package repositories on Open Build Service project.
$ sudo sh -c "echo 'deb http://download.opensuse.org/repositories/home:/sfl-monitoring:/monitoring-tools/Debian_7.0/ ./' > /etc/apt/sources.list.d/monitoring-tools.list"
$ wget http://download.opensuse.org/repositories/home:/sfl-monitoring:/monitoring-tools/Debian_7.0/Release.key
$ sudo apt-key add - < Release.key
$ sudo apt-get update
$ sudo apt-get install plugin-<the plugin you want>
You can browse the online documentation at http://sfl-monitoring-tools.readthedocs.org/
To generate a plugin, you need to install jinja2, either by pip or via your package manager:
$ sudo pip install jinja2
or
$ sudo (apt-get|yum) install python-jinja2
Then
$ make new-plugin
To execute a plugin, you need to install the library shinkenplugins:
$ sudo pip install shinkenplugins
or for Debian and Ubuntu:
$ sudo apt-get install lib-shinkenplugins
After modifying files under debian/, you can add an entry in the changelog by doing:
$ author=$(git log -n 1 --format=%aN)
$ export DEBFULLNAME=$author
$ email=$(git log -n 1 --format=%ae)
$ export DEBEMAIL=$email
$ msg=$(git log -n 1 --format=%s)
$ version=$(date +%Y.%m.%e.%H.%M)
$ dch $msg --no-auto-nmu --newversion $version
make packages
This will build the .orig.tar.gz, .debian.tar.gz, .dsc, and .changes files.
make obs
This will checkout the OBS project and commit the new debian source package files. You must be a maintainer on the OBS project to successfully run this command. Travis has the permissions to do it.