Legend 是指 PromQL 查询结果中展示的指标名称或者图例。在可视化工具如 Grafana 中,通常可以通过设置 Legend 来美化展示效果,使得图表更加易读易懂。
Legend 的内容可以是查询语句中的某个标签值、某个指标的单位、某个操作的别名等等,也可以是自定义的字符串。
例如,下面是一条典型的查询语句:
sum(rate(http_requests_total{status="200", app="myapp"}[5m])) by (instance)
其中 sum(rate(http_requests_total{status=“200”, app=“myapp”}[5m])) 是计算指标值的部分,by (instance) 则表示按 instance 标签分组计算。
这条查询语句返回的结果可能包含多个 instance 的数据,可以通过设置 Legend 显示每个 instance 对应的具体值,例如:
sum(rate(http_requests_total{status="200", app="myapp"}[5m])) by (instance) -> {{instance}}
这样 Legend 就会显示每个 instance 的具体值,方便读者理解和解读查询结果。