Node.js agent release notesRSS

Notes

Features

• Added instrumentation for http2 client methods (#3284) (bda7aea)

Bug fixes

• Updated ioredis instrumentation to handle breakage of errors when using .pipeline. (#3457) (49f4d93)
• Updated openai instrumentStream function to handle empty chunk when include_usage is set (#3427) (f804940)

Code refactoring

• Update express instrumentation to subscribe to events emitted (#3424) (bbf3d01)
• Updated instances in instrumentation of Array.forEach for a more performant for...of or for index loop (#3463) (99484ce)
• Updated instances of Array.forEach for a more performant for...of or for index loop (#3440) (48c37bf)
• Updated token calculation for aws-bedrock LLM Events (#3445) (9450181)
• Updated token calculation for google-genai LLM Events (#3431) (41d32be)
• Updated token calculation for openai LLM Events (#3430) (b8678cc)

Documentation

• Updated compatibility report (#3459) (f253b97)

Miscellaneous chores

• Update release workflows (#3444) (d1ec158)

Tests

• Added a randomString helper to agent_helper and use it in ioredis to avoid flappy tests, also updated local instances of random strings in kafka, elasticsearch and opensearch tests (#3462) (4deb6d8)
• Fixed conflict between ioredis and ioredis-esm by running flushdb instead of flushall to avoid index getting removed mid test (#3464) (5e3f0a8)
• Fixed express async error test to purposely misspell a method to emit a crash (#3435) (ff9f064)
• Moved aws-sdk-v3 common.js requirement of semver (#3461) (6a380ef)
• Pinned Next.js tests to <16.0.0 (#3446) (10787a1)
• Updated minimum tested version of @langchain/core to 1.0.0 (#3437) (b61f67a)

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 fastify instrumentation to subscribe to events emitted (#3407) (51e361e)

• Updated pg and pg-native instrumentation to subscribe to events emitted (#3397) (04af258)

• Updated config.instrumentation.timers.enabled to false to disable timers.setTimeout and timers.setInterval by default. (#3414) (b925d3d)

  • To re-enable, set config.instrumentation.timers.enabled to true in config or set NEW_RELIC_INSTRUMENTATION_TIMERS_ENABLED=true

Documentation

• Updated compatibility report (#3413) (fef98dd)

Miscellaneous chores

• Added a new diagnostics base class and migrated undici to use new class (#3408) (8047bf1)
• Created directory for samplers (#3419) (dd2d3df)

Styles

• Require check-types and require-returns-type jsdoc (#3400) (e4cd687)
• Require jsdoc check*, implements-on-classes, and some no-undefined-types (#3404) (4fa645b)
• Require jsdoc require-returns-check and require-property-* (#3403) (1008073)

Tests

• Added helper to get version of package when package.json not exported, and updated tests that need it (#3411) (5ae02c7)
• Fixed fastify segment tree assertion when security agent is enabled (#3422) (b2cf6ed)
• Refactored mcp tests to listen on new port for every streaming test, removed unncessary shutdown of process (#3420) (17db813)
• Updated an openai assertion with setTimeout disabled (#3421) (ceec8f9)

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

• Update amqplib instrumentation to subscribe to events emitted (#3377) (fecbb08)
• Updated cassandra-driver instrumentation to subscribe to events emitted. (#3372) (bb87cd8)

Documentation

• Updated compatibility report (#3385) (b79be72)

Miscellaneous chores

• Updated @apm-js-collab/tracing-hooks to latest to take advantage of wasm optimizations (#3398) (cda56cc)

Styles

• Require jsdoc/valid-types and jsdoc/check-param-names (#3368) (5d1b1d9)
• Require jsdoc require-param-description and require-param-type (#3391) (3785d0c)

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 tracing callback on subscribers (#3371) (e6ad52e)

Bug fixes

• Updated openai instrumentation to properly return APIPromise to avoid crashing when using completions.parse or responses.parse (#3382) (c7ccf26)

Documentation

• Updated compatibility report (#3370) (754c2f0)

Miscellaneous chores

• Removed unused loader.mjs (#3376) (66a9fd5)
• Updated metrics for OTel Bridge enablement/disablement (#3381) (b976c37)
• Updated supportability metric names for OTel Bridge enablement… (#3383) (c7c1d6c)

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

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