Intégration n8n
Superviser n8n sans confondre exécution et résultat.
Connexion d’instance, synchronisation des workflows, historique d’exécution et heartbeat répondent à des questions différentes. Cette page définit le périmètre de chacune.
- Auteur
- Datvero
- Mise à jour
- Méthode
- Produit + documentation primaire
Réponse directe
Réponse directe
Datvero peut connecter une instance n8n par URL et clé API, synchroniser ses workflows et observer leur état. Un heartbeat Datvero peut compléter cette vue pour détecter une exécution attendue qui ne se manifeste pas. Aucun de ces signaux ne prouve à lui seul que le résultat métier est correct.
La connexion API établit l’inventaire observable
La connexion Datvero demande un nom d’instance, son URL de base et une clé API. Le serveur vérifie que la connexion répond avant de créer l’instance, chiffre la clé avant stockage et ne la renvoie pas dans les réponses de consultation. La clé reste néanmoins un secret : son périmètre et sa rotation doivent être gérés côté n8n.
La synchronisation transforme les workflows accessibles en objets suivis par Datvero. Elle permet de centraliser plusieurs instances sans modifier le comportement d’exécution des workflows. Une erreur de synchronisation décrit un problème de visibilité ou d’accès ; elle ne signifie pas automatiquement que n8n a cessé d’exécuter ses tâches.
- Utiliser une URL HTTPS et une clé dédiée lorsque n8n le permet.
- Limiter les autorisations au périmètre nécessaire et documenter le propriétaire de la clé.
- Traiter une synchronisation ancienne ou en erreur comme une perte de visibilité.
Trois signaux, trois questions
L’historique n8n indique qu’une exécution existe et expose son état selon les données conservées par l’instance. Un heartbeat est un événement explicite envoyé par le workflow à Datvero. Une règle d’attente compare enfin le dernier signal reçu avec une cadence configurée. Superposer ces signaux réduit les angles morts, mais ne les rend pas équivalents.
Une exécution en succès peut produire zéro donnée, écrire dans la mauvaise destination ou ignorer une branche utile. À l’inverse, un heartbeat manquant peut venir d’une cadence mal configurée. Les automatisations critiques devraient donc ajouter une validation métier près de leur sortie, par exemple vérifier la présence d’un identifiant créé ou le nombre d’objets réellement transmis.
- Exécution : le moteur a enregistré un run et son état technique.
- Heartbeat : le workflow a atteint le point instrumenté.
- Validation métier : la conséquence attendue existe dans le système cible.
Construire une alerte exploitable
Une alerte utile identifie le workflow, le dernier succès connu, le signal absent ou en erreur et l’heure attendue. Elle évite de conclure prématurément à une cause. La première décision est de déterminer si le workflow n’a pas démarré, a échoué, a terminé sans produire l’effet attendu ou si Datvero a simplement perdu l’accès aux données.
Datvero peut regrouper les événements dans un incident et permettre l’acquittement puis la résolution. La résolution doit correspondre au retour de l’état attendu et non au simple fait qu’une notification a été lue. Pour un événement ayant un impact, conserver une chronologie et une action préventive est plus utile qu’une succession de retries non documentés.
- Dédupliquer les alertes répétées pour un même état sans masquer une aggravation.
- Séparer accusé de réception, mitigation et résolution vérifiée.
- Après correction, contrôler la destination et les données déjà partiellement traitées.
Ce que l’intégration n8n ne garantit pas
La disponibilité de l’API, la rétention des exécutions et les données visibles dépendent de la version, du plan et de la configuration n8n. Datvero ne remplace pas les contrôles natifs de n8n, la sauvegarde de l’instance, la gestion des secrets ni les validations intégrées au workflow.
Datvero n’exécute pas passivement un workflow pour vérifier qu’il fonctionne. Son détecteur de heartbeat observe les signaux reçus ; il n’appelle pas n8n pour provoquer une exécution. Cette séparation évite qu’un outil de supervision modifie involontairement le processus qu’il observe.
- Pas de garantie que succès technique signifie succès métier.
- Pas de récupération automatique universelle : un retry peut dupliquer un effet.
- Pas de certification de disponibilité, de sécurité ou de conformité de l’instance connectée.
Vérifiabilité
Sources primaires et documentation
Les sources externes expliquent les capacités des plateformes ou les pratiques générales. Elles ne certifient ni ne recommandent Datvero.
- n8n public API
Documentation officielle n8n — Authentification, endpoints et limites de l’API publique.
- All executions
Documentation officielle n8n — États, historique et reprise d’une exécution.
- Monitoring
Documentation officielle n8n — Options de monitoring disponibles pour les instances n8n.
FAQ
Questions fréquentes
Datvero exécute-t-il mes workflows n8n ?
La supervision par API et heartbeat est conçue pour observer et synchroniser. Le détecteur de heartbeat ne lance pas les workflows à votre place.
Un workflow n8n “success” est-il forcément correct ?
Non. Ce statut décrit l’exécution technique selon n8n. Une validation métier distincte doit confirmer l’effet attendu dans la destination.
Pourquoi combiner API et heartbeat ?
L’API donne l’inventaire et l’historique disponibles ; le heartbeat peut signaler l’absence d’un passage attendu. Les deux couvrent des modes de panne différents.