Analyse de l'orchestration
Où trouver les chiffres du routage, ce que chacun mesure et sur quelle période.
Il n'existe aucun tableau de bord unique pour l'orchestration. Les chiffres sont répartis sur quatre interfaces, qui répondent chacune à une question différente sur une période différente. L'erreur la plus courante consiste à comparer deux de ces chiffres et à conclure que l'un est faux.
| Interface | Question traitée | Période |
|---|---|---|
| Orchestration, Vue d'ensemble | Quelles sont les performances de chaque connexion pour mon compte ? | 7, 30 ou 90 jours |
| Orchestration, Matrice | Que se passe-t-il actuellement pour chaque opérateur ? | Fenêtre glissante de 15 minutes |
| Panneau uplift de la page Vue d'ensemble | Qu'a réellement récupéré la cascade ? | 7 jours |
| Konsole, Routing Log | Pourquoi ce paiement précis a-t-il emprunté cette route ? | Par appel de débit |
Les quatre sont réservées au mode live. Les paiements de la sandbox ne sont pas routés. Ils sont donc exclus de tous les chiffres de cette page. La section Orchestration elle-même n'est disponible qu'en mode live.
La page Vue d'ensemble et ce que mesure chaque chiffre
Choisissez une période de 7, 30 ou 90 jours. Les chiffres peuvent dater de dix minutes au plus. Une commande d'actualisation permet d'obtenir immédiatement la valeur actuelle.
Vous obtenez ces chiffres par connexion, tous calculés à partir de vos propres transactions sur cette période. Les noms sont les libellés affichés par le Dashboard.
TransactionsnombrefacultatifTaux de succèspourcentagefacultatifVolumemontantfacultatifDernière utilisationdatefacultatifAu-dessus de la liste, les chiffres de la même période sont regroupés pour toutes les connexions, avec deux valeurs supplémentaires. Durée moyenne représente le nombre moyen de secondes entre la création du paiement et son crédit. Elle mesure tout le parcours du payeur, y compris le temps passé à chercher son téléphone, pas seulement le délai de réponse du prestataire. La tendance affichée avec Transactions compare le nombre de transactions à celui de la période précédente de même durée.
Deux taux de réussite, deux significations
La page Vue d'ensemble calcule la réussite à partir des transactions créditées. Une demande abandonnée fait donc baisser ce taux. Le routage regarde la fiabilité récente, qui ignore les échecs dus au payeur. Une demande abandonnée ne la modifie pas. Une connexion peut afficher 72 % sur la page Vue d'ensemble tout en restant saine pour le routage. Les deux chiffres sont justes.
Quand une connexion est considérée comme dégradée
Une seule règle détermine les termes et les couleurs affichés : vert à partir de 95 %, orange à partir de 80 %, rouge en dessous, et aucun verdict sous 5 paiements. Chaque écran l'applique sur sa propre période.
| Emplacement | Données nécessaires | Verdict |
|---|---|---|
| Bannière d'avertissement de la page Vue d'ensemble | La page Matrice ci-dessous, en direct | Un canal est signalé dès qu'une de ses cellules est rouge |
| Health badge de la page du prestataire | 5 paiements au cours des dernières 24 heures | Vert à partir de 95 %, orange à partir de 80 %, rouge en dessous |
| Couleur d'une cellule de la page Matrice | 5 tentatives au cours des 15 dernières minutes | Verte à partir de 95 %, orange à partir de 80 %, rouge en dessous, et rouge dès que le coupe-circuit est ouvert ou que la connexion est refusée |
En dessous du minimum, aucune conclusion n'est affichée. Une cellule grise ou l'absence de badge signifie que le trafic ne suffit pas pour se prononcer, pas qu'il existe un problème.
La matrice et le diagnostic qu'elle permet
La matrice place vos canaux d'opérateurs sur les lignes et vos connexions sur les colonnes. Elle remplit chaque cellule avec les données d'une fenêtre glissante de 15 minutes. Elle permet une distinction impossible dans une liste par prestataire.
Une ligne entièrement rouge signifie que l'opérateur lui-même est en panne. Toutes les connexions qui atteignent MTN Cameroun échouent. Il n'existe donc aucune autre route possible. Vous devez attendre ou cesser de proposer ce canal jusqu'à son rétablissement.
Une cellule rouge alors que les voisines restent stables indique que votre chemin vers cet opérateur rencontre un problème, pas l'opérateur lui-même. Le trafic peut être préservé, car une autre connexion de la même ligne fonctionne. C'est exactement le cas que la cascade gère seule et celui où une politique sur ce canal produit un effet immédiat : Acceptation maximale, ou une santé minimale, place la connexion défaillante derrière celle qui fonctionne, sur ce canal uniquement.
Chaque cellule indique également si le circuit de cette route est ouvert. Cela explique pourquoi une connexion semble ne recevoir aucun trafic. Lorsque les identifiants de la connexion manquent ou sont refusés, la cellule passe au rouge et affiche Connexion refusée à la place du badge du circuit.
Ce que la cascade a récupéré
Le chiffre qui justifie à lui seul l'orchestration se trouve sur la page Vue d'ensemble. Pour les sept derniers jours, il indique le nombre de paiements qu'un prestataire de repli a débités après l'échec sur le chemin de celui classé avant lui, ainsi que leur volume. Seuls les basculements à l'intérieur d'une même décision de routage comptent : un payeur qui a réessayé de lui-même après un refus a ouvert une nouvelle décision, et n'est pas compté.
Chacun de ces paiements aurait été perdu dans une intégration à prestataire unique. Le panneau affiche également le volume traité par les canaux actuellement signalés comme dégradés. Ce chiffre représente votre exposition actuelle, pas un résultat déjà obtenu.
Comparez-le à vos avertissements de chemin unique
Un nombre élevé de récupérations sur un canal qui affiche également un avertissement de chemin unique est le meilleur argument pour connecter un deuxième prestataire. La cascade sauve déjà les paiements lorsqu'elle le peut, mais elle ne possède aucune autre connexion pour les sauver sur ce canal.
Le conseiller et les constats qui produisent un effet
La page Vue d'ensemble lit votre matrice et génère des constats, classés selon leur gravité et le volume concerné. Ils sont déterministes, calculés à partir de vos propres données, et vous pouvez vérifier tous les chiffres qu'ils contiennent.
L'avertissement single path conduit toujours à un véritable changement : un canal, une connexion, aucune solution de repli et le volume qui s'arrêterait en cas d'échec. La correction consiste à connecter un deuxième prestataire pour ce canal. Il s'agit de l'action qui apporte le plus de valeur dans tout le module.
Le constat operator down est informatif, à juste titre. Aucune configuration ne peut corriger la panne d'un opérateur.
Le dernier constat signale une connexion qui échoue sur un canal alors qu'une autre est en bonne
santé, et renvoie à la politique de ce canal sur la page Matrice : choisissez
Acceptation maximale, ou fixez une santé minimale, et la connexion défaillante est essayée après
la connexion en bonne santé, sur ce canal uniquement. Sur chaque paiement du canal, Wajub applique
la politique aux connexions qu'aucune règle de routage n'a placées.
Augmenter plutôt la priority de la connexion la déplacerait sur tous les canaux.
Lire une décision ou en filtrer plusieurs
Le journal de routage de Konsole contient une entrée par tentative de débit : une par appel à
POST /payments/{id}. Un payeur qui effectue deux tentatives sur le même paiement en laisse deux.
Les filtres permettent de répondre aux questions que les chiffres regroupés ne couvrent pas.
| Filtre | Résultat isolé |
|---|---|
| Résultat, A eu un repli | Décisions dans lesquelles plusieurs candidats ont été classés |
| Résultat, Fournisseur ignoré par le coupe-circuit | Décisions dans lesquelles une connexion était en pause sur le canal |
| Résultat, Aucun candidat éligible | Décisions dont la liste était vide, les cas avec une réponse 422 |
| Channel | Un réseau d'opérateur à la fois |
| Provider | Décisions que cette connexion a gagnées : c'est elle qui a pris le paiement |
| Transaction reference | Un paiement, du début à la fin |
La sélection d'une ligne ouvre chaque candidat et la raison de sa place, à côté des tentatives qui ont suivi : chaque candidat essayé affiche son résultat et sa latence. Cette association entre la décision et son résultat n'est présentée qu'à cet endroit.
Alertes
Orchestration, Alertes surveille un chiffre pour vous et vous prévient lorsqu'il franchit un seuil. Wajub évalue chaque règle toutes les 5 minutes, uniquement sur les paiements live.
| Champ | Valeurs possibles |
|---|---|
| Métrique | Taux de réussite, taux d'erreur, nombre de transactions, volume, taux de livraison des webhooks, nombre d'échecs de webhook, taux d'abandon du tunnel ou profondeur de la file |
| Condition | Passe sous un seuil, l'atteint en descendant, le dépasse, l'atteint en montant, ou lui est égal |
| Période | Les 5 dernières minutes, 15 minutes, la dernière heure ou les dernières 24 heures |
| Portée | Tout, une connexion, un canal ou une règle de routage |
| Notification | Des adresses e-mail, un webhook Slack ou votre propre URL |
| Délai de répit | De 5 minutes à 24 heures avant qu'une même règle puisse se déclencher à nouveau |
Une portée canal compte les paiements débités sur ce canal, un paiement envoyé sur mobile ou
cm.mobile comptant pour l'opérateur auquel il a été résolu. Une portée règle compte les paiements
que cette règle a routés. La portée ne restreint que les métriques de paiement. Les métriques de
webhook comptent toutes les livraisons vers vos propres endpoints, et la métrique du tunnel toutes
les pages de paiement ouvertes. Une cible Slack ou webhook reçoit un corps JSON avec rule_id,
rule_name, observed_value, context et fired_at. Les 20 dernières alertes déclenchées sont
listées sur la même page.
Ce qui n'est pas mesuré
Connaître les éléments manquants vous évite de chercher des exportations qui n'existent pas.
Le coût est une donnée d'entrée, pas un résultat. Le tarif négocié saisi sur une connexion sert à trouver la connexion la moins chère pour chaque paiement. Il n'est jamais regroupé sous forme de coût par transaction ou de comparaison des dépenses. Si vous en avez besoin, calculez-le depuis vos propres exportations de transactions et les tarifs saisis.
Aucune de ces informations n'est accessible dans l'API. Il n'existe aucun endpoint pour les statistiques des prestataires, les décisions de routage, les cellules de la matrice ou les constats du conseiller. Aucune exportation CSV n'est disponible. Les analyses d'orchestration se consultent dans le Dashboard et dans Konsole.
La sandbox ne contribue à aucun chiffre. Aucune décision n'est enregistrée, aucune tentative n'est comptée et aucune cellule n'est actualisée. Une matrice vide sur un compte de test très actif est donc normale.
Pages associées
- Orchestration des paiementsLa manière dont est prise la décision à l'origine de chacun de ces chiffres.
- Cascade et repliLe parcours réellement suivi par les paiements récupérés.
- PrestatairesLa priorité, le poids et les tarifs négociés, à modifier selon les données présentées ici.
- Journal de routageUne décision par paiement, avec sa liste complète de candidats.