首页/云/可观测性速查/图例格式化:让序列名可读
Grafana 与看板53 条

图例格式化:让序列名可读

Legend format 用标签模板给序列起人名:{{job}} - {{instance}} 比整串指标名可读得多;Table 图例还能附加统计列辅助扫读。

可观测性速查云更新于 2026-10-13

图例格式化是什么

Legend format 是面板里的图例模板:用双花括号引用序列标签,给每条曲线起一个可读的名字。默认图例往往是完整的指标名加一整串标签,既长又难扫读;把它改成「对象 + 维度」的短名称,看图速度会明显提升。除了图例,标题、单位说明以及面板变量都能复用同一套模板语法。

基本信息

适用范围时间序列、表格等面板的查询选项
模板语法{{标签名}} 引用序列标签,也可引用面板变量
命名建议对象(谁)+ 维度(哪类)+ 关键标签
图例模式列表、表格、隐藏等几种展示方式

典型使用场景

  • 多实例对比:图例显示实例名,一眼看出异常节点
  • 多接口对比:按方法与状态码组合命名曲线
  • 环境区分:图例带环境变量,避免跨环境看错曲线
  • 表格模式扫读:开启图例统计值,快速找出最大与平均
  • 看板整洁:隐藏无意义序列名,减少视觉噪音

写法示例

写法示例
# 指标:http_requests_total{job="api",method="GET",status="500"}
# Legend format 写:
{{method}} {{status}}                 # 输出 GET 500

# 带实例区分
{{instance}} {{method}}

# 混合面板变量:$env 来自看板变量
{{job}} @ $env

# 图例模式:Table 模式会附加 Max / Avg 等统计列
# 图例过长时只保留 2 到 3 个关键标签,其余隐去

常见写法与效果

写法图例显示适用情况
{{method}} {{status}}GET 500接口与状态码对比
{{instance}}10.0.1.12:9100多实例资源对照
{{job}} @ $envapi @ prod跨环境同名指标
{{le}}0.5直方图桶序列辨识
(留空)完整指标名临时排查时保留原始信息
占位符写错标签名时图例显示为空字符串,曲线变成一条没有名字的线;先在 Explore 里确认标签名,再回填到面板。
图例太长会挤压绘图区:需要保留的信息用两三个标签表达,其余细节放进工具提示或变量里,图上只留能区分曲线的部分。

易错点

  • 占位符标签名写错时图例为空,排查时先确认标签名再判断是否是数据问题
  • 图例堆叠过多标签会遮挡绘图区,实际可视面积明显减少
  • 只看图例不看查询条件容易误读:同一个名字可能来自不同数据源或不同聚合口径
  • 表格模式图例不设置统计列时,扫读效率反而低于折线图,按需要选择模式

数据来源与参考

  • Grafana 官方文档 · Legend 配置
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌