可观测性与稳定性 / 系统课时

by 和 without 有什么区别

by 和 without 有什么区别

PromQL 聚合不仅是在算总和或平均值,还决定结果里保留哪些标签。by 和 without 都用于控制聚合维度,但思路相反:前者明确保留,后者明确删除。选对它们,才能得到适合 Grafana 展示和告警匹配的时间序列。

学习目标

  • 理解 by 与 without 对结果标签的影响
  • 能按实例、服务等维度编写聚合查询
  • 能判断什么时候应显式保留标签,什么时候应排除标签

by 是白名单式保留

by 表示“只按这些标签分组”。没有写进 by (...) 的普通标签会在聚合结果中被丢弃,因此它适合你已经明确知道最终结果需要哪些维度的场景。Prometheus 的聚合运算符可以在表达式前后使用 by 或 without 子句。([普罗米修斯][1])

例如,Node Exporter 的网络接收指标通常按主机和网卡产生多条序列。下面的查询先计算每块网卡每秒接收字节数,再按 instance 汇总,得到每台主机一条结果:

text
sum by (instance) (
  rate(node_network_receive_bytes_total[5m])
)

预期结果

text
{instance="<HOST>:<PORT>"} <BYTES_PER_SECOND>

实际主机、端口和数值会不同。关键是聚合后只保留 instance 这一业务维度,网卡等其他标签不再出现在结果中。

without 是黑名单式删除

without 表示“聚合时去掉这些标签,其余标签继续保留”。官方定义正好与 by 相反:without 删除列出的标签,而 by 丢弃未列出的标签。([普罗米修斯][1])

如果只是想把不同网卡合并,但希望保留当前指标上的其他上下文,可以写:

text
sum without (device) (
  rate(node_network_receive_bytes_total[5m])
)

预期结果

text
{instance="<HOST>:<PORT>", job="<JOB>"} <BYTES_PER_SECOND>

这里明确删除 device,而 instance、job 以及输入序列上其他未被删除的标签仍可能保留。因此,当抓取配置以后新增了额外标签时,without 的结果维度也可能随之增加。

两种写法怎样选择

需求 更适合的写法 原因
Grafana 面板只需要每台主机一条线 by (instance) 输出标签集合明确、稳定
告警只关心服务和实例 by (job, instance) 避免无关标签参与告警分组
只想消掉一个高基数维度 without (pod) 其他上下文标签自动保留
未来标签可能变化,但都希望保留 without (...) 不必逐个列出保留项

两种写法有时会得到相同数值,但不代表语义相同。只有当“by 列出的标签集合”恰好等于“原标签集合减去 without 删除的标签”时,输出标签才一致。

告警场景更看重标签稳定性

聚合结果会继续参与比较、向量匹配、Grafana 图例和 Alertmanager 路由,因此标签集合本身就是查询结果的一部分。面向长期运行的面板或告警规则时,通常优先用 by 明确声明真正需要的业务维度;只有当目标确实是“删除少数技术标签并保留其余上下文”时,再使用 without。

判断时不要只看当前数值是否正确,还要看结果标签是否稳定。一个能算出正确数字、却意外保留 pod、cpu、device 等标签的表达式,仍可能造成图表线条暴增或告警重复。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

by 和 without 有什么区别

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通