N8n Monitor

核心用法

本技能提供 N8N 自动化工作流平台的 Docker 容器级运维监控能力，主要功能覆盖四个维度：

1. 容器状态检查 (docker ps | grep n8n)
快速定位 N8N 容器运行状态，确认进程存活、端口映射及启动时间等关键信息。

2. 日志实时追踪 (docker logs --tail 50 n8n)
提取最近 50 条日志记录，用于故障排查、执行追溯和异常检测。

3. 健康状态诊断 (docker inspect --format='{{.State.Health.Status}}' n8n)
读取 Docker 健康检查探针返回的状态，识别 starting/healthy/unhealthy 等关键状态。

4. 资源使用监控 (docker stats --no-stream n8n)
获取 CPU、内存、网络 IO 和块设备的实时/快照用量数据。

显著优点

• 零依赖：纯 Docker CLI 实现，无需额外安装监控 Agent
• 即时响应：直接对接容器运行时，延迟极低
• 轻量输出：Markdown 表格化呈现，适合 CLI 和聊天场景阅读
• 精准定位：针对 N8N 单容器场景优化，避免通用监控工具的信息过载

潜在局限

• 单容器视角：无法覆盖 N8N 外部分库（如 Redis/Postgres）或编排层（K8s）健康
• 无历史数据：基于即时命令，缺乏趋势分析和告警阈值机制
• 权限要求：需宿主机 Docker 守护进程访问权限（通常 root 或 docker 组成员）
• 日志截断：固定 50 条 tail 可能遗漏关键上下文

适合人群

• 个人开发者自建 N8N 实例的日常巡检
• 小团队无专业监控体系时的应急排查
• CI/CD 流水线中的部署后健康验证

常规风险

• 权限升级风险：Docker 组等效于 root 访问，共享环境需控制技能调用范围
• 敏感信息泄露：日志可能包含工作流执行数据、API 密钥片段，输出需脱敏
• 误操作边界：当前为只读监控，但若后续扩展需严格限制写操作权限

核心用法

n8n-monitor是一款专用于N8N工作流自动化平台的Docker容器监控技能，提供四类核心运维能力：

| 功能模块 | 命令示例 | 输出说明 |

|---------|---------|---------|

| 容器状态检查 | `docker ps \| grep n8n` | 实时运行状态、端口映射、启动时间 |

| 日志追踪 | `docker logs --tail 50 n8n` | 最近50条应用日志，快速定位异常 |

| 健康诊断 | `docker inspect --format='{{.State.Health.Status}}'` | 容器健康检查状态（healthy/unhealthy） |

| 资源监控 | `docker stats --no-stream n8n` | CPU、内存、网络、磁盘I/O实时指标 |

显著优点

1. 极致轻量化：5文件/41行代码/951字节，零依赖，秒级部署
2. 零攻击面：无第三方依赖、无外部API、无敏感数据收集，供应链风险为零
3. 标准工具链：完全基于Docker原生命令，无需额外学习成本
4. 输出友好：Markdown表格格式，适配自动化报告和通知场景

潜在局限

• 功能单一：仅限监控查询，不含自动化修复或告警触发能力
• 被动运维：需手动执行或配合外部调度器（如crontab）实现定时巡检
• 权限要求：执行环境需具备Docker CLI访问权限
• 无历史数据：不提供趋势分析或长期指标存储

适合人群

• N8N自托管用户（Self-hosted）
• DevOps/SRE运维工程师日常巡检
• 小型团队缺乏专业监控栈（如Prometheus+Grafana）的轻量替代方案
• 需要快速排查容器状态的技术支持人员

常规风险

| 风险类型 | 评估 | 说明 |

|---------|------|------|

| 命令注入 | 极低 | 当前使用固定字符串，无用户输入拼接 |

| 权限滥用 | 低 | 需Docker组权限，建议按最小权限原则配置 |

| 信息泄露 | 无 | 仅读取容器元数据，不涉及敏感业务数据 |

| 运行时故障 | 低 | 依赖本地Docker daemon可用性 |

来源备注：T3级别（个人开发者项目），代码本身经CLS-Certify六维检测满分通过，建议结合GitHub公开仓库和持续维护记录提升信任度。