Outils de diagnostic

Le point de santé /healthz

Le point d'entrée le plus simple pour savoir si un service répond est /healthz. Une requête GET sur ce point renvoie l'état de santé du service interrogé : c'est le premier contrôle à faire quand on ne sait pas encore si le problème vient du service lui-même ou de sa connectivité.

• Une réponse saine indique que le service est en vie et répond aux requêtes. C'est un « oui » à la question « le service tourne-t-il ? », pas une preuve que tout le chemin réseau fonctionne.
• Pas de réponse : le service ne tourne pas, n'écoute pas, ou n'est pas joignable depuis l'endroit d'où vous testez. Distinguez ces cas en testant depuis un autre point.
• Utilisez /healthz comme premier tri : s'il répond, cherchez le problème plus haut (politique d'accès, chemin, abonnement) ; s'il ne répond pas, cherchez côté service ou joignabilité de base.

Topologie temps réel dans la console

La console offre une vue d'ensemble que les tests locaux ne donnent pas : l'inventaire des appareils, leur statut et la topologie du réseau telle que la vigie la voit. C'est l'endroit où vérifier d'un coup d'œil qu'un appareil est bien présent, actif, et relié à ses pairs.

• Inventaire : chaque appareil figure avec son statut (actif, en attente, suspendu…), son adresse mesh et son nom.
• Topologie : les liens d'un appareil vers ses pairs du même réseau sont représentés, ce qui aide à repérer un nœud isolé.
• Indicateurs d'état : ils indiquent si un pair est en ligne et depuis quand.

Logs et statut d'enrôlement

Quand un appareil ne se comporte pas comme attendu, deux sources renseignent sur son état : ses logs locaux et son statut d'enrôlement. Le statut d'enrôlement dit si l'appareil est admis et approuvé ; les logs disent ce qu'il tente et où il échoue.

Vérifier la connectivité

Une fois le service sain et l'appareil actif, reste à valider le lien de bout en bout. La procédure de vérification de connectivité enchaîne quelques contrôles simples — adresse attribuée, joignabilité d'un pair, résolution de noms, topologie — dont chacun isole une couche différente.

1. 1
   Confirmer l'adresse attribuéeL'appareil porte-t-il une adresse en 100.64.x ? Sans adresse, il n'est pas allé au bout de son enrôlement.
2. 2
   Joindre un pairEnvoyez un ping vers l'adresse d'un autre appareil actif. Une réponse confirme que le chemin est établi, même via le relais.
3. 3
   Vérifier la résolution de nomsRésolvez le nom d'un pair et joignez-le par son nom : si l'adresse répond mais pas le nom, le problème est côté résolution, pas côté connectivité.
4. 4
   Observer la topologieRecoupez avec la console, en laissant passer un cycle de rafraîchissement (~30 s).

Questions fréquentes