探针(Node.js Agent)版本说明

更新时间:
复制 MD 格式

本文介绍 ARMS 应用监控 Node.js 探针的版本更新历史。

查看探针版本

  1. 登录 ARMS 控制台

  2. 在左侧导航栏选择应用监控 > 系统管理,然后单击探针发布记录页签,下拉选中Nodejs。

探针版本

版本

发布时间

发布说明

1.0.3

2026625

新特性

  • 新增 Vercel AI SDK 插桩能力,支持服务端 Agent/LLM/Tool 自动采集、首 Token 时间指标、Agent/Tool/Embedding/Rerank Span 采集以及 RAG 元数据检测。

  • 新增 Claude Agent 插桩能力。

现有特性调整

  • 优化 ARMS 配置生成逻辑,增加输入参数校验,避免无效配置导致错误。

  • 优化远程配置轮询机制,增加定时器生命周期管理,避免资源泄漏。

1.0.2

2026610

新特性

  • 新增 LangChain v1.x 插桩能力,支持 Agent 名称解析、工具定义提取、CommonJS 接入示例和流式调用首 Token 时间指标。

  • 新增 LangGraph 插桩能力,支持 createReactAgent 和 Pregel stream 场景识别。

  • 新增 GenAI 应用类型识别能力,支持 OpenAI 调用场景的 GenAI 指标采集。

  • 新增 LangChain 和 LangGraph 远程配置启停能力。

现有特性调整

  • 调整 OpenAI 插件配置,新增 traceContent 控制项。

  • 调整 ESM Loader 模块解析逻辑,兼容 langsmith 及其相对依赖加载。

  • 调整环境变量配置说明,补充 ARMS_* 推荐变量、旧变量兼容关系、K8s 元数据、导出器和批处理配置。

新插件或者插件新版本

  • 支持 LangChain v1.x 插件。

  • 支持 LangGraph 插件。

问题修复

  • 修复 npm 包运行时代码残留 @ali/* 依赖的问题。

  • 修复 LangChain Span 父子关系在异步 Handler 场景下丢失的问题。

1.0.1

2026519

新特性

  • 新增远程配置能力,支持从 ARMS 服务端拉取配置并应用采样、Span Limits 和插件开关。

  • 新增声明式采样策略,支持 always-on、always-off、trace-id-ratio 和 parent-based。

  • 新增指标采集能力,支持 metricExporter、metricProcessor、metricFlushIntervalMs、Observable 回调超时和运行时统计配置。

  • 新增探针自监控日志能力,支持 logExporter 和 logExportIntervalMs 配置。

  • 新增 Log-Trace 关联能力,支持在应用日志中自动注入 Trace Context。

  • 新增 Node.js 12 兼容性支持。

现有特性调整

  • 调整 NodeSDK 默认资源探测能力,集成 K8s 资源检测器并支持 ARMS 集群、命名空间和工作负载资源属性。

  • 调整数据库与运行时采集逻辑,补齐 SQL 元数据、业务指标、自监控指标和 Runtime 指标采集。

  • 调整 HTTP 链路上下文传播能力,支持 EagleEye 上游服务上下文传递与注入。

新插件或者插件新版本

  • 支持 OpenAI 插件,支持 Token 增强配置 enrichTokens。

  • 支持 pino、winston、bunyan、console 日志插件。

  • 支持 Runtime 指标插件,采集 Event Loop、V8 Heap、GC 和 Process 指标。

  • 支持 KafkaJS V2.x 插件。

  • 支持 gRPC 插件指标采集与自监控能力增强。

性能优化

  • 优化 Node.js 和 V8 指标采集逻辑,降低异常场景下的采集噪声和无效采集。

问题修复

  • 修复 traceparent 请求头被覆盖的问题。

  • 修复 HTTP 请求属性提取不完整的问题。

  • 修复指标上报请求被业务链路采集的问题。

  • 修复 SQL 元数据和异常元数据未达到批量阈值时长期堆积不上报的问题。

  • 修复资源属性缺少 acs.arms.service.id 的问题。

1.0.0

2025123

新特性

  • 新增 Node.js 应用链路追踪接入能力,支持通过 ESM Loader、CommonJS 预加载和手动 NodeSDK 三种方式接入。

  • 新增 ARMS Trace 上报能力,支持服务名、License、地域、工作空间、项目和服务 ID 等基础配置。

  • 新增自动资源探测能力,支持进程、主机等运行环境资源属性采集。

新插件或者插件新版本

  • 支持 HTTP、Express、Koa、Undici、gRPC、DNS、Socket.IO、Net 等 Node.js 网络与 Web 框架插件。

  • 支持 MongoDB、Mongoose、MySQL、MySQL2、PostgreSQL、Redis、ioredis、Kafka 等数据库与消息插件。