请参与 Prometheus 用户调研(2026 年 3 月版) ,帮助社区确定未来开发工作的优先级!

可视化 Prometheus 3.8.0 中的目标重标签规则

2025年12月2日作者 Julius Volz (@juliusv)

Prometheus 的 目标重标签 (target relabeling) 功能允许您调整已发现目标的标签,甚至完全丢弃该目标。重标签规则虽然功能强大,但可能难以理解和调试。您的规则必须与服务发现机制返回的预期标签相匹配,任何步骤出错都可能导致目标标签错误或被意外丢弃。

为了帮助您找出问题所在(或验证配置是否正确),Prometheus 3.8.0 刚刚在 Prometheus 服务器的 Web UI 中添加了一个重标签可视化工具 ,使您能够检查每条重标签规则如何应用于已发现目标的标签。让我们看看它是如何工作的!

使用重标签可视化工具

如果您前往任何 Prometheus 服务器的“Service discovery”(服务发现)页面(例如:https://demo.promlabs.com/service-discovery ),现在您会看到每个已发现目标都有一个“show relabeling”(显示重标签)按钮。

Service discovery page screenshot

点击此按钮可以查看每条重标签规则如何按顺序应用于该特定目标。

该可视化工具会向您展示:

  • 服务发现机制发现目标的初始标签
  • 每条重标签规则的详细信息,包括其操作类型和其他参数。
  • 在每条重标签规则应用后,标签是如何变化的,并以颜色高亮显示修改、添加和删除的内容。
  • 在应用所有重标签规则后,该目标最终是被保留还是丢弃
  • 如果目标被保留,其最终输出标签是什么。

为了调试重标签规则,您现在可以从上到下阅读此图表,找到标签发生意外变化或目标被意外丢弃的具体步骤。这将帮助您更轻松地识别重标签规则中的配置错误。

结论

Prometheus 服务器 Web UI 中新的重标签可视化工具是一个强大的工具,可以帮助您理解和调试目标重标签配置。通过提供每条重标签规则如何影响目标标签的逐步视图,它使识别和修复设置中的问题变得更加容易。立即将您的 Prometheus 服务器升级到 3.8.0 并试用一下吧!