Files
Support-Agent/docs/storage/analyses/daily_storage_state.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

5.5 KiB
Raw Blame History

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.
  • Site : le même panneau, en anglais (D-023), dans la figure du site src/storage/final.py (historique complet du bloc Storage de la vue client, D-039) ; la page de comparaison l'importe de là.
  • 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).
  • 2026-10-13 : panneau en anglais, partagé avec la figure du site src/storage/final.py ; livraison du domaine (vue client, notifications, guide docs/storage/guide/, D-039).