Node.js agent release notesRSS

メモ

⚠ 重大な変更

このバージョンの Node.js エージェントは SemVer のメジャー アップデートであり、次の重大な変更が含まれています。メジャー バージョンでは、メンテナーの規定によりサポート終了となった言語ランタイムのサポートが中止される場合があります。さらに、メジャー バージョンでは、特定の計装のサポートが終了し、削除される場合があります。 これらの変更の詳細については、 移行ガイドを参照してください。

• Node.js 20のサポートを終了しました
• @apollo/severの計装をプラグイン（@newrelic/apollo-server-plugin）から従来の計装に移行しました
• クロスアプリケーショントレーシング（CAT）機能を削除しました
• ライセンス、アプリケーション、およびセキュリティポリシー（LASP）のサポートを削除
• 〜の計装を削除 koa-route
• 〜の計装を削除 koa-router
• ロジックは以前にトランザクション終了時に移動されたため、shim.prefixRouteParametersを削除しました
• MySQL Pool#queryセグメントの作成を削除しました
• 削除 shim.argsToArray
• @nestjs/cliおよび@nestjs/coreのサポートされている最小バージョンを次に更新 10.0.0
• nextのサポートされている最小バージョンを14に更新しました
• bluebirdのサポートされている最小バージョンを次に更新： 3.0.0
• mysql2のサポートされている最小バージョンを次に更新： 3.0.0
• cassandra-driverのサポートされている最小バージョンを次に更新 4.0.0
• fastify 3.xのサポートを終了しました
• config.distributed_tracing.exclude_newrelic_headerをデフォルトでtrueに設定されるように更新しました

特徴

• fastify 3.x のサポートを終了しました (#3980) (720979b)
• Node.js 20のサポートを終了 (#3980) (5306223)
• @apollo/severの計装をプラグイン（@newrelic/apollo-server-plugin）から従来の計装に移行しました (#3980) (736e0a4)
• shim.argsToArrayを削除(#3980) (9183d29)
• ロジックは以前にトランザクション終了時に移動されたため、shim.prefixRouteParametersを削除しました (#3980) (9f1408e)
• MySQL Pool#queryセグメントの作成を削除 (#3980) (1d5a6dd)
• クロスアプリケーショントレーシング（CAT）機能を削除 (#3980) (a87ed4d)
• koa-routeの計装を削除 (#3980) (40c10d9)
• koa-routerの計装を削除しました (#3980) (038ecc7)
• ライセンス、アプリケーション、およびセキュリティポリシー（LASP）のサポートを削除しました (#3980) (bc09485)
• config.distributed_tracing.exclude_newrelic_headerがデフォルトでtrueに設定されるように更新しました (#3980) (774ce08)
• cassandra-driverの最小サポートバージョンを4.0.0に更新しました (#3980) (419337a)
• @nestjs/cliと@nestjs/coreの最小サポートバージョンを10.0.0に更新しました (#3980) (120e6de)
• bluebirdの最小サポートバージョンを3.0.0に更新しました (#3980) (369f920)
• mysql2の最小サポートバージョンを3.0.0に更新しました（#3980）（2861406）
• nextの最小サポートバージョンを14に更新しました (#3980) (80c5c0c)

コードリファクタリング

• 排他時間とトレースの合計時間の計算方法を更新しました (#3980) (b227ed6)
• ホットパスのパフォーマンスを向上させるため、tracer.bindFunctionのインスタンスをtracer.runInContextで更新しました (#3811) (5d77085)

ドキュメント

• 互換性レポートを更新しました (#3990) (f3bb380)

雑用

• gitフックの代わりにhuskyを削除し、npm installにセキュリティ強化オプションを追加しました (#3988) (e3a7dda)
• 本番環境の依存関係を最新に更新しました (#3996) (b710bac)

テスト

• 互換性レポートで@nestjs/coreをサポートしていることが示されるように、nest jsのバージョン管理されたテストのpackage.jsonにminSupportedを追加しました (#3982) (bfa4aa1)
• prisma 7のテストを追加 (#3980) (116ee9c)
• バージョン管理されたテストランナーのコードを@newrelic/test-utiltiesからエージェントに移動しました (#3980) (d4f9a0c)
• @newrelic/test-utilitiesを削除しました (#3980) (1751147)
• スモークテストのようなesmテストのサンプルサイズを削減 (#3986) (40669fb)
• test/lib/get-package-version.jsを修正 (#3993) (5d31f08)
• AWS-sdk-v3テストでのバージョン検索の問題を修正（#3992）（7be3f4a）
• groupedDependenciesを使用するようにaws-sdk-v3テストランナーを再構築 (#3984) (fc67490)
• 実行する組み合わせの数を減らすため、いくつかのバージョン付きテストスタンザを更新しました (#3991) (d606305)

継続的なインテグレーション

• APIドキュメントのコミット/プッシュを可能にするため、contents: writeをpost-releaseに追加しました (#3978) (90c4e61)
• 残りのアクションがNode 24で実行されるように更新しました (#3980) (ea21934)
• actions/download-artifactのバージョンをv8に更新 (#3980) (54a58b9)
• node 24で確実に実行されるようにアクションのバージョンを更新 (#3980) (6302002)

サポートステートメント:

最新のエージェント バージョンが利用可能になったらすぐに更新することをお勧めします。最新バージョンにアップグレードできない場合は、エージェントを 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/ )

メモ

特徴

• Google ADK BaseAgent.runAsyncの計装を追加しました (#3905) (c6c51d5)
• Google ADKFunctionTool.runAsyncを計装（#3935）（57f9ed7）
• @azure/functions計装をサブスクライバー タイプに更新しました (#3915) (227e779)
• ログでライセンスキーをマスクする方法を更新しました (#3945) (6289502)

バグ修正

• <3.4.0のファイルの再構成に対応するため、connectの計装クエリを更新しました (#3923) (00b615c)
• Promiseが履行または拒否された場合にセグメントをタッチするようにtracer.bindFunctionを更新しました（#3967）（712db61）
• @smithy/smithy-client 4.13.0+の使用に対応するようにAWS SDK v3の計装を更新しました(#3965) (5e0fe24)

コードリファクタリング

• undici、ドメイン、およびprocess._fatalExceptionの計装におけるAsyncLocalStorage.enterWithへの依存を削除しました (#3894) (612b449)

ドキュメント

• 互換性レポートを更新しました (#3941) (214b353) (#3934) (5a962d4) (#3909) (ad6fa8a)

雑用

• max_trace_segmentsがヒットしたときにログ行を追加 (#3933) (46b9238)
• client-dynamodbテスト用にassertSegmentDurationをコメントアウト (#3972) (590cd3e)
• amqplibテストの問題を修正 (#3969) (a770000)
• Connectの計装をサブスクライバー タイプにリファクタリングしました (#3912) (e5d87b7)
• kafkajs 計装をサブスクライバー タイプにリファクタリングしました (#3958) (72e383c)
• memcachedテストでのactualTime vs segmentDurationアサーションを削除 (#3932) (98c50e0)
• @apm-js-collab/tracing-hooks 0.7.0に更新しました (#3949) (5c99cd1)

テスト

• assertSegmentDurationカスタムアサーションを追加し、memcachedのテストに追加しました (#3875) (b28d866)

継続的なインテグレーション

• CodeQLの警告を解消するため、すべてのワークフローに最小権限モデルを適用 (#3961) (237d5b9)

サポートステートメント:

最新のエージェント バージョンが利用可能になったらすぐに更新することをお勧めします。最新バージョンにアップグレードできない場合は、エージェントを 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/ )

メモ

バグ修正

• onceをサブスクライブしたイベントハンドラーのリークを回避するためにchild_process計装を修正しました (#3907) (ad0b1f6)

ドキュメント

• 互換性レポートを更新しました (#3897) (0ed2202)

サポートステートメント:

最新のエージェント バージョンが利用可能になったらすぐに更新することをお勧めします。最新バージョンにアップグレードできない場合は、エージェントを 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

• Fixed detecting AWS SDK message attributes presence (#3903) (e81dc61)

Tests

• Updated minAgentVersion for 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-sdk v3計装をリファクタリングしました

  • @aws-sdk/smithy-clientサブスクライバーを追加しました (#3877) (0e350fc)
  • AWS Bedrock Middlewareを使用して@smithy/smithy-client send サブスクライバーを追加しました (#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)

• メッセージブローカー定数を使用するようにamqplibをリファクタリングしました (#3879) (77621fb)

ドキュメント

• 互換性レポートを更新しました (#3874) (ae887c4)

雑用

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