Node.js agent release notesRSS

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

Notes

Bug fixes

• Fixed detecting AWS SDK message attributes presence (#3903) (e81dc61)

Tests

• Updated minAgentVersion for Anthropic versioned tests (#3900) (e1f6c32)
• Reorganized the test utilities in AWS versioned tests (#3895) (3025571)

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 support for @anthropic-ai/sdk (#3881) (e8713bb)
• Updated OTel DB attributes to stable names from semantic conventions 1.40.0 (#3826) (6d3000d)
• Added distributed tracing propagation to SNS (#3893) (8fc1144)

Code refactoring

• Refactor @aws-sdk v3 instrumentation to subscribe to events emitted
  • Added @aws-sdk/smithy-client subscriber (#3877) (0e350fc)
  • Added @smithy/smithy-client send subscriber with AWS Bedrock Middleware (#3864) (5e0a6d1)
  • Moved generic AWS Client middleware to subscriber (#3889) (3cb1e1b)
  • Updated aws-sdk/dynamodb instrumentation to a subscriber middleware (#3891) (ff677a2)
  • Updated aws sdk v3 instrumentation to split out bedrock utilities from actual wrapped middleware (#3883) (eed340e)
  • Updated Lambda instrumentation to a subscriber middleware (#3890) (12f8284)
  • Refactored SNS instrumentation to subscriber type (#3876) (b9f3326)
  • Refactored SQS instrumentation to subscriber type (#3880) (de46dee)
• Refactored LlmErrorMessage to use vendor-specific subclasses (#3882) (5b0fd2b)
• Refactored amqplib to use message broker constants (#3879) (77621fb)

Documentation

• Updated compatibility report (#3874) (ae887c4)

Miscellaneous chores

• Updated @apm-js-collab/tracing-hooks to 0.6.0 (#3884) (f6ef470)
• Updated Undici tests to cover version 8 (#3896) (f27e75f)

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

• Instrumented grpc server stream to bind async context to stream event handlers (#3855) (92c70a8)

Code refactoring

• Refactored when instrumentation to subscribe to events emitted (#3866) (1b55c5a)
• Refactored memcached instrumentation to subscribe to events emitted (#3849) (915b320)
• Refactored bluebird instrumentation to subscribe to events emitted (#3858) (e3d84c2)
• Refactored q instrumentation to subscribe to events emitted (#3853) (9fdb0b8)
• Refactored grpc-js client instrumentation to subscriber type (#3856) (057fca2)
• Refactored grpc-js server instrumentation to subscriber type (#3805) (ca3010a)
• Updated @langchain/core subscribers to properly instrument the tool class methods (#3850) (2d17eed)

Documentation

• Updated compatibility report (#3831) (9156a6a)

Miscellaneous chores

• Added subscriber packages to load-externals (#3868) (83adcc4)

Tests

• Removed unused context manager feature flag for running versioned tests (#3851) (15c9757)
• Updated core tracing cross agent tests (#3860) (08e4570)
• Fixed issue with span links test (#3863) (23a8594)
• Removed segment duration timing threshold in memcached tests (#3869) (bd24410)

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 Continuous Profiling (#3834) (6d8d5b5)
  • Added server-side configuration for profiling.enabled (#3790) (0d44e5b) (#3847) (e57223c)
  • Added delay + duration to ProfilingAggregator (#3815) (8000665)
  • Added supportability metrics for profiling (#3801) (19bbb7e)
  • Prevented ProfilingAggregator from running in serverless mode (#3806) (e4db0f4)
  • Disabled profiling.enabled when high security mode is enabled (#3803) (9d4eebb)
  • Added Heap profiler (#3751) (8262f6b)
  • Added Cpu Profiler (#3747) (2c2097f)

Note: Continuous Profiling UI is coming soon! While the Node.js agent now supports Continuous Profiling data collection, the visualization experience will debut in Limited Preview starting next week. If you would like to get early access to the profiling dashboards and UI features, please reach out to your Account Executive (AE) about how to opt-in to the preview.

Code refactoring

• Refactor winston instrumentation to subscribe to events emitted (#3808) (4af2f48)

Documentation

• Updated compatibility report (#3824) (0cfb356)

Tests

• Added segment duration tests for ioredis/iovalkey (#3825) (9738bc8)
• Added segment duration timing tests for mysql2 (#3820) (bb424ff)
• Changed structure of bedrock tests to avoid getting instrumented core libraries from first test (#3838) (886a36c)
• Changed structure of lambda and sns tests to avoid getting instrumented core libraries from first test (#3836) (414044d)
• Updated @aws-sdk/lib-dynamodb version range (#3829) (d28c938)

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 @apm-js-collab/tracing-hooks to 0.5.0, to allow instrumentation on windows environments. (#3819) (d8f6d0f)
  • This version of @apm-js-collab/tracing-hooks includes the windows path fix for @apm-js-collab/code-transformer, see.

Code refactoring

• Updated redis v3 instrumentation to subscribe to events emitted (#3802) (4d18302)

Documentation

• Updated compatibility report (#3813) (27cb0a5)

Tests

• Add redis-client and node-redis-client segment duration timing tests (#3810) (f07bcfe)

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 time_to_first_token for LlmChatCompletionSummary (#3781) (737f374)
• Added time_to_first_token for AWS Bedrock (#3804) (a993b00)
• Added time_to_first_token for Google Gen AI (#3785) (d90ee70)
• Added time_to_first_token for OpenAI (#3782) (07cfd57)

Code refactoring

• Migrated redis 4+ instrumentation to subscribe to events emitted (#3773) (add6827)

Documentation

• Updated compatibility report (#3800) (5228cdc) (#3795) (1d6fe52) (#3791) (e79db5b) (#3777) (12fe4c6)

Miscellaneous chores

• Added version comment for agent-metadata.yml (#3779) (1267293)
• Refactored nestjs instrumentation to subscriber type (#3792) (f7feb25)
• Removed @langchain/core peer dep from langchain openai and aws tests (#3788) (e670bb1)
• Removed unneccessary generic-pool context propagation (#3786) (bdd35fb)
• Removed unnecessary superagent context propagation (#3798) (81650e1)
• Updated @apm-js-collab/tracing-hooks to 0.4.0 (#3787) (d85fb2b)
• Updated version format in agent-metadata.yml (#3778) (61759e9)

Tests

• Updated langchain vectorstore tests to use a custom vectorstore to simplify the testing process (#3793) (0fd9b54)
• Updated version range for langgraph tests (#3794) (e02ce99)

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