Monitor 单机版：快速开始与试点准备

文档状态与适用范围

审阅日期：2026-09-08。本页根据 Monitor 单机版源码整理，main.go:40 标记 v2.1.7，go.mod:3 声明 Go 1.23.12。该标记不是本站验证过的正式 release；没有执行构建、部署或通知测试。本文用于组织非关键主机试点，不代表已具备生产服务保障。集中式节点汇聚、Web 管理和业务自动修复不属于单机版范围。

已实现能力核对

实际入口 main.go:527 加载 JSON 配置，启动指标采集、告警处理和报告调度。main.go:877 采集 CPU、内存、磁盘、负载、IO 等待、网络与 TCP 状态；main.go:1044 提供 TCP、HTTP(S)、进程和 Docker 探针。通知通道包含钉钉、企业微信、飞书和 SMTP 邮箱，但通道是否送达仍需人工确认。

试点准备与权限

选择一台非关键主机，登记系统版本、架构、应用归属、既有监控、维护窗口与退出条件。确认二进制来源、校验记录和对应源码标记，不从未经确认的地址下载安装包。源码构建者需自行准备匹配的 Go 工具链及受控依赖来源；本文不宣称所有打包目标均通过运行验证。

为程序分配专用运行身份和可写日志位置。只授予实际需要的系统读取权限；使用 Docker 探针时先确认 CLI 与守护进程访问策略，不将 Docker 组权限等同于普通只读权限。通知接收组、凭据保管人与凭据轮换计划应在实施前确定，公开记录仅保留脱敏标识。

只读基线与启动准备

先使用系统获准工具记录 CPU、内存、磁盘、进程和现有告警，保存同一时间段的基线。获准制品可以先查看版本；该检查不证明探针或通知工作正常。

./monitor -v

实际监控入口使用 -c 指定 JSON 配置；若文件不存在，源码会创建默认配置，因此启动不应被标记为完全只读。先离线审查配置语法、目标清单、阈值与日志空间，再由负责人在试点中启动；开始时禁用告警和报告输出，完成采集确认后按批准窗口逐项启用。

首次验收清单

• 版本输出与所获制品记录一致，启动读取的是预期配置文件。
• 采集值与系统工具同时间段对照，不能将未知或缺失指标记为正常。
• 每个探针均有目标、协议、超时和预期结果；HTTP 2xx 仅代表状态码满足条件。
• 连续观察资源与日志增长，确定适合本环境的采样周期和保留预算。
• 测试通知和恢复由接收人确认到达，并登记事件、触发和到达时间。

以上为待执行标准，不是本次已完成结果。

常见问题与停止条件

配置解析失败时先核对文件路径、JSON 语法与字段类型，不通过删除配置反复生成默认值。Docker 探针异常应区分 CLI 缺失、权限不足、容器不存在及健康检查失败。出现额外通知、权限扩大、业务资源压力或日志快速增长时立即停止推广，恢复已保存的配置；不要填满磁盘或关闭业务服务制造测试告警。

通知风险与后续阅读

-t 会真实发送测试通知，且退出 0 不代表接收端送达；不能把它加入无通知授权的巡检流程。通知凭据、目标地址及完整日志不应提交到公开文档。后续按配置与探针使用建立覆盖清单，再按运行维护交接；场景方法见Linux 主机监控，产品入口见Monitor 单机版。