79 lines
5.1 KiB
Markdown
79 lines
5.1 KiB
Markdown
# `DAILY_STORAGE_STATE` : espace libre du disque en fin de jour
|
||||
|
|
|
|||
|
|
- **Statut** : prototype en place (2026-10-13). État seul, sans verdict ; seuils arbitraires (D-034) ; pas encore de cas annotés par l'expert.
|
|||
|
|
- **Script** : premier panneau de `python3 src/storage/all_analyses.py [CSV ou dossiers]` (défaut : `data/WEISSHORN/`), qui écrit `out/<STATION>_storage.html` et l'ouvre.
|
|||
|
|
- **Code** : `src/storage/storage_state.py` (`run()`, `day_facts()`), bibliothèque standard uniquement, sans import du projet.
|
|||
|
|
|
|||
|
|
## Question posée
|
|||
|
|
|
|||
|
|
Chaque jour, combien d'espace reste-t-il sur la partition `/data`, et est-ce encore confortable, bas ou critique ?
|
|||
|
|
|
|||
|
|
- **Lien avec la question du domaine** : c'est la moitié « bientôt plein » de la notification. Le niveau seul ne dit pas quand le disque sera plein : c'est `DAYS_UNTIL_STORAGE_FULL`.
|
|||
|
|
- **En pourcentage** : la taille de la partition change d'une station à l'autre (3,67 et 5,98 GiB, `docs/storage/domaine/point-de-depart.md`). Un seuil en GiB ne se transposerait pas.
|
|||
|
|
|
|||
|
|
## Principe
|
|||
|
|
|
|||
|
|
On prend la dernière mesure du jour et on classe la part d'espace libre sur deux planchers.
|
|||
|
|
|
|||
|
|
Calcul exact, pour chaque jour UTC d :
|
|||
|
|
1. Dernière heure de d où `data_storage_free_gb` et `data_storage_used_gb` sont mesurés et finis → `measured_at`. S'il n'y en a pas, `state` = `None` (UNKNOWN).
|
|||
|
|
2. `usable_gb` = libre + utilisé : l'espace utilisable sans la réserve de `root`, comme le `percent` de `psutil`.
|
|||
|
|
3. `free_percent` = 100 × libre / `usable_gb`, soit 100 − `data_storage_percent` du collecteur.
|
|||
|
|
4. `state` = `OK` si `free_percent` ≥ 20, `LOW` s'il est ≥ 10, sinon `CRITICAL`.
|
|||
|
|
|
|||
|
|
Une seule mesure suffit : l'espace libre est un niveau, pas une statistique du jour (pas de couverture minimale).
|
|||
|
|
|
|||
|
|
Sortie (contrat commun) : un point par jour.
|
|||
|
|
- `t` = dernière heure du jour présente dans la série.
|
|||
|
|
- `value` = `free_percent`, en % (`None` si UNKNOWN).
|
|||
|
|
- `anomaly` = `None` : état seul, sans verdict. L'état est dans `facts.state`.
|
|||
|
|
- `facts` = `state`, `free_gb`, `free_percent`, `usable_gb`, `measured_at`.
|
|||
|
|
|
|||
|
|
## Constantes et sources
|
|||
|
|
|
|||
|
|
| Constante | Valeur | Source |
|
|||
|
|
|---|---|---|
|
|||
|
|
| `FREE_PERCENT_FLOORS` | 20 % (plancher de `OK`), 10 % (plancher de `LOW`) | **Choix arbitraire de l'utilisateur**, pour commencer (2026-10-13, D-034) ; ni la doc AIMsight ni le collecteur n'en donnent. À revoir avec l'expert (`docs/storage/domaine/questions-pour-l-expert.md`). |
|
|||
|
|
|
|||
|
|
## Graphique
|
|||
|
|
|
|||
|
|
- **En haut** : `free_percent` jour par jour (ligne), les deux planchers en pointillés, l'état en marqueurs (couleur et symbole). Le survol donne tous les faits.
|
|||
|
|
- **Dessous** : `data_storage_free_gb`, `data_storage_used_gb`, `data_storage_total_gb`, en GiB.
|
|||
|
|
|
|||
|
|
## Résultats (jeu de travail : WEISSHORN, export de 65 jours)
|
|||
|
|
|
|||
|
|
- 09/08 au 18/08 : UNKNOWN (début d'historique, aucune mesure).
|
|||
|
|
- 19/08 au 30/08 : `OK`, 99,94 à 99,69 % libre : disque presque vide, mise en service.
|
|||
|
|
- 31/08 : `OK`, 76,66 % libre. Un bloc de 1,3 GiB écrit entre 13:00 et 15:00 UTC fait perdre 23 points en deux heures.
|
|||
|
|
- 01/09 au 13/10 : `OK`, de 76,53 % à 56,67 % libre (3,20 GiB sur 5,65 GiB utilisables le 13/10).
|
|||
|
|
- Les jours coupés par l'export ou par un trou (19/08, 20/08, 13/10) ont un état : une mesure suffit.
|
|||
|
|
- Au rythme mesuré par `DAYS_UNTIL_STORAGE_FULL` (28,18 MiB/jour), WEISSHORN passerait `LOW` vers le 27/12/2026 et `CRITICAL` vers le 17/01/2027 (projection, pas une observation).
|
|||
|
|
- `LOW` et `CRITICAL` ne sont donc jamais observés. Aucun cas annoté par l'expert.
|
|||
|
|
|
|||
|
|
## Options écartées
|
|||
|
|
|
|||
|
|
| Option | Pourquoi écartée |
|
|||
|
|
|---|---|
|
|||
|
|
| Seuil en GiB | Les partitions n'ont pas la même taille d'une station à l'autre. |
|
|||
|
|
| Pourcentage du total, réserve de `root` comprise | Cette réserve n'est pas accessible à un utilisateur ordinaire ; `psutil` la retire aussi. |
|
|||
|
|
| Couverture minimale du jour (comme `DAILY_SIGNAL_STATE`) | Le niveau d'un disque ne se moyenne pas : la dernière mesure est l'état le plus récent. |
|
|||
|
|
| Minimum du jour | Égal à la dernière mesure sur un disque qui se remplit ; après une purge dans la journée, c'est la dernière mesure qui est juste. |
|
|||
|
|
| `*_disk_1k-blk` (NORDEND, version plus ancienne du collecteur) | Partition plate pendant 104 jours, pas celle des mesures : choix de l'utilisateur (D-034). |
|
|||
|
|
|
|||
|
|
## Limites connues
|
|||
|
|
|
|||
|
|
1. **Seuils arbitraires** (D-034).
|
|||
|
|
2. **Réserve de `root`** (5,4 % du total sur WEISSHORN) : si le logiciel d'acquisition tourne en `root`, il peut encore écrire à 0 % libre.
|
|||
|
|
3. **Un niveau ne dit pas l'urgence** : 15 % libres sur un disque qui ne se remplit pas ne pressent pas ; 30 % qui fondent en une semaine, si. C'est le rôle de `DAYS_UNTIL_STORAGE_FULL`.
|
|||
|
|
4. **Une seule station, jamais sous 56 % libre** ; aucun cas annoté.
|
|||
|
|
5. **Une mesure par jour compte, la dernière** : un bloc écrit puis effacé dans la journée n'apparaît pas.
|
|||
|
|
|
|||
|
|
## Pistes
|
|||
|
|
|
|||
|
|
- Des seuils de l'expert, peut-être différents par taille de partition.
|
|||
|
|
|
|||
|
|
## Historique
|
|||
|
|
|
|||
|
|
- **2026-10-13** : création (D-034).
|
|||
|
|
- **2026-10-13** : résultats sur l'export de 65 jours de WEISSHORN (09/08-13/10), qui remplace celui de 10 jours.
|
|||
|
|
- **2026-10-13** : combinée à l'autre analyse Storage dans la couleur du jour, matrice état × horizon (`docs/storage/matrice-etat-horizon.drawio`, colonnes ; D-035).
|