首页/云/可观测性速查/metric_relabel_configs:抓取后的指标治理
Prometheus 与采集64 条

metric_relabel_configs:抓取后的指标治理

metric_relabel_configs 在抓取返回后、入库前处理样本:丢弃高成本指标、删除敏感或高基数标签、做重命名;是控制序列数、保护 TSDB 的主要手段。

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

指标重标记的时机

指标重标记在抓取返回之后、写入存储之前处理样本:丢弃不需要的指标、删除高基数或敏感标签、把标签改名。它是控制序列数、保护存储的主要手段,也是唯一能在入库之前做取舍的位置。

丢弃是不可逆的

丢弃是单向操作:入库之后无法追溯被丢掉的数据。因此规则改动应先在测试环境验证,并检查告警与看板依赖的指标是否被误删,否则会出现看板空白、告警静默失效这类问题,而且很难第一眼看出原因。

基本信息

执行时机抓取返回后、入库之前
作用对象样本及其标签,而不是目标
常用动作丢弃指标、删除标签、标签改名
主要风险丢弃之后无法追溯原始数据

典型使用场景

  • 控制基数:丢弃明细类指标或删除高基数标签
  • 清理无用指标:去掉体积大且无人使用的指标
  • 合规要求:删除包含敏感信息的标签
  • 统一命名:把不同来源的同义指标改成统一名称
  • 容量保护:在写入前削减样本量,避免存储压力过大

丢弃指标与清理标签

丢弃指标与清理标签
scrape_configs:
  - job_name: app
    static_configs:
      - targets: ['10.0.1.21:8080']
    metric_relabel_configs:
      # 丢弃体积大且无人使用的指标
      - source_labels: [__name__]
        regex: 'go_(gc|memstats)_.*'
        action: drop
      # 删除敏感与高基数标签
      - regex: '(token|session_id)'
        action: labeldrop

动作与场景

动作作用典型场景
丢弃指标整条指标不再入库清理无用或高基数指标
删除标签保留指标但减少维度移除敏感或高基数标签
标签改名统一命名口径合并同义指标
只保留白名单仅留下指定指标严格控制采集范围

改动前的检查

  • 先列出目标指标被哪些看板与告警引用
  • 规则的作用范围要明确,避免正则过宽导致误删
  • 改完观察序列总数变化与关键告警是否仍在评估
在采集端做取舍比事后治理更省成本:规则生效后序列数与存储占用会立即改善。
丢弃不可逆:入库后无法追溯被丢弃的数据,规则上线前务必先在测试环境验证影响面。

易错点

  • 丢弃规则过宽:告警依赖的指标被误删,告警静默失效
  • 与目标重标记混用:作用对象不同,规则位置写错就完全不生效
  • 直接改生产规则:无法追溯影响,出问题只能整份回滚
  • 删除标签不做评估:看板与变量依赖的维度消失,图表变空

数据来源与参考

  • Prometheus 文档 · metric_relabel_configs
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌