态势图上的每个格子代表一个节点,颜色代表状态。这篇文档解释四种状态的含义和判定条件。
四种状态
健康。 心跳正常、算力正常、没有异常信号。这是你希望占多数的状态。
关注。 节点还在工作,但有指标偏离了正常范围。比如算力比平时低、端口探测失败、磁盘空间紧张。这类情况不紧急,但值得看一眼。
异常。 节点在线,但存在问题。比如区块高度停止推进、算力掉到零、关键服务未运行。这需要处理。
离线。 超过 3 分钟没有收到心跳。节点可能真的断了,也可能是网络问题。
判定逻辑
状态不是只看单一指标,而是综合判断。
离线判定基于心跳。心跳间隔默认 30 秒,超过 3 分钟没有心跳就判离线。这个阈值是为了过滤网络抖动——偶发的一两次丢包不会触发告警。
异常判定基于多个信号:
- 区块高度超过一定时间没有变化(说明节点没有同步)
- 算力为零但节点在线(说明没在挖)
- 关键进程不在运行
关注判定是软性的:指标还在合理范围内,但趋势不对。比如算力缓慢下降、内存占用持续上升。
告警什么时候触发
不是每次状态变化都发告警。规则是:
- 从健康变成异常或离线——发告警。
- 从异常或离线恢复成健康——发恢复通知。
- 在异常状态持续期间——不发重复告警,但事件会持续记录时长。
这样做是为了避免告警轰炸。一个节点半夜挂掉,你只会收到一条"离线"和(修好后)一条"恢复",而不是每隔几分钟一条。
收到告警后先做什么
先看事件详情。 点事件能看到影响范围、开始时间、持续时长,以及导致判定的具体原因。
确认是真的还是误判。 有时候是网络波动、有时候是采集端出了问题。事件详情里的其他指标可以帮你区分——比如心跳断了但区块高度还在涨,说明节点在跑,只是上报通道有问题。
按情况处置。
- 采集端问题:重启客户端服务。
- 节点进程问题:连远程桌面看日志。
- 网络问题:检查节点的出站连接。
关于"关注"这个状态
很多人会问:为什么要有"关注",不能只有正常和异常两档?
因为运维的现实是灰色的。一个算力下降 10% 的节点,你说它异常吗?不至于。你说它正常吗?也不对。如果把所有"不太对劲"都算成异常,告警会泛滥,人就麻木了。
"关注"这个档位的价值在于:它提醒你去看一眼,但不要求你立刻行动。看完之后你可以判断"这是正常波动"或者"这个趋势要盯着"。
状态能保留多久
节点数据的保留期默认 30 天(可通过后台配置调整)。事件记录保留更久,因为它们是状态变化的历史,数据量小得多。
超过保留期的原始采样会被归档和降采样,趋势图仍然能看出走势,但精度会降低。
一些小细节
- 态势图上的格子颜色是实时更新的,刷新间隔 30 秒。
- 鼠标悬停在格子上能看到该节点的简要信息。
- 节点数少于 100 时,态势图会切换成列表视图——格子太少反而不好看。
—— Pi Admin X 团队
