Apache HertzBeat

Apache HertzBeat是 Apache 软件基金会旗下的开源监控项目，可通过 HTTP、JMX、SSH、SNMP、JDBC、Prometheus 等现有协议采集服务器、数据库、中间件和网络设备。无代理减少了逐机安装组件的工作，但账号、端口、证书、模板和采集频率仍需逐项治理。

先用一类资产打通协议

选择两台非关键且版本相同的目标，例如 MySQL 测试库。创建专用只读账号，只开放采集所需网络方向，再从 HertzBeat 验证地址、端口、认证和 TLS。连接失败时按 DNS、路由、防火墙、证书、账号权限和目标服务状态依次排查，不要先提高账号权限。

监控模板必须核对指标含义

HertzBeat 以监控模板描述协议参数、采集指标和页面展示；自定义类型也可通过 YML 模板生成监控管理、图表和阈值配置。接入后抽查指标名称、单位、标签和采集命令，确认不同软件版本返回字段一致。高频 JDBC 查询、JMX 调用或 SNMP 遍历都可能给目标系统增加负担，应记录单次耗时和失败率。

采集成功不等于监控有效

阈值要对应一个处置动作

官方文档提供实时阈值和周期阈值，后者可通过 PromQL 等表达式计算一段时间的数据；规则还能设置触发次数、告警等级、通知模板和关联监控。CPU 短暂抖动可设置持续次数，磁盘容量更适合趋势或周期判断。每条规则附上负责人、影响范围和操作手册，没有行动价值的阈值不应进入值班通道。

模板变更要有一组回归资产

监控模板新增指标、修改 OID、SQL 或字段映射时，先在不同版本的测试资产回放。对比变更前后的指标数量、单位、空值和采集耗时，确认旧版本不会因新字段全部失败。模板文件、适用版本、维护人和回滚版本一并进入配置库；升级 HertzBeat 后优先运行这组回归，而不是等生产告警消失才发现兼容问题。

用三种故障验收告警闭环

1. 关闭测试目标端口，确认产生不可达告警；
2. 制造可控指标越界，确认等级与持续条件正确；
3. 临时停用一个通知渠道，确认失败可见且备用渠道接管；
4. 恢复目标后，核对恢复事件与持续时间；
5. 检查静默、抑制和分组是否减少重复轰炸。

邮件、钉钉、飞书、Webhook 等通知凭据需单独保管。生产扩容前还要监控 HertzBeat 自身的采集器、存储和通知组件，并为模板变更建立版本记录与回归资产。