categories | title |
---|---|
monitoring | Howto Grafana |
Grafana permet d'effectuer des requêtes sur des bases de données, pour en afficher des graphes personnalisés. Nous l'utilisons en combinaison avec collectd et InfluxDB.
Grafana n'étant pas disponible sous Debian Stretch, nous utilisons les dépôts fournis par GrafanaLabs.
# wget https://packages.grafana.com/gpg.key -O /etc/apt/trusted.gpg.d/grafana.asc
# chown _apt /etc/apt/trusted.gpg.d/grafana.asc
# echo "deb https://packages.grafana.com/oss/deb stable main" > /etc/apt/sources.list.d/grafana.list
# apt update
# apt install grafana
# systemctl daemon-reload
# systemctl enable grafana-server.service
# systemctl start grafana-server.service
# grafana-server -v
Version 6.6.1 (commit: 21bf8b71bc, branch: HEAD)
# systemctl status grafana-server.service
● grafana-server.service - Grafana instance
Loaded: loaded (/usr/lib/systemd/system/grafana-server.service; enabled; vendor preset: enabled)
Docs: http://docs.grafana.org
Main PID: 2400 (grafana-server)
Tasks: 35 (limit: 4915)
CGroup: /system.slice/grafana-server.service
└─2400 /usr/sbin/grafana-server --config=/etc/grafana/grafana.ini --pidfile=/var/run/grafana/grafana-server.pid cfg:default.paths.logs=/var/log/grafana cfg:default.paths.data=/var/lib/grafana cfg:default.paths.plugins=/var/lib/grafana/plugins cfg:default.paths.provisioning=/etc/grafana/provisioning
On modifie le fichier de configuration /etc/grafana/grafana.ini
afin de n'écouter qu'en local, pour ensuite utiliser un reverse proxy vers 127.0.0.1:3000
[server]
http_addr = 127.0.0.1
Si grafana est dans un sous-dossier de la forme example.com/grafana/
plutôt que grafana.example.com
, il faut alors l'indiquer dans la configuration :
[server]
root_url = http://localhost:3000/grafana/
Les identifiants par défaut sont admin/admin
, et doivent être changés à la première connexion à l'interface.
Pour ajouter par exemple une source InfluxDB, avec les données dans une base collectd :
Un dashboard hérite des permissions de son dossier parent. Pour ne pas avoir les permissions par défaut every viewers can view
et every editors can edit
, étant donné que les permissions du dossier par défaut Général ne sont pas modifiables, il faut créer un nouveau dossier n'ayant pas ces permissions et y placer les dashboards. Ainsi, les utilisateurs n'auront par défaut pas accès à tous les dashboards.
Des dashboards créés par la communauté peuvent être importés depuis https://grafana.com/dashboards