Release notes for the Node.js agent

更新时间:
复制 MD 格式

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.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.