Node.js agent release notesRSS

Notes

Features

• Added browser_monitoring.version configuration option (#4269) (b62ca00)
  • When this is set, it will pin the browser agent version when using newrelic.getBrowserTimingHeader to the version selected.
  • If you specify a version that is no longer supported or invalid, it will not resolve to any browser agent when calling newrelic.getBrowserTimingHeader.

Bug fixes

• Updated undici instrumentation to not attempt to create an external segment when transaction is not active (#4278) (d634246)
• Updated http2 instrumentation to properly inject traceparent header with external segment id (#4279) (ccd7800)

Code refactoring

• Refactored child_process instrumentation to use tracing channel instead of Shim (#4212) (5a39c38)
• Refactored dns instrumentation to subscribe to events emitted (#4224) (c04289f)

Miscellaneous chores

• Regenerated agent config json schema (#4275) (c2107ed)
• Update secret naming (#4277) (09f5b25)

Tests

• Added legacy-peer-deps to google adk tests to avoid peer dep conflict (#4280) (e4a6b35)

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

Features

• Added support for MessageBroker/Kafka/Cluster/{cluster_id}/{Produce|Consume}/{topic_name} metrics (#4263) (3be98f1)
• Updated GCP hostname to support more Cloud Run instance types (#4256) (67bfd0d)

Bug fixes

• Fixed duplicated router mount path in transaction names for async middleware (#4272) (51a3bf4)
• Fixed otlp payload format for metrics in AWS Lambda (#4270) (5d29078) (upcoming feature; not yet available)

Documentation

• Updated compatibility report (#4273) (40b3172) (#4267) (b4fa928) (#4253) (9fe7038)

Miscellaneous chores

• Deprecated utilization.gcp_use_instance_as_host in favor of utilization.gcp_cloud_run.use_instance_as_host (#4258) (450303e)

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

• Prevented duplicate external segments when undici negotiates HTTP/2 (#4251) (c94b81b)

Code refactoring

• Split BedrockResponse and BedrockCommand into Converse and InvokeModel variants (#4235) (8235cf5)
• Updated Claude detection logic in InvokeModelCommand (#4245) (b090344)

Documentation

• Updated compatibility report (#4249) (f69eecd)

Miscellaneous chores

• Pinned nestjs to unblock CI (#4248) (44abb5d)

Tests

• Added type: module for @nestjs/core tests, including version 12 (#4252) (7971d05)

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 @google/adk instrumentation for v2.0.0 (#4243) (6f850a8)

Code refactoring

• Co-located Attributes and PrioritizedAttributes under lib/attributes/ (#4227) (c2a01d2)

Miscellaneous chores

• Added workflows to generate a config schema and version before agent release (#4161) (56987ca)

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 openai instrumentation to support >=7.5.0 (#4228) (062b569)

Performance improvements

• Skipped gRPC/http2 instrumentation when parent segment is opaque (#4220) (ed2e9f3)

Code refactoring

• Include all .mjs equivalents in openai instrumentation to properly function when using ESM (#4232) (55c4dd9)
• Removed dead wrapNoSegment code from zlib instrumentation (#4231) (56207ec)

Documentation

• Updated compatibility report (#4225) (679245c)

Miscellaneous chores

• Improved docs and benchmarking for attributes (#4207) (7dbcd04)

Tests

• Fixed flaky CpuProfiler and sampling-rate integration tests (#4229) (edfe9a6)
• Widened error margin in ratio-based-sampler flaky test (#4234) (ff0496e)

Continuous integration

• Updated child_process.exec calls to child_process.execFile in bin/npm-commands.js (#4211) (f07a8cd)

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 OTEL metrics wrapping meters too many times (#4216) (6f917ad)
• Improved Apollo server resolver instrumentation performance (#4206) (2a394e8)
• Updated getBrowserTimingHeader to handle when a transaction may not be finalized and still return the browser agent string without transaction intrinsics (#4209) (fbf636b)

Performance improvements

• Skipped context wrapping for skipped Apollo resolver segments (#4210) (6bf954b)

Documentation

• Updated compatibility report (#4202) (8811cd2)

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

Updated addAttribute to only increase the attributeCount for new attributes (#4184) (f05df73)

Documentation

Updated compatibility report (#4191) (5b5f8ce)

Miscellaneous chores

Reverted clean-jsdoc-theme to 4.x (#4192) (e7b3ddf)

Tests

• Added unit tests for bin/git-commands.js (#4199) (a8bb311)
• Sync cross agent tests and fix related DT assertions (#4198) (44388c0)

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

Bug fixes

• Set ignoreApdex warning log to trace-level (#4188) (79bac5e)

Documentation

• Updated compatibility report (#4176) (3886190)

Miscellaneous chores

• Removed update-snyk-prs workflow (#4185) (ab7722c)
• Restored scrollbar on API docs (#4181) (3ea46fb)
• Updated all @opentelemetry deps from 0.219.0 to 0.221.0 (#4179) (62c3779)
• Updated conventional commit dev deps to latest (#4178) (f4db525)
• Updated out of date dev deps: @matteo.collina/tspl, @newrelic/eslint-config, @slack/bolt, borp, c8, clean-jsdoc-theme, lint-staged and proxyquire (#4175) (e978762)

Continuous integration

• Added a poll npm workflow to ensure new package version exists before executing any dependent workflows (#4182) (224c4f9)
• Normalized how we retrieve agent version from package.json (#4183) (949e620)

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

Features

• Collect OTEL metrics in AWS Lambda (#4166) (204c166)
  • Feature not generally available as of 2026-07-27. A future release will enable the necessary plumbing for full functionality.

Bug fixes

• Updated openai instrumentation to cache the results of responses.parse chain on openai custom promises (#4173) (35dce3c)

Documentation

• Fixed typos in 14.3.1 release (#4170) (dd84830)
• Updated compatibility report (#4165) (33eceac)

Miscellaneous chores

• Updated @apm-js-collab/tracing-hooks to 0.13.0 (#4167) (153acec)
• Updated @octokit/rest to 22.x (#4172) (55d90c2)
• Updated commander to v15 and added unit tests for scripts that use it (#4168) (e409204)

Tests

• Updated runnables-streaming.js to consume the stream on the tracking metrics tests to avoid test time outs (#4169) (1a132bf)

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