Add the Storage and Cellular domains with their starting notes

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-13 09:38:33 +02:00
1 parent dd4841a6d8
commit 504c8634e3
4 files changed
+113

No files matched your search

+62
View File
@@ -0,0 +1,62 @@
# Cellular : point de départ
Note de départ du domaine `cellular` (D-030). Elle se complète au fil du skill `nouveau-domaine` ; les pistes passent dans les fiches quand les analyses s'écrivent.
## Question du domaine
La liaison 4G de la station est-elle assez bonne pour que ses données arrivent, et se dégrade-t-elle ?
## Ce que mesure le collecteur
Source : `docs/aimsight/collecteur_system_info.py`, `get_modem_info`, `parse_*` et `map_csq_*` ; export par `SYNC_SPEC` (rubrique `modem`). Le modem n'est relu qu'un cycle sur dix ; entre deux lectures, la dernière réponse est reprise.
| Métrique | Commande AT | Valeurs | Sens |
|---|---|---|---|
| `rsrp_dBm` | AT+CESQ | dBm, de −140 à −43 ; 255 = inconnu | puissance reçue du signal de référence LTE |
| `rsrq_dB` | AT+CESQ | dB, de −19,5 à −2,5 par pas de 0,5 | qualité reçue : RSRP rapporté à la puissance totale (bruit et interférences compris) |
| `rssi_dbm` | AT+CSQ | dBm, de −113 à −51 par pas de 2 ; 99 = inconnu | puissance totale reçue |
| `ber_percent` | AT+CSQ | %, codes 0 à 7 → 0,1 / 0,3 / 0,6 / 1,2 / 2,4 / 5 / 9 / 13 | taux d'erreur binaire |
| `registration` | AT+CEREG? | home, roaming, searching, denied, not_registered, unknown | enregistrement au réseau |
| `link` | AT+CGACT? et AT+CGPADDR | up, down | `up` si le contexte de données a une adresse IP |
| `network_technology` | AT+COPS? | GSM, UMTS, LTE, E-UTRAN | technologie radio |
| `network_operator` | AT+COPS? | texte | opérateur |
- `SIM_CCID` et l'adresse IP du modem sont aussi exportés : ce sont des identifiants de station, à ne jamais recopier dans `docs/`.
## Ce que montrent les données
- **Instantanés** (`data/metadata.md`, 2026-10-09) :
- WILDSTRUBEL : RSRP −81 dBm, RSRQ −13,5 dB, RSSI −51 dBm, BER 2,4 %, E-UTRAN, `home`, `link` up ;
- VERMONT : RSRP −105 dBm, RSRQ −10 dB.
- **WEISSHORN** (`data/WEISSHORN/`, export du 2026-10-13, du 03/10 07:00 au 13/10 07:00 UTC) :
- moyennes horaires : RSRP de −98,25 à −60,50 dBm ; RSRQ de −18,75 à −5,00 dB ; RSSI de −67,5 à −51,0 dBm (le plafond est atteint) ; BER de 0,53 à 13,00 % ;
- les métriques texte sont la liste des échantillons de l'heure, un toutes les 15 minutes (ex. `['up', 'up', 'up', 'up']`). Sur tout l'export : `link` toujours `up`, `registration` toujours `home`, toujours `E-UTRAN`, un seul opérateur. Chaque heure a 4 échantillons, sauf la première et la dernière de l'export (2), coupées par l'extraction.
## Ce qu'en dit la doc AIMsight
- Manuel de la station (§ 4G Connectivity Setup) : le « Link status » doit passer à « Up » ; antenne dégagée, loin du métal et des autres antennes.
- FAQ : « A 4G connection may take a few minutes to become available after the station starts » ; réception faible en intérieur, en sous-sol, derrière du béton ou du métal ; « Loss of remote connectivity does not necessarily mean that the measurement station itself has stopped operating ».
- Contexte support (§ 5.1) : « Is the modem alive? », avec « modem state » comme preuve candidate.
## Pièges connus
- **Une donnée absente peut être l'anomalie elle-même** : quand le lien tombe, les mesures du modem n'arrivent plus. Distinguer un trou pendant une coupure d'énergie (croiser avec Energy), un trou avec la station alimentée (piste : le lien), et un trou rempli plus tard par une remontée différée.
- **RSSI à −51 dBm veut dire « −51 dBm ou plus »** : la valeur sature.
- Si la lecture du modem échoue, le collecteur rapporte `link = down` avec toutes les valeurs vides : un lien `down` sans mesures n'est pas un signal faible.
- **Moyennes de codes** : `ber_percent` et `rssi_dbm` sont des codes AT moyennés sur l'heure. Une moyenne comme 0,53 % ne correspond à aucun code.
- **Moyennes horaires en dB** : la moyenne de valeurs en dB n'est pas la moyenne des puissances, et elle aplatit les décrochages brefs.
- **Métriques texte** : `common.stations.load_csv` ne lit que des nombres et les ignore.
- **`SIM_CCID` se charge comme un nombre** (notation flottante) : il apparaît parmi les séries numériques. Ne jamais l'afficher ni le tracer.
- **Aucun seuil de qualité** (« bon », « faible ») n'a encore de source : il en faudra une (doc du module radio, opérateur, expert), ou bien comparer la station à son propre passé.
## CSV reçus et manquants
- Reçus (WEISSHORN) : toutes les métriques du modem de `SYNC_SPEC`, et `last_sync` (heures de synchronisation, toutes les 15 minutes ; piste pour un futur domaine « Communication »).
- Non reçu : l'adresse du VPN (`ip_address{interface="nebula"}`), hors de ce domaine.
- L'export couvre 10 jours : assez pour l'état du jour, court pour comparer la station à son propre passé. Un historique plus long le remplacera.
## Pistes d'analyses (non décidées)
- Le niveau du jour (médiane du RSRP), comparé au passé de la station.
- La part des heures avec `link = up`.
- Les heures sans mesure alors que la station est alimentée.
+51
View File
@@ -0,0 +1,51 @@
# Storage : point de départ
Note de départ du domaine `storage` (D-030). Elle se complète au fil du skill `nouveau-domaine` ; les pistes passent dans les fiches quand les analyses s'écrivent.
## Question du domaine
La station a-t-elle encore assez d'espace disque pour continuer à stocker ses mesures, et pour combien de temps ?
## Ce que mesure le collecteur
Source : `docs/aimsight/collecteur_system_info.py`, `get_proc_info` et `SYNC_SPEC` (rubrique `proc`).
| Métrique exportée | Unité | Sens |
|---|---|---|
| `data_storage_free_gb` | GiB (÷ 1024³) | espace libre de la partition `/data` (`psutil.disk_usage('/data')`) |
| `data_storage_used_gb` | GiB | espace utilisé |
| `data_storage_total_gb` | GiB | taille de la partition |
| `data_storage_percent` | % | utilisé / (utilisé + libre), calcul de `psutil` |
- Le collecteur publie les trois premières sous une seule métrique `data_storage_gb`, avec un label `state` (`free`, `used`, `total`). L'export CSV aplatit ce label dans le nom de la métrique.
## Ce que montrent les données
- **Instantanés** (`data/metadata.md`, 2026-10-09) :
- WILDSTRUBEL : total 5,98, libre 5,61, utilisé 0,04 GiB ;
- VERMONT expose d'autres noms, absents de notre copie du collecteur : `total_disk_1k-blk` (3 849 952), `used_disk_1k-blk` (2 829 916) et `avail_disk_1k-blk` (793 940), en blocs de 1 kio, ainsi que `DB_file_size`, `DB_total_entries`, `DB_uploaded`, `DB_not_uploaded`.
- **WEISSHORN** (`data/WEISSHORN/`, export du 2026-10-13, du 03/10 07:00 au 13/10 07:00 UTC, moyennes horaires) : libre de 3,21 à 3,48 GiB, utilisé de 2,17 à 2,45 GiB, total 5,98 GiB.
## Ce qu'en dit la doc AIMsight
- Manuel de la station (`AIMsight Test Manual.pdf`, § Disk) : « Monitor available capacity, especially for frequent schedules, long time series, or image-heavy acquisitions ». Après l'enregistrement d'un schedule, vérifier « available internal storage ».
- Contexte support (`AIMsight_agentic_support_project_context.md`, § 5.1) : « Is storage available? », avec « disk usage » comme preuve candidate ; « storage remaining » figure parmi les « Likely high-value future signals ».
## Pièges connus
- **Utilisé + libre ≠ total** : 5,65 contre 5,98 GiB chez WILDSTRUBEL ; 3,46 contre 3,67 GiB chez VERMONT. Un écart de 5 à 6 % est cohérent avec les blocs réservés d'ext4, mais ce n'est pas vérifié. Le pourcentage de `psutil` se calcule sans eux.
- **Deux familles de métriques** : `data_storage_*` (WEISSHORN, WILDSTRUBEL) et `*_disk_1k-blk` (VERMONT), selon la version du logiciel ou la partition mesurée. Laquelle vaut pour chaque station : question ouverte.
- **Les totaux diffèrent** d'une station à l'autre (3,67 et 5,98 GiB, peut-être pas la même partition) : raisonner en espace libre et en vitesse de remplissage, pas sur un pourcentage fixe.
- Un trou de mesure pendant une coupure d'énergie n'est pas un problème de disque : croiser avec Energy.
## CSV reçus et manquants
- Reçus (WEISSHORN) : `data_storage_free_gb`, `data_storage_used_gb`, `data_storage_total_gb`.
- Manquants : `data_storage_percent` (calculable à partir des deux premiers), et les métriques `DB_*` de VERMONT (base locale, envois en attente).
- L'export couvre 10 jours : assez pour l'état du jour, court pour une vitesse de remplissage. Un historique plus long le remplacera.
## Pistes d'analyses (non décidées)
- L'espace libre du jour.
- La vitesse de remplissage et les jours avant saturation (espace libre ÷ pente sur plusieurs jours).
- Les purges : sauts de l'espace libre vers le haut.