首页
/ OpenTelemetry JavaScript 语义约定 v1.31.0 版本解析

OpenTelemetry JavaScript 语义约定 v1.31.0 版本解析

2025-06-16 21:37:10作者:毕习沙Eudora

OpenTelemetry 作为云原生时代可观测性领域的重要标准,其语义约定(Semantic Conventions)为各类遥测数据提供了统一的命名和结构规范。本文重点分析 OpenTelemetry JavaScript 实现中最新发布的语义约定 v1.31.0 版本带来的重要变化。

核心变更概述

本次 v1.31.0 版本更新主要围绕三个方面展开:CPU 监控指标的标准化重构、新增硬件主机监控指标,以及对 Kubernetes 资源指标的完善。这些变更体现了 OpenTelemetry 在系统监控领域的持续演进。

CPU 监控指标重构

本次版本对 CPU 相关指标进行了重要重构,将原先以 system.cpu 为前缀的指标统一迁移到新的 cpu 命名空间下:

  • system.cpu.frequency 变更为 cpu.frequency
  • system.cpu.time 变更为 cpu.time
  • system.cpu.utilization 变更为 cpu.utilization

这种重构使得指标命名更加简洁,同时与其他技术栈的命名保持更好的一致性。开发者需要注意及时更新代码中对这些指标的引用。

新增硬件主机监控指标

v1.31.0 引入了以 hw.host 为前缀的一系列新指标,用于监控主机硬件状态:

  • hw.host.ambient_temperature:主机环境温度
  • hw.host.energy:主机能耗
  • hw.host.heating_margin:主机加热余量
  • hw.host.power:主机功率

这些指标特别适用于需要监控物理服务器或边缘设备硬件状态的场景,为基础设施监控提供了更丰富的维度。

Kubernetes 资源指标完善

在 Kubernetes 监控方面,本次更新主要涉及:

  1. 复制控制器(ReplicationController)相关指标的命名规范化:

    • k8s.replication_controller.available_pods 变更为 k8s.replicationcontroller.available_pods
    • k8s.replication_controller.desired_pods 变更为 k8s.replicationcontroller.desired_pods
  2. 新增多个 Kubernetes 资源属性:

    • HPA(Horizontal Pod Autoscaler)相关属性:k8s.hpa.namek8s.hpa.uid
    • ResourceQuota 相关属性:k8s.resourcequota.namek8s.resourcequota.uid
    • ReplicationController 标识属性:k8s.replicationcontroller.namek8s.replicationcontroller.uid

这些变更使得 Kubernetes 监控数据的结构更加完整和一致。

OpenTelemetry SDK 监控指标

本次更新还新增了多个用于监控 OpenTelemetry SDK 本身运行状态的指标:

  • 导出相关指标:otel.sdk.exporter.span.exported.countotel.sdk.exporter.span.inflight.count
  • 处理相关指标:otel.sdk.processor.span.processed.countotel.sdk.processor.span.queue.capacityotel.sdk.processor.span.queue.size
  • Span 相关指标:otel.sdk.span.ended.countotel.sdk.span.live.count

这些指标为诊断和优化 OpenTelemetry SDK 的性能提供了有力工具。

移动端应用监控增强

针对移动应用场景,新增了以下属性:

  • Android 应用状态:android.app.state,包含 background/created/foreground 等状态值
  • iOS 应用状态:ios.app.state,包含 active/background/foreground/inactive/terminate 等状态值

这些属性使得移动应用的性能监控能够更准确地反映应用的实际运行状态。

其他重要变更

  1. 终端用户相关属性:

    • 重新启用了 enduser.id 属性
    • 新增 enduser.pseudo.id 用于匿名用户标识
  2. 代码追踪相关:

    • 废弃了 code.namespace 属性,建议将其内容合并到 code.function.name
    • code.filepath 重命名为 code.file.path
  3. 生成式 AI 相关:

    • 新增了多个 Agent 和 Tool 相关属性
    • gen_ai.openai.request.response_format 替换为更通用的 gen_ai.output.type

升级建议

对于正在使用 OpenTelemetry JavaScript 实现的开发者,建议:

  1. 检查项目中是否使用了本次变更中废弃的属性,及时更新为新的命名
  2. 评估新增指标和属性是否适用于当前监控场景,考虑纳入监控体系
  3. 特别关注 CPU 指标的变化,确保指标采集和展示不受影响

OpenTelemetry 语义约定的持续演进体现了其在统一可观测性标准方面的努力,开发者及时跟进这些变化将有助于构建更加标准化和可维护的监控系统。

登录后查看全文
热门项目推荐

热门内容推荐

最新内容推荐

项目优选

收起
docsdocs
OpenHarmony documentation | OpenHarmony开发者文档
Dockerfile
144
1.93 K
kernelkernel
deepin linux kernel
C
22
6
ohos_react_nativeohos_react_native
React Native鸿蒙化仓库
C++
192
274
openGauss-serveropenGauss-server
openGauss kernel ~ openGauss is an open source relational database management system
C++
145
189
RuoYi-Vue3RuoYi-Vue3
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
930
553
nop-entropynop-entropy
Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台,包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分,采用java语言实现,可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用
Java
8
0
openHiTLSopenHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!
C
423
392
金融AI编程实战金融AI编程实战
为非计算机科班出身 (例如财经类高校金融学院) 同学量身定制,新手友好,让学生以亲身实践开源开发的方式,学会使用计算机自动化自己的科研/创新工作。案例以量化投资为主线,涉及 Bash、Python、SQL、BI、AI 等全技术栈,培养面向未来的数智化人才 (如数据工程师、数据分析师、数据科学家、数据决策者、量化投资人)。
Jupyter Notebook
75
66
CangjieCommunityCangjieCommunity
为仓颉编程语言开发者打造活跃、开放、高质量的社区环境
Markdown
1.11 K
0
openHiTLS-examplesopenHiTLS-examples
本仓将为广大高校开发者提供开源实践和创新开发平台,收集和展示openHiTLS示例代码及创新应用,欢迎大家投稿,让全世界看到您的精巧密码实现设计,也让更多人通过您的优秀成果,理解、喜爱上密码技术。
C
64
511