Node.js agent release notesRSS

Notes

Features

• Updated shim/when instrumentation to use tracer to run in context (#2642) (1a80ad5)

Bug fixes

• Fixed amqplib instrumentation via ESM (#2668) (a36deba)

Documentation

• Remove SECURITY.md (#2633) (41002cd)
• Updated compatibility report (#2670) (281c0fa)
• Updated match custom-assertion jsdoc (#2636) (c37abe5)

Miscellaneous chores

• Upgraded import-in-the-middle to work around a bug introduced in 1.11.1 (#2618) (9ad476a)

Tests

• Migrated aws-sdk-v2 and aws-sdk-v3 tests to node:test (#2620) (e0dc015)
• Migrated test/unit/shim to node:test (#2599) (8d1acff)
• Migrated test/versioned/amqplib to node:test (#2612) (7bdada6)
• Migrated test/versioned/express to node:test (#2609) (bd2f1a5)
• Migrated bluebird versioned tests to node:test (#2635) (6e28fad)
• Migrated last group of unit tests to node:test (#2624) (386f546)
• Migrated unit tests to node:test (#2623) (86231b7)
• Updated tests that relied on tspl by awating the plan.completed instead of calling end to avoid flaky tests (#2610) (935ac14)
• Updated tests that used the context manager directly and instead use the tracer to access the segment context (#2643) (b917b3e)
• Updated the mininum version of pg-native in pg-esm tests to align with the pg tests (#2616) (16be714)
• Migrated bunyan, pino, and winston tests to node:test (#2634) (69c1ab8)
• Migrated fastify tests to node:test (#2632) (b522477)
• Migrated block of unit tests to node:test (#2607) (e33807b)
• Migrated block of unit tests to node:test (#2604) (cd90ce1)
• Migrated block of unit tests to node:test (#2593) (6d4d49e)

Continuous integration

• Added delay to site extension publishing to wait for NPM (#2665) (e412020)

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 handling of Pino merging object (#2600) (de3c266)

Documentation

• Updated compatibility report (#2589) (2f45a4a)

Miscellaneous chores

• deps: Udpated @newrelic/security-agent to v2.0.0 (#2594) (92e6978)

Tests

• Converted transaction* and urltils tests to node:test (#2585) (d169546)
• Fixed @koa/router tests. path-to-regex differs between @koa/router and koa-router now (#2587) (608dd98)
• Removed transitive deps from versioned tests as they will auto-install if required as peer deps (#2580) (0db6599)
• Updated a missing minSupported in aws-sdk-v3 versioned tests (#2582) (c997af6)
• Updated fastify versioned tests to work with fastify@5.0.0 (#2584) (a5a1526)
• Updated how we handle the koa-router nuance of wildcard routes (#2588) (ddeb097)
• Updated koa-router to tests to handle bug fixes from 13.0.1 (#2578) (a28e2e6)
• Migrate block of unit tests to node:test (#2570) (5cd1d8a)
• Migrate second block of unit tests to node:test (#2572) (943a83e)
• Reduce koa-router version to enable CI (#2573) (f44a99b)
• Removed noisy test log (#2583) (3766ed6)

Continuous integration

• Added workflow run trigger to Azure site extension publish job (#2575) (e8ae942)

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 utilization info for ECS (#2565) (6f92073)

Bug fixes

• Ensured README displays for Azure site extension (#2564) (a30aed5)

Documentation

• Updated compatibility report (#2562) (8f7aebe)

Tests

• Convert metric and metrics-recorder tests to node:test (#2552) (7ae4af4)
• Updated serverless unit tests to node:test (#2549) (619f23c)

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 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.