Node.js agent release notesRSS

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

Notes

Features

• Added support for account level governance of AI monitoring (#2326) (7069335)

Code refactoring

• Removed redundant isExpected in the Exception class (#2328) (38f9825)
• Reduced duplication in the error-collector (#2323) (10581bf)
• Refactored benchmark tests to complete async functions (#2334) (57a4dfb)

Documentation

• Included commands and links for Mac setup (#2327) (6eddb72)
• Updated compatibility report (#2318) (3a910ef)

Miscellaneous chores

• Fixed copy paste error in post release workflow (#2329) (6f2da7a)
• Implemented split jobs for post release docs publishing (#2319) (c14ec3b)

Tests

• Fixed recordMiddlewawre benchmark test (#2338) (fb55ac7)

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 Node 22(#2305) (0bf8908)
• Added AIM support for Meta Llama3 models in AWS Bedrock (#2306) (ff2e509)

Documentation

• Updated compatibility report (#2309) (7bf77c6)

Miscellaneous chores

• Added @amychisholm03 to list of contributors 🎉 (#2310) (8a890f1)
• Forced re-creation of API docs on gh-pages (#2307) (917110a)

Tests

• Updated undici versioned tests to assert an error is present and not the actual message (#2299) (4e38ed4)

Continuous integration

• Added Node 22 to CI (#2164) (4b12d9e)
• Added Node 22 to smoke tests and nightly versioned test runs (#2316) (af00666)
• Moved the docs PR job to before api docs publish (#2300) (2e7252e)

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 getting container ids from ECS metadata API (#2292) (dbca830)

Bug fixes

• Handled assigning headers in LambdaProxyWebRequest when there are no headers present (#2293) (e4d22f3)

Documentation

• Updated compatibility report (#2290) (b5fc893)

Tests

• Fixed log error stack message truncating and failing equality test (#2294) (8e06f0f)
• Updated shimmer method in benchmark tests (#2281) (1528d68)

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