OpenTelemetry JS 中 HTTP 语义约定稳定性选项失效问题解析

问题背景

在 OpenTelemetry JS 项目的 instrumentation-http 模块中，开发人员发现当设置了环境变量 OTEL_SEMCONV_STABILITY_OPT_IN=http 时，HTTP 客户端和服务器的跟踪数据仍然使用了旧的语义约定属性（如 http.status_code），而不是预期的稳定语义约定（如 http.response.status_code）。

技术分析

这个问题源于代码中对环境变量解析的实现方式存在缺陷。在 instrumentation-http 模块中，原本应该使用 for...of 循环来遍历 OTEL_SEMCONV_STABILITY_OPT_IN 环境变量值的数组，但实际上使用了 for...in 循环，导致循环遍历的是数组的索引而非元素本身。

问题影响

这个缺陷会导致：

1. 即使明确设置了环境变量，也无法启用 HTTP 相关的稳定语义约定
2. 生成的遥测数据会继续使用旧的、可能被弃用的属性命名
3. 影响数据的一致性和后处理流程

解决方案

该问题已通过以下方式修复：

1. 将循环方式从 for...in 改为 for...of
2. 确保正确遍历环境变量值的数组元素
3. 使稳定语义约定的启用逻辑能够按预期工作

最佳实践建议

对于使用 OpenTelemetry JS instrumentation-http 模块的开发人员，建议：

1. 确保使用包含此修复的版本（0.54.0 之后的版本）
2. 验证环境变量设置是否正确生效
3. 检查生成的跟踪数据是否使用了预期的属性命名

总结

这个问题的修复确保了 OpenTelemetry JS 中 HTTP 语义约定的稳定性选项能够按预期工作，使开发人员能够平滑过渡到稳定的语义约定系统。对于依赖 OpenTelemetry 进行应用监控的团队来说，及时更新到包含此修复的版本非常重要，以确保数据的一致性和未来兼容性。