Node.js agent release notesRSS

Notes

Bug fixes

• Updated undici instrumentation to fix crash with trying to calculate exclusive duration on a segment that no longer exists (#2884) (3b7e4bf)

Documentation

• Updated compatibility report (#2878) (e784f84)

Miscellaneous chores

• Fixed dns integration tests (#2883) (dd30ad7)

Tests

• Restored the branch to test apollo-server-plugin to main (#2879) (978faab)

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

• Removed transaction from segment. Introduced a new enterSegment and enterTransaction to make context propagation more clear (#2646) (d84531a)
• Removed children from segments. (#2689) (66f140f)
• Added segment tree to transaction trace (#2717) (8fcc239)
• Added segment synthesizer and provided ability to convert http client otel spans to external http trace segments (#2745) (c42f8e6)
• Added otel consumer span processing (#2854) (82fe9d5)
• Added segment and transaction synthesis for http server spans (#2833) (8fa4d05)
• Added segment synthesis for db client otel spans to db trace (#2820) (1ad1858)
• Added segment synthesis for internal spans (#2840) (436c63d)
• Added segment synthesis for otel producer spans (#2839) (30f4995)

Bug fixes

• Updated shim.createSegment and shim.handleMqTracingHeaders to be backwards compatible with the changes to context manager (#2844) (554b4bf)

Code refactoring

• Removed class construction on the segment synthesis and instrumentation (#2837) (4b7ec0f)

Documentation

• Updated compatibility report (#2869) (4bde427)

Miscellaneous chores

• Added rules engine to match OTEL spans (#2694) (2c93c68)
• Updated rules engine to account for fallbacks (#2831) (19fbdfb)
• Updated versioned tests docs (#2874) (73a84d7)

Tests

• Updated a langchain test to be less rigid on asserting the tracking metric by @langchain/core version (#2876) (73985ea)

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 @opensearch-projects/opensearch v2.1.0+ (#2850) (763c0e6)

Bug fixes

• Fixed event matcher to use properties specific to web requests (v1/ALB and v2) (#2863) (a93fe6e)

Miscellaneous chores

• Fixed mysql2 tests for new mysql2 version (#2853) (30a6de0)
• Updated eslint configuration (#2851) (d2fba9d)
• Utilize updated @newrelic/eslint-config (#2865) (f53d4fc)

Tests

• Removed t.diagnostic from tests (#2858) (23ca237)

Continuous integration

• Updated codecov-action to latest released version sha (#2866) (75f8902)

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 entity linking attributes to aws-sdk v3 Lambda segments (#2845) (8820265)
• Provided ability to define newrelic config as newrelic.mjs (#2836) (972b59d)

Documentation

• Updated compatibility report (#2828) (d5fe8e3)

Miscellaneous chores

• deps: Updated @newrelic/security-agent to v2.2.0 (#2842) (170941e)
• Updated borp configs to target tests correctly (#2835) (66ae59d)

Tests

• Removed tap and cleaned up left over tap helpers (#2804) (37407b6)
• Updated match to fail if you pass in an object that lacks the expected keys (#2843) (a3db8bd)

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

• Fixed mysql2 promise instrumentation to properly handle createPool and createPoolCluster (#2823) (a679872)
• Fixed matching for Lambda events containing resource but which aren't API Gateway (#2825) (64d2042)

Documentation

• Updated compatibility report (#2814) (580a27f)

Miscellaneous chores

• Improved documentation for assertSegments (#2819) (298473c)

Tests

• Added test/custom-assertions.js to the apollo-server external versioned tests config (#2817) (568525a)
• Fixed flakey when versioned test (#2821) (54f034b)

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

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