Monitor-Gateway

定位与当前状态

Monitor-Gateway 是 Douyy Ops Toolkit 的多节点监控组件。Agent 在被监控主机采集指标并执行服务探针，Gateway 汇聚数据、计算中心规则、发送通知并提供控制台。它适合内网节点集中监测，不是日志中心、APM 或分布式链路追踪平台。

本条目依据 2026-09-08 的 README、入口、路由、存储与通知实现审阅补充，未安装 Agent、发送告警或验证目标环境。当前集成级别为资料收录，在线体验关闭，不承诺生产容量、高可用或通知 SLA。

已核对的能力

• 主机指标与探针：CPU、内存、磁盘、inode、网络等指标，以及 TCP、HTTP、进程和 Docker 服务检查。
• 数据汇聚：Agent 指标与心跳上报，节点、历史、统计和告警查询；支持 Memory、SQLite、MySQL。
• 中心规则：支持 agent_only、gateway_only 和 merge 模式，分别由 Agent、中心或合并规则决定告警。
• 通知治理：钉钉、企业微信、飞书、Slack、SMTP 邮件和通用 Webhook，配套队列、重试、限速及恢复通知。
• 值班视图：Web 控制台、Prometheus 指标和定点或间隔集群报告。
• 管理入口：Token 权限分离、配置热加载、测试通知与报告调度查询。

使用前提

准备网关持久化存储、受控网络、节点身份、分权 Token 与获准通知接收人。Go 1.21+ 可构建当前源码，SQLite 使用纯 Go 驱动。探针范围与 Agent 权限应逐项评估，尤其是 Docker 和主机详细统计；不要默认给所有节点完整管理权限。

建议使用流程

先配置单个 Gateway 和一台试点 Agent，再验证心跳、指标与历史入库；明确告警规则模式后，测试一条可控告警及恢复通知。最后验证报告调度、存储增长和异常情况下的数据缺口，记录结果后才逐批扩大节点范围。

不能做什么与停止条件

采集成功不代表通知送达，HTTP 探针成功也不等于业务事务成功。当前资料不证明多实例高可用、跨网无损补传或自动修复能力。Memory 重启丢数据，非 strict 模式的 SQLite/MySQL 初始化失败会降级为 Memory；生产接入应明确持久化与 storage.strict=true，发现降级时暂停推广。

监听端口、存储、TLS 与队列大小等配置变更需重启，并非全部支持热加载。未完成 Token 分权、访问限制和通知权限确认前，不向公网开放，也不向真实值班群批量测试。

配套文档与场景

• 快速开始：网关与首台 Agent
• 使用指南：规则、通知与报告
• 运行维护：存储、排障与升级
• 项目档案与验证边界
• Linux 主机监控场景
• Prometheus 告警分级与降噪知识

关联内容是监控流程参考，不表示 Gateway 已接管现有 Prometheus 或 Alertmanager。

源码依据与版本说明

可核对 main.go、cmd/agent/main.go、internal/gw/gateway.go、internal/alert/rules.go、internal/notify/channels.go 与 internal/storage/factory.go。根 VERSION 标记为 v2.1.7，仅表示本次审阅的源码版本线索；普通构建未注入版本时显示 dev。未核验公共 release，故正式版本、仓库与下载链接不据此填写。