Node.js agent release notesRSS

Notes

Features

• Added support for parsing container ids from docker versions using cgroups v2. (#1830) (9892901)

Miscellaneous chores

• [Snyk] Upgraded @grpc/grpc-js from 1.9.2 to 1.9.4. (#1823) (81f9450)
• deps: Updated aws-sdk, koa, superagent (#1831) (8b4e963)

Tests

• Increased timeout for integration tests to avoid random failures. (#1827) (5202048)

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

• Updated agent initialization to allow running in worker threads when config.worker_threads.enabled is true (#1817) (a39f0ef)

Bug fixes

• Updated Elasticsearch instrumentation to register on v7.13.0+ only (#1816) (6437671)

Miscellaneous chores

• dev-deps: Bumped @babel/traverse (#1818) (d3c8d04)
• Updated release note headers to follow standard sentence caps (#1806) (91d3600)

Tests

• Updated the grpc versioned tests utils to dynamically bind ports to avoid conflicts between cjs and esm tests (#1820) (95ac917)

Continuous integration

• Disabled fail-fast on testing jobs to make sure all versions are run before getting canceled because of a flappy test (#1819) (0928ee3)
• Updated CI workflow to use larger runners on versioned tests but only when running against the main branch (#1812) (01eaa14)
• Updated post release script to update the nodejs_agent_version only on staging and us prod, eu will get it via replication now (#1811) (317a00a)

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 initialization to return the API on start up to the security agent properly (#1807) (99e5792)

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 for ElasticSearch (#1785) (a748b84)

Bug fixes

• Updated agent to create a stub api when running in a worker thread to avoid Next.js early return errors (#1800) (636e8f0)
• Updated shimmer to allow registering instrumentation for different versions of the same module (#1799) (30f0b16)

Miscellaneous chores

• deps: Updated @newrelic/security-agent to v0.3.0 (#1786) (9ca78ae)
• Separated running versioned tests between local and external (#1792) (6ffe2f6)
• dev-deps Updated get-func-name to fix CVE (#1790) (f378c77)

Tests

• Updated elasticsearch container to ignore highwatermark to function on a constrained environment (#1803) (8380e9d)
• Updated invalid json pino test as this was fixed in 8.15.1 of the pino library. (#1782) (3e65fdc)

Continuous integration

• Added steps to zip up container logs on versioned test failure (#1804) (0a54729)

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 for fetch. (#1776) (980b4dc)
• Removed undici feature flag. This will now instrument undici by default. (#1772) (683b254)
• Updated undici instrumentation to create segment on request create instead of after connection and opening socket to more accurately record time it takes to make an undici request. (#1770) (3f494f8)

Performance Improvements

• Trace: optimise getTotalTimeDurationInMillis function to push to an array instead of concat arrays. (#1774) (6ecde97)
  • Thanks @infinity-naveen for your contribution 🎉

Miscellaneous Chores

• Updated Next.js plugin versioned tests to use main now that require-in-the-middle fixes have been merged. (#1768) (6a72d1f)
• Upgraded @newrelic/test-utilities and removed unused shimmer.patchModule and shimmer.unpatchModule (#1769) (96620ef)

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

• Removed support for Node 14.
• Replaced ESM loader with import-in-the-middle to fix instrumentation firing for both CommonJS and ESM.
  • You must load both the ESM loader and agent as follows: node --experimental-loader newrelic/esm-loader.mjs -r newrelic path/to/app.js.
  • Removed config.esm.custom_instrumentation_entrypoint to register ESM instrumentation. You can now just call the newrelic.instrument* APIs but you must pass in an object and specify isEsm: true. See example.
• Updated agent to use require-in-the-middle to register CommonJS instrumentation. You can no longer use an onResolved hook to register custom instrumentation.
• Updated the default context manager to be AsyncLocalContextManager.
• Renamed shim.handleCATHeaders to shim.handleMqTracingHeaders.
• Updated agent to only run in the main thread. This is because running in a worker thread does not completely function out of the box. This will reduce the overhead for customers that are naively trying to load this into worker threads.

Features

• Added support for Node 20.
• Renamed shim.handleCATHeaders to shim.handleMqTracingHeaders (#1735) (6788f9e)
  • If you have calls to shim.handleCATHeaders, the signature is identical and a function name change is only necessary.
  • Note: The agent will be removing CAT functionality in an upcoming release.
• Updated the default context manager to be AsyncLocalContextManager (#1731) (25f2bd8)
  • To restore functionality of legacy context manager you can set config.feature_flag.legacy_context_manager to true or `NEW_RELIC_FEATURE_FLAG_LEGACY_CONTEXT_MANAGER=true
  • Please note this legacy context manager will be removed in future major releases. If you have any issues, please raise with New Relic support or on the issues of the agent.

Bug Fixes

• Replaced esm loader with import-in-the-middle to fix instrumentation firing for both commonjs and esm (#1760) (4452354), closes 1646
  • Breaking Change: Updated ESM loader that now requires to use both a loader and -r.
    • node --experimental-loader newrelic/esm-loader.mjs -r newrelic path/to/app.js
  • Breaking Change: Removed config.esm.custom_instrumentation_entrypoint to register ESM instrumentation.
    • You can now just call the newrelic.instrument* APIs but you must pass in an object and specify isEsm: true.
• Updated prisma instrumentation to parse prisma datamodel with internal package (#1765) (48079b3)

Code Refactoring

• Updated agent to use require-in-the-middle to register CommonJS instrumentation (#1758) (d4b4f11)
  • Removed onResolved hook. If you're using custom instrumentation with an onResolved hook, you must update to use onRequire
  • You can no longer instrument files that are not within a node_module unless you provide an absolute path to the file when registering the instrumentation.
  • You cannot instrument both the base module and a sub module.

Miscellaneous Chores

• Remove support for Node 14 (#1756) (0ff9912)
• Updated the bundled packages to the latest @newrelic/superagent, @newrelic/aws-sdk, @newrelic/koa, @newrelic/native-metrics, and @newrelic/test-utilities (#1766) (8f6e15b)
• Updated the aws-sdk external branch to be main now that the code is in there (#1761) (d34d0fe)

Tests

• update smoke tests versioned matrix in CI to 16, 18, and 20. (#1762) (c82b517)

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 around JSON.parse in formatting pino log lines because pino can return invalid json (#1750) (8f2e11a)

Miscellaneous Chores

• deps: Updated @newrelic/security-agent to v0.2.1 (#1754) (0d04f14)
• Fix smoke tests node 20 (#1745) (8c053e0)
• fixed typos in lib/config/index.js comments (#1749) (9000a14)

Tests

• Added a full suite of unit tests for the collector/http-agents (#1748) (9d4201b)

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

Security Improvements

• updated ESM loader to track instrumentation by url in a map instead of in url to avoid remote code execution. (#1741) (c8dc779)

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

Miscellaneous Chores

• deps: Updated @newrelic/security-agent to v0.2.0 (#1737) (9bf2a01)
• restored engines to >=14 until we actually drop support for Node 14 (#1738) (8d66123)

Continuous Integration

• Add Node.js 20.x to CI and remove 14.x (#1603) (c4b008c)
• update support statement (#1733) (3013da9)

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