Ereignisse nicht-interaktiv im Grafana annotieren

Einleitung

Mit dem Programm "grafannotate" - A command line tool to create annotations in Grafana können Annotationen im Grafana nicht-interaktiv angelegt werden. Sowohl die Annotation von diskreten Zeitpunkten (point-in-time) als auch von Zeitbereichen (time-region) ist damit möglich.

Installation

Per Python virtualenv.

virtualenv ~/.hiveeyes-tools
~/.hiveeyes-tools/bin/pip install grafannotate
echo 'alias grafannotate=~/.hiveeyes-tools/bin/grafannotate' >> ~/.bash_profile

Pre-flight checks

Dies sollte auf jeden Fall erstmal klappen.

grafannotate --help

Konfiguration

Damit alles ordnungsgemäß funktioniert, muss man die Annotationen im Dashboard so einrichten wie bei Interaktiv im Grafana erzeugte Annotationen zwischen verschiedenen Panels und Dashboards teilen beschrieben.

Screenshot

Beispiele

Annotationen auf Zeitpunkte

# Create point-in-time annotation at now(), with title.
grafannotate --uri https://username:password@swarm.hiveeyes.org/grafana/api/annotations --tag test --title "Event Title" --description "Event Description"

# Create point-in-time annotation at specified time.
grafannotate --uri https://username:password@swarm.hiveeyes.org/grafana/api/annotations --tag test --description "Text only" --start 1561140000 --end 1561140000

Annotationen auf Zeitbereiche

# Create time-region annotation from start to now().
grafannotate --uri https://username:password@swarm.hiveeyes.org/grafana/api/annotations --tag test --description "Text only" --start 1561140000

# Create time-region annotation from start to end.
grafannotate --uri https://username:password@swarm.hiveeyes.org/grafana/api/annotations --tag "test" --tag "foo"--description "Text only" --start 1561141000 --end 1561142000

Entwicklung

Bei Erschließung von Annotationen im Grafana per "grafannotate".

Sammlung von Verbesserungswünschen