通信服务 · 告警陷阱模块（trap-Modules）

服务分类：通信服务 —— 对应统一告警管理域与监控告警通道

模块定位

统一告警服务（trap = 告警捕获/陷阱）：汇总 nfarmsd 自身、nf-agent 代理、 IoT 设备与外部监控的告警，分级处置并推送多渠道（飞书 webhook / SMTP 邮件， 可扩展 SNMP trap 接收）。

功能

• 告警登记：/alerts/report 上报、/alerts/recover 恢复；
• 分级：info / warning / critical（告警模板统一规范见 ../nfos/告警模板统一规范表.md）；
• 推送：飞书 webhook 推送（本机默认关闭，本地配置 [alert] enabled=false 仅写库）；
• 规则驱动：Prometheus 指标（nfarmsd_commands_failed_total 等）触发建议告警；
• 联动：critical 告警自动转工单（ticket 模块）；monitor_noreply@nfarms.cn 邮件通道。

接口要点

GET  /alerts                 告警列表（status 过滤）
POST /alerts/report          上报告警 {rule?, level, message, ...}
POST /alerts/recover         恢复告警

状态与关联

• 已实现：nfarmsd 统一告警框架（飞书推送、禁用态写库）；
• 关联前端：console/（告警）、online/（规则中心告警参数）；
• 关联代理：nf-agent 指标异常触发告警。