Prometheus relabeling动态重命名是将服务发现元标签（如__meta_consul_service）或地址信息转换为业务标签（如service、app）的关键机制，通过labelmap批量映射和replace正则提取实现，作用于采集前的Target元数据，并需配合labeldrop清理冗余元标签。
Prometheus 的 relabeling 动态重命名，核心是把服务发现生成的元标签（比如 __meta_consul_service、__meta_kubernetes_pod_label_app）或原始地址信息，转换成业务可读、查询友好、存储可控的标签名，比如 service、app、env。它不是简单改个名字，而是打通监控语义与运维逻辑的关键桥梁。
动态重命名本质是 labelmap + replace 的组合运用labelmap 适合批量映射前缀一致的元标签，replace 更灵活，支持正则提取和构造。两者都发生在采集前（relabel_configs 阶段），作用对象是 Target 的元数据标签。
用 labelmap 批量转译元标签
当服务发现（如 Kubernetes 或 Consul）注入大量 __meta_* 标签时，直接暴露这些内部标签既冗余又不可查。labelmap 可一次性将它们“剥掉前缀”变成业务标签：
- 配置示例：
- action: labelmap regex: __meta_kubernetes_pod_label_(.+) replacement: $1
效果：
__meta_kubernetes_pod_label_app=backend→ 新增标签app=backend；__meta_kubernetes_pod_label_env=prod→env=prod。 - 注意：
regex必须捕获组（括号），replacement引用$1才能取到实际值；未匹配的__meta_*标签会被自动丢弃。
用 replace 提取结构化信息并重命名
当目标地址含业务线索（如 web-prod-v2-7f89b4c56-xyz:9100），可用 replace 抽取关键字段：
- 示例：从
__address__提取环境和角色- source_labels: [__address__] regex: ([^-]+)-([^-]+)-[^-]+-.* target_label: env replacement: $2 - source_labels: [__address__] regex: ([^-]+)-([^-]+)-[^-]+-.* target_label: role replacement: $1
效果：
web-prod-v2-7f89b4c56-xyz:9100→env=prod、role=web。 - 关键点：
source_labels是输入源，target_label是新标签名，regex要覆盖全部可能格式，否则匹配失败则不写入。
避免常见陷阱
- 元标签（
__*）默认不入库，重命名后的新标签才进入指标； - 多条 relabel 规则顺序执行，前一条删掉的标签，后一条就不可见；
-
labelmap不改变原标签，只新增；replace可覆盖已有标签（包括instance或job）； - 测试时打开 Prometheus Targets 页面，直接看每个 Target 的 “Labels” 区域，确认重命名是否生效。
重命名后要配套做 labeldrop
保留业务标签的同时，务必清理无用元标签，防止高基数：
- action: labeldrop regex: "__meta_.*|__scheme__|__metrics_path__"
这条规则会删除所有 __meta_ 开头及两个固定元标签，让最终指标干净利落。
不复杂但容易忽略。
