# `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/`), qui écrit `out/_cellular.html` et l'ouvre. - **Code** : `src/cellular/link_state.py` (`run()`, `day_facts()`), 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`. Calcul exact, pour chaque jour UTC d ayant au moins une ligne `link` : 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. 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 la série `last_sync` manque. 5. `up_percent` = `n_up` / (`SAMPLES_PER_HOUR` × 24), en %. 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 | | 2 | `n_down` ≥ 1 | `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` = `up_percent`, en % du temps (`None` si l'état est UNKNOWN). - `anomaly` = `None` : état seul, sans verdict. L'état est dans `facts.state`. - `facts` = `state`, `up_percent`, `n_up`, `n_down`, `n_missing`, `n_messages_lost`, `hours`. ## Constantes et sources | Constante | Valeur | Source | |---|---|---| | `SAMPLES_PER_HOUR` | 4 | Un instantané par envoi, toutes les 15 minutes : `last_sync` et 4 échantillons par heure, WEISSHORN du 03/10 au 13/10. La cadence n'est pas dans le collecteur (`cmd_sync` est lancé de l'extérieur). | | `HOURS_PER_DAY` | 24 | Jour UTC complet. | ## Graphique - **En haut** : `up_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'instantanés `up` par heure, en barres. ## Résultats sur WEISSHORN (jeu de travail) - 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). - Aucun cas annoté par l'expert : l'analyse n'a pas encore vu un seul `DOWN` ni `MISSING`. ## 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. | ## Limites connues 1. **Aucun incident observé** : les états `DOWN` et `MISSING` n'ont jamais été vus sur des données réelles. 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 inconnue** : on ne sait pas si les envois perdus pendant une coupure du lien arrivent plus tard (file Redis `aimsight:sync`). Si oui, une coupure du lien apparaît comme `DOWN` ; sinon, 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. ## Pistes - Avec les cas de l'expert : décider si un seul envoi manquant suffit à sortir de `UP`. - `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é.