# Tableau de bord

## Ce que c'est

Un tableau de bord est une page composée de panneaux, chacun transformant une requête en image, disposés pour que quelqu'un puisse lire l'état de ce qui est suivi sans interroger personne. La même idée porte d'autres noms : la documentation de Prometheus les appelle consoles, et une équipe peut dire « le tableau » ou « l'écran au mur ». Grafana décrit ses tableaux de bord comme un ou plusieurs panneaux disposés en lignes ou en onglets qui « donnent une vue d'ensemble immédiate d'informations liées », et chaque panneau comme le conteneur d'une visualisation construite par une requête sur une source. Cette source peut être un système de stockage de séries temporelles, une base SQL, une API ou un simple fichier CSV.

Les panneaux prennent quelques formes. Une courbe d'évolution dans le temps montre une tendance : mémoire utilisée sur la dernière journée, requêtes par minute sur la dernière semaine. Un seul grand nombre répond à « combien maintenant ». Une jauge montre une valeur dans une plage connue, comme l'espace disque utilisé par rapport à la capacité totale disponible. Un tableau énumère les éléments à surveiller, une ligne par élément. Un voyant indique un état de marche ou d'arrêt. La plupart des bons tableaux de bord utilisent deux ou trois de ces formes, choisies selon la question, avec très peu de panneaux de chaque.

Sur une page web, ces panneaux sont des éléments d'interface ordinaires. Le guide ARIA Authoring Practices du W3C décrit leur comportement pour les personnes utilisant un clavier ou un lecteur d'écran. Les onglets changent de vue et montrent un panneau de contenu à la fois. Une table est une grille statique de lignes et de cellules ; une grille est sa version interactive, parcourue avec les touches fléchées. Un indicateur de mesure suit le modèle meter pour une valeur dans une plage définie ; une alerte est un message bref et important attirant l'attention sans interrompre l'activité du lecteur. Une jauge suivant le modèle meter porte sa plage et sa valeur sous forme de texte :

```html
<div
    role="meter"
    aria-label="Disk used"
    aria-valuemin="0"
    aria-valuemax="100"
    aria-valuenow="72"
    aria-valuetext="72% (31 GB free)"
></div>
```

Un tableau de bord attend d'être regardé, ce qui le distingue de ses voisins. Une alerte vient à la personne quand un seuil est franchi. Un rapport est un instantané produit à la demande, puis figé. Le tableau de bord se met à jour ; il vaut exactement l'attention que quelqu'un lui accorde.

## Pourquoi c'est important

Un tableau de bord donne à l'équipe une lecture partagée de l'état des choses. Sans lui, la même question reçoit la réponse de celui qui a un terminal ouvert, à sa manière, et deux personnes pendant un incident peuvent passer plusieurs minutes à découvrir qu'elles regardaient des nombres différents. Avec lui, la conversation part de la même image, et ceux qui n'écriraient jamais une requête voient comment se porte le système.

Il raccourcit aussi le chemin de « quelque chose ne va pas » à « cette partie ne va pas ». Les recommandations de Prometheus sur les consoles proposent un tableau de bord par service, montrant chacun la latence et les erreurs des services avec lesquels il communique. On peut ainsi partir du sommet de l'arbre et suivre les mauvais chiffres jusqu'au service qui les cause. Un tableau de bord organisé selon la structure du système réduit ce parcours à quelques clics.

Il a aussi un coût. Chaque panneau exécute sa requête à chaque actualisation, sur chaque écran où il est ouvert. Chaque panneau porte aussi une affirmation dont quelqu'un doit préserver l'exactitude lorsque le service sous-jacent change de nom, est divisé ou est retiré du service. Un tableau de bord de quarante panneaux porte quarante affirmations, dont la plupart ne sont pas lues.

## À quoi cela ressemble en pratique

Dans le cadre de ses fonctions précédentes, la fondatrice a créé le
[premier tableau de bord d'observabilité d'une organisation](/fr/portfolio/built-the-companys-first-observability-dashboard/), qui
a commencé par recueillir des mesures du CPU, de la RAM, du disque et de la température sur des serveurs Linux distants via SSH, conteneurs Docker compris. Une deuxième version est passée à Grafana et Prometheus. Ses panneaux ont été choisis avec les équipes DevOps et d'ingénierie : utilisation du CPU, de la mémoire, temps de fonctionnement des services et latence des API. Il tournait sur le grand téléviseur du bureau, où chacun pouvait voir l'état de la production en passant, avec des alertes sur les dépassements de seuil en complément. Les équipes détectaient et résolvaient les incidents 40 % plus vite.

Un
[tableau de bord de supervision ultérieur sous Grafana et Prometheus](/fr/portfolio/cut-operational-risk-with-grafana-and-prometheus/)
nomme ce qui comptait le plus : des métriques porteuses de sens, plutôt que des chiffres flatteurs qui donnent une impression d'activité sans rien dire. Les seuils d'alerte ont ensuite été fixés sur ces métriques et rendus visibles là où l'équipe les verrait encore à temps pour agir. L'équipe est passée de la réaction aux urgences à la détection des problèmes tant qu'ils sont encore mineurs.

Sur un hôte de 464 MB de mémoire, la même question reçoit une autre réponse.
[Sept rôles en lecture seule produisent à la demande des rapports Markdown sur l'hôte en fonctionnement](/fr/portfolio/built-7-read-only-host-reporting-roles/),
couvrant les accès, le trafic, les métriques, la sécurité et plus encore. Une pile de métriques n'y tiendrait pas et ne justifierait pas son coût même si elle y tenait. Leur règle directrice convient tout autant à un tableau de bord : n'affichez que les nombres mesurés par l'exécution, car un rapport qui comble une lacune par un chiffre plausible est pire qu'un rapport qui la laisse vide.

## Où les problèmes surviennent

Un tableau de bord peut sembler sain et pourtant tromper, le plus souvent à cause de ce qu'on y a mis.

**Tous les nombres disponibles arrivent à l'écran.** Il est tentant de tout montrer. Les recommandations de Prometheus avertissent qu'on obtient ainsi des consoles si denses que même un spécialiste peine à les lire. Elles suggèrent au plus cinq graphiques par console et au plus cinq courbes par graphique. Partez des défaillances probables et montrez ce qui les distingue.

**Les chiffres flatteurs prennent la place.** Le total des requêtes servies depuis le lancement ne fait que monter, et le nombre d'utilisateurs inscrits dit peu sur aujourd'hui. Ils donnent une impression d'activité sans changer aucune décision. Réservez le panneau à un nombre dont l'évolution ferait agir quelqu'un.

**Un seul tableau de bord veut servir tout le monde.** Ce dont un ingénieur d'astreinte a besoin la nuit, savoir ce qui est en panne, diffère de ce qu'un développeur cherche en construisant une fonctionnalité, par exemple combien de personnes rencontrent un cas limite donné. Prometheus dit clairement qu'un ensemble de consoles sert rarement les deux, et que deux ensembles fonctionnent mieux.

**La couleur porte tout le message.** Une rangée de points rouges et verts ne dit rien à qui ne distingue pas ces couleurs, ni sur un écran monochrome. Le critère de succès 1.4.1 de WCAG 2.2, de niveau A, interdit de faire de la couleur l'unique moyen visuel de transmettre une information ; ajoutez un mot, une forme ou une position. Selon 1.4.11, de niveau AA, les parties d'un graphique nécessaires à sa compréhension doivent avoir un rapport de contraste d'au moins 3:1 avec les couleurs voisines, un seuil que des tracés fins aux couleurs pastel sur fond blanc n'atteignent souvent pas.

**Une jauge invente un plafond absent.** Le modèle meter de l'APG concerne une valeur dans une plage définie. Sa propre note déconseille son emploi sans maximum significatif, ou pour une progression. Les requêtes par seconde n'ont pas de plafond naturel ; un cadran en invente un et transforme une heure normalement chargée en urgence apparente. Utilisez plutôt une courbe d'évolution dans le temps.

**L'écran attend quelqu'un qui est rentré chez lui.** Personne ne regarde un téléviseur de bureau à trois heures du matin. Les problèmes qui nécessitent une personne relèvent des alertes ; les recommandations de Prometheus préconisent d'alerter sur les symptômes ressentis par les utilisateurs et de relier chaque alerte à la console qui aide à trouver le composant en faute. L'alerte appelle quelqu'un, et le tableau de bord est son point d'arrivée.

## Pour aller plus loin

- [Grafana : tableaux de bord](https://grafana.com/docs/grafana/latest/visualizations/dashboards/) — panneaux, lignes, sources de données, requêtes et transformations, selon un outil très utilisé.
- [WAI-ARIA Authoring Practices Guide : modèles](https://www.w3.org/WAI/ARIA/apg/patterns/) — le comportement attendu des onglets, tables, grilles, indicateurs de mesure et alertes pour les personnes utilisant un clavier ou un lecteur d'écran.
- [Prometheus : consoles et tableaux de bord](https://prometheus.io/docs/practices/consoles/) — les recommandations de cinq graphiques à cinq courbes et le choix d'un public par ensemble.
- [Prometheus : alertes](https://prometheus.io/docs/practices/alerting/) — alerter sur les symptômes et relier chaque alerte à la console qui les explique.
- [Comprendre WCAG 2.2 : utilisation de la couleur](https://www.w3.org/WAI/WCAG22/Understanding/use-of-color.html) — les raisons pour lesquelles la couleur seule ne peut transmettre un état, avec des exemples.
- [Comprendre WCAG 2.2 : contraste non textuel](https://www.w3.org/WAI/WCAG22/Understanding/non-text-contrast.html) — le contraste de 3:1 requis pour les lignes de graphiques et les éléments d'interface.

<https://engineer.company/fr/glossary/dashboard/>
