Tableaux de bord : Zabbix et Grafana

Un tableau de bord rassemble sur un écran les indicateurs utiles à un public : les problèmes en cours pour les techniciens, la disponibilité des services pour la direction, les tendances de capacité pour le responsable. Zabbix a ses propres tableaux de bord ; Grafana, logiciel libre de visualisation, s'y connecte par un plugin et produit des tableaux plus souples et plus soignés. Ce chapitre construit un tableau de bord Zabbix, installe Grafana 13 et son plugin Zabbix avec un compte en lecture seule, puis donne les règles d'un tableau de bord lisible.

Les tableaux de bord de Zabbix

Dashboards, bouton Create dashboard (ou Edit dashboard sur celui qui existe). Un tableau de bord a une ou plusieurs pages (qui peuvent défiler en diaporama) et des widgets, placés sur une grille. Les plus utiles en version 7.0 :

Un tableau de bord peut être privé ou partagé avec des utilisateurs et des groupes (bouton Sharing), en lecture ou en écriture. Un modèle peut aussi contenir ses propres tableaux de bord : chaque hôte lié en hérite, dans Monitoring > Hosts, lien Dashboards.

Pour un usage interne, ces tableaux de bord suffisent souvent. Grafana prend le relais quand on veut mélanger plusieurs sources (Zabbix, une base de données métier, Prometheus), des visualisations plus riches, ou des tableaux de bord pour des publics qui n'ont pas de compte Zabbix.

Comment Grafana lit Zabbix

Grafana ne collecte rien : il interroge l'API de Zabbix (api_jsonrpc.php, servie par l'interface web) au moment où l'on affiche un tableau de bord. Les données restent dans Zabbix, la configuration des tableaux de bord dans Grafana.

Installer Grafana sur Debian 13

Chez Sorbier, Grafana s'installe sur srv-journaux, à côté de Zabbix. Depuis le dépôt officiel de Grafana Labs :

sudo apt-get install -y apt-transport-https wget gnupg
sudo mkdir -p /etc/apt/keyrings
sudo wget -O /etc/apt/keyrings/grafana.asc https://apt.grafana.com/gpg-full.key
sudo chmod 644 /etc/apt/keyrings/grafana.asc
echo "deb [signed-by=/etc/apt/keyrings/grafana.asc] https://apt.grafana.com stable main" | sudo tee /etc/apt/sources.list.d/grafana.list
sudo apt-get update
sudo apt-get install grafana
sudo systemctl daemon-reload
sudo systemctl enable --now grafana-server

Grafana écoute sur le port TCP 3000. Ouvre http://192.168.10.180:3000 depuis le poste d'administration, connecte-toi avec admin / admin : Grafana impose aussitôt un nouveau mot de passe. Le paquet grafana installe l'édition libre (OSS) ; en novembre 2026, c'est la branche 13.

Côté pare-feu : 192.168.10.208/28 (ADMIN) vers 192.168.10.180, TCP 3000. Ajoute aussi apt.grafana.com à l'alias DEPOTS_MAJ du chapitre 4, sinon srv-journaux ne pourra pas télécharger Grafana ni ses mises à jour. Comme pour Zabbix, passe Grafana en HTTPS avant la mise en production (réglages protocol, cert_file et cert_key de la section [server] de /etc/grafana/grafana.ini, ou un proxy inverse Apache devant Grafana).

Installer et activer le plugin Zabbix

sudo grafana cli plugins install alexanderzobnin-zabbix-app
sudo systemctl restart grafana-server

Le plugin (version 6.10 en novembre 2026, pour Grafana 11.6 et plus récent) est une application : il faut l'activer. Dans Grafana, Administration > Plugins and data > Plugins, cherche Zabbix, ouvre-le et clique sur Enable.

Un compte Zabbix en lecture seule pour Grafana

Grafana n'a besoin que de lire. Donne-lui le moins de droits possible.

1. Users > User groups, Create user group : Grafana (lecture). Onglet Host permissions : groupes Serveurs Linux, Serveurs Windows, Réseau, Services web, droit Read.
2. Users > Users, Create user : grafana, membre de ce groupe, rôle User role (le rôle prédéfini sans droit de configuration, qui autorise l'accès à l'API), un mot de passe long que personne n'utilisera.
3. Users > API tokens, Create API token : nom grafana-srv-journaux, utilisateur grafana, une date d'expiration (un an, avec un rappel de renouvellement). Zabbix affiche le jeton une seule fois : copie-le.

La source de données

Dans Grafana, Connections > Add new connection, cherche Zabbix, Add new data source :

Save & test doit afficher la version de l'API de Zabbix. Une erreur de certificat signifie que srv-journaux ne fait pas confiance au certificat de sa propre interface : installe le certificat de l'autorité interne dans le système, ou, si Grafana est sur la même machine, utilise http://localhost/zabbix/api_jsonrpc.php (le flux ne quitte pas le serveur). Le plugin propose aussi une connexion directe à la base (Direct DB Connection), plus rapide sur de longues périodes : elle passe par une source de données MySQL de Grafana avec un compte MariaDB limité à la lecture des tables history, history_uint, trends et trends_uint.

Construire un tableau de bord

Dashboards > New > New dashboard > Add visualization, choisis la source Zabbix. Dans l'éditeur de requête, Query type Metrics, puis quatre filtres : Group, Host, Item tag et Item. Chaque filtre accepte un nom exact ou une expression régulière entre barres obliques :

Les variables rendent un tableau de bord réutilisable : dans Dashboard settings > Variables, crée $groupe (requête Zabbix de type Group) et $hote (type Host, dans $groupe), puis utilise $groupe et $hote dans les requêtes. En haut du tableau de bord, deux listes déroulantes permettent de passer d'un serveur à l'autre sans dupliquer les panneaux.

Un tableau de bord lisible

Un bon tableau de bord répond à une question pour un public. Avant de dessiner, écris la question.

Quelques règles :

• l'information la plus importante en haut à gauche, là où l'œil commence ;
• moins de panneaux : une dizaine au plus par écran. Un tableau de bord où tout clignote ne montre rien ;
• des unités et des seuils cohérents partout (le rouge signifie toujours la même chose) ;
• une période adaptée : les dernières heures pour l'exploitation, des mois pour la capacité ;
• pour la direction, des pourcentages et des tendances, pas des courbes de processeur ;
• pas de couleur comme seule information : ajoute un libellé (« En panne ») pour les daltoniens et les impressions en noir et blanc.

Exercices