在 Prometheus 3.8.0 中可视化目标重打标签规则
2025年12月2日作者 Julius Volz (@juliusv)
Prometheus 的目标重打标签功能允许您调整已发现目标的标签,甚至完全丢弃该目标。重打标签规则虽然功能强大,但可能难以理解和调试。您的规则必须与服务发现机制返回的预期标签相匹配,任何一步出错都可能导致目标标签不正确或被意外丢弃。
为了帮助您找出问题所在(或验证其正确性),Prometheus 3.8.0 刚刚在 Prometheus 服务器的 Web UI 中添加了一个重打标签可视化工具 ,让您可以检查每条重打标签规则是如何应用于已发现目标的标签上的。让我们来看看它是如何工作的!
使用重打标签可视化工具
如果您访问任何 Prometheus 服务器的“Service discovery”(服务发现)页面(例如:https://demo.promlabs.com/service-discovery ),您现在会看到每个已发现目标旁边都有一个新的“show relabeling”(显示重打标签)按钮。

点击此按钮,您将看到每条重打标签规则是如何按顺序应用于该特定目标的。
可视化工具会向您展示:
- 由服务发现机制发现的目标的初始标签。
- 每条重打标签规则的详细信息,包括其操作类型和其他参数。
- 每条重打标签规则应用后,标签的变化情况,其中更改、添加和删除会用颜色高亮显示。
- 在所有重打标签规则应用后,目标最终是被保留还是被丢弃。
- 如果目标被保留,其最终的输出标签。
要调试您的重打标签规则,您现在可以从上到下阅读此图表,找到标签发生意外变化或目标被丢弃的确切步骤。这应该能帮助您更容易地识别重打标签规则中的配置错误。
结论
Prometheus 服务器 Web UI 中新增的重打标签可视化工具是一个强大的工具,可以帮助您理解和调试目标重打标签的配置。通过提供每条重打标签规则如何影响目标标签的逐步视图,它使识别和修复您设置中的问题变得更加容易。立即将您的 Prometheus 服务器更新到 3.8.0 版本来体验一下吧!