图例格式化是什么
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}} @ $env | api @ prod | 跨环境同名指标 |
| {{le}} | 0.5 | 直方图桶序列辨识 |
| (留空) | 完整指标名 | 临时排查时保留原始信息 |
占位符写错标签名时图例显示为空字符串,曲线变成一条没有名字的线;先在 Explore 里确认标签名,再回填到面板。
图例太长会挤压绘图区:需要保留的信息用两三个标签表达,其余细节放进工具提示或变量里,图上只留能区分曲线的部分。