Node.js agent release notesRSS

Notes

Features

• Added support for express@5 (#2555) (252f3b2).
• Provided ability to disable instrumentation for a 3rd-party package (#2551) (abfb9f0).
  • To disable instrumentation, set config.instrumentation.<library>.enabled to false. The values of <library> are the keys listed here.
  • Be cautious when using this feature, as disabling instrumentation for a library could affect instrumentation of other libraries executed afterwards.

Miscellaneous chores

• Added CI for publishing agent as Azure site extension (#2488) (468943a).
• Added Azure site extension installation scripts (#2448) (a56c4e1).

Tests

• Converted llm-events tests to use node:test (#2535) (ebfa2e9).
• Migrated test/unit/spans to use node:test (#2556) (9319071).
• Migrated test/unit/util to use node:test (#2546) (0b07be8).
• Migrated tests in test/unit/instrumentation to use node:test (#2531) (47b8398).
• Converted collector unit tests to node:test (#2510) (762511b).
• Converted errors unit tests to node:test (#2540) (ae82760).

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

• Fixed detection of REST API type payloads in AWS Lambda (#2543) (adfeebc)

Documentation

• Cleaned up formatting of api.js to properly inject example snippets when rendering on API docs site (#2524) (4b34f3d)
• Updated compatibility report (#2523) (29784ea)
• Updated Next.js Otel cloud provider FAQ (#2537) (6553807)

Tests

• Converted db unit tests to node:test (#2514) (bea4548)
• Converted grpc, lib, and utilization tests to node:test (#2532) (c207e1e)
• Replaced distributed tracing tests with node:test (#2527) (8184c56)
• Added a match function for tests (#2541) (51e7f34)
• Converted config to node:test (#2517) (1534a73)

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 new API method withLlmCustomAttributes to run a function in a LLM context (#2437) (57e6be9)
  • The context will be used to assign custom attributes to every LLM event produced within the function

Bug fixes

• Improved AWS Lambda event detection (#2498) (5e8b260)

Documentation

• Updated compatibility report (#2493) (0448927)

Miscellaneous chores

• Fixed linting scripts (#2497) (c395779)
• Removed examples/shim (#2484) (40d1f5c)
• Updated test-utils dependency and added matrix-count only (#2494) (5e04c76)

Tests

• Converted the api unit tests to node:test (#2516) (ab91576)
• Converted context-manager unit tests to node:test (#2508) (9363eb0)

Continuous integration

• Updated codecov action sha to post coverage from forks. Added flag to fail ci if it fails to upload report (#2490) (12fbe56)

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 instrumentation support for Express 5 beta (#2476) (06a4c2f)
  • This will be experimental until express@5.0.0 is generally available

Bug fixes

• Updated koa instrumentation to properly get the matched route name and to handle changes in @koa/router@13.0.0 (#2486) (0c2ee2f)

Documentation

• Removed reference to @newrelic/next in README (#2479) (8740539)
• Updated compatibility report (#2487) (c0a5e64)

Miscellaneous chores

• Reverted to upstream require-in-the-middle (#2473) (9bbc41c)
• Updated aggregators unit tests to node:test (#2481) (fd2d76f)

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

• Updated amqplib instrumentation to properly parse host/port from connect (#2461) (91636a8)
• Updated redis instrumentation to parse host/port when a url is not provided (#2463) (2b67623)
• Updated the kafkajs node metrics to remove /Named from the name (#2458) (37ce113)

Code refactoring

• Updated pino instrumentation to separate the wrapping of asJson into its own function (#2464) (81fdde1)

Documentation

• Updated compatibility report (#2460) (a4570e9)

Miscellaneous chores

• Removed limit on superagent versioned testing (#2456) (b4b6a6b)

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

• Pick log message from merging object in Pino instrumentation (#2421) (599072b)
• Added TLS verification for Redis (#2446) (9a16b70)

Documentation

• Updated compatibility report (#2440) (32abe5f)
• Updated examples to properly use specs (#2422) (f7e8c58)
• Fixed typo in doc header (#2433) (9726e23)

Miscellaneous chores

• Added entity relationship attributes to SQS segments (#2436) (578aead)
• Converted agent unit tests to node:test (#2414) (b32f793)
• Fixed mongodb-esm tests in combination with security agent (#2444) (5d617de)
• Limited superagent tests to avoid new breaking release (#2439) (f1dd8e7)
• Removed promise resolvers from callback based agent unit tests (#2450) (3766895)

Tests

• Moved pkgVersion to collection-common to avoid a conflict with ESM tests (#2438) (7260fa3)
• Restored mongodb-esm tests (#2434) (67a12e3)
• Updated custom test reporter to only log failed tests when there are failures (#2425) (baa37ec)
• Updated tls redis tests to work with older versions of redis v4 (#2454) (ffd9b17)

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

⚠ BREAKING CHANGES

• Dropped support for Node.js 16
• Removed legacy context manager
• Removed support for redis less than version 2.6.0
• Removed instrumentation for director
• Updated mongodb instrumentation to drop support for versions 2 and 3

Features

• Dropped support for Node.js 16 (#2394) (1870010)
• Removed legacy context manager (#2404) (321244c)
• Removed support for redis less than version 2.6.0 (#2405) (e2c0a31)
• Removed instrumentation for director (#2402) (1b355e7)
• Added server.address to amqplib spans (#2406) (09636a4)
• Updated mongodb instrumentation to drop support for versions 2 and 3 (#2398) (a0ae32a)
• Migrated instrumentation for next into agent (#2409) ([b55d8e1](https://github.com/newr elic/node-newrelic/commit/b55d8e1ca09e6055ea09f4fcd773a05245e7203f))
  • You no longer need to load Next.js instrumentation via @newrelic/next.
  • Instead you must load the agent via NODE_OPTIONS='-r newrelic' next start

Documentation

• Updated compatibility report (#2401) (a53085d)

Miscellaneous chores

• Added test configs for defined targets in the aws test suite (#2403) (cf514d9)
• Added producer and consumer metrics to kafkajs instrumentation (#2407) (41c1cc6)
• Switched to using Node built-in test runner (#2387) (b9f64b7)
• Updated @newrelic/native-metrics to 11.0.0 (#2412) (aef69e2)
• Updated dashboard links in developer-setup.md (#2397) (16866da)
• Verified MySQL host:port metric is recorded (#2400) (74176f7)

Tests

• Removed mongodb-esm tests as they are not atomic and conflicting with mongodb tests in CI (#2416) (e587b9d)
• Updated minimum version of lesser used versions of 3rd party libraries (#2399) (ef8c006)

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 fs.glob in Node 22+ (#2369) (1791a4e)

Bug fixes

• Updated aws-sdk v3 instrumentation to load custom middleware last to properly get the external http span to add aws.* attributes (#2382) (751801b)
• Updated cassandra-driver instrumentation to properly trace promise based executions (#2351) (bab9a8b)

Documentation

• Removed examples/api/ (#2381) (fb964de)
• Removed out of date ROADMAP_Node.md from root of project (#2367) (4be870c)
• Updated compatibility report (#2345) (f08adc3)

Miscellaneous chores

• Always upload status logs in compatibility report CI (#2341) (b3f1ee3)

Tests

• Removed server.start in grpc tests as it is deprecated and no longer needed (#2372) (d212b15)
• Updated benchmark test results to output result files (#2350) (1b51a68)

Continuous integration

• Added benchmark test GitHub Action (#2366) (afd3ab4)
• Increased the limit of installs from 2 to a bigger number for versioned tests (#2346) (f85a385)
• Updated bin/create-docs-pr to create an empty array if changelog.json is missing security (#2348) (7d5368c)

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 redis v4 instrumentation to work with transactions(multi/exec) (#2343) (39eb842)

Documentation

• Updated compatibility report (#2342) (5c9e3e6)

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