v12.4.0

v12.4.0 (2024-09-11)

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
  • This feature is use at your own risk. 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. (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/)

v12.3.1

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

v12.3.0

v12.3.0 (2024-08-27)

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

v12.2.0

v12.2.0 (2024-08-19)

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

v12.1.1

v12.1.1 (2024-08-15)

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

v12.1.0

v12.1.0 (2024-08-12)

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

v12.0.0

v12.0.0 (2024-07-31)

⚠ BREAKING CHANGES

• Dropped support for Node.js 16
• Removed legacy context manager
• Removed support for redis < 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 < 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)
  • 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/)

v11.23.2

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

v11.23.1

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

v11.23.0

v11.23.0 (2024-07-10)

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