Value mappings 是什么
Value mappings 把底层数值翻译成业务语言：0 与 1 映射成「已下线」「运行中」，状态码映射成描述，缺失数据显示成「无数据」。它解决的是巡检表里全是数字、接手人要背含义的问题。映射只作用于显示层，排序、阈值与导出仍按原始数值处理，因此它能在不改变数据口径的前提下显著提升表格与状态图的可读性。
基本信息
| 适用平台 | Grafana 8+，位于字段或面板的 Value mappings 设置 |
|---|---|
| 映射类型 | value、range、regex、special |
| 特殊值 | null、NaN、true/false 等 |
| 常见搭配 | Table、Stat、State timeline 面板 |
| 权限要求 | 看板 Editor |
典型使用场景
- 状态可读化：0 与 1 显示为「已下线」「运行中」并配红绿颜色
- 状态码翻译：404 显示为「未找到」，直接看出问题性质
- 空值提示：无数据显示为「无数据」，避免被误读成 0
- 区间分档：把连续数值区间映射成健康、注意、严重三档
- 布尔可读化：布尔字段显示为「已启用」「未启用」
使用要点
- 对缺失数据统一显示「无数据」，是避免误读最有效的一条
- 映射与阈值同时配置时颜色以实际执行顺序为准，效果不符先查两层配置
- 映射不改变原始数据，排序与导出仍按数值，报表评审要注意
- 语义相近的字段尽量复用同一套映射，减少维护成本
- 团队内约定状态词表，避免同一状态在不同看板用不同措辞
映射配置片段
映射配置片段
"mappings": [
{"type": "value", "options": {
"0": {"text": "已下线", "color": "red"},
"1": {"text": "运行中", "color": "green"}}},
{"type": "special", "options":
{"match": "null", "result": {"text": "无数据"}}}
]映射类型对照
| 类型 | 作用 | 典型用法 |
|---|---|---|
| value | 按具体值映射 | 状态码与枚举值 |
| range | 按区间映射 | 健康度分档 |
| regex | 按正则匹配映射 | 路径或命名归类 |
| special | 处理空值等特殊值 | 无数据显示为占位文案 |
| 颜色 | 随映射设置颜色 | 状态类字段 |
对缺失数据统一显示「无数据」可以避免把空值误读成 0，这一点在巡检表与状态看板里尤其重要。