Node.js agent release notesRSS

Notes

Bug fixes

• Added defensive code for obtaining protocol in outbound http calls (#3367) (ecda4e8)

Code refactoring

• Benchmark test names (#3357) (229ff0d)

Documentation

• Updated compatibility report (#3351) (cf9f95d)

Continuous integration

• Benchmark tests run on push on main (#3359) (c0f81c3)
• Changed NUGET_SOURCE workflow to variable (#3364) (10692db)
• Fix benchmark workflow (#3365) (7da99b5)
• Updated the GH_RELEASE_TOKEN to point to our bot user PAT instead of python agent (#3363) (06eb5c1)

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

• Default requestParameters to an object to avoid crash in transaction.addRequestParameters (#3361) (ecd0d1d)

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 MCP StreamableHTTPClientTransport support (#3337) (7189a35)

Code refactoring

• Removed instances of url.parse. Streamlined how http instrumentation creates relevant attributes. (#3340) (1fc1e1a)
• Updated openai instrumentation to subscribe to events emitted (#3331) (04dd677)

Documentation

• Updated compatibility report (#3344) (e422919)

Miscellaneous chores

• Refactored OTEL bridge signals setup (#3244) (ec8edef)

Tests

• Added more cassandra-driver tests (#3323) (d2e9d10)
• Fixed long running benchmark test and add shimmer.subscribers benchmark test (#3349) (15253c0)
• Fixed langchain openai streaming tests by explicitly passing streaming: true to chat model (#3346) (4f12499)
• Fixed openai test after migration to tracing channel (#3336) (0d01e29)
• Hardened batch-span-streamer.test.js to avoid random failures in CI (#3338) (2077ce3)

Continuous integration

• Set benchmark host default to staging (#3332) (55f6b8d)
• Updated the redis container to use the official redis image as bitnami/redis is moving and no reason to use a 3rd party image (#3342) (8ffb393)

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

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