The mockups now walk a list of domains (D-039): the support Home loads every station in data/ and notifies each station x domain that is Orange or Red; the client view becomes maquettes/user/summary.py, one System Summary page per station with one block per measured domain. Storage shows a free-space scale and the estimated full date; Cellular shows the day's sends in words and a four-class signal scale. HEADLINE moves into each day_color.py, with a Green sentence for the client view. src/storage/final.py and src/cellular/final.py write the site figures in English; the comparison pages reuse their panels. Each domain gets a short two-layer guide in docs/<domaine>/guide/. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
6.7 KiB
Guide : lire le diagnostic de stockage d'une station AIMsight
- Statut : brouillon, 2026-10-13. La couleur du jour est calculée par
src/storage/day_color.py, selon la matrice dedocs/storage/matrice-etat-horizon.drawio(D-035). Prototype : seuils arbitraires, une seule station, aucun cas de l'expert. - Lecteurs : la partie 1 s'adresse au client final (elle est affichée dans le bloc Storage de la page System Summary) ; la partie 2 à l'ingénieur support AIMsight.
Partie 1 : lecture rapide
1. Ce que surveille le diagnostic
La station enregistre ses mesures sur un disque (la partition /data). Chaque jour, le diagnostic répond à une question : reste-t-il assez de place sur le disque, et pour combien de temps ?
La réponse est une couleur par jour.
2. Les couleurs, et ce qu'il faut faire
| Couleur | Ce que ça veut dire | Que faire |
|---|---|---|
| 🟢 Vert | Le disque a assez de place, et il ne sera pas plein avant 2 mois au rythme actuel. | Rien. |
| 🟠 Orange | La place baisse : moins de 20 % libres, ou disque plein dans moins de 2 mois au rythme actuel. | Surveiller, et prévenir le support : il reste du temps pour intervenir. |
| 🔴 Rouge | Moins de 10 % libres, ou disque plein dans moins de 14 jours. | Contacter le support. |
| ⚪ Gris | Inconnu : pas de mesure du disque ce jour-là, ou pas encore assez de jours mesurés pour connaître le rythme (il en faut au moins 5). | Regarder les jours voisins. |
- Seuils provisoires : 20 % et 10 % libres, 2 mois et 14 jours sont un premier choix, en attente de l'avis de l'expert.
3. Ce qu'affiche le bloc
- Free space : l'espace libre en fin de journée, en % de l'espace utilisable, placé sur une échelle à trois zones (Critical sous 10 %, Low sous 20 %, OK au-dessus).
- Full : la date à laquelle le disque sera plein si le rythme des 7 derniers jours continue. C'est une estimation, pas une prévision : un changement de réglage de la station change le rythme. « Not expected » : le disque ne se remplit pas.
4. Un exemple réel (station WEISSHORN, 2026)
| Période | Couleur | Ce qui se passe |
|---|---|---|
| 09/08 – 22/08 | ⚪ | Début de l'historique, puis moins d'une semaine de mesures du disque : le rythme n'est pas encore connu. |
| 23/08 – 02/09 | 🟢 | Mise en service : disque presque vide, qui ne se remplit pas. |
| 31/08 | 🟢 | 1,3 GiB écrits en deux heures : l'espace libre passe de 99,7 % à 76,7 %. L'estimation ne s'affole pas pour un seul bloc. |
| 03/09 – 13/10 | 🟢 | Remplissage régulier, 28 MiB par jour. Le 13/10 : 57 % libres, disque plein vers le 06/02/2027. |
Aucun jour orange ou rouge n'a encore été observé. Au rythme actuel, la station passerait orange vers le 09/12/2026 (plein dans moins de 2 mois), puis rouge vers le 17/01/2027 (moins de 10 % libres).
Partie 2 : annexe technique (support)
La couleur du jour combine deux analyses de l'espace libre de /data (data_storage_free_gb, data_storage_used_gb, moyennes horaires). Le détail (calcul exact, sources, résultats, options écartées) est dans leurs fiches : docs/storage/analyses/daily_storage_state.md et docs/storage/analyses/days_until_storage_full.md. Une couleur conclut au plus consistent with : elle signale une journée à regarder.
5. Les deux analyses
DAILY_STORAGE_STATE: la dernière mesure du jour.free_percent= libre / (libre + utilisé), la réserve derootexclue, comme lepercentdepsutil. État :OKsi ≥ 20 %,LOWsi ≥ 10 %, sinonCRITICAL(planchers arbitraires, D-034). Une mesure suffit ; sans mesure, l'état est inconnu.DAYS_UNTIL_STORAGE_FULL: le rythme du jour est la baisse de l'espace libre depuis la fin de jour mesurée précédente, ramenée à un jour. Le rythme retenu est la médiane des rythmes des 7 derniers jours, s'il y en a au moins 4 ; sinon l'horizon est inconnu. Jours restants = libre / rythme. Un rythme ≤ 0 : le disque ne se remplit pas (filling = False). La médiane écarte un bloc isolé (le 31/08 sur WEISSHORN) ou une purge.
6. La matrice : du niveau et de l'horizon à la couleur
L'horizon est la classe de DAYS_UNTIL_STORAGE_FULL : moins de 14 jours, moins de 60 jours, 60 jours ou plus (ou disque qui ne se remplit pas), ou inconnu. Seuils de jours arbitraires (D-035).
| État \ Horizon | ≥ 60 j ou ne se remplit pas | < 60 j | < 14 j | inconnu |
|---|---|---|---|---|
OK |
🟢 | 🟠 | 🔴 | ⚪ |
LOW |
🟠 | 🟠 | 🔴 | 🟠 |
CRITICAL |
🔴 | 🔴 | 🔴 | 🔴 |
- Lecture : la pire des deux analyses. Orange ou rouge peut venir d'une seule ; vert demande les deux. Un état inconnu donne un jour gris.
- Pourquoi deux analyses : le niveau voit un bloc ponctuel que l'estimation ne prévoit pas ; l'estimation voit un disque qui fond alors que le niveau est encore confortable.
- WEISSHORN (09/08 au 13/10/2026) : 52 jours 🟢, 14 ⚪ (jusqu'au 22/08), aucun 🟠 ni 🔴.
7. Lire la figure
python3 src/storage/final.py écrit out/<STATION>_storage_daily.html et sa figure en JSON (.json, pour Plotly.newPlot). C'est l'historique complet du bloc Storage. La page de comparaison (python3 src/storage/all_analyses.py, out/<STATION>_storage.html) reprend les mêmes panneaux, avec les séries du disque dessous.
- Panneau
DAILY_STORAGE_STATE:free space (end of day)en %, les planchers de 20 % et 10 % en tirets, l'état en marqueurs (● vertOK, ◆ jauneLOW, ✕ violetCRITICAL). - Panneau
DAYS_UNTIL_STORAGE_FULL:days until full, un point par jour estimé. - Survol : tous les faits calculés du jour (rythme en MiB/jour, date estimée, nombre de rythmes dans la fenêtre).
- Attention aux couleurs : celles des panneaux distinguent les états, ce ne sont pas celles de la matrice.
8. Limites à connaître
- Seuils arbitraires : 20 % et 10 % libres, 60 et 14 jours (D-034, D-035). Questions en suspens :
docs/storage/domaine/questions-pour-l-expert.md. - Une seule station, jamais sous 56 % libres :
LOW,CRITICAL, orange et rouge n'ont jamais été observés ; aucun cas de l'expert. - Un bloc ponctuel n'est pas prévu : sur un disque à moins de 1,3 GiB libres, le bloc du 31/08 l'aurait rempli sans que l'estimation ne bouge. Seul le niveau le voit, le jour même.
- Disque plein : conséquence inconnue. Une purge automatique ferait que « plein » n'arrive jamais ; si l'acquisition tourne en
root, elle peut écrire dans la réserve (5,4 % du total sur WEISSHORN). - Projection linéaire : un changement de schedule met 4 jours à dominer la médiane.
- Versions plus anciennes du collecteur (VERMONT, NORDEND) : pas de mesure de
/data, donc pas de bloc Storage.