E4 Diagnostiquer

Trouver ce qui ne va pas, et savoir si c'est de notre ressort.

Commencer par le tableau de bord

Tableau de bord : six tuiles et graphiques sur 24 heures
Trois questions, trois réponses indépendantes. Ici : authentification valide, envois refusés.
QuestionTuile
1Les capteurs émettent-ils ?Réception radio
2L'authentification est-elle valide ?Connexion IoBase
3Les mesures sont-elles acceptées ?Envoi vers IoBase

Les graphiques répondent à la question suivante : depuis quand ? Un creux dans les trames date une panne plus vite qu'une lecture de journal.

Aller au bon endroit

Ce qu'on observeAller à
Une seule balise est rougeBalise silencieuse
Toutes les balises sont rougesFlux arrêté
Les balises remontent, la plateforme ne reçoit rienEnvois refusés
Authentification en défautAuthentification
Rien ne va, et la passerelle semble muetteFlux arrêté

Une balise est silencieuse

Une balise passe au rouge après six fois sa cadence attendue sans trame.

1Les autres balises remontent-elles ? Si non, le problème est la passerelle — voir Flux arrêté.
2Regarder le graphique qualité radio : une dégradation progressive annonce des piles en fin de vie ou un obstacle apparu.
3Vérifier le compteur de trames : s'il est reparti de zéro, la balise a redémarré — piles changées, ou redémarrage à distance.
4Sur place : refaire la séquence d'aimant, vérifier les piles.

Les mesures ne sont pas acceptées

Les balises remontent, mais la tuile Envoi vers IoBase est rouge. Le message de la tuile donne la nature du problème.

MessageCauseQuoi faire
EAI_NONAMELe nom de la plateforme ne résout plus Pas de notre ressort → E5
ECONNREFUSED · délai dépasséPlateforme joignable mais indisponible Pas de notre ressort → E5
Code 400Contenu refusé Vérifier site, source de données, modèle et métriques de la balise (✎ Modifier)
Code 401Jeton refusé Un renouvellement se déclenche seul. Si cela persiste → Authentification
Les mesures émises pendant l'incident sont perdues

Il n'y a pas de file de rejeu. Le journal de la passerelle dit ce qui a été perdu, mais rien ne le rattrape. À savoir avant d'annoncer une reprise.

L'authentification est en défaut

SituationSignificationQuoi faire
Code 425L'équipement attend une validation humaine côté plateformePas de notre ressort → E5
Renouvellement échoué, une foisUne reprise automatique s'arme Attendre le cycle suivant
Renouvellement échoué, à répétitionLe jeton de renouvellement est perdu Un nouvel enrôlement est nécessaire → E5
Aucun renouvellement depuis plus de 12 hLa tâche périodique ne tourne plus Voir Flux arrêté

Le flux est arrêté

Signes : plus aucune balise ne remonte, le temps de fonctionnement ne progresse plus, le cockpit ne répond plus.

1Le cockpit répond-il encore ? S'il répond, le flux tourne.
2Se connecter à l'interface d'administration de la passerelle et vérifier son état.
3Redémarrer le moteur depuis cette interface. Les jetons sont rechargés automatiquement au démarrage : aucun ré-enrôlement n'est nécessaire.

Lire le journal

Sur la passerelle, l'option -a est obligatoire — sans elle la commande n'affiche rien tout en semblant fonctionner :

grep -a "IOBASE_" /overlay/log/messages | tail -20

Chercher le premier marqueur attendu qui manque : il désigne l'étape fautive. Signification des 91 marqueurs : référence.

Trois marqueurs qui ne sont pas des pannes

ASYSTOM_SKIP_GENERIC — capteur d'une autre marque, c'est voulu.
IOBASE_SKIP — configuration de balise incomplète, la passerelle préfère ne pas envoyer.
DAP_REFRESH_SKIP_FRESH — jeton récent, volontairement épargné.

Entretien

TâcheCadence
Renouvellement du jetontoutes les 12 hautomatique
Rotation du journal des tramesquotidienne automatique — un fichier par exécution, l'arriéré ne se rattrape pas
État des balisestoutes les 2 minautomatique
Statistiques horairestoutes les 10 minautomatique

Déployer un changement

Réservé à qui modifie la passerelle. Le danger n'est pas le redémarrage, mais le renouvellement de jeton qu'il peut déclencher : ces jetons sont à usage unique.

  1. Contrôler — vérifier que le flux à déployer ne retire aucun node du flux en service. Un capteur déclaré depuis le cockpit n'existe que là.
  2. Sauvegarder — flux, état d'authentification, configuration des balises.
  3. Renouveler le jeton si nécessaire — une garde l'épargne s'il a moins de six heures. Au-delà, provoquer le renouvellement à froid, l'observer réussir, puis déployer.
  4. Répéter la restauration — prouver qu'on sait réécrire l'état sans personne.
  5. Déployer, puis vérifier DAP_REFRESH_SKIP_FRESH dans le journal, le nombre de nodes, et la présence des capteurs.
L'âge du jeton se lit dans le fichier, pas sur sa date

La garde des six heures s'appuie sur l'horodatage contenu dans le fichier d'état. Sa date de modification change dès qu'on réécrit le fichier et peut annoncer un état rassurant qui ne correspond à rien.

Mettre à jour l'interface du cockpit, en revanche, ne redémarre pas le flux : c'est sans risque.