Bietet n8n eine API zum Abrufen von Workflow-Analysen oder Metriken, oder ist eine solche Funktion über den n8n MCP-Server verfügbar?
Hallo @mylearnings_abu
Die n8n Public REST API stellt Ausführungsdaten zur Verfügung, die du programmatisch abfragen kannst. Wichtige Endpunkte sind:
-
GET /api/v1/executions— Ausführungen mit Filtern auflisten (Workflow-ID, Status, Datumsbereich) -
GET /api/v1/executions/{id}— Details einer bestimmten Ausführung abrufen -
GET /api/v1/workflows— Workflows auflisten (zur Querverweisierung von IDs)
Dies ist die primäre Methode, um Ausführungsverlauf zu erfassen und deine eigenen Kennzahlen zu aggregieren (Erfolgs-/Fehlerzahlen, Laufzeiten usw.). Sie ist sowohl in Cloud als auch Self-Hosted verfügbar.
Für Echtzeit-Betriebskennzahlen stellt n8n einen /metrics-Endpunkt bereit, wenn du ihn über Umgebungsvariablen aktivierst:
N8N_METRICS=true
N8N_METRICS_INCLUDE_QUEUE_METRICS=true # für Queue-Modus
Dies liefert Kennzahlen und Zähler wie:
-
n8n_scaling_mode_queue_jobs_active— derzeit ausgeführte Jobs -
n8n_scaling_mode_queue_jobs_completed— insgesamt abgeschlossen seit Start -
n8n_scaling_mode_queue_jobs_failed— insgesamt fehlgeschlagen seit Start
Der /metrics-Endpunkt ist nicht in n8n Cloud verfügbar — nur Self-Hosted.
Für tiefe ausführungsspezifische Tracing unterstützt n8n OpenTelemetry-Spans mit umfangreichen Attributen:
-
n8n.workflow.id,n8n.workflow.name,n8n.execution.status -
n8n.execution.mode(manuell, Webhook, Trigger, Wiederholung) -
n8n.execution.error_typebei Fehlern
Dies speist sich in Observability-Plattformen wie Grafana, Jaeger oder Datadog ein
Die MCP Server Tools Reference enthält ein Tool zum Ausführen eines Workflows nach ID und zum Abrufen der Ausführungs-ID. Der MCP-Server konzentriert sich jedoch auf Workflow-Ausführung und -Verwaltung (Auslösen, Auflisten, Verwalten von Workflows), nicht auf das Abrufen von Analysen oder aggregierten Kennzahlen. Es gibt kein spezielles MCP-Tool zum Abrufen von Ausführungsstatistiken oder Analysedaten.
Du kannst dich auf folgendes zur schnellen Referenz beziehen
Hilft dir das weiter?
Danke für die schnelle Antwort!
Hi @mylearnings_abu
Das integrierte Analytics-Feature von n8n heißt Insights und hat seinen eigenen Endpunkt in der öffentlichen API:
GET /api/v1/insights/summary?startDate=2026-07-01T00:00:00Z&endDate=2026-07-29T00:00:00Z
Es gibt die Gesamtzahl der Produktionsausführungen, die Fehlerzahl, die Fehlerquote, die eingesparte Zeit und die durchschnittliche Laufzeit zurück, jeweils mit einer Abweichung zum vorherigen Zeitraum, plus ein optionaler projectId-Filter. Ein Scoped API-Schlüssel benötigt insights:read. Es werden nur Produktionsausführungen von übergeordneten Workflows gezählt, daher werden manuelle Ausführungen und Subworkflow-Ausführungen aus diesen Zahlen ausgeschlossen.
Danke @Anshul_Namdev, dass du das geteilt hast. Haben wir einen Endpunkt pro Workflow-Basis?
@Anshul_Namdev Ich kann diesen Umfang in meinem aktuellen gehosteten n8n-Setup nicht finden.
@mylearnings_abu Kein Pro-Workflow-Endpunkt auf der öffentlichen API, /insights/summary ist die einzige Insights-Route und projectId ist sein einziger Filter. Pro-Workflow-Zahlen existieren in der Insights-Dashboard-Tabelle, nicht über die API.
Bei dem Scope wurde insights:read in 2.16 und der Summary-Endpunkt in 2.17 ausgeliefert, daher werden diese Elemente auf Instanzen, die älter als diese Version sind, nicht angezeigt, wenn du einen API-Schlüssel erstellst. Ein Upgrade bringt dir beides, die aktuelle stabile Version ist 2.32.6.
Da du self-hosted betreibst, gibt dir der Prometheus-Endpunkt heute Pro-Workflow-Zahlen mit eingeschaltetem Workflow-ID-Label:
N8N_METRICS=true
N8N_METRICS_INCLUDE_MESSAGE_EVENT_BUS_METRICS=true
N8N_METRICS_INCLUDE_WORKFLOW_ID_LABEL=true
Ich verwende n8n Enterprise Edition v2.27.4. Wenn ich versuche, einen API-Schlüssel zu erstellen, sehe ich keine Scopes im Zusammenhang mit Insights
Muss ich noch weitere Konfigurationen vornehmen?
Hallo @mylearnings_abu
1)Aktualisiere bitte zunächst auf die neueste stabile Version von n8n.
2)Falls deine Instanz N8N_DISABLED_MODULES=insights in deiner Umgebung gesetzt hat, wird der Bereich nicht in der Benutzeroberfläche angezeigt, da die Funktion deaktiviert ist.
3)Nur Instanzeigentümer und Administratoren haben Zugriff auf Insights. Überprüfe deine Benutzerrolle unter Einstellungen > Benutzer.
4)Bestätige, dass deine Enterprise-Lizenz ordnungsgemäß aktiviert ist. Gehe zu Einstellungen > Nutzung und Plan, um dies zu überprüfen.
Hilft dir das weiter?
@mylearnings_abu 2.27.4 wird bereits mit dem Scope ausgeliefert, es geht also eher um die Lizenzfreigabe als um den Build. Der Scope-Picker bietet insights:read nur an, wenn die Lizenz der Instanz das Enterprise-Insights-Feature trägt, und ein Enterprise-Schlüssel ohne diese Berechtigung wird es überhaupt nicht auflisten. Überprüfe, was deiner tatsächlich gewährt:
docker exec -u node -it <your-n8n-container-name> n8n license:info
Lasse den docker exec-Teil weg, wenn du mit npm installiert hast. Falls insights nicht in den Berechtigungen aufgelistet ist, die es ausgibt, muss der Schlüssel für deinen Plan neu ausgestellt werden, support@n8n.io kann das tun.