为什么需要重命名指标：迁移旧系统、统一命名规范、避免命名冲突
在可观测性实践中，指标命名并非一成不变。随着系统演进、团队扩张以及观测平台统一，原始指标名称往往成为数据消费的障碍。重命名指标是 OpenTelemetry 指标处理管线中最常见的治理动作，其核心驱动力来自以下三个场景。
三大核心驱动力
| 驱动力 | 典型场景 | 后果（若不重命名） |
|---|---|---|
| 迁移旧系统 | 从 Prometheus / StatsD / 自研监控迁移到 OpenTelemetry | 仪表盘失效、告警规则断裂、历史数据无法关联 |
| 统一命名规范 | 多团队、多语言服务使用不同命名风格（snake_case / camelCase / 点分式） | 查询困难、语义歧义、SLO 无法跨服务聚合 |
| 避免命名冲突 | 合并多个数据源或库时出现同名不同义指标 | 指标覆盖、错误聚合、误告警 |
1. 迁移旧系统：保持向后兼容
当组织从遗留监控系统（如 Prometheus 2.x 自建、StatsD、Datadog Agent 旧版）迁移到 OpenTelemetry 时，原有指标名称已被大量消费端依赖：
- 仪表盘：Grafana 面板直接引用旧指标名
- 告警规则：Alertmanager / 自研告警引擎基于旧名称匹配
- 历史趋势：长期存储中的指标名无法自动跟随新命名
重命名策略在此场景下充当适配层：在 OpenTelemetry Collector 中通过 transform 处理器将旧名称映射为新名称，同时保留旧名称的导出副本，实现平滑过渡。
迁移最佳实践：采用“双写期”策略——同时保留旧名和新名指标至少一个完整数据保留周期，待所有消费端验证无误后再移除旧名。
2. 统一命名规范：消除语义混乱
在微服务架构中，不同团队、不同语言的服务往往采用不同的指标命名风格：
- Go 服务：
http_requests_total（snake_case） - Java 服务：
httpRequestsTotal（camelCase） - Python 服务：
http.requests.total（点分式） - 遗留系统：
HTTP_REQUESTS（大写加下划线）
这种混乱导致跨服务查询时必须记忆多种命名模式，且无法使用统一的聚合规则。重命名指标可以将所有服务收敛到 OpenTelemetry 推荐的 Semantic Conventions（语义约定） 命名体系下。
推荐规范：遵循
namespace.metric_name.unit 三层结构，例如 http.server.request_count、db.client.query_duration_ms。OpenTelemetry 官方 Semantic Conventions 仓库提供了完整的命名参考。
3. 避免命名冲突：防止数据污染
当多个数据源或第三方库被集成到同一个 OpenTelemetry 管线时，同名指标可能代表完全不同的含义：
| 来源 | 指标名 | 实际含义 |
|---|---|---|
| Redis exporter | requests_total |
Redis 命令执行次数 |
| HTTP 中间件 | requests_total |
HTTP 请求总数 |
| gRPC 拦截器 | requests_total |
gRPC 调用次数 |
如果不加区分地合并，后端时序数据库会将三个不同语义的时间序列写入同一个 metric 名下，导致：
- 数据覆盖：相同标签组合的值互相覆盖
- 错误聚合：求和/平均等聚合操作混入无关数据
- 误告警：阈值判断基于混合数据，失去准确性
通过重命名为 redis.requests_total、http.server.requests_total、rpc.server.requests_total，可以彻底隔离不同来源的语义空间。
注意：命名冲突不仅发生在不同数据源之间，也可能发生在同一服务的不同版本或不同 feature flag 分支中。建议在 CI/CD 管线中加入指标命名审查步骤。
重命名操作的典型流程
在 OpenTelemetry Collector 中，重命名指标通常通过 transform 处理器完成。以下是一个将旧指标名映射到新命名规范的配置示例：
processors:
transform:
metric_statements:
- context: metric
statements:
# 迁移旧系统：保留旧名同时创建新名
- set(name) = "http.server.request_count" where name == "http_requests_total"
# 统一命名规范：将 camelCase 转为 snake_case
- set(name) = "db.client.query_duration_ms" where name == "dbClientQueryDurationMs"
# 避免命名冲突：添加命名空间前缀
- set(name) = "redis." + name where name == "requests_total" and resource.attributes["service.name"] == "redis-cache"