Analyse de l'orchestration

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.

Les quatre sont réservées au mode live. Les paiements dans la sandbox n'atteignent jamais l'orchestrateur. Ils sont donc exclus de tous les chiffres de cette page. La section Orchestration elle-même est inaccessible avec une clé de test par le middleware de route.

La page Overview et ce que mesure chaque chiffre

Choisissez une période de 7, 30 ou 90 jours. La page est mise en cache pendant dix minutes. Une commande d'actualisation permet d'obtenir immédiatement la valeur actuelle.

Vous obtenez cinq chiffres par connexion, tous calculés à partir de vos propres transactions sur cette période.

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. avg_processing_time représente le nombre moyen de secondes entre la création du paiement et son crédit. Il 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. trend compare le nombre de transactions à celui de la période précédente de même durée.

Quand une connexion est considérée comme dégradée

Deux seuils déterminent les termes et les couleurs affichés. Ils portent sur des périodes différentes.

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 de la fenêtre glissante de 15 minutes que le moteur maintient pendant le routage. 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ù augmenter la priorité d'une autre connexion produit un effet immédiat.

Chaque cellule indique également si le circuit de cette route est ouvert. Cela explique pourquoi une connexion semble ne recevoir aucun trafic.

Ce que la cascade a récupéré

Le chiffre qui justifie à lui seul l'orchestration se trouve sur la page Overview. Pour les sept derniers jours, il indique le nombre de paiements qui ont nécessité plusieurs tentatives avant d'être finalement crédités, ainsi que leur volume.

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.

Le conseiller et les constats qui produisent un effet

La page Overview 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.

Les autres constats proposent de modifier une politique de cascade sur la page Matrix. Cette politique ne modifie pas actuellement l'ordre dans lequel le routeur essaie vos connexions. Le véritable levier est la priority de la connexion elle-même, dans Orchestration, Providers. Une règle de routage permet d'adapter cette préférence au canal, à la devise ou au montant.

Lire une décision ou en filtrer plusieurs

Le journal de routage de Konsole contient un enregistrement par décision, écrit lors de la construction de la liste des candidats. Il existe donc un enregistrement 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.

La sélection d'une ligne ouvre la liste complète des candidats et leurs scores, à côté des tentatives qui ont suivi. Cette association entre la décision et son résultat n'est présentée ensemble qu'à cet endroit.

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 alimente le bonus du moindre coût dans le score de routage. 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.