diff --git a/HowtoGrafana.md b/HowtoGrafana.md new file mode 100644 index 00000000..a05f2fe6 --- /dev/null +++ b/HowtoGrafana.md @@ -0,0 +1,70 @@ +--- +categories: monitoring +title: Howto Grafana +... + +* Documentation : + +[Grafana](https://grafana.com/) 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](HowtoCollectd) et [InfluxDB](HowtoInfluxDB). + + +## Installation + +Grafana n'étant pas disponible sous Debian Stretch, nous utilisons les dépôts fournis par GrafanaLabs. + +~~~ +# curl -s https://packagecloud.io/gpg.key | apt-key add - +# echo "deb https://packagecloud.io/grafana/stable/debian/ stretch main" > /etc/apt/sources.list.d/grafana.list +# apt update +# apt install grafana +# systemctl enable grafana-server.service +# systemctl start grafana-server.service + +# grafana-server -v +Version 5.1.4 (commit: a5fe24fcc) + +● 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 +~~~ + +## Configuration + +On modifie la configuration 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 +~~~ + +## Utilisation + +### Ajouter une source + +Pour ajouter par exemple une source [InfluxDB](HowtoInfluxDB), avec les données dans une base [collectd](HowtoCollectd) : + +* Configuration > Data Sources > Add data source +* Name : Collectd +* Type : InfluxDB +* URL : http://localhost:8086 +* Access : Server +* Database : collectd + +### Créer un dashboard + +* Create > Dashboard +* Configurer le dashboard en cliquant sur la roue dentée en haut à droite + +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 + +### Créer un graphe + +* Se rendre dans le dashboard précédemment créé > En haut à droite, choisir Add panel > Choisir le type de graphe +* Cliquer sur Panel Title > Edit +* Parcourir les onglets pour choisir la source et configurer le graphe \ No newline at end of file