Node.js agent release notesRSS

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_attributes to all outgoing OpenTelemetry metrics calls (#4128) (a0c1c5b)
• Added support for ai_monitoring.enabled,ai_monitoring.streaming.enabled, and ai_monitoring.record_content.enabled to be assigned via server-side config (#4123) (c4d8032)

Bug fixes

• Fixed bunyan log forwarding multiple duplicate lines (#4132) (b0f4242)
• Fixed OTEL crash when adding exceptions to spans (#4130) (508542e)

Documentation

• Updated compatibility report (#4125) (405b59b) (#4107) (267a964)

Miscellaneous chores

• Changed notify-release.yml schedule with our bot user (#4135) (a9318ae)
• Changed versioned-security-agent.yml schedule 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-native tests 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 winston instrumenting to assign handleExceptions to the first NrTransport to avoid registering duplicate uncaughtException handlers (#4108) (d60a48d)
  • This would create a linear memory leak because the NrTransport objects for loggers no longer in use, would not be freed because of the global process.on('uncaughtException') handler

Documentation

• Updated compatibility report (#4099) (058fde6)

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 samples to prisma and next to cut down on versions under test on packages we recommend using hybrid ageninstrumentation (#4112) (7d8bd7c)
• Resolved grpc proto-loader from the running suite's node_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_id and trace_id labels to CpuProfiler sample data (#4049) (c2b1737)
• Added new GCP Cloud Run hostname logic to include K_REVISION (#4069) (02855dc)
• Added profiling.source_mapping.enabled config option (#4090) (43add80)
• Removed spanId in outgoing tracestate header (#4091) (40a8bf1)

Code refactoring

• Refactored mongodb instrumentation to subscribe to events emitted (#4059) (d2777ba)

Documentation

• Updated compatibility report (#4078) (047a063)

Miscellaneous chores

• Addressed long standing CI flakes (#4093) (ae973a0)
• Fixed package version resolution on Node 26 (#4094) (73d14a9)

Continuous integration

• Updated release-creation to use lts/* for node-version (#4080) (7eaed22)
• Updated setup-node job to include check-latest to 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/)

Bug fixes

Fixed Azure functions crashing when they include response headers (#4070) (c88d2b7)

Documentation

Updated compatibility report (#4067) (0ae24b8)

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.

See the New Relic Node.js agent EOL policy for information about agent releases and support dates.

Notes

Documentation

• Removed outdated Next.js documentation in repo (#4060) (185bb66)
• Updated compatibility report (#4047) (25cbd38)

Miscellaneous chores

• Added proxy config support to OTEL metrics (#4041) (6c04b8a)
• Added supportability metrics to OTEL metrics export (#4051) (db6e4e3)
• Updated min version of @opentelemetry 0.x packages to ^0.219.0 (#4065) (3f58ad0)

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 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/)

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/sever instrumentation 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.prefixRouteParameters as the logic was previously moved to when a transaction ends
• Removed creating MySQL Pool#query segments
• Removed shim.argsToArray
• Updated minimum supported version of @nestjs/cli and @nestjs/core to 10.0.0
• Updated minimum supported version of next to 14
• Updated minimum supported version of bluebird to 3.0.0
• Updated minimum supported version of mysql2 to 3.0.0
• Updated minimum supported version for cassandra-driver to 4.0.0
• Dropped support for fastify 3.x
• Updated config.distributed_tracing.exclude_newrelic_header to be set to true by default

Features

• Dropped support for fastify 3.x (#3980) (720979b)
• Dropped support for Node.js 20 (#3980) (5306223)
• Migrated @apollo/sever instrumentation from a plugin(@newrelic/apollo-server-plugin) to traditional instrumentation (#3980) (736e0a4)
• Removed shim.argsToArray (#3980) (9183d29)
• Removed shim.prefixRouteParameters as the logic was previously moved to when a transaction ends (#3980) (9f1408e)
• Removed creating MySQL Pool#query segments (#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_header to be set to true by default (#3980) (774ce08)
• Updated minimum supported version for cassandra-driver to 4.0.0 (#3980) (419337a)
• Updated minimum supported version of @nestjs/cli and @nestjs/core to 10.0.0 (#3980) (120e6de)
• Updated minimum supported version of bluebird to 3.0.0 (#3980) (369f920)
• Updated minimum supported version of mysql2 to 3.0.0 (#3980) (2861406)
• Updated minimum supported version of next to 14 (#3980) (80c5c0c)

Code refactoring

• Updated how exclusive time and trace total time is calculated (#3980) (b227ed6)
• Updated instances of tracer.bindFunction with tracer.runInContext to improve performance in hot paths (#3811) (5d77085)

Documentation

• Updated compatibility report (#3990) (f3bb380)

Miscellaneous chores

• Removed husky in lieu of git hooks, added security hardened options to npm install (#3988) (e3a7dda)
• Updated production dependencies to the latest (#3996) (b710bac)

Tests

• Added minSupported to 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-utilties to 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-v3 test runner to use groupedDependencies (#3984) (fc67490)
• Updated a few versioned test stanzas to reduce the number of combinations it runs (#3991) (d606305)

Continuous integration

• Added contents: write to post-release to 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-artifact to 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/)

Notes

Features

• Added instrumentation for Google ADK BaseAgent.runAsync (#3905) (c6c51d5)
• Instrument Google ADK FunctionTool.runAsync (#3935) (57f9ed7)
• Updated @azure/functions instrumentation to subscriber type (#3915) (227e779)
• Updated how license keys are redacted in logs (#3945) (6289502)

Bug fixes

• Updated connect instrumentation queries to handle file restructure in <3.4.0 (#3923) (00b615c)
• Updated tracer.bindFunction to touch segment if a promise is fulfilled or rejected (#3967) (712db61)
• Updated aws sdk v3 instrumentation to handle using @smithy/smithy-client 4.13.0+ (#3965) (5e0fe24)

Code refactoring

• Removed reliance on AsyncLocalStorage.enterWith for undici, domain and process._fatalException instrumentation (#3894) (612b449)

Documentation

• Updated compatibility report (#3941) (214b353) (#3934) (5a962d4) (#3909) (ad6fa8a)

Miscellaneous chores

• Added log line when max_trace_segments is hit (#3933) (46b9238)
• Comment out assertSegmentDuration for client-dynamodb test (#3972) (590cd3e)
• Fix issue with amqplib tests (#3969) (a770000)
• Refactored Connect instrumentation to subscriber type (#3912) (e5d87b7)
• Refactored kafkajs instrumentation to subscriber type (#3958) (72e383c)
• Remove actualTime vs segmentDuration assertion in memcached tests (#3932) (98c50e0)
• Updated @apm-js-collab/tracing-hooks to 0.7.0 (#3949) (5c99cd1)

Tests

• Added assertSegmentDuration custom assertion and added it to memcached tests (#3875) (b28d866)

Continuous integration

• Applied least-privilege model to all workflows to appease CodeQL (#3961) (237d5b9)

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

• Fixed child_process instrumentation to avoid leaking event handlers subscribed to once (#3907) (ad0b1f6)

Documentation

• Updated compatibility report (#3897) (0ed2202)

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/)