70 lines
2.7 KiB
Markdown
70 lines
2.7 KiB
Markdown
---
|
|
categories: monitoring
|
|
title: Howto Grafana
|
|
...
|
|
|
|
* Documentation : <http://docs.grafana.org/>
|
|
|
|
[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://packages.grafana.com/gpg.key | apt-key add -
|
|
# echo "deb https://packages.grafana.com/oss/deb stable 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 <https://grafana.com/dashboards>
|
|
|
|
### 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 |