Files
Support-Agent/docs/storage/guide/diagnostic-stockage.md
T
maximeandClaude Opus 5.5 f0990c16e6 Deliver Storage and Cellular in the mockups, with site figures and guides
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>
2026-10-13 16:05:26 +02:00

6.7 KiB
Raw Blame History

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 de docs/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 de root exclue, comme le percent de psutil. État : OK si ≥ 20 %, LOW si ≥ 10 %, sinon CRITICAL (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 (● vert OK, ◆ jaune LOW, ✕ violet CRITICAL).
  • 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

  1. 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.
  2. Une seule station, jamais sous 56 % libres : LOW, CRITICAL, orange et rouge n'ont jamais été observés ; aucun cas de l'expert.
  3. 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.
  4. 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).
  5. Projection linéaire : un changement de schedule met 4 jours à dominer la médiane.
  6. Versions plus anciennes du collecteur (VERMONT, NORDEND) : pas de mesure de /data, donc pas de bloc Storage.