如何在Grafana仪表板中替换变量值以显示更易读标签?
在Grafana中替换变量值为可读性标签的可行方案
完全可以实现,以下是几种常用的实用方案:
1. 变量定义时直接用「值|显示名」格式
如果你的变量是查询型(比如从Prometheus/MySQL等数据源拉取),可以在查询语句里直接返回「原始值|友好显示名」的格式,Grafana会自动拆分,下拉菜单和面板里显示友好名称,实际查询时用原始值。
- 举个Prometheus的例子,查询语句可以这么写:
label_values(job) | map(job, job + "|" + replace(job, "api-v1", "用户API服务(v1)")) - 如果是SQL数据源,直接返回两列数据,第一列是原始值,第二列是显示名称,Grafana会自动关联两者。
2. 用「值映射」统一替换
不想改数据源查询的话,直接用Grafana自带的「值映射」功能:
- 打开变量编辑界面,找到「值映射」选项
- 点击「添加映射」,选「值到文本」,输入原始变量值和对应的友好标签
- 配置完后,所有用到这个变量的面板都会自动显示友好标签,查询逻辑完全不受影响
3. 面板内用模板函数局部替换
如果只是个别面板需要调整,可以用replace()模板函数在标签、图例或标题里手动替换:
- 比如图例里写:
${replace($your_variable, "原始值1", "友好标签1")} - 这种方式灵活,适合只需要局部修改的场景,但要逐个面板配置
内容的提问来源于stack exchange,提问作者Oscar Cervantes
相关产品推荐
相关产品推荐

