阈值的作用

阈值把数值区间映射成颜色，让数值偏离预期时在看板上一眼可见；阈值线则把关键分界画在图上，便于判断当前值距离边界还有多远。两者只影响展示、不产生通知，是看板表达判断标准的方式。

档位与基准色

阈值按档位定义，从基准色开始逐级提升，每一档给出触发该颜色的起始数值。配置时要留意第一档承担基准色的特殊角色，也要注意不同面板类型对阈值的支持程度不同，趋势面板与单值面板的表现并不一致。

基本信息

典型使用场景

• 容量水位：按百分比分档，快速识别接近上限的资源
• 延迟对比：在关键阈值处标线，判断是否接近目标
• 错误率展示：分档着色，异常区间一眼可见
• 单值面板：用颜色表达当前状态是否越界
• 口径评审：阈值线让判定标准可视化，便于与业务方对齐

阈值配置片段

"fieldConfig": {
  "defaults": {
    "thresholds": {
      "mode": "absolute",
      "steps": [
        {"color": "green", "value": null},   # 基准档
        {"color": "orange", "value": 80},    # 达到 80 变色
        {"color": "red", "value": 90}
      ]
    },
    "custom": {"thresholdsStyle": {"mode": "dashed"}}
  }
}

阈值与展示方式

配置约定

• 阈值与告警共用一套判定口径，先在文档写清再分别落地
• 颜色档位不宜过多，三四档足以表达正常、注意与异常
• 改阈值时同步检查依赖它的告警规则，避免两边漂移