Node.js agent release notesRSS

Notes

Features

• Added support for native Next.js OTEL instrumentation via the Hybrid Agent (#4040) (1944f39)

Bug fixes

• Updated label parser to handle empty values in an object key (#4004) (73c00d7)

Code refactoring

• Migrate @hapi/hapi and @hapi/vision to subscriber-based (#3995) (54c60a8)
• Refactored koa instrumentation to subscribe to events emitted (#4016) (e1f6c27)
• Updated MiddlewareWrapper maybeHandleError to only mark error as handled if there was a previously stored error (#4032) (1b21cc8)

Documentation

• Removed linked to @newrelic/apollo-server-plugin as instrumentation was merged into agent (#4003) (9afd9cb)
• Moved apollo-server docs to the docs website (#3994) (11ca2ae)
• Updated compatibility report (#4028) (b16ad6e) (#4014) (3efa1ff) (#4002) (33a8236)

Miscellaneous chores

• Deprecate instrumentLoadedModule API (#4034) (306ff86)
• Added audit logging for OTEL metrics (#4018) (494c836)
• Added OTEL rule to support Prisma 7 (#4013) (c142c60)
• Fix ordering of OTEL rules (#4025) (150476a)
• Refactored OTEL transform rules (#3999) (48ff739)
• Fixed node-version in CI workflow (#4042) (dd05ea9)
• Updated codecov action (#4039) (31b9c84)
• Updated remote-method to use audit method of logger (#4038) (0e4507e)
• Added baseline instructions for Claude bot (#4036) (c8f6649)
• Updated dependencies
  • Removed unused dev dependencies (#4005) (e00f7d3)
  • Updated @apm-js-collab/tracing-hooks to 0.9.1 (#4043) (f05e5d4)
  • Updated commander to latest (#4021) (83b1d58)
  • Updated nock to latest (#4022) (9bf79ab)
  • Updated sinon to latest (#4020) (0ced304)
  • Updated protobufjs to latest (#4006) (45c61f3)
  • Upgraded glob to 13 (#4008) (3053545)
  • Upgraded got and rimraf to latest (#4007) (b967593)

Tests

• Add stable http.request shim so AWS test agent setup works with smithy >=4.7.3 (#4010) (c5fd80a)
• Added an undici versioned test to assert behavior with using a self signed cert and undici.Agent (#4026) (27507bc)
• Refactor mongodb-esm tests to test >=4.1.4 (#4023) (d85767f)
• Removed reliance on glob in lieu of fs.glob (#4019) (204f124)
• Updated undici.Agent versioned test to skip using custom dispatcher on versions <5.2.0 as it was not supported (#4029) (08cd079)

Support statement:

We recommend updating to the latest agent version as soon as it's available. If you can't upgrade to the latest version, update your agents to a version no more than 90 days old. Read more about keeping agents up to date. (https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/)

See the New Relic Node.js agent EOL policy for information about agent releases and support dates. (https://docs.newrelic.com/docs/apm/agents/nodejs-agent/getting-started/nodejs-agent-eol-policy/)

Notas

⚠ CAMBIOS CRÍTICOS

Esta versión del agente Node.js es una actualización IMPORTANTE de SemVer y contiene los siguientes cambios importantes. Las versiones PRINCIPALES pueden dejar de brindar soporte para entornos de ejecución de idiomas que llegaron al final de su vida útil según el mantenedor. Además, es posible que las versiones PRINCIPALES dejen de ofrecer soporte para cierta instrumentación y la eliminen. Para obtener más detalles sobre estos cambios, consulte la guía de migración.

• Se eliminó el soporte para Node.js 20
• Se migró la instrumentación de @apollo/sever de un plug-in (@newrelic/apollo-server-plugin) a instrumentación tradicional
• Se eliminó la funcionalidad de rastreo multiaplicación (CAT)
• Se eliminó el soporte para las políticas de licencia, aplicación y seguridad (LASP)
• Se eliminó la instrumentación para koa-route
• Se eliminó la instrumentación para koa-router
• Se eliminó shim.prefixRouteParameters ya que la lógica se movió previamente al momento en que finaliza una transacción
• Se eliminó la creación de segmentos MySQL Pool#query
• Remoto shim.argsToArray
• Se actualizó la versión mínima compatible de @nestjs/cli y @nestjs/core a 10.0.0
• Se actualizó la versión mínima compatible de next a 14
• Se actualizó la versión mínima admitida de bluebird a 3.0.0
• Se actualizó la versión mínima admitida de mysql2 a 3.0.0
• Se actualizó la versión mínima compatible de cassandra-driver a 4.0.0
• Se eliminó el soporte para fastify 3.x
• Se actualizó config.distributed_tracing.exclude_newrelic_header para que se establezca en true por defecto

Característica

• Se eliminó el soporte para fastify 3.x (#3980) (720979b)
• Se eliminó el soporte para Node.js 20 (#3980) (5306223)
• Se migró la instrumentación de @apollo/sever de un plug-in(@newrelic/apollo-server-plugin) a la instrumentación tradicional (#3980) (736e0a4)
• Se eliminó shim.argsToArray (#3980) (9183d29)
• Se eliminó shim.prefixRouteParameters ya que la lógica se movió previamente al momento en que finaliza una transacción (#3980) (9f1408e)
• Se eliminó la creación de MySQL Pool#query segmentos (#3980) (1d5a6dd)
• Se eliminó la funcionalidad de rastreo multiaplicación (CAT) (#3980) (a87ed4d)
• Se eliminó la instrumentación para koa-route (#3980) (40c10d9)
• Se eliminó la instrumentación para koa-router (#3980) (038ecc7)
• Se eliminó el soporte para las políticas de licencia, aplicación y seguridad (LASP) (#3980) (bc09485)
• Se actualizó config.distributed_tracing.exclude_newrelic_header para que se establezca en true por defecto (#3980) (774ce08)
• Se actualizó la versión mínima compatible para cassandra-driver a 4.0.0 (#3980) (419337a)
• Se actualizó la versión mínima compatible de @nestjs/cli y @nestjs/core a 10.0.0 (#3980) (120e6de)
• Se actualizó la versión mínima compatible de bluebird a 3.0.0 (#3980) (369f920)
• Se actualizó la versión mínima compatible de mysql2 a 3.0.0 (#3980) (2861406)
• Se actualizó la versión mínima compatible de next a 14 (#3980) (80c5c0c)

Refactorización de código

• Se actualizó cómo se calculan el tiempo exclusivo y el tiempo total de la traza (#3980) (b227ed6)
• Se actualizaron las instancias de tracer.bindFunction con tracer.runInContext para mejorar el rendimiento en las rutas críticas (#3811) (5d77085)

Documentación

• Informe de compatibilidad actualizado (#3990) (f3bb380)

Tareas varias

• Se eliminó husky en lugar de los hooks de git, se agregaron opciones de seguridad reforzada a npm install (#3988) (e3a7dda)
• Se actualizaron las dependencias de producción a la última versión (#3996) (b710bac)

Pruebas

• Se agregó minSupported al package.json de las pruebas versionadas de nest js para asegurar que el informe de compatibilidad muestre que admitimos @nestjs/core (#3982) (bfa4aa1)
• Se agregaron pruebas de prisma 7 (#3980) (116ee9c)
• Se movió el código del ejecutor de pruebas versionado de @newrelic/test-utilties al agente (#3980) (d4f9a0c)
• Se eliminó @newrelic/test-utilities (#3980) (1751147)
• Reducir el tamaño de la muestra de las pruebas esm tipo smoke (#3986) (40669fb)
• Se solucionó test/lib/get-package-version.js (#3993) (5d31f08)
• Se corrigió el problema de búsqueda de versión en las pruebas de aws-sdk-v3 (#3992) (7be3f4a)
• Reestructurar el ejecutor de pruebas aws-sdk-v3 para usar groupedDependencies (#3984) (fc67490)
• Se actualizaron algunos bloques de prueba versionados para reducir el número de combinaciones que ejecuta (#3991) (d606305)

integración continua

• Se agregó contents: write a post-release para permitir el commit/push de la documentación de la API (#3978) (90c4e61)
• Se actualizaron las acciones restantes para que se ejecuten en Node 24 (#3980) (ea21934)
• Versión actualizada de actions/download-artifact a v8 (#3980) (54a58b9)
• Versiones actualizadas de las acciones para garantizar que se ejecuten en node 24 (#3980) (6302002)

Declaración de apoyo:

Recomendamos actualizar a la última versión del agente tan pronto como esté disponible. Si no puede actualizar a la última versión, actualice su agente a una versión que no tenga más de 90 días de antigüedad. Obtenga más información sobre cómo mantener al agente actualizado. (https:\/\/docs.newrelic.com\/docs\/new-relic-solutions\/new-relic-one\/install-configure\/update-new-relic-agent\/)

Consulte la política de EOL del agente Node.js de New Relic para obtener información sobre los lanzamientos del agente y las fechas de soporte. (https:\/\/docs.newrelic.com\/docs\/apm\/agents\/nodejs-agent\/getting-started\/nodejs-agent-eol-policy\/)

Notas

Característica

• Se agregó instrumentación para Google ADK BaseAgent.runAsync (#3905) (c6c51d5)
• Instrumento Google ADK FunctionTool.runAsync (#3935) (57f9ed7)
• Se actualizó la instrumentación de @azure/functions al tipo de suscriptor (#3915) (227e779)
• Se actualizó cómo se ocultan las claves de licencia en los logs (#3945) (6289502)

Corrección de errores

• Se actualizaron las consultas de instrumentación de connect para manejar la reestructuración de archivos en <3.4.0 (#3923) (00b615c)
• Se actualizó tracer.bindFunction para tocar el segmento si una promesa se cumple o se rechaza (#3967) (712db61)
• Se actualizó la instrumentación de AWS SDK v3 para manejar el uso de @smithy/smithy-client 4.13.0+ (#3965) (5e0fe24)

Refactorización de código

• Se eliminó la dependencia de AsyncLocalStorage.enterWith para la instrumentación de undici, dominio y process._fatalException (#3894) (612b449)

Documentación

• Reporte de compatibilidad actualizado (#3941) (214b353) (#3934) (5a962d4) (#3909) (ad6fa8a)

Tareas varias

• Se agregó una línea de log cuando se alcanza max_trace_segments (#3933) (46b9238)
• Comentar assertSegmentDuration para la prueba client-dynamodb (#3972) (590cd3e)
• Se solucionó el problema con las pruebas de amqplib (#3969) (a770000)
• Se refactorizó la instrumentación de Connect al tipo de suscriptor (#3912) (e5d87b7)
• Se refactorizó la instrumentación de kafkajs al tipo de suscriptor (#3958) (72e383c)
• Eliminar la aserción actualTime vs segmentDuration en las pruebas de memcached (#3932) (98c50e0)
• Se actualizó @apm-js-collab/tracing-hooks a 0.7.0 (#3949) (5c99cd1)

Pruebas

• Se agregó la aserción personalizada assertSegmentDuration y se agregó a memcached pruebas (#3875) (b28d866)

integración continua

• Se aplicó el modelo de mínimo privilegio a todos los flujos de trabajo para satisfacer a CodeQL (#3961) (237d5b9)

Declaración de apoyo:

Recomendamos actualizar a la última versión del agente tan pronto como esté disponible. Si no puede actualizar a la última versión, actualice su agente a una versión que no tenga más de 90 días de antigüedad. Obtenga más información sobre cómo mantener al agente actualizado. (https:\/\/docs.newrelic.com\/docs\/new-relic-solutions\/new-relic-one\/install-configure\/update-new-relic-agent\/)

Consulte la política de EOL del agente Node.js de New Relic para obtener información sobre los lanzamientos del agente y las fechas de soporte. (https:\/\/docs.newrelic.com\/docs\/apm\/agents\/nodejs-agent\/getting-started\/nodejs-agent-eol-policy\/)

Notas

Corrección de errores

• Se corrigió la instrumentación de child_process para evitar la fuga de manejadores de eventos suscritos a once (#3907) (ad0b1f6)

Documentación

• Informe de compatibilidad actualizado (#3897) (0ed2202)

Declaración de apoyo:

Recomendamos actualizar a la última versión del agente tan pronto como esté disponible. Si no puede actualizar a la última versión, actualice su agente a una versión que no tenga más de 90 días de antigüedad. Obtenga más información sobre cómo mantener al agente actualizado. (https:\/\/docs.newrelic.com\/docs\/new-relic-solutions\/new-relic-one\/install-configure\/update-new-relic-agent\/)

Consulte la política de EOL del agente Node.js de New Relic para obtener información sobre los lanzamientos del agente y las fechas de soporte. (https:\/\/docs.newrelic.com\/docs\/apm\/agents\/nodejs-agent\/getting-started\/nodejs-agent-eol-policy\/)

Notas

Corrección de errores

• Se corrigió la detección de la presencia de atributos de mensaje del SDK de AWS (#3903) (e81dc61)

Pruebas

• Se actualizó minAgentVersion para las pruebas versionadas de Anthropic (#3900) (e1f6c32)
• Se reorganizaron las utilidades de prueba en las pruebas versionadas de AWS (#3895) (3025571)

Declaración de apoyo:

Recomendamos actualizar a la última versión del agente tan pronto como esté disponible. Si no puede actualizar a la última versión, actualice su agente a una versión que no tenga más de 90 días de antigüedad. Obtenga más información sobre cómo mantener al agente actualizado. (https:\/\/docs.newrelic.com\/docs\/new-relic-solutions\/new-relic-one\/install-configure\/update-new-relic-agent\/)

Consulte la política de EOL del agente Node.js de New Relic para obtener información sobre los lanzamientos del agente y las fechas de soporte. (https:\/\/docs.newrelic.com\/docs\/apm\/agents\/nodejs-agent\/getting-started\/nodejs-agent-eol-policy\/)