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

更新时间:
复制 MD 格式

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

查看探针版本

  1. 登录 ARMS 控制台。

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

探针版本

版本

发布时间

发布说明

1.0.8

2026年8月26日

新特性

  • 新增标签服务能力,支持实例标签和应用标签的全生命周期管理,包括初始化、归一化、合并和刷新。

  • 新增应用标签富化。

现有特性调整

  • 优化 AgentInfo 心跳上报。

  • 优化 Span 导出时的标签注入策略。

  • 优化 K8s 元数据采集逻辑。

  • 优化 Claude Agent 语义。

1.0.7

2026年8月11日

新特性

  • 新增 Nuxt 2 自动插桩能力。

  • 新增日志控制配置能力,支持控制内部诊断日志开关、日志级别、console 输出和业务日志 Trace 注入。

现有特性调整

  • 调整远程配置解析能力,支持从远程配置下发日志采集和 Trace 注入控制。

  • 调整 Nuxt 插件能力,Nuxt 2 与 Nuxt 3/Nitro/h3 场景由同一 nuxt 插件配置项管理。

新插件或者插件新版本

  • 支持 Nuxt 2。

性能优化

  • 优化 Trace 批处理导出能力,支持导出并发、失败重试和重试队列,提升高并发链路上报稳定性。

  • 优化 ARMS 指标导出器,支持导出分片、并发、唯一 series 限制和失败重试队列,提升高并发指标上报稳定性。

  • 优化异常元数据批处理与队列管理,支持批量、队列大小、单条 value 长度、去重缓存和重试配置。

1.0.6

2026年8月5日

新特性

  • 新增 Claude Agent user_input 粒度追踪能力,支持 AsyncIterable prompt 中每个真实用户输入生成独立 Agent 根 Span 和 TraceId。

现有特性调整

  • 调整 Claude Agent 插件配置,新增 traceGranularity 配置,支持 query、user_input、turn 写法,其中 turn 会归一为 user_input。

1.0.5

2026年7月29日

新特性

现有特性调整

  • 调整 Node.js Agent 默认插件配置,默认启用 Next.js 与 Nuxt/Nitro 自动采集能力。

  • 调整 Nuxt/Nitro 插件处理逻辑,支持嵌套 handler 场景创建追踪 Span。

新插件或者插件新版本

  • 支持 Next.js。

  • 支持 Nuxt 3/Nitro/h3。

1.0.4

2026年7月16日

现有特性调整

  • 统一 ARMS 应用公共 RPC 指标 duration 口径为毫秒值,覆盖 HTTP Core、Undici、MongoDB、Mongoose、ioredis、Kafka、Socket.IO 等插件。

  • HTTP Core 补齐 slow、by-status、latency 指标;by-status 指标 label 统一为 status,HTTP status 使用原始状态码字符串。

  • gRPC 补齐 slow、by-status、latency 指标;by-status 指标 label 统一为 status。

  • 统一异常指标 label,使用 excep.ids,不再使用 excepIds;MySQL/MySQL2 异常路径统一使用 CRC 异常 ID。

  • Kafka、Socket.IO、Redis、ioredis、MongoDB、Mongoose、PG 等插件补齐 Trace 业务属性和 slow/error 指标覆盖。

  • 统一 GenAI 指标低基数 label,OpenAI、Vercel AI、LangChain、Claude Agent 的 calls/error/slow/duration/token/first-token 指标 label 口径保持一致;token 指标补充 usageType。

  • Runtime 指标补充 Linux 下 process.open_file_descriptor.count、process.context_switches、process.memory.virtual 采集;非 Linux 环境不再上报虚假 virtual memory 值。

问题修复

  • 修复 HTTP by-status 指标错误使用 statusCode label 的问题。

  • 修复部分插件错误指标缺少 excep.ids 的问题。

  • 修复 Runtime process.memory.virtual 使用 V8 heapTotal 作为虚拟内存值的问题。

  • 修复 OpenAI 自动插桩后再次手动插桩导致重复 LLM Span 的问题。

1.0.3

2026年6月25日

新特性

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

  • 新增 Claude Agent 插桩能力。

现有特性调整

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

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

1.0.2

2026年6月10日

新特性

  • 新增 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

2026年5月19日

新特性

  • 新增远程配置能力,支持从 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

2025年12月3日

新特性

  • 新增 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 等数据库与消息插件。

支持的 Node.js 组件和框架

Web 框架

框架

支持版本

说明

Express

>=4.0.0 <6

自动插桩

Koa

>=2.0.0 <4

自动插桩

Next.js

>=12.0.0 <17.0.0

支持 SSR、RSC、API Route、middleware 等链路

Nuxt 3/Nitro/h3

h3 >=1.0.0 <2.0.0

hookable >=5.0.0 <6.0.0

支持 Nitro server handler、h3 handler、render hook

Nuxt 2

>=2.3.0 <3.0.0

支持 @nuxt/server、@nuxt/vue-renderer、@nuxt/core 关键链路

数据库与存储

组件

支持版本

说明

MongoDB

>=3.3.0 <4

>=4.0.0 <7

自动插桩

Mongoose

>=5.9.7 <9

自动插桩

MySQL

>=2.0.0 <3

自动插桩

MySQL2

>=1.4.2 <4

自动插桩

PostgreSQL (pg)

pg >=8.0.3 <9

pg-pool >=2.0.0 <4

自动插桩

Redis

>=2.6.0 <4

自动插桩

ioredis

>=2.0.0 <6

自动插桩

消息队列

组件

支持版本

说明

Kafka(kafkajs)

>=0.3.0 <3

自动插桩

AI/GenAI

组件

支持版本

说明

OpenAI

>=4 <6

支持 Token 增强配置

Vercel AI SDK

>=4.0.0 <7

支持 Agent/LLM/Tool 自动采集、首 Token 时间指标

LangChain

v1.x(动态插桩)

支持 Agent 名称解析、工具定义提取、流式调用首 Token 时间指标

LangGraph

v1.x(动态插桩)

支持 createReactAgent 和 Pregel stream 场景

Claude Agent

>=0.3.0 <1

支持 user_input 粒度追踪

日志框架

组件

支持版本

说明

pino

>=7.0.0 <11

自动插桩,支持 Log-Trace 关联

winston

>=3.0.0 <4

自动插桩,支持 Log-Trace 关联

bunyan

>=1.8.0 <3

自动插桩,支持 Log-Trace 关联

console

-

自动插桩,支持 Log-Trace 关联

其他

组件

支持版本

说明

HTTP/HTTPS

Node.js 内置

自动插桩

Undici

随 Node.js runtime

自动插桩

gRPC

^1.0.0

自动插桩

DNS

Node.js 内置

自动插桩

Socket.IO

>=3 <5

自动插桩

Net

Node.js 内置

自动插桩

Runtime

Node.js 内置

采集 Event Loop、V8 Heap、GC、Process 指标