mirroir readonly du Gitit wiki.evolix.org (attention, ne rien commiter/merger sur ce dépôt) https://wiki.evolix.org
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

83 lines
3.3 KiB

3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
  1. ---
  2. categories: monitoring
  3. title: Howto Grafana
  4. ...
  5. * Documentation : <http://docs.grafana.org/>
  6. [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).
  7. ## Installation
  8. Grafana n'étant pas disponible sous Debian Stretch, nous utilisons les dépôts fournis par GrafanaLabs.
  9. ~~~
  10. # wget https://packages.grafana.com/gpg.key -O /etc/apt/trusted.gpg.d/grafana.asc
  11. # chown _apt /etc/apt/trusted.gpg.d/grafana.asc
  12. # echo "deb https://packages.grafana.com/oss/deb stable main" > /etc/apt/sources.list.d/grafana.list
  13. # apt update
  14. # apt install grafana
  15. # systemctl daemon-reload
  16. # systemctl enable grafana-server.service
  17. # systemctl start grafana-server.service
  18. # grafana-server -v
  19. Version 6.6.1 (commit: 21bf8b71bc, branch: HEAD)
  20. # systemctl status grafana-server.service
  21. ● grafana-server.service - Grafana instance
  22. Loaded: loaded (/usr/lib/systemd/system/grafana-server.service; enabled; vendor preset: enabled)
  23. Docs: http://docs.grafana.org
  24. Main PID: 2400 (grafana-server)
  25. Tasks: 35 (limit: 4915)
  26. CGroup: /system.slice/grafana-server.service
  27. └─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
  28. ~~~
  29. ## Configuration
  30. 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
  31. ~~~
  32. [server]
  33. http_addr = 127.0.0.1
  34. ~~~
  35. ### Reverse proxy avec sous dossier
  36. 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 :
  37. ~~~
  38. [server]
  39. root_url = http://localhost:3000/grafana/
  40. ~~~
  41. ## Utilisation
  42. Les identifiants par défaut sont `admin/admin`, et doivent être changés à la première connexion à l'interface.
  43. ### Ajouter une source
  44. Pour ajouter par exemple une source [InfluxDB](HowtoInfluxDB), avec les données dans une base [collectd](HowtoCollectd) :
  45. * Configuration > Data Sources > Add data source
  46. * Name : Collectd
  47. * Type : InfluxDB
  48. * URL : http://localhost:8086
  49. * Access : Server
  50. * Database : collectd
  51. ### Créer un dashboard
  52. * Create > Dashboard
  53. * Configurer le dashboard en cliquant sur la roue dentée en haut à droite
  54. 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.
  55. Des dashboards créés par la communauté peuvent être importés depuis <https://grafana.com/dashboards>
  56. ### Créer un graphe
  57. * Se rendre dans le dashboard précédemment créé > En haut à droite, choisir Add panel > Choisir le type de graphe
  58. * Cliquer sur Panel Title > Edit
  59. * Parcourir les onglets pour choisir la source et configurer le graphe