Skip to content

Latest commit

 

History

History
56 lines (43 loc) · 1.71 KB

README.md

File metadata and controls

56 lines (43 loc) · 1.71 KB

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:

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