Files
Support-Agent/docs/cellular/guide/diagnostic-cellulaire.md
T
maximeandClaude Opus 5.5 f0990c16e6 Deliver Storage and Cellular in the mockups, with site figures and guides
The mockups now walk a list of domains (D-039): the support Home loads
every station in data/ and notifies each station x domain that is Orange
or Red; the client view becomes maquettes/user/summary.py, one System
Summary page per station with one block per measured domain. Storage
shows a free-space scale and the estimated full date; Cellular shows the
day's sends in words and a four-class signal scale.

HEADLINE moves into each day_color.py, with a Green sentence for the
client view. src/storage/final.py and src/cellular/final.py write the
site figures in English; the comparison pages reuse their panels. Each
domain gets a short two-layer guide in docs/<domaine>/guide/.

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

7.3 KiB
Raw Blame History

Guide : lire le diagnostic 4G d'une station AIMsight

  • Statut : brouillon, 2026-10-13. La couleur du jour est calculée par src/cellular/day_color.py, selon la matrice de docs/cellular/matrice-lien-signal.drawio (D-037). Prototype : aucun cas de l'expert, deux corrections de DAILY_LINK_STATE en attente du spécialiste.
  • Lecteurs : la partie 1 s'adresse au client final (elle est affichée dans le bloc Cellular de la page System Summary) ; la partie 2 à l'ingénieur support AIMsight.

Partie 1 : lecture rapide

1. Ce que surveille le diagnostic

La station envoie ses mesures par la 4G, toutes les 15 minutes, soit 96 envois par jour. Chaque jour, le diagnostic répond à une question : tous les envois de la station sont-ils arrivés ?

La réponse est une couleur par jour. Le bloc montre aussi la qualité du signal 4G reçu par la station.

2. Les couleurs, et ce qu'il faut faire

Couleur Ce que ça veut dire Que faire
🟢 Vert Tous les envois sont arrivés. Rien.
🟠 Orange Quelques envois manquent, ou la 4G a été signalée coupée, mais la station a continué à mesurer. Rien si l'orange est isolé : un envoi perdu suffit à le produire. Prévenir le support si les oranges se suivent plusieurs jours.
🔴 Rouge La station s'est tue une grande partie de la journée (5 heures ou plus). Contacter le support. Regarder aussi le bloc Energy : une station sans énergie se tait aussi.
⚪ Gris Inconnu : journée incomplète (premier jour suivi, jour en cours), ou envois arrivés mais signal mesuré trop peu de temps. Regarder les jours voisins.
  • La couleur du jour peut encore changer tant que la journée n'est pas terminée (minuit UTC).

3. Ce qu'affiche le bloc

  • Data sent : « All data received », le nombre d'envois manquants sur 96, ou « 4G link reported down ».
  • Signal : la qualité du signal sur la journée, sur une échelle à quatre classes : Cell edge (limite de la zone couverte), Mid cell, Good, Excellent. Le signal ne change pas la couleur : une station en limite de zone peut tout transmettre. C'est un repère, pas une alerte.

4. Deux exemples réels (2026)

WEISSHORN : une station bien couverte

Jour Couleur Ce qui se passe
20/08 🔴 Fin de la mise en service : 18 heures de silence, 43 envois manquants.
22/08, 29/08, 30/08, 01/09, 05/09, 06/09 🟠 Oranges isolés : un à trois envois perdus, la station revient au vert le lendemain. Rien à faire.
03/09 🟠 La 4G est signalée coupée une fois, mais les 96 envois sont arrivés.
07/09 – 12/10 🟢 Tous les envois arrivent. Signal « Good » tous les jours.

NORDEND : une station en limite de zone

Période Couleur Ce qui se passe
30/06 – 01/07, 11 – 13/07, 22 – 23/07, 19/08, 22/08 🔴 Coupures de la liaison, de 1 à 23 heures sans envoi.
26/08 – 06/09 🟠 presque tous les jours 1 à 5 envois perdus par jour : une série d'oranges, la situation où il faut prévenir le support (cas pas encore confirmé par l'expert).
le reste surtout 🟢 Signal « Cell edge » presque tous les jours, et pourtant 76 jours sur 109 tous les envois arrivent.

Partie 2 : annexe technique (support)

La couleur du jour combine deux analyses des messages du modem : link et last_sync (deux messages par envoi), et les mesures radio rsrp_dBm et rsrq_dB (moyennes horaires). Le détail (calcul exact, sources, résultats, options écartées) est dans leurs fiches : docs/cellular/analyses/daily_link_state.md et docs/cellular/analyses/daily_signal_state.md. Une couleur conclut au plus consistent with : elle signale une journée à regarder.

5. Les deux analyses

  • DAILY_LINK_STATE : envois attendus = 4 par heure × 24 (cadence observée, non documentée). Par heure, un envoi est arrivé si l'un de ses deux messages est arrivé. L'état se lit dans cet ordre :
    1. jour incomplet dans l'export, ou début d'historique : inconnu ;
    2. au moins un échantillon link = down : DOWN ;
    3. un envoi entier ou un message manquant : MISSING (la cause n'est pas établie : lien, énergie, serveur) ;
    4. sinon : UP.
  • DAILY_SIGNAL_STATE : médianes du jour du RSRP et du RSRQ, classées sur une grille publiée (attribuée au modem Quectel BG96 par KORE Wireless, identique au wiki Teltonika) : EXCELLENT ≥ −80 dBm / −10 dB, GOOD ≥ −90 / −15, MID_CELL ≥ −100 / −20, sinon CELL_EDGE. Le jour prend la pire des deux classes. Moins de 20 heures mesurées sur 24 : inconnu.

6. La matrice : du lien et du signal à la couleur

Lien \ Signal mesuré (toute classe) inconnu (< 20 h)
UP 🟢 ⚪
MISSING 🟠 🔴
DOWN 🟠 🔴
inconnu ⚪ ⚪
  • Rouge : des envois manquent et le signal n'est pas mesuré 20 heures sur 24, donc la station s'est tue 5 heures ou plus. Ce critère reprend MIN_COVERAGE, sans nouveau seuil : sur NORDEND, il retient 9 des 11 coupures lourdes, et aucun des petits manques (D-037).
  • Pourquoi le signal ne change pas la couleur : avec UP × CELL_EDGE en orange, NORDEND serait notifiée 76 jours sur 109 alors que tous ses envois sont arrivés.
  • Totaux : WEISSHORN (09/08 au 13/10/2026), 46 jours 🟢, 7 🟠, 1 🔴, 12 ⚪ ; NORDEND (26/06 au 13/10/2026), 76 🟢, 20 🟠, 9 🔴, 5 ⚪.

7. Lire la figure

python3 src/cellular/final.py écrit out/<STATION>_cellular_daily.html et sa figure en JSON (.json, pour Plotly.newPlot). C'est l'historique complet du bloc Cellular. La page de comparaison (python3 src/cellular/all_analyses.py, out/<STATION>_cellular.html) reprend les mêmes panneaux, avec les séries du modem et les envois reçus par heure dessous.

  • Panneau DAILY_LINK_STATE : sends received en % des envois attendus, l'état en marqueurs (● vert UP, ◆ jaune MISSING, ✕ violet DOWN).
  • Panneaux DAILY_SIGNAL_STATE (RSRP en dBm, puis RSRQ en dB) : la daily median, les planchers de la grille en tirets, la classe en marqueurs.
  • Survol : tous les faits calculés du jour (envois reçus et manquants, échantillons up et down, médianes, couverture).
  • Attention aux couleurs : celles des panneaux distinguent les états et les classes, ce ne sont pas celles de la matrice.

8. Limites à connaître

  1. Aucun cas de l'expert : les questions sont dans docs/cellular/domaine/questions-pour-l-expert.md.
  2. Cadence supposée de 15 minutes sur toutes les stations : une station réglée autrement serait orange tous les jours.
  3. Pas de croisement avec Energy : une coupure d'énergie fait aussi manquer les envois, et donne un rouge Cellular.
  4. Comptage par heure : un envoi décalé d'une seconde change d'heure (NORDEND, 15/07 : orange à tort). Deux corrections sont retenues sur le principe mais non codées, en attente du spécialiste.
  5. Un seul down suffit : un état fugitif du modem colore la journée en orange (WEISSHORN, 03/09).
  6. Grille du signal d'un autre modem, présentée comme indicative : NORDEND est CELL_EDGE presque tous les jours et transmet presque tout.
  7. Versions plus anciennes du collecteur (NORDEND) : sans link, ni DOWN ni messages perdus ; seuls les envois entiers manquants se voient.