OpenTelemetry JS 语义约定更新：ATTR前缀标准化实践

在OpenTelemetry JS项目中，近期完成了一项重要的语义约定标准化工作——将所有包中的属性前缀从SEMRESATTRS_和SEMATTRS_统一更改为简洁的ATTR_前缀。这项变更是OpenTelemetry语义约定演进计划的一部分，旨在简化代码并提高一致性。

背景与动机

OpenTelemetry作为云原生可观测性的事实标准，其语义约定定义了跨语言、跨平台的标准化属性命名规范。在JS实现中，早期的属性前缀设计较为冗长，随着规范的成熟，团队决定简化前缀以提升开发者体验。

变更内容

本次变更主要涉及以下方面：

1. 将所有语义属性常量的前缀统一为ATTR_
2. 保持原有属性的功能不变，仅修改命名方式
3. 不引入新的属性，专注于现有属性的标准化

技术实现要点

对于稳定版本的语义约定，开发者应继续使用@opentelemetry/semantic-conventions包。而对于不稳定(experimental)的语义约定，推荐的做法是：

1. 在项目中创建本地semconv.ts文件
2. 使用JS贡献库中的脚本生成该文件内容
3. 通过本地文件引用不稳定语义约定

这种设计既保证了稳定API的可靠性，又为实验性功能提供了灵活的演进空间。

影响范围与兼容性

该变更影响OpenTelemetry JS生态系统的多个包，但通过精心规划的实施策略：

• 保持了向后兼容性
• 分阶段逐步推进变更
• 确保不破坏现有监控数据的连续性

最佳实践建议

对于使用OpenTelemetry JS的开发者：

1. 及时更新依赖版本以获取标准化命名
2. 新代码中统一使用ATTR_前缀
3. 逐步迁移现有代码中的旧前缀
4. 关注语义约定稳定性的标注，合理选择导入方式

这项标准化工作体现了OpenTelemetry项目对开发者体验的持续优化，通过简化命名约定降低了使用门槛，同时保持了规范的严谨性和扩展性。