首页/云/可观测性速查/relabel_configs:抓取前的目标标签改写
Prometheus 与采集64 条

relabel_configs:抓取前的目标标签改写

relabel_configs 在抓取发生前处理目标元标签(__address__、__param_* 等),常用于改写端口、过滤目标、添加业务标签与生成实例标签。

可观测性速查云更新于 2026-10-12

常用动作

action作用典型用例
keep / drop保留或丢弃目标只采集特定角色实例
replace用正则捕获改写标签从 __address__ 提取端口生成标签
labeldrop / labelkeep删或保留标签清理无用的元标签
hashmod按哈希分片多个 Prometheus 分担大目标集

从地址提取实例标签并改写抓取端口

从地址提取实例标签并改写抓取端口
relabel_configs:
  - source_labels: [__address__]
    regex: '([^:]+):(\\d+)'
    target_label: instance
    replacement: '$1'
  - source_labels: [__address__]
    regex: '([^:]+):.*'
    target_label: __address__
    replacement: '$1:9100'
以 __ 开头的内置标签只在抓取前阶段有效:__param_*、__scheme__ 等都是 relabel 可改写的对象。

易错点

  • relabel 的 regex 是完整匹配(隐含锚定),要部分匹配需用 .* 包裹
  • replace 是默认 action:忘记写 action 时会按 replace 执行,可能与预期不符

数据来源与参考

  • Prometheus 文档 · relabel_config
  • Prometheus 文档 · Configuration 的 relabel 说明
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌