# 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/_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/_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.