Node.js agent release notesRSS

Notes

Code refactoring

• Updated agent to use @apm-js-collab/tracing-hooks for the CJS/ESM registration for tracing channel based instrumentation (#3324) (4b2c14f)

Documentation

• Updated compatibility report (#3330) (2831a89)

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 register Supportability/Features/Instrumentation/OnRequire/<pkg> metrics for subscriber based instrumentation (#3312) (87bfa40)
• Added esm loader hook and commonjs patch to work with orchestrion-js (#3312) (415aeba)
• Added instrumentation for @modelcontextprotocol/sdk client calls client.callTool, client.readResource, and client.getPrompt (#3312) (5d9790b)

Bug fixes

• Fixed logic around detecting OTEL packages (#3326) (4df30e5)
• Updated shimmer.setupSubscribers to properly setup and skip subscribers that are disabled (#3312) (cf5b3ec)

Code refactoring

• Added ability to disable subscribers via config.instrumentation.<pkg-name>.enabled (#3312) (55f8fe7)
• Added ability to prevent creation of segments in subscriber based instrumentation when parent is marked as internal and of the same package (#3322) (91f91c2)
• Removed id parameter from opensearch class (#3312) (8be00ce)
• Updated opensearch instrumentation to subscribe to events emitted (#3312) (9a27a5d)
• Updated elasticsearch instrumentation to subscribe to events emitted (#3312) (a3e2348)
• Updated ioredis instrumentation to subscribe to events emitted (#3312) (90b97d2)
• Updated pino instrumentation to subscribe to events emitted (#3312) (28bbe9f)
• Updated subscribers to have a common createSegment that creates, assigns attributes, starts segment (#3317) (aa3f8d9)
• Updated undici instrumentation to remove its reliance on shim. Also updated storing the relevant segments on context instead of symbols on the request object (#3312) (ec17fa7)

Documentation

• Updated compatibility report (#3313) (749ddc9) (#3304) (cc000a7)

Miscellaneous chores

• change from ending segment to touching for feature parity with shim (#3312) (4d39fc5)
• Updated eslint configuration (#3296) (5c168a6)

Tests

• Fixed obtaining opensearch package version for older versions we instrument (#3314) (e45ab27)
• Removed unnecessary prisma.$use in tests to unpin (#3303) (db20324)

Continuous integration

• Allow users to run benchmark tests even if not sending metrics (#3307) (1be1514)
• Change benchmark tests to use TEST_LICENSE (#3325) (1f7f733)

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 logs API (#3228) (19a9c78)
• Added supportability metrics when instrumentation has been disabled for a package (#3252) (6098a5b)
• Disabled timers instrumentation by default in the sample configuration (#3253) (72eb8d4)

Bug fixes

• Fixed transaction.url obfuscation (#3280) (dc09492)

Code refactoring

• Updated http-outbound to parse url only once (#3270) (5bb0f8d)

Documentation

• Updated distributed tracing example target to use the correct repo (#3254) (1fb3859)
• Updated compatibility report (#3299) (8b85342)
• Updated compatibility report (#3267) (2712c94)
• Updated compatibility report (#3265) (daedadd)
• Updated compatibility report (#3261) (bd7d3fa)
• Updated compatibility report (#3246) (c289fb5)
• Updated compatibility report (#3241) (64529e1)

Miscellaneous chores

• Added guardrail for OTEL bridge (#3283) (ff71865)
• Refactored API bootstrapping (#3281) (97be8f6)

Tests

• Cleaned up engines and version ranges in versioned tests (#3260) (c7fd60e)
• Fixed failing http benchmark test (#3258) (7e8cd48)
• Fixed a failing span-event benchmark test (#3255) (05b955f)
• Fixed CI issues with latest 24 (#3277) (960d169)
• Fixed tests that assumed timers instrumentation was always enabled (#3257) (40cfda1)
• Forced install of peer deps on nestjs test app (#3269) (4e454ff)

Continuous integration

• Updated CI to fail if benchmark tests fail (#3256) (a6a7a15)
• Added sending benchmark metrics to NR One (#3285) (7fc8e40)

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