Aller au contenu

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.

InterfaceQuestion traitéePériode
Orchestration, Vue d'ensembleQuelles sont les performances de chaque connexion pour mon compte ?7, 30 ou 90 jours
Orchestration, MatriceQue se passe-t-il actuellement pour chaque opérateur ?Fenêtre glissante de 15 minutes
Panneau uplift de la page Vue d'ensembleQu'a réellement récupéré la cascade ?7 jours
Konsole, Routing LogPourquoi 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.

Transactionsnombrefacultatif
Paiements live attribués à cette connexion pendant la période.
Taux de succèspourcentagefacultatif
La part de ces paiements réellement créditée sur votre solde. Ce taux d'acceptation est calculé depuis vos comptes. Un payeur qui abandonne la demande le fait donc baisser.
Volumemontantfacultatif
Volume crédité pendant la période. Les montants de toutes les devises sont additionnés sans conversion : lisez-le devise par devise si vous encaissez dans plusieurs.
Dernière utilisationdatefacultatif
Paiement le plus récent sur cette connexion. Il permet de repérer une connexion qui a discrètement cessé de recevoir du trafic.

Au-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.

EmplacementDonnées nécessairesVerdict
Bannière d'avertissement de la page Vue d'ensembleLa page Matrice ci-dessous, en directUn canal est signalé dès qu'une de ses cellules est rouge
Health badge de la page du prestataire5 paiements au cours des dernières 24 heuresVert à partir de 95 %, orange à partir de 80 %, rouge en dessous
Couleur d'une cellule de la page Matrice5 tentatives au cours des 15 dernières minutesVerte à 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.

FiltreRésultat isolé
Résultat, A eu un repliDécisions dans lesquelles plusieurs candidats ont été classés
Résultat, Fournisseur ignoré par le coupe-circuitDécisions dans lesquelles une connexion était en pause sur le canal
Résultat, Aucun candidat éligibleDécisions dont la liste était vide, les cas avec une réponse 422
ChannelUn réseau d'opérateur à la fois
ProviderDécisions que cette connexion a gagnées : c'est elle qui a pris le paiement
Transaction referenceUn 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.

ChampValeurs possibles
MétriqueTaux 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
ConditionPasse sous un seuil, l'atteint en descendant, le dépasse, l'atteint en montant, ou lui est égal
PériodeLes 5 dernières minutes, 15 minutes, la dernière heure ou les dernières 24 heures
PortéeTout, une connexion, un canal ou une règle de routage
NotificationDes adresses e-mail, un webhook Slack ou votre propre URL
Délai de répitDe 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.

Que pensez-vous de ce contenu ?