Explorateur de journaux
Retrouver un message, lire sa chaîne de traitement et suivre le trafic à mesure qu'il arrive.
L'explorateur liste tous les messages traités par le système, du plus récent au plus ancien. C'est l'outil pour répondre à « qu'est-il arrivé à ce message ? » et « pourquoi ces messages échouent-ils ? ».
Le tableau
| Colonne | Ce qu'elle montre |
|---|---|
| Heure | Quand le message est arrivé |
| Expéditeur | Le numéro de téléphone d'origine |
| Code | Le code de signal porté par le message |
| Chaîne | Les cinq étapes, et jusqu'où le message est allé |
| Résultat | Le résultat global |
La colonne Chaîne est celle à lire en premier. Elle montre les cinq étapes d'un coup d'œil : une ligne qui s'arrête à Rapporteur vous dit que l'expéditeur n'était pas enregistré, sans qu'il faille l'ouvrir.
Vues enregistrées
Quatre vues couvrent les questions courantes :
- Tous les messages — tout, du plus récent au plus ancien.
- Expéditeurs non enregistrés — messages venant de numéros que le système ne reconnaît pas.
- Échecs de distribution — réponses que la passerelle n'a pas pu livrer.
- Échecs DHIS2 — messages correctement analysés mais impossibles à écrire comme événements.
Chacune est un point de départ plutôt qu'une limite ; ajoutez des filtres par-dessus n'importe laquelle.
Filtrer
La recherche porte sur le texte du message, le numéro de téléphone et le numéro de référence. Au-delà, des filtres peuvent être ajoutés sur des champs individuels — code, type EBS, téléphone, numéro de référence — et combinés, avec une plage temporelle.
Suivi en direct
Activer Direct suit le trafic à mesure qu'il arrive, ce qu'on veut dans les minutes suivant la publication d'un flux. Les nouveaux messages sont annoncés dès leur arrivée. Désactivez-le avant de vous installer pour enquêter, afin que les lignes cessent de bouger sous vos yeux.
Inspecter un message
Sélectionner une ligne ouvre le panneau de détail avec le message complet, chaque étape et son résultat, et les identifiants nécessaires pour suivre le message ailleurs. L'identifiant du message peut être copié pour être cité dans un ticket, et la requête peut être copiée sous forme de commande cURL pour la reproduire hors du portail.
Un ordre d'enquête pratique
- Filtrez sur les échecs, à l'aide d'une vue enregistrée ou du résultat.
- Lisez la colonne Chaîne pour repérer l'étape où ils s'arrêtent. Des échecs qui partagent une étape partagent généralement une cause.
- Ouvrez-en un et lisez son détail en entier.
- Agissez selon l'étape. Les échecs de grammaire renvoient à la grammaire du flux ou à ses codes ; les échecs de rapporteur à l'enregistrement ; les échecs d'événement à DHIS2 ou à la correspondance ; les échecs de réponse à la passerelle.
Quand de nombreux messages échouent d'un coup
Vérifiez s'ils partagent une étape et s'ils ont commencé à un moment précis. Une chute brutale à l'étape Événement signifie généralement DHIS2 plutôt qu'un changement de configuration ; une chute à Grammaire suit généralement la publication ou la modification d'un flux. La vue d'ensemble de la santé montre ces deux formes plus clairement que le tableau.