grafana_alerts 1.0.0.dev2

Alerting Module to use with Grafana metrics.

Collects stats from a grafana server based in information available in Grafana Dashboards, compare those values to an alert table and throws alert emails in case it is needed.

Sites

Installation package: https://pypi.python.org/pypi/grafana_alerts

Project Home: https://github.com/pabloa/grafana-alerts

Issues amd bugs: https://github.com/pabloa/grafana-alerts/issues

Installation

sudo pip install grafana-alerts

if you get an error, perhaps it is because the version available is a development version. In this case try with:

sudo pip install --pre grafana-alerts

Configuration

Create a file /etc/grafana_alerts/grafana_alerts.cfg with:

#
# Grafana alerts configuration file.
#

# The URL where grafana server is listening. It must finish with the character '/' (default value: http://localhost:3130)
grafana_url = http://yourgrafanaserver.com/grafana/

# Grafana token with viewer access (default value: empty string)
grafana_token = qwertysDssdsfsfsdfSFsfsfEWrwrwERwrewrwrWeRwRwerWRwERwerWRwerweRwrEWrWErwerWeRwRwrewerr==

# email to use as alert sender (default value: grafana-alert@localhost)
email_from = [e-mail]

# smtp server to use (default value: localhost)
smtp_server = localhost

# smtp server host to use (default value: 25)
smtp_port = 25

Mark your grafana boards with the tag “monitored”

In each monitored Dashboard, add a text panel with title ‘alerts’ and a description of your alerts. For example::

50<=x<=100; normal; [e-mail]

35<x<50; warning; [e-mail]

x<=35; critical; [e-mail], [e-mail]

Notes:

• values depend of the graph in that dashboard.

• x is mandatory.

Add a cron task to execute grafana_alerts for example each 3 minutes::

*/3 * * * *     grafana_alerts