Grafana状态历史面板使用教程：展示服务可用性

Grafana虽然没有直接名为“状态历史面板”的组件，但可以通过State Timeline面板、Time series+Value Mappings，以及叠加统计信息这三种方式来实现服务可用性展示：一是使用State Timeline直观呈现布尔值或枚举值的状态变化；二是借助Time series退化成色块效果来模拟状态历史条；三是配合Stat和Table面板，对可用率和状态变更记录进行量化分析。

Grafana 实际上并不存在一个官方原生、名称就叫“状态历史面板”的面板类型。日常所说的“Grafana状态历史面板”，大多数情况下指的是 State Timeline 面板（状态时间线），或者通过 Time series + Value Mappings + Thresholds 这套配置组合，来展示服务可用性的历史状态变化。它解决的核心需求很明确：将离散的健康状态，例如 1/0、up/down、healthy/unhealthy，沿时间轴清晰地可视化出来，让服务在某一时间段内的可用性波动、故障持续区间和恢复过程都能被快速识别。

下面按三种常见且实用的方式进行说明：

一、用 State Timeline 面板直接展示状态变化
这是最接近“状态历史”展示需求的 Grafana 原生方案（Grafana v9.0+ 默认支持）：

• 适用场景：服务探针返回布尔型或枚举型指标（如 probe_success{job="hunyuan-ocr"} = 1 表示正常存活，0 表示探测失败）
• 操作步骤：
  • 新建面板 → 选择 State Timeline 类型
  • 编写 PromQL 查询，确保只返回单条时间序列（如 probe_success{job="hunyuan-ocr", instance=~"ocr-prod-.*"}）
  • 在 Field options 中启用 Map numeric values，设置：
    • 0 → "Down"（红色）
    • 1 → "Up"（绿色）
  • 可按需开启 Show legend 和 Fill gaps，让中断区间连续显示，方便判断宕机持续时长

二、用 Time series 面板 + Value Mappings 模拟状态历史
这种方式兼容较旧版本的 Grafana，同时配置灵活度更高：

• 查询返回带时间戳的状态值（例如 up{job="nginx"} or vector(1)）
• 在面板选项中：
  • 设置 Stat 为 None（关闭聚合）
  • 开启 Value mappings：
    • 0 → ❌ Down
    • 1 → ✅ Up
  • 关闭 Show value，仅保留图例与颜色标识
• 最终效果：折线图会退化成一段段垂直色块，横轴表示时间，纵轴数值本身没有实际意义，视觉上更像连续的“状态条”或“状态历史图”

三、叠加统计信息强化可用性解读
仅看状态颜色还不够，通常还需要通过数据指标来量化服务可用性：

• 在同一仪表盘中增加一个 Stat 面板，计算最近 1 小时可用率：

  100 * a vg_over_time(probe_success{job="hunyuan-ocr"}[1h])

  单位设置为 %，并通过阈值标红（例如 <99.5%）

• 再增加一个 Table 面板，列出最近 5 次状态变更：

  probe_success unless probe_success offset 30s

  配合 Sort by time descending，可以快速定位最近一次宕机的开始与恢复时间

需要特别注意的是，所有状态类监控指标最好都由被监控服务主动暴露，例如 Prometheus Exporter 的 /probe 端点；或者由 Blackbox Exporter 通过主动探测生成状态数据。像 absent()、count() 这类推断式写法，一般不建议直接作为服务状态判断依据。原因也很直接：它们本质上表达的是“没有采集到数据”，而不是严格意义上的“服务不可用”，如果直接用于可用性监控，误判概率往往会更高。

从本质上看，服务可用性监控不是单纯比较数值大小，而是在判断“服务是否仍在持续响应”。State Timeline 能把每一次心跳、每一次中断都转换成可视化时间刻度，让运维人员快速看清：服务刚刚中断了 47 秒，现在是否已经恢复稳定。