Files
Support-Agent/docs/cellular/analyses/daily_link_state.md
T
maximeandClaude Opus 5.5 91ba1bd8ef Add the DAILY_LINK_STATE and DAILY_SIGNAL_STATE cellular analyses
Explore WEISSHORN for the cellular domain, count lost sends and
messages, grade the daily RSRP and RSRQ medians on the published
Quectel grid, and record D-031.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 10:48:34 +02:00

86 lines
6.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# `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/<STATION>_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é.