n8n 是否提供任何 API 來取得工作流程分析或指標?或是 n8n MCP 伺服器是否提供此類功能?
n8n 公開 REST API 公開了執行資料,你可以透過程式查詢。主要端點包括:
-
GET /api/v1/executions— 列出執行記錄並支援篩選(工作流程 ID、狀態、日期範圍) -
GET /api/v1/executions/{id}— 取得特定執行的詳細資訊 -
GET /api/v1/workflows— 列出工作流程(用於交叉參考 ID)
這是提取執行歷史記錄並聚合自訂指標(成功/失敗計數、執行時間等)的主要方式。Cloud 版本和自託管版本都可用。
對於即時運營指標,當你透過環境變數啟用時,n8n 會公開 /metrics 端點:
N8N_METRICS=true
N8N_METRICS_INCLUDE_QUEUE_METRICS=true # 用於佇列模式
這提供了如下計量和計數器:
-
n8n_scaling_mode_queue_jobs_active— 目前執行中的工作 -
n8n_scaling_mode_queue_jobs_completed— 啟動以來完成的總數 -
n8n_scaling_mode_queue_jobs_failed— 啟動以來失敗的總數
/metrics 端點在 n8n Cloud 上不可用 — 僅限自託管。
對於深層的個別執行追蹤,n8n 支援OpenTelemetry spans,其中包括豐富的屬性:
-
n8n.workflow.id、n8n.workflow.name、n8n.execution.status -
n8n.execution.mode(手動、webhook、觸發器、重試) -
失敗時的
n8n.execution.error_type
這會輸入到 Grafana、Jaeger 或 Datadog 等可觀測性平台
MCP 伺服器工具參考包含一個工具可按 ID 執行工作流程並取得執行 ID。但是,MCP 伺服器主要專注於工作流程執行和管理(觸發、列出、管理工作流程),而不是提取分析或聚合指標。沒有專用的 MCP 工具來取得執行統計或分析資料。
你可以參考下面的快速參考
這有幫助嗎?
感謝你的迅速回應!
Hi @mylearnings_abu
n8n 的內建分析功能是 Insights,它在公開 API 上有自己的端點:
GET /api/v1/insights/summary?startDate=2026-07-01T00:00:00Z&endDate=2026-07-29T00:00:00Z
它會傳回總生產執行次數、失敗次數、失敗率、節省的時間和平均執行時間,每個指標都與前一個期間的偏差相比較,加上可選的 projectId 篩選條件。限定範圍的 API 金鑰需要 insights:read 權限。只計算來自父工作流程的生產執行,因此手動執行和子工作流程執行會被排除在這些數字之外。
感謝 @Anshul_Namdev 分享這個。我們是否有基於工作流程的端點?
@Anshul_Namdev 我在目前託管的 n8n 設定中找不到此範圍。
@mylearnings_abu 公開 API 上沒有按工作流程的端點,/insights/summary 是唯一的深入解析路由,projectId 是其唯一的篩選器。按工作流程的數字存在於深入解析儀表板表格中,而不是透過 API。
關於範圍,insights:read 在 2.16 中發布,摘要端點在 2.17 中發布,因此任何比該版本更舊的實例在您建立 API 金鑰時都不會列出它。升級可以獲得兩者,目前穩定版本是 2.32.6。
由於您是自託管的,Prometheus 端點今天可以為您提供按工作流程的數字,並開啟工作流程 ID 標籤:
N8N_METRICS=true
N8N_METRICS_INCLUDE_MESSAGE_EVENT_BUS_METRICS=true
N8N_METRICS_INCLUDE_WORKFLOW_ID_LABEL=true
我正在使用 n8n Enterprise Edition v2.27.4。當我嘗試建立 API 金鑰時,看不到任何與 Insights 相關的範圍
是否需要進行任何額外的設定?
1)首先,請更新到最新穩定版本的 n8n。
2)如果你的實例在環境中設定了 N8N_DISABLED_MODULES=insights,由於該功能已關閉,該範圍將不會出現在 UI 中。
3)只有實例擁有者和管理員可以查看「深入分析」。請在 設定 > 使用者 下驗證你的使用者角色。
4)確認你的企業授權已正確啟用。前往 設定 > 使用量與方案 進行驗證。
這有幫助嗎?
@mylearnings_abu 2.27.4 已經包含該範圍,所以這是授權問題而不是構建問題。範圍選擇器只會在實例的授權包含企業洞察功能時提供 insights:read,而沒有該授權的企業密鑰根本不會列出它。檢查你的密鑰實際授予了什麼:
docker exec -u node -it <your-n8n-container-name> n8n license:info
如果你使用 npm 安裝,請忽略 docker exec 部分。如果 insights 不在它列出的授權中,該密鑰需要根據你的計畫重新簽發,support@n8n.io 可以處理這個問題。

