README.md

Fluxios

Jul 11, 2016

Introduction

Fluxios is a script to take and parse nagios perfdata files and write them to InfluxDB.

Inspiration (and some small pieces of code) has been taken from graphios and the Shinken mod-influxdb module:

• https://github.com/shawn-sterling/graphios
• https://github.com/savoirfairelinux/mod-influxdb

The main differences between fluxios and graphios are:

• Use of influxdb-python to handle all the communication with influxdb
• All configuration is done via config file
• Better handling of perfdata, namely regexes, shlex.split, and re.split where necessary
• Simpler code, fluxios only supports influxdb
• Better use of influxdb tags and fields by storing data more usefully.

Nagios perfdata is mapped into points as such:

point = {
	"measurement": check_command,
	"timestamp": timestamp,
	"fields": {
                "label": label,
                "value": value,
                "uom": uom,
                "warn": warn,
                "crit": crit,
                "min": min,
                "max": max
	}
	"tags": {
	    "service_description": service_description,
	    "host_name": host_name,
	    "metric": label,
	}
}

Grafana

There is a grafana scripted dashboard under grafana/. Install this under /usr/share/grafana/public/dashboards. Change nagios_host_default and nagios_ds to suit your particular installation. Adjust the links in the initial dashboard variable as appropriate.

License

Fluxios is released under the GPLv2.

Todo

• Finish this readme
• tox unit tests
• Either a retry or buffered approach to sending points to influxdb
• Don't delete perfdata file unless it is older than cfg['fluxios']['interval'] seconds