Node.js agent release notesRSS

Notes

Bug fixes

• Fixed matching for ALB and API Gateway (v1 & v2) events for Lambda (#2780) (2f1a6c6)
• Updated mysql2 instrumentation to work with 3.11.5+ (#2811) (3ec4fee)

Documentation

• Fixed changelog to group the labels in logs work (#2776) (04271da)
• Fixed links to next.js apps (#2812) (834440c)
• Updated compatibility report (#2809) (fc1fbda)

Tests

• Migrated test/integration/api tests to node:test (#2787) (03b01a3)
• Migrated test/integration/core tests to node:test (#2781) (36bc0e7)
• Migrated test/integration/instrumentation tests to node:test (#2784) (963fb30)
• Migrated test/integration/transaction tests to node:test (#2783) (68e1a0c)
• Migrated test/integration/utilization tests to node node:test (#2794) (db237e9)
• Migrated test/smoke/api tests to node:test (#2772) (af3bbcd)
• Migrated CAT integration tests to node:test (#2778) (bd9df5f)
• Migrated integration tests at root to node:test (#2803) (a7ef080)
• Migrated root smoke tests to node:test (#2771) (78f2709)
• Migrated smoke tests in test/smoke/agent, test/smoke/e2e, and test/smoke/index to node:test (#2774) (440a0af)
• Removed t.diagnostic as they're better suited as code comments (#2786) (ee24027)
• Fixed flaky test on macOS (#2790) (eebf06b)
• Removed reference to pino internals (#2805) (0382ee2)
• Restricted mysql2 version to get CI working (#2808) (ad60ed4)
• Updated agent integration tests to node:test (#2782) (d556512)
• Updated config integration tests to node:test (#2777) (fe8d2df)
• Updated distributed-tracing integration tests to node:test (#2798) (83ad1f3)
• Updated grpc integration tests to node:test (#2789) (ea8f743)
• Updated index, issue-2155, and metric integration tests to node:test (#2801) (80b55c2)
• Updated q, superagent, and when tests to node:test (#2773) (ff2d8d0)
• Updated shimmer, uninstrumented, environment, flatten, and logger integration tests to node:test (#2802) (83fd7ee)
• Added per test file timing to test reporter (#2785) (00d9940)

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 labels.enabled and labels.exclude to config defaults (#2727) (36adb13)

• Added new configuration options to add custom tags (labels) to logs (#2743) (d20c874)

  • With custom tags on logs, platform engineers can easily filter, search, and correlate log data for faster and more efficient troubleshooting, improved performance, and optimized resource utilization. To learn more about this feature see the documentation
  • To enable set config.application_logging.forwarding.labels.enabled to true or the environment variable NEW_RELIC_APPLICATION_LOGGING_FORWARDING_LABELS_ENABLED to true (#2727) (36adb13)
  • To exclude labels that were set on application from logs use config.application_logging.forwarding.labels.exclude or the environment variable NEW_RELIC_APPLICATION_LOGGING_FORWARDING_LABELS_EXCLUDE

• Added support for Bedrock Claude 3.5 invoke model user request (#2721) (a901a24)

• Moved entity.guid, entity.name, entity.type, and hostname to common.attributes on logs payload instead of in every log message (#2736) (a7f14de)

Bug fixes

• Corrected expected shape of user input in get Prompt() (#2741) (a8eef8b)

Documentation

• Updated compatibility report (#2755) (459a3f1)

Miscellaneous chores

• Fixed test reporter (#2751) (5878ef9)
• Improved unit test speed (#2728) (9640030)

Tests

• Fixed two assertions to work against older versions of openai (#2726) (8996fc3)
• Migrated ioredis, prisma and undici versioned tests to node:test (#2746) (449ae03)
• Migrated memcached, nestjs, and restify versioned tests to node:test (#2752) (653f614)
• Migrated nextjs versioned tests to node:test (#2749) (d385af6)
• Migrated redis versioned tests to node:test (#2725) (9752827)
• Updated hapi tests to node:test (#2722) (636899b)
• Updated kafkajs, langchain, & openai tests to node:test (#2723) (b6e4c5d)
• Updated koa tests to node:test (#2744) (86c22a4)
• Updated mongodb tests to node:test (#2738) (295e7e6)
• Updated pg and pg-esm tests to node:test (#2750) (40aea36)

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 cloud.resource_id attribute to dynamo spans (#2701) (904f41b)
• Enhance Proxy Request Handling to Display Actual External URLs (#2698) (3ef7bbe)
  • Thanks for the contribution @mstarzec386

Documentation

• Updated compatibility report (#2712) (82f0e98) (#2699) (4432c42)

Miscellaneous chores

• Added a benchmark script for our sql parser (#2708) (9b6de68)
• Updated express-esm, generic-pool, grpc, & grpc-esm tests to node:test (#2702) (a229bbf)

Tests

• Migrated mysql and mysql2 versioned tests to node:test (#2711) (fc767e0)

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 cloud.aws.account_id to default config (#2691) (0ccee8e)

Bug fixes

• Fixed issue parsing docker container id (#2705) (0c897ab)

Documentation

• Updated compatibility report (#2679) (3c19cdf)

Miscellaneous chores

• Moved recorders to lib/metrics/recorders (#2666) (d8dfe84)

Tests

• Fixed file extensions for aws-sdk v2 and v3 versioned tests to reflect they have been migrated to node:test (#2687) (4ec09ba)
• Migrated elasticsearch and esm-package versioned tests to node:test (#2680) (0e0c2b2)
• Updated cls and connect tests to node:test (#2676) (1e74434)
• Reorganized custom assertions and improved test reporter (#2700) (9e98b18)
• Updated cassandra-driver tests to node:test (#2678) (bd4f7ff)

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 ARN and provider to Lambda segments (#2674) (a23294c)
• Added IAST configurations for scan scheduling and restrictions (#2645) (13a627a)

Documentation

• Updated compatibility report (#2673) (e4d0503)

Miscellaneous chores

• Replaced static openssl cert usage with in-process cert (#2671) (72872f4)

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