Journalisation externe pour chaque lot d'intégration
Chaque lot d'intégration d'Administrate publie désormais un journal d'exécution lisible à Administrate lui-même, permettant aux équipes opérationnelles de vérifier le résultat sans ouvrir n8n.
Le défi
Les intégrations tournent dans n8n, mais les équipes opérationnelles d'Administrate ne devraient pas avoir besoin d'accéder à l'interface n8n pour comprendre si une synchronisation a réussi, quels enregistrements ont été rejetés ou où un problème est survenu. L'historique d'exécution natif ne suffisait pas à donner la bonne visibilité aux utilisateurs métier.
La solution
Nous avons construit un workflow de journalisation externe dédié, appelé après chaque lot écrit dans Administrate. Il transforme les données techniques d'exécution en un journal opérationnel et le publie via l'API GraphQL d'Administrate.
- Capture l'intégration, le système source, le type d'objet, le numéro de lot, le watermark et les totaux d'enregistrements.
- Classe chaque lot en success, warning ou failed selon les enregistrements écrits et rejetés.
- Publie un message concis plus des détails au niveau des enregistrements, y compris les enregistrements rejetés et les raisons.
- Lie les enregistrements écrits avec succès lorsque disponibles et limite les vues détaillées pour les gros lots.
- Utilise une logique de réessai afin qu'une défaillance temporaire de journalisation n'élimine pas silencieusement la visibilité opérationnelle.
Résultats
- Les équipes Administrate peuvent consulter la santé des intégrations depuis leur propre plateforme, sans accès direct à n8n.
- Chaque lot dispose d'un enregistrement auditable des enregistrements écrits, rejetés et totaux.
- Les enregistrements rejetés et les watermarks fournissent le contexte nécessaire pour enquêter rapidement sur les exceptions.
Problèmes d'affaires
- Les opérations dépendaient de l'accès à n8n pour savoir si les intégrations s'étaient terminées correctement
- Les données techniques d'exécution n'étaient pas assez compréhensibles ou disponibles pour les utilisateurs métier
- Les enregistrements rejetés manquaient d'une piste d'audit cohérente et visible par le client
Avantages clés
- Le statut d'intégration est visible dans Administrate sans ouvrir n8n
- Chaque lot enregistre totaux, résultats, watermarks et raisons de rejet
- Les statuts success, warning et failure rendent les exceptions immédiatement compréhensibles
- La publication protégée par réessai garde la piste d'audit fiable
Détails de l'application
- Workflow n8n dédié de 4 nœuds appelé après l'achèvement des lots cibles
- Mutation GraphQL Administrate : createExternalIntegrationLog
- Détails par lot : source, type d'objet, totaux, watermark et résultat par élément
- Détails des gros lots limités à 200 entrées