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

85 lines
6.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.