n8n fournit-il une API pour récupérer les analyses ou les métriques de workflow, ou existe-t-il une telle fonctionnalité disponible via le serveur MCP de n8n ?
Salut @mylearnings_abu
L’API REST publique n8n expose les données d’exécution que vous pouvez interroger par programmation. Les points de terminaison clés incluent :
-
GET /api/v1/executions— lister les exécutions avec filtres (ID de workflow, statut, plage de dates) -
GET /api/v1/executions/{id}— obtenir les détails d’une exécution spécifique -
GET /api/v1/workflows— lister les workflows (pour faire référence aux IDs)
C’est le moyen principal de récupérer l’historique d’exécution et d’agréger vos propres métriques (comptages de succès/échecs, durées d’exécution, etc.). Elle est disponible à la fois sur Cloud et auto-hébergée.
Pour les métriques opérationnelles en temps réel, n8n expose un point de terminaison /metrics lorsque vous l’activez via des variables d’environnement :
N8N_METRICS=true
N8N_METRICS_INCLUDE_QUEUE_METRICS=true # pour le mode file d'attente
Ceci fournit des jauges et des compteurs comme :
-
n8n_scaling_mode_queue_jobs_active— tâches en cours d’exécution -
n8n_scaling_mode_queue_jobs_completed— total complété depuis le démarrage -
n8n_scaling_mode_queue_jobs_failed— total échoué depuis le démarrage
Le point de terminaison /metrics n’est pas disponible sur n8n Cloud — auto-hébergée uniquement.
Pour un suivi approfondi par exécution, n8n supporte les spans OpenTelemetry, qui incluent des attributs riches :
-
n8n.workflow.id,n8n.workflow.name,n8n.execution.status -
n8n.execution.mode(manual, webhook, trigger, retry) -
n8n.execution.error_typeen cas d’échec
Cela s’intègre aux plateformes d’observabilité comme Grafana, Jaeger ou Datadog
La référence des outils du serveur MCP inclut un outil pour exécuter un workflow par ID et récupérer l’ID d’exécution. Cependant, le serveur MCP est axé sur l’exécution et la gestion des workflows (déclenchement, listage, gestion des workflows), et non sur l’extraction d’analyses ou de métriques agrégées. Il n’existe pas d’outil MCP dédié pour récupérer les statistiques d’exécution ou les données d’analyse.
Vous pouvez vous référer à ce qui suit pour une référence rapide
Ça vous aide ?
Merci pour la réponse rapide !
Bonjour @mylearnings_abu
La fonctionnalité d’analyse intégrée de n8n s’appelle Insights, et elle dispose de son propre endpoint sur l’API publique :
GET /api/v1/insights/summary?startDate=2026-07-01T00:00:00Z&endDate=2026-07-29T00:00:00Z
Elle retourne le nombre total d’exécutions en production, le nombre d’échecs, le taux d’échec, le temps économisé et la durée moyenne d’exécution, chacun avec un écart par rapport à la période précédente, plus un filtre projectId optionnel. Une clé API scoped nécessite insights:read. Seules les exécutions en production des workflows parents sont comptées, donc les exécutions manuelles et les exécutions de sous-workflows sont exclues de ces chiffres.
Merci @Anshul_Namdev de partager ceci. Avons-nous un endpoint par workflow ?
@Anshul_Namdev je ne trouve pas cette portée dans ma configuration n8n hébergée actuelle.
@mylearnings_abu Pas de point de terminaison par workflow sur l’API publique, /insights/summary est la seule route insights et projectId est son seul filtre. Les chiffres par workflow existent dans le tableau du tableau de bord Insights, pas via l’API.
Sur la portée, insights:read a été lancé dans la version 2.16 et le point de terminaison summary dans la version 2.17, donc toute instance plus ancienne que cela ne le listera pas quand vous créez une clé API. La mise à niveau vous donne les deux, la version stable actuelle est 2.32.6.
Comme vous êtes auto-hébergé, le point de terminaison Prometheus vous donne les chiffres par workflow dès maintenant, avec l’étiquette d’ID de workflow activée :
N8N_METRICS=true
N8N_METRICS_INCLUDE_MESSAGE_EVENT_BUS_METRICS=true
N8N_METRICS_INCLUDE_WORKFLOW_ID_LABEL=true
J’utilise la n8n Enterprise Edition v2.27.4. Quand j’essaie de créer une clé API, je ne vois aucun scope lié à Insights
Y a-t-il une configuration supplémentaire à effectuer ?
Salut @mylearnings_abu
1)D’abord, mets à jour vers la dernière version stable de n8n.
2)Si ton instance a N8N_DISABLED_MODULES=insights défini dans ton environnement, la portée n’apparaîtra pas dans l’interface utilisateur puisque la fonctionnalité est désactivée.
3)Seuls les propriétaires d’instance et les administrateurs ont accès à Insights. Vérifie ton rôle utilisateur sous Paramètres > Utilisateurs.
4)Confirme que ta licence Enterprise est correctement activée. Va à Paramètres > Utilisation et Plan pour vérifier.
Ça t’aide ?
@mylearnings_abu 2.27.4 est déjà livré avec la portée, il s’agit donc plutôt d’un droit de licence que d’une construction. Le sélecteur de portée ne propose insights:read que lorsque la licence de l’instance comporte la fonctionnalité Enterprise insights, et une clé Enterprise émise sans ce droit ne l’affichera pas du tout. Vérifiez ce que la vôtre accorde réellement :
docker exec -u node -it <your-n8n-container-name> n8n license:info
Omettez la partie docker exec si vous avez installé avec npm. Si insights ne figure pas dans les droits affichés, la clé doit être réémise selon votre plan, support@n8n.io peut le faire.