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/severde 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.prefixRouteParametersya 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/cliy@nestjs/corea10.0.0 - Se actualizó la versión mínima compatible de
nexta 14 - Se actualizó la versión mínima admitida de
bluebirda3.0.0 - Se actualizó la versión mínima admitida de
mysql2a3.0.0 - Se actualizó la versión mínima compatible de
cassandra-drivera4.0.0 - Se eliminó el soporte para
fastify3.x - Se actualizó
config.distributed_tracing.exclude_newrelic_headerpara que se establezca entruepor defecto
Característica
- Se eliminó el soporte para
fastify3.x (#3980) (720979b) - Se eliminó el soporte para Node.js 20 (#3980) (5306223)
- Se migró la instrumentación de
@apollo/severde un plug-in(@newrelic/apollo-server-plugin) a la instrumentación tradicional (#3980) (736e0a4) - Se eliminó
shim.argsToArray(#3980) (9183d29) - Se eliminó
shim.prefixRouteParametersya 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#querysegmentos (#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_headerpara que se establezca entruepor defecto (#3980) (774ce08) - Se actualizó la versión mínima compatible para
cassandra-drivera4.0.0(#3980) (419337a) - Se actualizó la versión mínima compatible de
@nestjs/cliy@nestjs/corea10.0.0(#3980) (120e6de) - Se actualizó la versión mínima compatible de
bluebirda3.0.0(#3980) (369f920) - Se actualizó la versión mínima compatible de
mysql2a3.0.0(#3980) (2861406) - Se actualizó la versión mínima compatible de
nexta 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.bindFunctioncontracer.runInContextpara mejorar el rendimiento en las rutas críticas (#3811) (5d77085)
Documentación
Tareas varias
- Se eliminó
huskyen lugar de los hooks de git, se agregaron opciones de seguridad reforzada anpm install(#3988) (e3a7dda) - Se actualizaron las dependencias de producción a la última versión (#3996) (b710bac)
Pruebas
- Se agregó
minSupportedal 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-utiltiesal 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-v3para usargroupedDependencies(#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: writeapost-releasepara 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-artifacta 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/functionsal 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
connectpara manejar la reestructuración de archivos en<3.4.0(#3923) (00b615c) - Se actualizó
tracer.bindFunctionpara 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-client4.13.0+ (#3965) (5e0fe24)
Refactorización de código
- Se eliminó la dependencia de
AsyncLocalStorage.enterWithpara la instrumentación de undici, dominio yprocess._fatalException(#3894) (612b449)
Documentación
Tareas varias
- Se agregó una línea de log cuando se alcanza
max_trace_segments(#3933) (46b9238) - Comentar
assertSegmentDurationpara la pruebaclient-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
actualTimevssegmentDurationen las pruebas dememcached(#3932) (98c50e0) - Se actualizó
@apm-js-collab/tracing-hooksa0.7.0(#3949) (5c99cd1)
Pruebas
- Se agregó la aserción personalizada
assertSegmentDurationy se agregó amemcachedpruebas (#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_processpara evitar la fuga de manejadores de eventos suscritos aonce(#3907) (ad0b1f6)
Documentación
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
Pruebas
- Se actualizó
minAgentVersionpara 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\/)
Notas
Característica
- Se agregó soporte de instrumentación para
@anthropic-ai/sdk(#3881) (e8713bb) - Se actualizaron los atributos de base de datos de OTel a nombres estables de las convenciones semánticas 1.40.0 (#3826) (6d3000d)
- Se agregó la propagación de rastreo distribuido a SNS (#3893) (8fc1144)
Refactorización de código
Refactorizar la instrumentación de
@aws-sdkv3 para suscribirse a los eventos emitidos- Se agregó el suscriptor
@aws-sdk/smithy-client(#3877) (0e350fc) - Se agregó el suscriptor
@smithy/smithy-clientsendcon AWS Bedrock Middleware (#3864) (5e0a6d1) - Se movió el middleware genérico de AWS
Cliental suscriptor (#3889) (3cb1e1b) - Se actualizó la instrumentación de
aws-sdk/dynamodba un middleware de suscriptor (#3891) (ff677a2) - Instrumentación de AWS SDK v3 actualizada para separar las utilidades de bedrock del middleware envuelto real (#3883) (eed340e)
- Se actualizó la instrumentación de Lambda a un middleware de suscriptor (#3890) (12f8284)
- Se refactorizó la instrumentación de SNS al tipo de suscriptor (#3876) (b9f3326)
- Se refactorizó la instrumentación de SQS al tipo de suscriptor (#3880) (de46dee)
- Se agregó el suscriptor
Se refactorizó
LlmErrorMessagepara usar subclases específicas del proveedor (#3882) (5b0fd2b)Se refactorizó
amqplibpara usar constantes del agente de mensajes (#3879) (77621fb)
Documentación
Tareas varias
- Se actualizó
@apm-js-collab/tracing-hooksa0.6.0(#3884) (f6ef470) - Pruebas de Undici actualizadas para cubrir la versión 8 (#3896) (f27e75f)
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\/)