Notes
⚠ BREAKING CHANGES
This version of the Node.js agent is a SemVer MAJOR update and contains the following breaking changes. MAJOR versions may drop support for language runtimes that have reached End-of-Life according to the maintainer. Additionally, MAJOR versions may drop support for and remove certain instrumentation. For more details on these changes please see the migration guide.
- Dropped support for Node.js 20
- Migrated
@apollo/severinstrumentation from a plugin(@newrelic/apollo-server-plugin) to traditional instrumentation - Removed Cross Application Tracing(CAT) functionality
- Removed support for License, Application, and Security Policies(LASP)
- Removed instrumentation for
koa-route - Removed instrumentation for
koa-router - Removed
shim.prefixRouteParametersas the logic was previously moved to when a transaction ends - Removed creating
MySQL Pool#querysegments - Removed
shim.argsToArray - Updated minimum supported version of
@nestjs/cliand@nestjs/coreto10.0.0 - Updated minimum supported version of
nextto 14 - Updated minimum supported version of
bluebirdto3.0.0 - Updated minimum supported version of
mysql2to3.0.0 - Updated minimum supported version for
cassandra-driverto4.0.0 - Dropped support for
fastify3.x - Updated
config.distributed_tracing.exclude_newrelic_headerto be set totrueby default
Features
- Dropped support for
fastify3.x (#3980) (720979b) - Dropped support for Node.js 20 (#3980) (5306223)
- Migrated
@apollo/severinstrumentation from a plugin(@newrelic/apollo-server-plugin) to traditional instrumentation (#3980) (736e0a4) - Removed
shim.argsToArray(#3980) (9183d29) - Removed
shim.prefixRouteParametersas the logic was previously moved to when a transaction ends (#3980) (9f1408e) - Removed creating
MySQL Pool#querysegments (#3980) (1d5a6dd) - Removed Cross Application Tracing(CAT) functionality (#3980) (a87ed4d)
- Removed instrumentation for
koa-route(#3980) (40c10d9) - Removed instrumentation for
koa-router(#3980) (038ecc7) - Removed support for License, Application, and Security Policies(LASP) (#3980) (bc09485)
- Updated
config.distributed_tracing.exclude_newrelic_headerto be set totrueby default (#3980) (774ce08) - Updated minimum supported version for
cassandra-driverto4.0.0(#3980) (419337a) - Updated minimum supported version of
@nestjs/cliand@nestjs/coreto10.0.0(#3980) (120e6de) - Updated minimum supported version of
bluebirdto3.0.0(#3980) (369f920) - Updated minimum supported version of
mysql2to3.0.0(#3980) (2861406) - Updated minimum supported version of
nextto 14 (#3980) (80c5c0c)
Code refactoring
- Updated how exclusive time and trace total time is calculated (#3980) (b227ed6)
- Updated instances of
tracer.bindFunctionwithtracer.runInContextto improve performance in hot paths (#3811) (5d77085)
Documentation
Miscellaneous chores
- Removed
huskyin lieu of git hooks, added security hardened options tonpm install(#3988) (e3a7dda) - Updated production dependencies to the latest (#3996) (b710bac)
Tests
- Added
minSupportedto the nest js versioned tests package.json to ensure the compatibility report will show we support@nestjs/core(#3982) (bfa4aa1) - Added prisma 7 tests (#3980) (116ee9c)
- Moved versioned test runner code from
@newrelic/test-utiltiesto agent (#3980) (d4f9a0c) - Removed
@newrelic/test-utilities(#3980) (1751147) - Decrease smoke-like esm tests' sample size (#3986) (40669fb)
- Fixed
test/lib/get-package-version.js(#3993) (5d31f08) - Fixed version lookup issue in aws-sdk-v3 tests (#3992) (7be3f4a)
- Restructure
aws-sdk-v3test runner to usegroupedDependencies(#3984) (fc67490) - Updated a few versioned test stanzas to reduce the number of combinations it runs (#3991) (d606305)
Continuous integration
- Added
contents: writetopost-releaseto allow commit/push of api docs (#3978) (90c4e61) - Updated remaining actions so they are running on Node 24 (#3980) (ea21934)
- Updated version of
actions/download-artifactto v8 (#3980) (54a58b9) - Updated versions of actions to ensure they are running on node 24 (#3980) (6302002)
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/)
メモ
特徴
- Google ADK
BaseAgent.runAsyncの計装を追加しました (#3905) (c6c51d5) - Google ADK
FunctionTool.runAsyncを計装(#3935)(57f9ed7) @azure/functions計装をサブスクライバー タイプに更新しました (#3915) (227e779)- ログでライセンスキーをマスクする方法を更新しました (#3945) (6289502)
バグ修正
<3.4.0のファイルの再構成に対応するため、connectの計装クエリを更新しました (#3923) (00b615c)- Promiseが履行または拒否された場合にセグメントをタッチするように
tracer.bindFunctionを更新しました(#3967)(712db61) @smithy/smithy-client4.13.0+の使用に対応するようにAWS SDK v3の計装を更新しました(#3965) (5e0fe24)
コードリファクタリング
- undici、ドメイン、および
process._fatalExceptionの計装におけるAsyncLocalStorage.enterWithへの依存を削除しました (#3894) (612b449)
ドキュメント
雑用
max_trace_segmentsがヒットしたときにログ行を追加 (#3933) (46b9238)client-dynamodbテスト用にassertSegmentDurationをコメントアウト (#3972) (590cd3e)- amqplibテストの問題を修正 (#3969) (a770000)
- Connectの計装をサブスクライバー タイプにリファクタリングしました (#3912) (e5d87b7)
- kafkajs 計装をサブスクライバー タイプにリファクタリングしました (#3958) (72e383c)
memcachedテストでのactualTimevssegmentDurationアサーションを削除 (#3932) (98c50e0)@apm-js-collab/tracing-hooks0.7.0に更新しました (#3949) (5c99cd1)
テスト
継続的なインテグレーション
サポートステートメント:
最新のエージェント バージョンが利用可能になったらすぐに更新することをお勧めします。最新バージョンにアップグレードできない場合は、エージェントを 90 日以内のバージョンに更新してください。エージェントを最新の状態に保つ方法の詳細については、こちらをご覧ください。( https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/ )
エージェントのリリースとサポート日については、New Relic Node.js エージェントの EOL ポリシーを参照してください。( https://docs.newrelic.com/docs/apm/agents/nodejs-agent/getting-started/nodejs-agent-eol-policy/ )
メモ
バグ修正
ドキュメント
サポートステートメント:
最新のエージェント バージョンが利用可能になったらすぐに更新することをお勧めします。最新バージョンにアップグレードできない場合は、エージェントを 90 日以内のバージョンに更新してください。エージェントを最新の状態に保つ方法の詳細については、こちらをご覧ください。( https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/ )
エージェントのリリースとサポート日については、New Relic Node.js エージェントの EOL ポリシーを参照してください。( https://docs.newrelic.com/docs/apm/agents/nodejs-agent/getting-started/nodejs-agent-eol-policy/ )
Notes
Bug fixes
Tests
- Updated
minAgentVersionfor Anthropic versioned tests (#3900) (e1f6c32) - Reorganized the test utilities in AWS versioned tests (#3895) (3025571)
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/)
メモ
特徴
@anthropic-ai/sdk計装サポートを追加しました (#3881) (e8713bb)- OTel DB 属性をセマンティック規則 1.40.0 の安定した名前に更新 (#3826) (6d3000d)
- SNSにディストリビューティッド(分散)トレーシングの伝搬を追加 (#3893) (8fc1144)
コードリファクタリング
発行されたイベントをサブスクライブするための
@aws-sdkv3計装をリファクタリングしました@aws-sdk/smithy-clientサブスクライバーを追加しました (#3877) (0e350fc)- AWS Bedrock Middlewareを使用して
@smithy/smithy-clientsendサブスクライバーを追加しました (#3864) (5e0a6d1) - 汎用 AWS
Clientミドルウェアをサブスクライバーに移動しました (#3889) (3cb1e1b) aws-sdk/dynamodb計装をサブスクライバーミドルウェアに更新しました (#3891) (ff677a2)- 実際のラップされたミドルウェアからBedrockユーティリティを分離するためにAWS SDK v3計装を更新しました (#3883) (eed340e)
- Lambdaの計装をサブスクライバーミドルウェアに更新しました (#3890) (12f8284)
- SNS計装をサブスクライバー タイプにリファクタリングしました (#3876) (b9f3326)
- SQSの計装をサブスクライバー タイプにリファクタリングしました (#3880) (de46dee)
ベンダー固有のサブクラスを使用するように
LlmErrorMessageをリファクタリングしました (#3882) (5b0fd2b)
ドキュメント
雑用
@apm-js-collab/tracing-hooksを0.6.0に更新しました (#3884) (f6ef470)- バージョン8をカバーするようにUndiciテストを更新しました (#3896) (f27e75f)
サポートステートメント:
最新のエージェント バージョンが利用可能になったらすぐに更新することをお勧めします。最新バージョンにアップグレードできない場合は、エージェントを 90 日以内のバージョンに更新してください。エージェントを最新の状態に保つ方法の詳細については、こちらをご覧ください。( https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/ )
エージェントのリリースとサポート日については、New Relic Node.js エージェントの EOL ポリシーを参照してください。( https://docs.newrelic.com/docs/apm/agents/nodejs-agent/getting-started/nodejs-agent-eol-policy/ )
メモ
特徴
コードリファクタリング
- 発行されたイベントをサブスクライブするために
when計装をリファクタリングしました (#3866) (1b55c5a) - 発行されたイベントをサブスクライブするための
memcached計装をリファクタリングしました (#3849) (915b320) - 発行されたイベントをサブスクライブするために
bluebird計装をリファクタリングしました (#3858) (e3d84c2) - 発行されたイベントをサブスクライブするために
q計装をリファクタリングしました (#3853) (9fdb0b8) grpc-jsクライアントの計装をサブスクライバー タイプにリファクタリングしました (#3856) (057fca2)grpc-jsサーバーの計装をサブスクライバー タイプにリファクタリングしました (#3805) (ca3010a)- ツールクラスのメソッドを適切に計測するために、
@langchain/core人の購読者を更新しました( #3850 )(2日前)
ドキュメント
雑用
テスト
- バージョン管理されたテストを実行するための、使用されていないコンテキストマネージャ機能フラグを削除しました( #3851 )(15c9757 )
- コア追跡クロスエージェントテストを更新しました( #3860 )(08e4570 )
- スパンリンクのテストに関する問題を修正しました( #3863 )(23a8594 )
memcachedテストのセグメント継続時間のタイミングを削除しました (#3869) (bd24410)
サポートステートメント:
最新のエージェント バージョンが利用可能になったらすぐに更新することをお勧めします。最新バージョンにアップグレードできない場合は、エージェントを 90 日以内のバージョンに更新してください。エージェントを最新の状態に保つ方法の詳細については、こちらをご覧ください。( https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/ )
エージェントのリリースとサポート日については、New Relic Node.js エージェントの EOL ポリシーを参照してください。( https://docs.newrelic.com/docs/apm/agents/nodejs-agent/getting-started/nodejs-agent-eol-policy/ )