108 lines
11 KiB
Markdown
108 lines
11 KiB
Markdown
# `DAILY_LINK_STATE` : état du lien 4G jour par jour
|
||
|
||
- **Statut** : prototype en place (2026-10-13). État seul, sans verdict ; pas encore de cas annotés par l'expert.
|
||
- **Script** : premier panneau de `python3 src/cellular/all_analyses.py [CSV ou dossiers]` (défaut : `data/WEISSHORN/` et `data/NORDEND/`, D-032), qui écrit `out/<STATION>_cellular.html` et l'ouvre.
|
||
- **Code** : `src/cellular/link_state.py` (`run()`, `day_facts()`, `by_day()`), bibliothèque standard uniquement, sans import du projet. Les séries viennent de `common.stations.load_stations`, qui charge `link` et `last_sync` comme la liste des échantillons de l'heure (D-031).
|
||
|
||
## Question posée
|
||
|
||
Chaque jour, les envois de la station sont-ils tous arrivés, complets, avec le lien 4G actif ?
|
||
|
||
- **Lien avec la question du domaine** (`docs/cellular/domaine/point-de-depart.md`) : des données qui arrivent est le premier service de la 4G. Ici, comme pour Energy, un envoi absent peut être l'anomalie elle-même.
|
||
- **Ce que l'analyse ajoute** : elle ne dépend d'aucun seuil radio ni d'aucun historique ; elle vaut dès le premier jour d'installation, comme `DAILY_BATTERY_STATE` (D-018).
|
||
|
||
## Principe
|
||
|
||
Le collecteur écrit `link = up` quand le contexte de données du modem a une adresse IP (`get_modem_info`, `docs/aimsight/collecteur_system_info.py`), et `sync` envoie un instantané toutes les 15 minutes, un message par métrique (`cmd_sync`). Deux de ces messages partent à chaque envoi, quel que soit l'état du modem : `link` (`down` si la lecture échoue) et `last_sync` (toujours le dernier). On compte, jour par jour, les envois reçus, les messages perdus dans un envoi reçu, et la valeur de `link`.
|
||
|
||
Les exports d'une version plus ancienne du collecteur (NORDEND) n'ont pas `link` : les envois se comptent alors sur `last_sync` seul, et ce qui dépend de `link` vaut `None`.
|
||
|
||
Calcul exact, pour chaque jour UTC d ayant au moins une ligne `link` (sinon `last_sync`) :
|
||
1. Pour chaque heure, les listes des échantillons de `link` et de `last_sync` (vides ou `None` si rien n'est arrivé).
|
||
2. `n_up`, `n_down` = nombre d'échantillons `up` et `down` du jour (`None` sans `link`). `n_sends` = envois reçus, doublons compris (le plus grand des deux comptes, heure par heure).
|
||
3. `n_missing` = envois entiers perdus : somme, heure par heure, de `SAMPLES_PER_HOUR` − le plus grand des deux comptes (un envoi est arrivé si l'un de ses deux messages est arrivé ; jamais négatif : un doublon ne bouche pas le trou d'une autre heure).
|
||
4. `n_messages_lost` = messages perdus dans un envoi arrivé : somme, heure par heure, de |compte `link` − compte `last_sync`|. `None` si l'une des deux séries manque.
|
||
5. `received_percent` = (envois attendus − `n_missing`) / envois attendus, et `up_percent` = `n_up` / envois attendus, en %, avec envois attendus = `SAMPLES_PER_HOUR` × 24. `None` sur un jour coupé (moins de 24 heures).
|
||
6. L'état se lit dans cet ordre (la première condition vraie l'emporte) :
|
||
|
||
| Ordre | Condition | `state` | Lecture |
|
||
|---|---|---|---|
|
||
| 1 | moins de 24 heures dans l'export | `None` (UNKNOWN) | jour coupé par l'export : le nombre d'envois attendus n'est pas connu |
|
||
| 1 bis | aucun envoi reçu avant ce jour (jour du premier envoi compris) | `None` (UNKNOWN) | début d'historique, pas une coupure (`docs/domaine/pieges-des-donnees.md`) ; calcul causal : seuls les jours ≤ d comptent |
|
||
| 2 | `n_down` ≥ 1 (jamais sans `link`) | `DOWN` | le modem a signalé le lien coupé au moins une fois, et cet envoi est quand même arrivé (remontée différée ou autre voie) |
|
||
| 3 | `n_missing` ≥ 1 ou `n_messages_lost` ≥ 1 | `MISSING` | des envois ou des messages manquent ; la cause n'est pas établie (lien, coupure d'énergie, réception côté serveur) |
|
||
| 4 | sinon | `UP` | tous les envois sont arrivés, lien actif |
|
||
|
||
Sortie (contrat commun) : un point par jour.
|
||
- `t` = dernière heure du jour présente dans la série.
|
||
- `value` = `received_percent`, en % des envois attendus (`None` si l'état est UNKNOWN). Il se calcule avec ou sans `link`.
|
||
- `anomaly` = `None` : état seul, sans verdict. L'état est dans `facts.state`.
|
||
- `facts` = `state`, `received_percent`, `up_percent`, `n_sends`, `n_up`, `n_down`, `n_missing`, `n_messages_lost`, `hours`.
|
||
|
||
## Constantes et sources
|
||
|
||
| Constante | Valeur | Source |
|
||
|---|---|---|
|
||
| `SAMPLES_PER_HOUR` | 4 | **Cadence observée, non documentée** : un envoi toutes les 15 minutes, d'après `last_sync` (WEISSHORN : 960 intervalles de 900 ± 1 s ; NORDEND : 9 498 intervalles sur ~9 800). Ni le collecteur (`cmd_sync` est lancé de l'extérieur) ni la doc AIMsight ne la fixent ; la FAQ cite « one measurement every 15 minutes », mais c'est le rythme des acquisitions de la caméra, réglé par le client. À confirmer (`docs/cellular/domaine/questions-pour-l-expert.md`). |
|
||
| `HOURS_PER_DAY` | 24 | Jour UTC complet. |
|
||
|
||
## Graphique
|
||
|
||
- **En haut** : `received_percent` par jour, placé à midi UTC (D-019), un marqueur par état (couleur, symbole et légende propres ; couleurs validées par le skill dataviz).
|
||
- **Dessous** : les séries du modem, et le nombre d'envois reçus par heure (`last_sync`, sinon `link`), en barres.
|
||
|
||
## Résultats (jeu de travail : WEISSHORN et NORDEND, D-032)
|
||
|
||
WEISSHORN (10 jours, avec `link`) :
|
||
|
||
- 04/10 au 12/10 : `UP` les 9 jours, 96 envois sur 96, aucun message perdu (960 envois sur 960 dans `last_sync`, espacés de 900 ± 1 s).
|
||
- Contrôle du compte sur des copies modifiées en mémoire (rien d'écrit) : un message `link` ou `last_sync` retiré donne `n_messages_lost` = 1 ; les deux retirés, `n_missing` = 1 ; sans série `last_sync`, `n_messages_lost` = `None`.
|
||
- 03/10 et 13/10 : UNKNOWN, jours coupés par l'export (17 et 8 heures ; la première et la dernière heure n'ont que 2 échantillons).
|
||
|
||
NORDEND (109 jours, sans `link`, du 26/06 au 13/10) :
|
||
- 76 jours `UP`, 29 `MISSING`, 5 UNKNOWN (26 au 29/06 : début d'historique, premier envoi le 29/06 à 07:00 ; 13/10 : coupé par l'export).
|
||
- Les `MISSING` lourds sont les coupures de 1 à 23 h : 30/06 (95 envois manquants), 01/07 (55), 10 au 13/07 (8 à 62), 22-23/07 (43 et 33), 19 au 22/08 (12 à 23). La tension reste de 13,94 à 14,37 V au retour, sans redémarrage à 12,6 V : cohérent avec une station alimentée.
|
||
- Les autres `MISSING` ont 1 à 5 envois manquants : fin août et début septembre surtout (26/08 au 06/09).
|
||
- Aucun cas annoté par l'expert : aucun `DOWN` vu (impossible sans `link`) ; les `MISSING` ne sont pas encore confirmés.
|
||
|
||
## Options écartées
|
||
|
||
| Option | Pourquoi écartée |
|
||
|---|---|
|
||
| Compter les heures où le RSRP est présent | Une heure avec 1 instantané sur 4 paraît complète ; `link` donne le compte exact. |
|
||
| Comparer toutes les métriques texte | `registration`, `network_*` et `ip` sont vides, donc pas envoyés, quand la lecture du modem échoue ou que le lien tombe : leur absence n'est pas une perte. |
|
||
| Compter les messages des métriques numériques | Moyennes horaires : le nombre de messages n'est pas dans l'export. |
|
||
| Tolérer un envoi manquant par jour | Aucune donnée pour le calibrer ; le compte reste dans `facts` pour en décider avec les cas de l'expert. |
|
||
| Déduire le lien des champs du modem sur NORDEND | Sans `link`, un envoi sans `network_technology` peut être une lecture du modem qui échoue (26 % des heures depuis juillet) ; ce n'est pas un lien coupé. |
|
||
|
||
## Limites connues
|
||
|
||
1. **Aucun cas confirmé** : `DOWN` n'a jamais été vu ; les `MISSING` de NORDEND attendent l'avis de l'expert.
|
||
2. **`MISSING` ne dit pas pourquoi** : une coupure d'énergie fait aussi manquer les envois. Le croisement avec Energy reste à faire, au plus tard dans la couleur du jour.
|
||
3. **Remontée différée** : sur NORDEND, rien n'arrive plus tard dans les heures des coupures (les envois y sont rangés à l'heure de la station) ; les envois perdus le restent. Une coupure du lien y apparaît donc comme `MISSING`.
|
||
4. **Un instantané toutes les 15 minutes** : une coupure plus courte entre deux envois n'est pas vue.
|
||
5. **Le jour en cours est UNKNOWN** jusqu'à sa dernière heure.
|
||
6. **Un message `link` absent n'est pas toujours perdu en route** : si le collecteur s'arrête plus de 120 s pendant que `sync` tourne, la réponse du modem expire dans Redis et `link` n'est pas envoyé. Cela compte aussi dans `n_messages_lost`.
|
||
7. **Seuls deux messages par envoi sont comptés** : la perte d'un autre message (une mesure radio, la tension) n'est pas vue.
|
||
8. **Sans `link`** (NORDEND) : ni `DOWN`, ni `up_percent`, ni `n_messages_lost` ; seuls les envois entiers manquants se voient.
|
||
9. **Comptage par heure** : un envoi décalé d'une seconde change d'heure, et un envoi en surnombre bouche un trou de sa propre heure (NORDEND en fait 5 à 7 par heure vers 06:00 et 09:00 UTC). Sur NORDEND, le 15/07 sort `MISSING` à tort (l'envoi de 09:00 est parti à 08:59, rangé dans l'heure de 08:00) et le 28/07 compte 1 envoi manquant au lieu de 2. Les 16 autres petits `MISSING` sont justes.
|
||
10. **Cadence supposée fixe** : 4 envois par heure sur toutes les stations. Une station réglée autrement (30 min, 1 h) sortirait `MISSING` tous les jours.
|
||
|
||
## Pistes
|
||
|
||
- **Deux corrections retenues sur le principe (2026-10-13), non codées** : l'utilisateur veut d'abord voir avec le spécialiste comment articuler le code.
|
||
1. **Compter par quart d'heure** (limite 9) : ramener chaque horodatage de `last_sync` au quart d'heure le plus proche (08:59 → 09:00, 06:19 → 06:15), puis compter les quarts d'heure distincts reçus dans la journée. Effet mesuré sur NORDEND : le 15/07 passe `UP`, le 28/07 reste `MISSING` avec 2 envois manquants, rien d'autre ne change.
|
||
2. **Mesurer la cadence de chaque station** (limite 10) : l'intervalle le plus fréquent entre ses envois des jours précédents (calcul causal), à la place de `SAMPLES_PER_HOUR`. 15 min sur WEISSHORN et sur NORDEND.
|
||
- Points d'articulation à trancher : `link` n'a pas d'horodatage propre (un compte par heure), alors que la correction 1 compte par quart d'heure sur `last_sync` : comment garder `n_messages_lost` cohérent ; cadence mesurée par l'analyse, ou lue dans la configuration de la station si elle y est.
|
||
- **Journal de la station** : `cmd_sync` y écrit le nombre de messages de chaque envoi. S'il devient accessible, le comparer à ce qui arrive donnerait les pertes réelles, et séparerait « pas envoyé » de « perdu en route » (question 6 de `docs/cellular/domaine/questions-pour-l-expert.md`).
|
||
- Avec les cas de l'expert : décider si un seul envoi manquant suffit à sortir de `UP`.
|
||
- **Renommer les états**, proposé le 2026-10-13, non décidé : `UP` se lit « lien actif », alors que sans `link` (NORDEND) il veut seulement dire « tous les envois sont arrivés ». Proposition : `COMPLETE`, `INCOMPLETE`, `LINK_DOWN`.
|
||
- `registration` (`searching`, `denied`) pourrait expliquer un `DOWN`.
|
||
|
||
## Historique
|
||
|
||
- **2026-10-13** : création, avec le chargement des métriques texte par `common.stations` (D-031).
|
||
- **2026-10-13** : ajout de `n_messages_lost` (messages perdus dans un envoi arrivé, `link` comparé à `last_sync`), qui mène aussi à `MISSING` ; `n_missing` compte désormais un envoi comme arrivé si l'un de ses deux messages est arrivé.
|
||
- **2026-10-13** : `link` facultatif (exports sans `link`, NORDEND) ; `value` devient `received_percent` ; ajout de `n_sends` ; début d'historique en UNKNOWN ; pourcentages `None` sur un jour coupé (D-032).
|
||
- **2026-10-13** : limites 9 (comptage par heure) et 10 (cadence supposée) ; deux corrections retenues sur le principe, non codées, en attente du spécialiste (« Pistes »).
|