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, 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 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, 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 — panneaux, lignes, sources de
données, requêtes et transformations, selon un outil très utilisé.

  * WAI-ARIA Authoring Practices Guide : modèles — 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 — les recommandations
de cinq graphiques à cinq courbes et le choix d'un public par
ensemble.

  * Prometheus : alertes — alerter sur les symptômes et relier
chaque alerte à la console qui les explique.

  * Comprendre WCAG 2.2 : utilisation de la couleur — les raisons
pour lesquelles la couleur seule ne peut transmettre un état, avec
des exemples.

  * Comprendre WCAG 2.2 : contraste non textuel — le contraste de
3:1 requis pour les lignes de graphiques et les éléments
d'interface.

hCette page sur le Web	URL:https://engineer.company/fr/glossary/dashboard/	engineer.company	70
