Affichage et légendes

Méta : grafana panels formatage zettelkasten

📝 Grafana Panels : Manipulation de l’Affichage et Légendes

Avoir choisi le bon graphique parmi les Grafana Panels : Les Types de Visualisations ne suffit pas. Si l’axe des ordonnées de votre courbe affiche 15000000000 au lieu de 15 GB, le tableau de bord est techniquement juste, mais humainement illisible. Grafana offre trois niveaux pour manipuler la sortie visuelle et la rendre compréhensible instantanément.

1. Standard Options (Les Options de Base)

Ces réglages se trouvent dans le menu de droite et s’appliquent à toutes les données renvoyées par la requête du Panel.

• Unit (L’Unité) : C’est le réglage le plus critique. Grafana gère les conversions intelligemment.

  • Exemples : Choisir Data (Metric) > Bytes convertira automatiquement les octets en Mo ou Go selon la valeur. Choisir Time > seconds convertira 120 en 2 minutes.

• Min / Max : Fixe l’échelle de l’axe Y. Très utile pour les pourcentages (fixer le Max à 100 permet d’éviter que le graphique ne s’adapte à 105% et ne se déforme lors d’un pic ponctuel irréaliste).

• Decimals : Force le nombre de chiffres après la virgule pour éviter l’encombrement visuel.

2. Le Nettoyage des Légendes

Par défaut, une requête PromQL renvoie des légendes illisibles de type : node_cpu_seconds_total{instance="serveur-1", job="node"}. Il y a trois façons de les manipuler :

A. Via le champ “Legend” de la requête (Le plus simple)

Dans l’éditeur de requête Prometheus en bas du panel, utilisez le champ “Legend format”.

• Syntaxe : {{nom_du_label}}

• Exemple : Si vous tapez Serveur {{instance}}, la légende affichera proprement Serveur serveur-1.

B. Via l’onglet “Transform” (Regex)

Si la source de données ne supporte pas le formattage de légende direct (ou pour nettoyer un label complexe), allez dans l’onglet Transform et utilisez Rename by regex.

(Pour revoir la mécanique des groupes de capture () et la syntaxe RE2 à utiliser ici, référez-vous au chapitre 4 de la note Déclaration des Variables Grafana).

C. Le mode Table des Légendes

Dans le menu de droite, la section Legend permet de passer l’affichage de “List” à “Table”. Cela permet d’ajouter des colonnes de statistiques directement dans la légende en bas du graphique (ex: Afficher la valeur actuelle Last, la valeur maximale Max et la moyenne Avg à côté du nom de chaque courbe).

3. Thresholds (Les Seuils de Couleur)

Les seuils permettent de colorer automatiquement une valeur (sur une courbe, une jauge ou un Stat panel) selon son niveau de gravité.

• Absolute : Se base sur la valeur brute (ex: Rouge si > 500 erreurs).

• Percentage : Se base sur le Min/Max défini plus haut (ex: Rouge si > 80% du Max).

• Exemple standard : Base = Vert, 75 = Orange, 90 = Rouge.

4. Les Overrides (Les Exceptions)

C’est l’outil de formatage le plus puissant de Grafana. Un “Override” permet de dire au système : “Applique toutes les options standards à tout le monde, SAUF à cette série de données spécifique”.

• Cas d’usage 1 (Mise en évidence) : J’affiche 10 courbes de serveurs. Je veux que serveur-prod soit en rouge et en trait très épais (Line width: 3), et que tous les autres soient en gris et fins.

• Cas d’usage 2 (Axes Y multiples) : J’affiche les Requêtes/sec (en nombres) et le Temps de réponse (en millisecondes) sur le même graphe. L’échelle sera faussée. Je crée un Override ciblant uniquement la série “Temps de réponse” pour forcer son affichage sur un deuxième axe Y, placé à droite du graphique.