n8n Monitor 技能

通过基于 Webhook 的 API 监控您自托管的 n8n 实例。获取健康报告、检测失败的工作流，并利用 n8n 执行过程中输出的结构化数据进行错误调试。

快速工作流

1. 调用 Webhook，请求体为 {"action": "get_workflow_executions", "limit": 50}，以获取整体健康概览
2. 检查 summary.failureRate 判断状态：GREEN（<10%）、YELLOW（10–25%）、RED（>25%）
3. 若存在失败情况，查看 workflowPerformance.topProblematicWorkflows，定位问题最严重的工作流
4. 如需深度调试，调用 {"action": "get_execution_details", "limit": 5, "workflow_id": ""}，获取错误信息及失败节点详情

可用端点

所有端点均为向 N8N_WEBHOOK_URL 环境变量所指定 URL 发起的 POST 请求。

get_active_workflows

返回所有启用中的工作流，包含其 ID、名称和元数据。

{"action": "get_active_workflows"}

get_workflow_executions

返回最近执行记录，并附带计算得出的关键性能指标（KPI）：失败率、耗时统计、各工作流性能表现、告警信息。

{"action": "get_workflow_executions", "limit": 50}

关键响应字段：

• summary.totalExecutions、summary.failureRate、summary.successRate
• timing.averageExecutionTime、timing.minExecutionTime、timing.maxExecutionTime
• workflowPerformance.topProblematicWorkflows（按失败率降序排列）
• alerts.highFailureRate（布尔值）、alerts.workflowsNeedingAttention（列表）

get_execution_details

返回指定工作流的详细错误数据：错误消息、失败节点名称与类型、时间戳等。

{"action": "get_execution_details", "limit": 5, "workflow_id": ""}

健康阈值

通知模板

单行摘要

n8n  | failure % ( exec) | 

快速状态（适用于 cron/心跳检测）

n8n monitor ( UTC) ->  

热点问题：
  - "" ( node)

完整报告

组合调用全部三个端点，构建全面视图：

1. 启用中工作流汇总（数量、分类）
2. 含 KPI 的健康状态（失败率、耗时、执行模式）
3. 热点问题表格（各工作流失败率）
4. 关键工作流的错误详情
5. 告警信息与推荐操作

推荐的监控模式

自动化 Cron 监控

• 每 30 分钟运行一次监控脚本，调用 get_workflow_executions
• 将健康状态记录到日志文件
• 使用心跳机制（例如每小时 :32 分）读取日志，仅当状态为 YELLOW 或 RED 时发送告警
• 状态为 GREEN 时保持静默

按需调试

• 调用 get_workflow_executions 识别哪些工作流正在失败
• 记录对应工作流 ID
• 使用该 ID 调用 get_execution_details，分析错误模式与失败节点信息

告警去重

• 对每个告警载荷生成哈希值
• 仅在哈希值发生变化时触发通知（即出现新错误或状态变更）
• 避免同一错误持续存在时产生冗余通知

环境配置

• N8N_WEBHOOK_URL：您的 n8n Webhook 终端地址（必需）
• Webhook 超时时间：30 秒（对于大规模实例，请使用更小的 limit 值）

效果良好的提示语示例

• “检查我的 n8n 实例健康状况”
• “哪些工作流正在失败？”
• “调试工作流 中的错误”
• “为最近 100 次执行生成健康报告”
• “我的数据处理工作流失败原因是什么？”

常见故障模式

• Webhook 超时：减小 limit 参数值
• 授权错误：检查 Webhook 工作流中配置的 n8n API 凭据
• 返回空结果：确认 Webhook 工作流已启用，且 URL 配置正确