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

6.8 KiB
Raw Blame History

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é.