All Products
Search
Document Center

Application Real-Time Monitoring Service:Release notes for the Node.js agent

Last Updated:Sep 09, 2026

This topic describes the release notes for the Node.js agent of Application Real-Time Monitoring Service (ARMS) Application Monitoring.

View the agent version

  1. Log on to the ARMS console.

  2. In the left navigation pane, choose Application Monitoring > Agent Management and click the Agent Release Notes tab.

Agent versions

Version

Release date

Release notes

1.0.8

August 26, 2026

New features

  • Added tag service capabilities that support full lifecycle management of instance tags and application tags, including initialization, normalization, merging, and refresh.

  • Added application tag enrichment.

Feature adjustments

  • Optimized AgentInfo heartbeat reporting.

  • Optimized the tag injection strategy during Span export.

  • Optimized Kubernetes metadata collection.

  • Optimized Claude Agent semantics.

1.0.7

August 11, 2026

New features

  • Added automatic instrumentation for Nuxt 2.

  • Added log-control configuration for internal diagnostic log switches, log levels, console output, and trace injection into application logs.

Feature adjustments

  • Updated remote configuration parsing to receive log collection and trace injection controls from remote configuration.

  • Updated the Nuxt plugin so that Nuxt 2 and Nuxt 3/Nitro/h3 scenarios use the same nuxt plugin configuration key.

New plugins

  • Added support for Nuxt 2.

Performance optimizations

  • Optimized trace batch export with export concurrency, retry-on-failure, and retry queues to improve trace reporting stability under high concurrency.

  • Optimized the ARMS metrics exporter with export sharding, concurrency, unique series limits, and retry queues to improve metric reporting stability under high concurrency.

  • Optimized exception metadata batching and queue management with batch, queue-size, single-value-length, deduplication-cache, and retry configuration.

1.0.6

August 5, 2026

New features

  • Added Claude Agent tracing at the user_input granularity. Each actual user input in an AsyncIterable prompt generates an independent Agent root Span and TraceId.

Feature adjustments

  • Updated the Claude Agent plugin configuration with traceGranularity, which supports query, user_input, and turn. The turn value is normalized to user_input.

1.0.5

July 29, 2026

New features

Feature adjustments

  • Updated the default Node.js agent plugin configuration to enable automatic collection for Next.js and Nuxt/Nitro by default.

  • Updated Nuxt/Nitro plugin handling to create trace spans in nested handler scenarios.

New plugins

  • Added support for Next.js.

  • Added support for Nuxt 3/Nitro/h3.

1.0.4

July 16, 2026

Feature adjustments

  • Standardized the duration unit of common RPC metrics for ARMS applications to milliseconds, covering the HTTP Core, Undici, MongoDB, Mongoose, ioredis, Kafka, and Socket.IO plugins.

  • Added slow, by-status, and latency metrics to HTTP Core. The label of by-status metrics is standardized to status, and the HTTP status uses the original status code string.

  • Added slow, by-status, and latency metrics to gRPC. The label of by-status metrics is standardized to status.

  • Standardized the exception metric label to excep.ids instead of excepIds. The MySQL and MySQL2 exception paths now use CRC exception IDs.

  • Added trace business attributes and slow/error metric coverage to the Kafka, Socket.IO, Redis, ioredis, MongoDB, Mongoose, and PostgreSQL plugins.

  • Standardized low-cardinality labels for GenAI metrics so that the calls, error, slow, duration, token, and first-token metrics of OpenAI, Vercel AI, LangChain, and Claude Agent use consistent labels. The usageType label is added to token metrics.

  • Added collection of the process.open_file_descriptor.count, process.context_switches, and process.memory.virtual runtime metrics on Linux. Invalid virtual memory values are no longer reported in non-Linux environments.

Bug fixes

  • Fixed an issue where HTTP by-status metrics incorrectly used the statusCode label.

  • Fixed an issue where the excep.ids label was missing from the error metrics of some plugins.

  • Fixed an issue where the Runtime process.memory.virtual metric used the V8 heapTotal value as the virtual memory value.

  • Fixed an issue where duplicate LLM spans were generated when OpenAI was instrumented manually after automatic instrumentation.

1.0.3

June 25, 2026

New features

  • Added Vercel AI SDK instrumentation with support for server-side Agent/LLM/Tool automatic collection, time-to-first-token metrics, Agent/Tool/Embedding/Rerank span collection, and RAG metadata detection.

  • Added Claude Agent instrumentation.

Feature adjustments

  • Optimized the ARMS configuration generation logic with input parameter validation to prevent errors caused by invalid configurations.

  • Optimized the remote configuration polling mechanism with timer lifecycle management to prevent resource leaks.

1.0.2

June 10, 2026

New features

  • Added LangChain v1.x instrumentation with support for agent name resolution, tool definition extraction, CommonJS integration, and time-to-first-token metrics for streaming calls.

  • Added LangGraph instrumentation with support for createReactAgent and Pregel stream scenarios.

  • Added GenAI application type identification and GenAI metric collection for OpenAI call scenarios.

  • Added remote configuration support to enable or disable LangChain and LangGraph instrumentation.

Feature adjustments

  • Updated the OpenAI plugin configuration to include a traceContent control.

  • Updated the ESM Loader module resolution logic for compatibility with LangSmith and its relative path dependencies.

  • Updated the environment variable configuration to include recommended ARMS_* variables, legacy variable mappings, Kubernetes metadata, and exporter and batch processing settings.

New plugins

  • Added the LangChain v1.x plugin.

  • Added the LangGraph plugin.

Bug fixes

  • Fixed an issue where the npm package retained references to @ali/* internal dependencies at runtime.

  • Fixed an issue where LangChain span parent-child relationships were lost in asynchronous handler scenarios.

1.0.1

May 19, 2026

New features

  • Added remote configuration support to pull configurations from the ARMS server and apply sampling rules, span limits, and plugin switches.

  • Added declarative sampling strategies: always-on, always-off, trace-id-ratio, and parent-based.

  • Added metrics collection support, including metric exporter, metric processor, flush interval, Observable callback timeout, and runtime statistics configuration.

  • Added agent self-monitoring log support with logExporter and logExportIntervalMs configuration.

  • Added Log-Trace correlation to automatically inject trace context into application logs.

  • Added compatibility with Node.js 12.

Feature adjustments

  • Updated the default NodeSDK resource detection to integrate Kubernetes resource detectors and support ARMS cluster, namespace, and workload resource attributes.

  • Updated the database and runtime collection logic to include SQL metadata, business metrics, self-monitoring metrics, and runtime metrics.

  • Updated HTTP trace context propagation to support EagleEye upstream service context pass-through and injection.

New plugins

  • Added the OpenAI plugin with enrichTokens token usage collection.

  • Added pino, winston, bunyan, and console logging plugins.

  • Added the Runtime metrics plugin to collect event loop, V8 heap, garbage collection (GC), and process metrics.

  • Added the KafkaJS v2.x plugin.

  • Added metrics collection and self-monitoring to the gRPC plugin.

Performance optimizations

  • Optimized Node.js and V8 metrics collection to reduce noise and unnecessary data in error scenarios.

Bug fixes

  • Fixed an issue where the traceparent request header was overwritten.

  • Fixed an issue where HTTP request attribute extraction was incomplete.

  • Fixed an issue where metric reporting requests were captured by business trace collection.

  • Fixed an issue where SQL metadata and exception metadata accumulated without being reported when the batch threshold was not reached.

  • Fixed an issue where the acs.arms.service.id resource attribute was missing.

1.0.0

December 3, 2025

New features

  • Added distributed tracing instrumentation for Node.js applications. Three integration methods are supported: ESM Loader, CommonJS preloading, and manual NodeSDK initialization.

  • Added ARMS trace reporting support with configuration for service name, license key, region, workspace, project, and service ID.

  • Added automatic resource detection for process and host runtime environment attributes.

New plugins

  • Added HTTP, Express, Koa, Undici, gRPC, DNS, Socket.IO, and Net plugins for Node.js networking and web frameworks.

  • Added MongoDB, Mongoose, MySQL, MySQL2, PostgreSQL, Redis, ioredis, and Kafka plugins for databases and messaging.

Supported Node.js components and frameworks

Web frameworks

Framework

Supported versions

Description

Express

>=4.0.0 <6

Automatic instrumentation

Koa

>=2.0.0 <4

Automatic instrumentation

Next.js

>=12.0.0 <17.0.0

Supports traces for SSR, RSC, API routes, middleware, and other paths

Nuxt 3/Nitro/h3

h3 >=1.0.0 <2.0.0

hookable >=5.0.0 <6.0.0

Supports Nitro server handlers, h3 handlers, and render hooks

Nuxt 2

>=2.3.0 <3.0.0

Supports key paths in @nuxt/server, @nuxt/vue-renderer, and @nuxt/core

Databases and storage

Component

Supported versions

Description

MongoDB

>=3.3.0 <4

>=4.0.0 <7

Automatic instrumentation

Mongoose

>=5.9.7 <9

Automatic instrumentation

MySQL

>=2.0.0 <3

Automatic instrumentation

MySQL2

>=1.4.2 <4

Automatic instrumentation

PostgreSQL (pg)

pg >=8.0.3 <9

pg-pool >=2.0.0 <4

Automatic instrumentation

Redis

>=2.6.0 <4

Automatic instrumentation

ioredis

>=2.0.0 <6

Automatic instrumentation

Message queues

Component

Supported versions

Description

Kafka (kafkajs)

>=0.3.0 <3

Automatic instrumentation

AI and generative AI

Component

Supported versions

Description

OpenAI

>=4 <6

Supports enhanced token configuration

Vercel AI SDK

>=4.0.0 <7

Supports automatic collection of Agent, LLM, and Tool calls, plus time-to-first-token metrics

LangChain

v1.x (dynamic instrumentation)

Supports agent name resolution, tool definition extraction, and time-to-first-token metrics for streaming calls

LangGraph

v1.x (dynamic instrumentation)

Supports createReactAgent and Pregel stream scenarios

Claude Agent

>=0.3.0 <1

Supports tracing at the user_input granularity

Logging frameworks

Component

Supported versions

Description

pino

>=7.0.0 <11

Automatic instrumentation with log-trace correlation

winston

>=3.0.0 <4

Automatic instrumentation with log-trace correlation

bunyan

>=1.8.0 <3

Automatic instrumentation with log-trace correlation

console

Not applicable

Automatic instrumentation with log-trace correlation

Other components

Component

Supported versions

Description

HTTP/HTTPS

Node.js built-in

Automatic instrumentation

Undici

Included with the Node.js runtime

Automatic instrumentation

gRPC

^1.0.0

Automatic instrumentation

DNS

Node.js built-in

Automatic instrumentation

Socket.IO

>=3 <5

Automatic instrumentation

Net

Node.js built-in

Automatic instrumentation

Runtime

Node.js built-in

Collects Event Loop, V8 Heap, GC, and Process metrics