Journal des livraisons d'une intégration

Que contient une ligne du journal ? #

Chaque ligne décrit un appel parti (ou tenté) :

• Horodatage — le moment de l'appel.
• Déclencheur — l'événement à l'origine : Fiche créée, Fiche modifiée, Fiche supprimée, Ticket créé, Ticket modifié, Statut de ticket modifié.
• Réponse — le code renvoyé par votre service, ou « Aucune réponse ».
• Latence — le temps de réponse, en millisecondes.
• Tentatives — le nombre d'essais sur le maximum, avec une précision : rejouée, abandonnée, non réessayée, nouvelle tentative programmée ou en attente.

L'état d'une livraison est En attente, Réussie, En échec, Abandonnée ou Rejouée.

Comment filtrer le journal ? #

Quatre filtres, en haut de la page :

• Intégration — pour ne voir qu'une intégration, ou toutes.
• État — en attente, réussie, en échec, abandonnée.
• Période — 24 heures, 7 derniers jours ou 30 jours.
• Cause — depuis le bloc « Pourquoi ça échoue », un clic sur un motif ouvre le journal filtré sur ce motif exact. Un bandeau Filtré sur … rappelle alors le filtre appliqué et la fenêtre retenue ; Retirer le filtre revient à la vue complète.

💡 Le journal se parcourt page par page, avec Page précédente et Page suivante. Il n'affiche ni total ni accès direct à une page donnée : resserrez la période ou les filtres plutôt que de feuilleter.

Que montre le détail d'une livraison ? #

Cliquez une ligne pour ouvrir le Détail de la livraison. Vous y trouvez :

• ce qui l'a déclenchée ;
• la chronologie des tentatives : chaque essai, son résultat, et le délai avant la prochaine tentative le cas échéant ;
• la requête envoyée — reconstruite depuis la configuration actuelle de l'intégration, jetons et signatures masqués ;
• la réponse reçue de votre service.

Un bouton Copier la requête met le tout dans le presse-papiers, ce qui aide à reproduire l'appel de votre côté.

Quand une livraison est le rejeu d'une autre, ou quand elle a elle-même été rejouée, le détail le dit et renvoie vers l'autre livraison.

Pourquoi le détail d'une vieille livraison a-t-il disparu ? #

Le contenu de la requête et de la réponse est conservé 30 jours, puis purgé. Passé ce délai, le détail affiche « Le détail a expiré » et la date de purge.

Ce qui reste exact et consultable : le statut, le code de réponse, la latence et la chronologie des tentatives. Ce qui disparaît : les corps de la requête et de la réponse. Une livraison dont le détail a expiré n'est plus rejouable — sans le corps, il n'y a plus rien à réémettre.

Les compteurs de santé, eux, sont conservés 90 jours.

Comment rejouer une livraison en échec ? #

1. Ouvrez le détail de la livraison.
2. Cliquez Rejouer cette livraison.

Le rejeu crée une nouvelle livraison : l'originale n'est pas modifiée, et les compteurs de santé ne changent pas rétroactivement.

Pour traiter un lot d'un coup, le bouton Rejouer les N abandons relance toutes les livraisons abandonnées correspondant aux filtres. Le récapitulatif indique combien ont été rejouées, combien n'ont pas pu l'être et pourquoi, et combien restent dans la file — relancez alors le rejeu pour les traiter.

Pourquoi une livraison ne peut-elle pas être rejouée ? #

Le message vous donne la raison :

• Le détail a expiré — passé 30 jours, il n'y a plus de corps à réémettre.
• Livraison encore en cours — le moteur va la retenter tout seul, n'intervenez pas.
• Livraison déjà réussie — la rejouer créerait un doublon chez votre destinataire.
• L'intégration a été supprimée — il n'y a plus de configuration à appliquer.
• L'intégration est coupée — réactivez-la avant de rejouer.
• Le journal est saturé — réessayez dans un instant.

Comment exporter le journal des livraisons ? #

Deux exports, au choix, depuis le menu du journal :

• Exporter (CSV) — les codes et les mesures : horodatage, déclencheur, état, code de réponse, latence, tentatives.
• Exporter avec les corps — le même fichier, augmenté du contenu des requêtes et des réponses. Ce fichier contient de la donnée client : traitez-le en conséquence.

L'export porte le nom donné par le serveur, pas un nom reconstitué par votre navigateur. Il respecte les filtres appliqués au moment du clic.

Quelques garde-fous utiles :

• Si aucune livraison ne correspond aux filtres, l'entrée Exporter est désactivée (« Rien à exporter ») : vous n'obtenez pas un fichier vide annoncé comme réussi.
• Un export trop volumineux est tronqué, et le message vous dit à combien de lignes : affinez la période ou les filtres pour tout obtenir.
• Les exports sont limités en fréquence ; un compte à rebours vous indique quand le suivant sera disponible.
• Si le téléchargement est interrompu avant la fin, Sphère vous prévient que le fichier obtenu serait incomplet plutôt que de vous le laisser croire valide.