Summary

This project was started to build a self-service and partially automated front end to the Influx/Telegraf monitoring tools.

It uses (or rather relies on) :

InfluxDB - TSDB Store

Chronograf - Visualisation

Telegraf - Agents for metric collection

Elasticsearch - Used to store telegraf configs, alert definitions, logs, etc.

Python - Standard Python3 package (Flask will be installed as part of this)

The features are as follows :

Automated Telegraf configuration Agent calls in to a Webserver which builds a dynamic config based off config fragments. There is a front end to manage what gets deployed to each host and Telegraf calls the web server on startup with a series of params to help build the config

Event configuration. Build threshold conditions based on metrics, and generate an alert when breached. (Alert not included). Events can have multiple tags assigned to (see 3)

Event groups. Create a grouping of alerts based on tags and allow these to be evaluated as a single entity, showing the status as RAG status on screen. Useful if you have a set of standard monitors on each box and you want to check them all in one go

Agent health. Simple page to show status of each agent by showing host uptime and last measurement with simple RAG status

Will write more when the project is a bit more mature.

What is included

This project is designed to install on a single Linux server as a non-root user. The installer script will :

Download binaries for InfluxDB, Chronograf, Kapacitor, Elasticsearch, Telegraf, Flask (Python), Web application

Install the binaries, symlinks, sample configs

Provide a web front end (via Flask) to view and configure the agents as well as thresholds/alerts

If you already have an Elasticsearch instance, you can amend the ./maas/conf/env config file to point to that instead.

How to install

Look at the ./maas/setup/README file for details