可观测性与稳定性 / 系统课时
by 和 without 有什么区别
by 和 without 有什么区别
PromQL 聚合不仅是在算总和或平均值,还决定结果里保留哪些标签。by 和 without 都用于控制聚合维度,但思路相反:前者明确保留,后者明确删除。选对它们,才能得到适合 Grafana 展示和告警匹配的时间序列。
学习目标
- 理解
by与without对结果标签的影响 - 能按实例、服务等维度编写聚合查询
- 能判断什么时候应显式保留标签,什么时候应排除标签
by 是白名单式保留
by 表示“只按这些标签分组”。没有写进 by (...) 的普通标签会在聚合结果中被丢弃,因此它适合你已经明确知道最终结果需要哪些维度的场景。Prometheus 的聚合运算符可以在表达式前后使用 by 或 without 子句。([普罗米修斯][1])
例如,Node Exporter 的网络接收指标通常按主机和网卡产生多条序列。下面的查询先计算每块网卡每秒接收字节数,再按 instance 汇总,得到每台主机一条结果:
sum by (instance) (
rate(node_network_receive_bytes_total[5m])
)预期结果
{instance="<HOST>:<PORT>"} <BYTES_PER_SECOND>实际主机、端口和数值会不同。关键是聚合后只保留 instance 这一业务维度,网卡等其他标签不再出现在结果中。
without 是黑名单式删除
without 表示“聚合时去掉这些标签,其余标签继续保留”。官方定义正好与 by 相反:without 删除列出的标签,而 by 丢弃未列出的标签。([普罗米修斯][1])
如果只是想把不同网卡合并,但希望保留当前指标上的其他上下文,可以写:
sum without (device) (
rate(node_network_receive_bytes_total[5m])
)预期结果
{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 等标签的表达式,仍可能造成图表线条暴增或告警重复。