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 18
• Updated min supported version for fastify to 3.0.0, pino to 8.0.0, and koa-router to 12.0.0

Features

• Dropped support for Node.js 18 (#3097) (cb7c080)
• Updated min supported version for fastify, pino, and koa-router (#3108) (ae9e21d)

Documentation

• Updated AI Monitoring compatibility docs with new AWS Bedrock APIs (#3230) (e1ff0d3)
• Updated compatibility report (#3237) (dc85e4e)

Tests

• Fixed assertSegments to insert all expected segments (#3239) (de183fb)
• Updated tests to mock outgoing calls to avoid issues in CI (#3234) (66694c6)

Continuous integration

• Updated prepare release to exclude semver major copy for repos other than node-newrelic (#3242) (82d9689)
• Updated release prep to add copy around breaking changes (#3199) (ca1131c)

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

• Instrument AWS Bedrock Converse API (#3191) (16ac684)

Bug fixes

• eventSegment.addAttribute will not crash if null (#3215) (8955f37)
• openai Responses API support changed to >=v4.87.0 (#3219) (19c0c70)

Documentation

• Updated compatibility report (#3220) (b4350c7)

Miscellaneous chores

• Converted .proto to .json for bundling (#3212) (1e208d4)

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

• Implemented configurable attribute value size limit (#3206) (08a6eca)

Documentation

• Updated compatibility report (#3190) (72c492c)

Miscellaneous chores

• Rename GCP ID config flag (#3205) (8446f29)

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 ability to report only on entry and exit spans (#3184) (1f909d3)
• Added Node.js 24 support (#3080) (a538c2a)

Documentation

• Updated compatibility report (#3186) (5498c15)

Miscellaneous chores

• Fix issues on Node 24 (#3181) (24832df)
• Removed force labels on main CI workflow (#3183) (3aaee17)
• Updated undici tests to unblock CI (#3185) (08261eb)

Continuous integration

• Fixed the name of todo colum in add to board reusable workflow (#3178) (f216e0c)

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 openai v5 streaming support (#3148) (6e90d41)
• Added support for openai.responses.create api (#3139) (a1204b2)

Bug fixes

• Fixed error logging for undefined tracestate header (#3170) (3c915f5)

Code refactoring

• Updated transformation rules to remove the bespoke rule to appease @google-cloud/pubsub <5.1.0 (#3151) (2d9b4b4)

Documentation

• Gemini compatibility (#3134) (bbdc531)
• Updated compatibility report (#3171) (f3361e4)

Miscellaneous chores

• Added logging of used New Relic environment variables (#3145) (1a9d9f5)
• Added supportability metrics to OTEL metrics API (#3164) (5312db0)
• Fixed formatting in Slack PR titles (#3167) (847859f)
• Improved output of pending prs script (#3160) (9bafd77)
• Improved setup of OpenTelemetry metrics API (#3138) (e91592d)
• Pinned google/genai to <1.5.0 (#3154) (04b9bde)
• Removed discontinued Bedrock models (#3158) (2c79a31)
• Removed usage of shim.argsToArray in favor of rest parameters (#3141) (b144d71)
• Tweaked nestjs test manifest (#3152) (51b82aa)

Tests

• Added JSDoc annotation for benchmark interface (#3127) (77e7e0a)
• fixed test assertion for langchain openai (#3169) (29ec912)
• Skips running nest 11+ on node 18 due to dropping support (#3149) (961975b)
• unpinned google genai tests (#3168) (cfa7114)

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 @google/genai Gemini AI LLM instrumentation (#3119) (7f28a29)
• Updated opentelemetry bridge to rely on configuration based transformation rules (#3125) (ad116d2)

Bug fixes

• Refactored getHostnameSafe to accommodate GCP (#3132) (f1eea8d)
• Updated openai instrumentation to work with 5.0.0+ (#3129) (09146a9)
• Updated rules to work with 1.17.0 and 1.24.0 for consumer and producer span kind (#3128) (686c747)

Documentation

• Updated compatibility report (#3124) (c51d45f) (#3117) (084e599)

Miscellaneous chores

• Added preliminary otel configuration (#3121) (664ee4a)

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 OTEL metrics API (#3109) (4a57721)

Bug fixes

• Fixed common.getKeys logic (#3114) (01d4fa5)
• Fixed Google Cloud Run hostname issue (#3111) (e233fb7)

Documentation

• Updated compatibility report (#3106) (3c47406)

Miscellaneous chores

• Added event source type to txn name for Lambda APM Mode (#3110) (ddc2e2a)

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 Azure Function HTTP streaming support (#3070) (9865e1c)

Code refactoring

• Added check to only set a FakeSpan if transaction.agent.otelSpanKey exists (#3071) (b0c1ac1)

Documentation

• Updated compatibility report (#3074) (7dc9aad)

Miscellaneous chores

• Fixed redis legacy test suite (#3077) (ec39925)
• Updated security agent (#3098) (48ed8cb)

Tests

• Added cross agent otel bridge tests (#3057) (1526bed)

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 createSegment to stop adding segments to trace when max_trace_segments is exceeded (#3056) (8f3336e)

Documentation

• Updated compatibility report (#3065) (#3063)

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