核心功能
n8n-monitor 是一套面向 Docker 部署环境的轻量级运维监控方案，专为 N8N 工作流自动化平台设计。通过组合标准 Docker CLI 命令，实现对容器生命周期、运行日志、健康状态及资源占用的多维度监控。
显著优点
1. 零依赖侵入：无需在 N8N 容器内安装额外代理，纯宿主机侧操作
2. 即时可用：利用 Docker 原生能力，响应延迟极低
3. 输出友好：Markdown 表格格式化，便于集成到通知渠道或工单系统
4. 权限最小化：仅需 Docker 组权限，无需 root 或数据库访问
潜在局限
- 单节点视角：无法跨 Docker Swarm/Kubernetes 集群聚合状态
- 无历史数据：基于实时
docker stats和--tail日志，缺乏时序趋势分析 - 被动监控：仅支持手动或定时触发，无自动告警机制
- 日志深度受限：
--tail 50可能遗漏关键故障线索
适用人群
- 自托管 N8N 的个人开发者与中小型团队
- 需要快速排障但无意部署完整 APM 栈（如 Prometheus+Grafana）的场景
- CI/CD 流水线中集成轻量级健康检查的 DevOps 工程师
常规风险
| 风险项 | 说明 | 缓解建议 |
|--------|------|----------|
| 敏感日志泄露 | `docker logs` 可能捕获工作流中的 API 密钥或 PII | 配置日志脱敏或限制查看权限 |
| 资源竞争 | 高频 `docker stats` 在大规模宿主机上产生额外负载 | 设置合理采样间隔（>10s） |
| 误判健康状态 | `Health.Status` 依赖容器内 `HEALTHCHECK` 定义，可能与应用实际可用性脱节 | 结合业务层探针（如 N8N `/healthz` 端点）交叉验证 |