Tous les produits
Search
Centre de documentation

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

Dernière mise à jour :Sep 09, 2026

Cette rubrique présente les notes de version de l'agent Node.js pour la surveillance des applications d'Application Real-Time Monitoring Service (ARMS).

Consulter la version de l'agent

  1. Connectez-vous à la console ARMS.

  2. Dans le volet de navigation de gauche, choisissez Application Monitoring > Agent Management et cliquez sur l'onglet Agent Release Notes.

Versions de l'agent

Version

Date de publication

Notes de version

1.0.8

26 août 2026

Nouvelles fonctionnalités

  • Ajout de capacités de service de tag prenant en charge la gestion du cycle de vie complet des tags d'instance et des tags d'application, y compris l'initialisation, la normalisation, la fusion et l'actualisation.

  • Ajout de l'enrichissement des tags d'application.

Ajustements des fonctionnalités

  • Optimisation de la transmission des signaux de heartbeat AgentInfo.

  • Optimisation de la stratégie d'injection de tag lors de l'exportation Span.

  • Optimisation de la collecte des métadonnées Kubernetes.

  • Optimisation de la sémantique Claude Agent.

1.0.7

11 août 2026

Nouvelles fonctionnalités

  • Ajout de l'instrumentation automatique pour Nuxt 2.

  • Ajout de la configuration log-control pour les commutateurs de journal de diagnostic interne, les niveaux de journal, la sortie console et l'injection de trace dans les journaux d'application.

Ajustements des fonctionnalités

  • Mise à jour de l'analyse de la configuration distante pour recevoir les contrôles de collecte de journal et d'injection de trace depuis la configuration distante.

  • Mise à jour du plugin Nuxt afin que les scénarios Nuxt 2 et Nuxt 3/Nitro/h3 utilisent la même clé de configuration de plugin nuxt.

Nouveaux plugins

  • Ajout de la prise en charge de Nuxt 2.

Optimisations des performances

  • Optimisation de l'exportation par lot de trace avec concurrence d'exportation, nouvelle tentative en cas d'échec et files d'attente de nouvelle tentative pour améliorer la stabilité de la transmission de trace sous forte concurrence.

  • Optimisation de l'exportateur de métriques ARMS avec fragmentation d'exportation, concurrence, limites de série unique et files d'attente de nouvelle tentative pour améliorer la stabilité de la transmission de métrique sous forte concurrence.

  • Optimisation du regroupement par lot et de la gestion de file d'attente des métadonnées d'exception avec configuration de lot, taille de file d'attente, longueur de valeur unique, cache de déduplication et nouvelle tentative.

1.0.6

5 août 2026

Nouvelles fonctionnalités

  • Ajout du traçage Claude Agent au niveau de granularité user_input. Chaque entrée utilisateur réelle dans une invite AsyncIterable génère un Span racine Agent et un TraceId indépendants.

Ajustements des fonctionnalités

  • Mise à jour de la configuration du plugin Claude Agent avec traceGranularity, qui prend en charge query, user_input et turn. La valeur turn est normalisée en user_input.

1.0.5

29 juillet 2026

Nouvelles fonctionnalités

Ajustements des fonctionnalités

  • Mise à jour de la configuration par défaut du plugin d'agent Node.js pour activer la collecte automatique pour Next.js et Nuxt/Nitro par défaut.

  • Mise à jour de la gestion du plugin Nuxt/Nitro pour créer des spans de trace dans les scénarios de gestionnaire imbriqué.

Nouveaux plugins

  • Ajout de la prise en charge de Next.js.

  • Ajout de la prise en charge de Nuxt 3/Nitro/h3.

1.0.4

16 juillet 2026

Ajustements des fonctionnalités

  • Normalisation de l'unité duration des métriques RPC courantes pour les applications ARMS en millisecondes, couvrant les plugins HTTP Core, Undici, MongoDB, Mongoose, ioredis, Kafka et Socket.IO.

  • Ajout des métriques slow, by-status et latency à HTTP Core. Le libellé des métriques by-status est normalisé en status, et le statut HTTP utilise la chaîne de code de statut d'origine.

  • Ajout des métriques slow, by-status et latency à gRPC. Le libellé des métriques by-status est normalisé en status.

  • Normalisation du libellé de métrique d'exception en excep.ids au lieu de excepIds. Les chemins d'exception MySQL et MySQL2 utilisent désormais des ID d'exception CRC.

  • Ajout d'attributs métier de trace et de la couverture de métrique slow/error aux plugins Kafka, Socket.IO, Redis, ioredis, MongoDB, Mongoose et PostgreSQL.

  • Normalisation des libellés à faible cardinalité pour les métriques GenAI afin que les métriques calls, error, slow, duration, token et first-token d'OpenAI, Vercel AI, LangChain et Claude Agent utilisent des libellés cohérents. Le libellé usageType est ajouté aux métriques de token.

  • Ajout de la collecte des métriques d'exécution process.open_file_descriptor.count, process.context_switches et process.memory.virtual sur Linux. Les valeurs de mémoire virtuelle invalides ne sont plus transmises dans les environnements non Linux.

Corrections de bugs

  • Correction d'un problème où les métriques HTTP by-status utilisaient incorrectement le libellé statusCode.

  • Correction d'un problème où le libellé excep.ids était absent des métriques d'erreur de certains plugins.

  • Correction d'un problème où la métrique Runtime process.memory.virtual utilisait la valeur V8 heapTotal comme valeur de mémoire virtuelle.

  • Correction d'un problème où des spans LLM dupliqués étaient générés lorsque OpenAI était instrumenté manuellement après l'instrumentation automatique.

1.0.3

25 juin 2026

Nouvelles fonctionnalités

  • Ajout de l'instrumentation Vercel AI SDK avec prise en charge de la collecte automatique côté serveur Agent/LLM/Tool, des métriques time-to-first-token, de la collecte de span Agent/Tool/Embedding/Rerank et de la détection de métadonnées RAG.

  • Ajout de l'instrumentation Claude Agent.

Ajustements des fonctionnalités

  • Optimisation de la logique de génération de configuration ARMS avec validation des paramètres d'entrée pour prévenir les erreurs causées par des configurations invalides.

  • Optimisation du mécanisme d'interrogation de configuration distante avec gestion du cycle de vie du minuteur pour prévenir les fuites de ressources.

1.0.2

10 juin 2026

Nouvelles fonctionnalités

  • Ajout de l'instrumentation LangChain v1.x avec prise en charge de la résolution de nom d'agent, de l'extraction de définition d'outil, de l'intégration CommonJS et des métriques time-to-first-token pour les appels en streaming.

  • Ajout de l'instrumentation LangGraph avec prise en charge des scénarios createReactAgent et flux Pregel.

  • Ajout de l'identification de type d'application GenAI et de la collecte de métrique GenAI pour les scénarios d'appel OpenAI.

  • Ajout de la prise en charge de la configuration distante pour activer ou désactiver l'instrumentation LangChain et LangGraph.

Ajustements des fonctionnalités

  • Mise à jour de la configuration du plugin OpenAI pour inclure un contrôle traceContent.

  • Mise à jour de la logique de résolution de module ESM Loader pour la compatibilité avec LangSmith et ses dépendances de chemin relatif.

  • Mise à jour de la configuration de variable d'environnement pour inclure les variables recommandées ARMS_*, les mappages de variables héritées, les métadonnées Kubernetes et les paramètres d'exportateur et de traitement par lot.

Nouveaux plugins

  • Ajout du plugin LangChain v1.x.

  • Ajout du plugin LangGraph.

Corrections de bugs

  • Correction d'un problème où le package npm conservait des références aux dépendances internes @ali/* au moment de l'exécution.

  • Correction d'un problème où les relations parent-enfant de span LangChain étaient perdues dans les scénarios de gestionnaire asynchrone.

1.0.1

19 mai 2026

Nouvelles fonctionnalités

  • Ajout de la prise en charge de la configuration distante pour extraire les configurations depuis le serveur ARMS et appliquer les règles d'échantillonnage, les limites de span et les commutateurs de plugin.

  • Ajout de stratégies d'échantillonnage déclaratives : always-on, always-off, trace-id-ratio et parent-based.

  • Ajout de la prise en charge de la collecte de métriques, y compris l'exportateur de métrique, le processeur de métrique, l'intervalle de vidage, le délai d'expiration de rappel Observable et la configuration des statistiques d'exécution.

  • Ajout de la prise en charge du journal d'auto-surveillance de l'agent avec la configuration logExporter et logExportIntervalMs.

  • Ajout de la corrélation Log-Trace pour injecter automatiquement le contexte de trace dans les journaux d'application.

  • Ajout de la compatibilité avec Node.js 12.

Ajustements des fonctionnalités

  • Mise à jour de la détection de ressource NodeSDK par défaut pour intégrer les détecteurs de ressource Kubernetes et prendre en charge les attributs de ressource de cluster, namespace et workload ARMS.

  • Mise à jour de la logique de collecte de base de données et d'exécution pour inclure les métadonnées SQL, les métriques métier, les métriques d'auto-surveillance et les métriques d'exécution.

  • Mise à jour de la propagation du contexte de trace HTTP pour prendre en charge le transfert et l'injection du contexte de service amont EagleEye.

Nouveaux plugins

  • Ajout du plugin OpenAI avec la collecte d'utilisation de token enrichTokens.

  • Ajout des plugins de journalisation pino, winston, bunyan et console.

  • Ajout du plugin de métriques Runtime pour collecter les métriques de boucle d'événements, tas V8, garbage collection (GC) et processus.

  • Ajout du plugin KafkaJS v2.x.

  • Ajout de la collecte de métriques et de l'auto-surveillance au plugin gRPC.

Optimisations des performances

  • Optimisation de la collecte de métriques Node.js et V8 pour réduire le bruit et les données inutiles dans les scénarios d'erreur.

Corrections de bugs

  • Correction d'un problème où l'en-tête de requête traceparent était écrasé.

  • Correction d'un problème où l'extraction d'attribut de requête HTTP était incomplète.

  • Correction d'un problème où les requêtes de transmission de métrique étaient capturées par la collecte de trace métier.

  • Correction d'un problème où les métadonnées SQL et les métadonnées d'exception s'accumulaient sans être transmises lorsque le seuil de lot n'était pas atteint.

  • Correction d'un problème où l'attribut de ressource acs.arms.service.id était manquant.

1.0.0

3 décembre 2025

Nouvelles fonctionnalités

  • Ajout de l'instrumentation de traçage distribué pour les applications Node.js. Trois méthodes d'intégration sont prises en charge : ESM Loader, préchargement CommonJS et initialisation manuelle de NodeSDK.

  • Ajout de la prise en charge de la transmission de trace ARMS avec configuration du nom de service, de la clé de licence, de la région, de l'espace de travail, du projet et de l'ID de service.

  • Ajout de la détection automatique de ressource pour les attributs d'environnement d'exécution de processus et d'hôte.

Nouveaux plugins

  • Ajout des plugins HTTP, Express, Koa, Undici, gRPC, DNS, Socket.IO et Net pour les frameworks web et la mise en réseau Node.js.

  • Ajout des plugins MongoDB, Mongoose, MySQL, MySQL2, PostgreSQL, Redis, ioredis et Kafka pour les bases de données et la messagerie.

Composants et frameworks Node.js pris en charge

Frameworks Web

Framework

Versions prises en charge

Description

Express

>=4.0.0 <6

Instrumentation automatique

Koa

>=2.0.0 <4

Instrumentation automatique

Next.js

>=12.0.0 <17.0.0

Prise en charge des traces pour SSR, RSC, les routes API, les middlewares et autres chemins

Nuxt 3/Nitro/h3

h3 >=1.0.0 <2.0.0

hookable >=5.0.0 <6.0.0

Prise en charge des gestionnaires de serveur Nitro, des gestionnaires h3 et des hooks de rendu

Nuxt 2

>=2.3.0 <3.0.0

Prise en charge des chemins clés dans @nuxt/server, @nuxt/vue-renderer et @nuxt/core

Bases de données et stockage

Composant

Versions prises en charge

Description

MongoDB

>=3.3.0 <4

>=4.0.0 <7

Instrumentation automatique

Mongoose

>=5.9.7 <9

Instrumentation automatique

MySQL

>=2.0.0 <3

Instrumentation automatique

MySQL2

>=1.4.2 <4

Instrumentation automatique

PostgreSQL (pg)

pg >=8.0.3 <9

pg-pool >=2.0.0 <4

Instrumentation automatique

Redis

>=2.6.0 <4

Instrumentation automatique

ioredis

>=2.0.0 <6

Instrumentation automatique

Files d'attente de messages

Composant

Versions prises en charge

Description

Kafka (kafkajs)

>=0.3.0 <3

Instrumentation automatique

IA et IA générative

Composant

Versions prises en charge

Description

OpenAI

>=4 <6

Prise en charge de la configuration avancée des jetons

Vercel AI SDK

>=4.0.0 <7

Prise en charge de la collecte automatique des appels Agent, LLM et Tool, ainsi que des métriques time-to-first-token

LangChain

v1.x (instrumentation dynamique)

Prise en charge de la résolution du nom de l'agent, de l'extraction de la définition des outils et des métriques time-to-first-token pour les appels en streaming

LangGraph

v1.x (instrumentation dynamique)

Prise en charge de createReactAgent et des scénarios de flux Pregel

Claude Agent

>=0.3.0 <1

Prise en charge du traçage au niveau de granularité user_input

Frameworks de journalisation

Composant

Versions prises en charge

Description

pino

>=7.0.0 <11

Instrumentation automatique avec corrélation entre journaux et traces

winston

>=3.0.0 <4

Instrumentation automatique avec corrélation entre journaux et traces

bunyan

>=1.8.0 <3

Instrumentation automatique avec corrélation entre journaux et traces

console

Sans objet

Instrumentation automatique avec corrélation entre journaux et traces

Autres composants

Composant

Versions prises en charge

Description

HTTP/HTTPS

Intégré à Node.js

Instrumentation automatique

Undici

Inclus avec le runtime Node.js

Instrumentation automatique

gRPC

^1.0.0

Instrumentation automatique

DNS

Intégré à Node.js

Instrumentation automatique

Socket.IO

>=3 <5

Instrumentation automatique

Net

Intégré à Node.js

Instrumentation automatique

Runtime

Intégré à Node.js

Collecte les métriques Event Loop, V8 Heap, GC et Process