Notes
Features
- Added source mapping support to heap profiler (#4122) (dcee39f)
- Added source mapping support to CPU (wall time) profiler (#4095) (f6123bc)
- Added
otlp_resource_attributesto all outgoing OpenTelemetry metrics calls (#4128) (a0c1c5b) - Added support for
ai_monitoring.enabled,ai_monitoring.streaming.enabled, andai_monitoring.record_content.enabledto be assigned via server-side config (#4123) (c4d8032)
Bug fixes
- Fixed
bunyanlog forwarding multiple duplicate lines (#4132) (b0f4242) - Fixed OTEL crash when adding exceptions to spans (#4130) (508542e)
Documentation
Miscellaneous chores
- Changed
notify-release.ymlschedule with our bot user (#4135) (a9318ae) - Changed
versioned-security-agent.ymlschedule with our bot user (#4134) (d7c6f64) - Changed smoke-test schedule with our bot user (#4133) (400268e)
- Sharded the versioned tests w/ security agent workflow (#4119) (fe200c4)
- Updated test runner to accept suites as positional parameters (#4117) (ac0985d)
Tests
- Added more scenarios to winston for constructing loggers (#4120) (ea90fc3)
- Added skip for winston test for ranges that do not support it (#4121) (e75e15e)
- Applied sampling to
pg-nativetests to reduce the matrix under test (#4124) (b1ad2da) - Fixed flaky amqplib async-work duration assertions (#4118) (3544237)
- Removed timing race from common.request unit tests (#4113) (b22c25b)
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/)
Notes
Bug fixes
- Updated
winstoninstrumenting to assignhandleExceptionsto the first NrTransport to avoid registering duplicateuncaughtExceptionhandlers (#4108) (d60a48d)- This would create a linear memory leak because the
NrTransportobjects for loggers no longer in use, would not be freed because of the globalprocess.on('uncaughtException')handler
- This would create a linear memory leak because the
Documentation
Continuous integration
- Pinned CI npm to 11 so native versioned suites build on Node 22 (#4114) (b844e94)
- Removed the 8 minute versioned shard timeout (#4111) (0ef6374)
- Attempted to fix memcached CI issue again (#4098) (f67fef5)
- Shard versioned tests across CI runners (#4101) (1471734)
Tests
- Added
samplesto prisma and next to cut down on versions under test on packages we recommend using hybrid ageninstrumentation (#4112) (7d8bd7c) - Resolved
grpcproto-loaderfrom the running suite'snode_modules(#4110) (5b5a9f8)
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/)
Notes
Features
- Added Node.js 26 support (#4084) (4a7f777)
- Added
span_idandtrace_idlabels toCpuProfilersample data (#4049) (c2b1737) - Added new GCP Cloud Run hostname logic to include
K_REVISION(#4069) (02855dc) - Added
profiling.source_mapping.enabledconfig option (#4090) (43add80) - Removed
spanIdin outgoingtracestateheader (#4091) (40a8bf1)
Code refactoring
Documentation
Miscellaneous chores
- Addressed long standing CI flakes (#4093) (ae973a0)
- Fixed package version resolution on Node 26 (#4094) (73d14a9)
Continuous integration
- Updated
release-creationto uselts/*for node-version (#4080) (7eaed22) - Updated
setup-nodejob to includecheck-latestto ensure we are getting the latest version of node (#4079) (4a425f6)
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/)
Corrección de errores
Se solucionó el bloqueo de Azure Functions cuando incluyen encabezados de respuesta (#4070) (c88d2b7)
Documentación
Informe de compatibilidad actualizado (#4067) (0ae24b8)
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.
Consulta la política de EOL del agente de Node.js de New Relic para obtener información sobre las versiones del agente y las fechas de soporte.
Notas
Documentación
- Se eliminó la documentación desactualizada de Next.js en el repositorio (#4060) (185bb66)
- Informe de compatibilidad actualizado (#4047) (25cbd38)
Tareas varias
- Se agregó soporte de configuración de proxy a las métricas de OTEL (#4041) (6c04b8a)
- Se agregaron métricas de compatibilidad a la exportación de métricas de OTEL (#4051) (db6e4e3)
- Se actualizó la versión mínima de los paquetes
@opentelemetry0.xa^0.219.0(#4065) (3f58ad0)
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 para la instrumentación nativa de OTEL de Next.js a través del agente híbrido (#4040) (1944f39)
Corrección de errores
- Se actualizó el analizador de etiquetas para manejar valores vacíos en una clave de objeto (#4004) (73c00d7)
Refactorización de código
- Migrar
@hapi/hapiy@hapi/visiona un modelo basado en suscriptores (#3995) (54c60a8) - Se refactorizó la instrumentación de
koapara suscribirse a los eventos emitidos (#4016) (e1f6c27) - Se actualizó MiddlewareWrapper
maybeHandleErrorpara marcar el error como manejado solo si había un error almacenado previamente (#4032) (1b21cc8)
Documentación
- Se eliminó el enlace a
@newrelic/apollo-server-pluginya que la instrumentación se fusionó en el agente (#4003) (9afd9cb) - Se movieron los documentos de
apollo-serveral sitio web de documentación (#3994) (11ca2ae) - Reporte de compatibilidad actualizado (#4028) (b16ad6e) (#4014) (3efa1ff) (#4002) (33a8236)
Tareas varias
Descontinuar la API
instrumentLoadedModule(#4034) (306ff86)Se agregó el logging de auditoría para las métricas de OTEL (#4018) (494c836)
Se agregó una regla de OTEL para admitir Prisma 7 (#4013) (c142c60)
Se refactorizaron las reglas de transformación de OTEL (#3999) (48ff739)
Se corrigió node-version en el flujo de trabajo de CI (#4042) (dd05ea9)
Se actualizó remote-method para usar el método audit de logger (#4038) (0e4507e)
Se agregaron instrucciones de línea de base para el bot Claude (#4036) (c8f6649)
Dependencias actualizadas
- Se eliminaron las dependencias de desarrollo no utilizadas (#4005) (e00f7d3)
- Se actualizó
@apm-js-collab/tracing-hooksa0.9.1(#4043) (f05e5d4) - Se actualizó
commandera la última versión (#4021) (83b1d58) - Se actualizó
nocka la última versión (#4022) (9bf79ab) - Se actualizó
sinona la última versión (#4020) (0ced304) - Se actualizó
protobufjsa la última versión (#4006) (45c61f3) - Se actualizó
globa 13 (#4008) (3053545) - Se actualizaron
gotyrimrafa la última versión (#4007) (b967593)
Pruebas
- Agrega un shim
http.requestestable para que la configuración del agente de prueba de AWS funcione con smithy >=4.7.3 (#4010) (c5fd80a) - Se agregó una prueba versionada de undici para verificar el comportamiento al usar un certificado autofirmado y
undici.Agent(#4026) (27507bc) - Refactorizar las pruebas de
mongodb-esmpara probar>=4.1.4(#4023) (d85767f) - Se eliminó la dependencia de
globen favor defs.glob(#4019) (204f124) - Se actualizó la prueba versionada de undici.Agent para omitir el uso del despachador personalizado en las versiones <5.2.0, ya que no era compatible (#4029) (08cd079)
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\/)
Notes
⚠ BREAKING CHANGES
This version of the Node.js agent is a SemVer MAJOR update and contains the following breaking changes. MAJOR versions may drop support for language runtimes that have reached End-of-Life according to the maintainer. Additionally, MAJOR versions may drop support for and remove certain instrumentation. For more details on these changes please see the migration guide.
- Dropped support for Node.js 20
- Migrated
@apollo/severinstrumentation from a plugin(@newrelic/apollo-server-plugin) to traditional instrumentation - Removed Cross Application Tracing(CAT) functionality
- Removed support for License, Application, and Security Policies(LASP)
- Removed instrumentation for
koa-route - Removed instrumentation for
koa-router - Removed
shim.prefixRouteParametersas the logic was previously moved to when a transaction ends - Removed creating
MySQL Pool#querysegments - Removed
shim.argsToArray - Updated minimum supported version of
@nestjs/cliand@nestjs/coreto10.0.0 - Updated minimum supported version of
nextto 14 - Updated minimum supported version of
bluebirdto3.0.0 - Updated minimum supported version of
mysql2to3.0.0 - Updated minimum supported version for
cassandra-driverto4.0.0 - Dropped support for
fastify3.x - Updated
config.distributed_tracing.exclude_newrelic_headerto be set totrueby default
Features
- Dropped support for
fastify3.x (#3980) (720979b) - Dropped support for Node.js 20 (#3980) (5306223)
- Migrated
@apollo/severinstrumentation from a plugin(@newrelic/apollo-server-plugin) to traditional instrumentation (#3980) (736e0a4) - Removed
shim.argsToArray(#3980) (9183d29) - Removed
shim.prefixRouteParametersas the logic was previously moved to when a transaction ends (#3980) (9f1408e) - Removed creating
MySQL Pool#querysegments (#3980) (1d5a6dd) - Removed Cross Application Tracing(CAT) functionality (#3980) (a87ed4d)
- Removed instrumentation for
koa-route(#3980) (40c10d9) - Removed instrumentation for
koa-router(#3980) (038ecc7) - Removed support for License, Application, and Security Policies(LASP) (#3980) (bc09485)
- Updated
config.distributed_tracing.exclude_newrelic_headerto be set totrueby default (#3980) (774ce08) - Updated minimum supported version for
cassandra-driverto4.0.0(#3980) (419337a) - Updated minimum supported version of
@nestjs/cliand@nestjs/coreto10.0.0(#3980) (120e6de) - Updated minimum supported version of
bluebirdto3.0.0(#3980) (369f920) - Updated minimum supported version of
mysql2to3.0.0(#3980) (2861406) - Updated minimum supported version of
nextto 14 (#3980) (80c5c0c)
Code refactoring
- Updated how exclusive time and trace total time is calculated (#3980) (b227ed6)
- Updated instances of
tracer.bindFunctionwithtracer.runInContextto improve performance in hot paths (#3811) (5d77085)
Documentation
Miscellaneous chores
- Removed
huskyin lieu of git hooks, added security hardened options tonpm install(#3988) (e3a7dda) - Updated production dependencies to the latest (#3996) (b710bac)
Tests
- Added
minSupportedto the nest js versioned tests package.json to ensure the compatibility report will show we support@nestjs/core(#3982) (bfa4aa1) - Added prisma 7 tests (#3980) (116ee9c)
- Moved versioned test runner code from
@newrelic/test-utiltiesto agent (#3980) (d4f9a0c) - Removed
@newrelic/test-utilities(#3980) (1751147) - Decrease smoke-like esm tests' sample size (#3986) (40669fb)
- Fixed
test/lib/get-package-version.js(#3993) (5d31f08) - Fixed version lookup issue in aws-sdk-v3 tests (#3992) (7be3f4a)
- Restructure
aws-sdk-v3test runner to usegroupedDependencies(#3984) (fc67490) - Updated a few versioned test stanzas to reduce the number of combinations it runs (#3991) (d606305)
Continuous integration
- Added
contents: writetopost-releaseto allow commit/push of api docs (#3978) (90c4e61) - Updated remaining actions so they are running on Node 24 (#3980) (ea21934)
- Updated version of
actions/download-artifactto v8 (#3980) (54a58b9) - Updated versions of actions to ensure they are running on node 24 (#3980) (6302002)
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/)