Node.js agent release notesRSS

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

Notes

Features

• Add internal OTEL API to agent (#4147) (b014f82)
• Collect on-CPU time alongside wall time in CpuProfiler (#4146) (3b440f3)

Bug fixes

• Avoid unconditional @opentelemetry/core require on agent startup (#4163) (f31bbe4)

Documentation

• Updated compatibility report (#4160) (8ba64fb)

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

• Resolved mongodb host details at operation time to support mongodb+srv:// clients (#4155) (7fd4443)

Documentation

• Updated compatibility report (#4156) (6058cf7) (#4153) (136f65a)

Miscellaneous chores

• Translated OTel exception into timed event (#4151) (36daebe)

Tests

• Fixed srv-connect DNS patching across mongodb driver versions (#4158) (ca4a7b0)

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

• Handled $0 as a replacement in a metric normalization rule to return the matched string in its entirety (#4150) (b57fcc8)

Documentation

• Updated compatibility report (#4137) (3c1a2b3)

Miscellaneous chores

• Attached serverless mode config to agent instance (#4140) (7a3592f)
• Removed dead otlp_endpoint config option (#4142) (05b072f)

Continuous integration

• Reverted CI schedules to previous schedules (#4139) (b6f8708)

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