Node.js agent release notesRSS

Bug fixes

Fixed Azure functions crashing when they include response headers (#4070) (c88d2b7)

Documentation

Updated compatibility report (#4067) (0ae24b8)

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

Documentation

• Removed outdated Next.js documentation in repo (#4060) (185bb66)
• Updated compatibility report (#4047) (25cbd38)

Miscellaneous chores

• Added proxy config support to OTEL metrics (#4041) (6c04b8a)
• Added supportability metrics to OTEL metrics export (#4051) (db6e4e3)
• Updated min version of @opentelemetry 0.x packages to ^0.219.0 (#4065) (3f58ad0)

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

メモ

特徴

• Hybridエージェントを介したネイティブNext.js OTEL計装のサポートを追加しました (#4040) (1944f39)

バグ修正

• オブジェクトキー内の空の値を処理するようにラベルパーサーを更新 (#4004) (73c00d7)

コードリファクタリング

• @hapi/hapiと@hapi/visionをサブスクライバーベースに移行 (#3995) (54c60a8)
• 発行されたイベントをサブスクライブするためにkoa計装をリファクタリングしました (#4016) (e1f6c27)
• 以前に保存されたエラーがあった場合にのみエラーを処理済みとしてマークするようにMiddlewareWrappermaybeHandleErrorを更新しました（#4032）（1b21cc8）

ドキュメント

• 計装がエージェントにマージされたため、@newrelic/apollo-server-pluginへのリンクを削除しました (#4003) (9afd9cb)
• apollo-serverのドキュメントをドキュメントサイトに移動しました (#3994) (11ca2ae)
• 互換性レポートを更新 (#4028) (b16ad6e) (#4014) (3efa1ff) (#4002) (33a8236)

雑用

• instrumentLoadedModuleAPIを非推奨化 (#4034) (306ff86)

• OTELメトリクスの監査ロギングを追加 (#4018) (494c836)

• Prisma 7をサポートするOTELルールを追加 (#4013) (c142c60)

• OTELルールの順序を修正 (#4025) (150476a)

• OTEL変換ルールをリファクタリング (#3999) (48ff739)

• CIワークフローのnode-versionを修正（#4042）（dd05ea9）

• codecovアクションを更新 (#4039) (31b9c84)

• ロガーのauditメソッドを使用するようにremote-methodを更新（#4038）（0e4507e）

• Claude botのベースライン指示を追加 (#4036) (c8f6649)

• 更新された依存関係

  • 未使用の開発依存関係を削除 (#4005) (e00f7d3)
  • @apm-js-collab/tracing-hooksを0.9.1に更新しました (#4043) (f05e5d4)
  • commanderを最新に更新しました (#4021) (83b1d58)
  • nockを最新に更新（#4022）（9bf79ab）
  • sinonを最新に更新 (#4020) (0ced304)
  • protobufjsを最新に更新 (#4006) (45c61f3)
  • globを13にアップグレードしました (#4008) (3053545)
  • gotとrimrafを最新版にアップグレードしました（#4007）（b967593）

テスト

• AWSテストエージェントのセットアップがsmithy >=4.7.3で機能するように、安定したhttp.requestシムを追加 (#4010) (c5fd80a)
• 自己署名証明書とundici.Agentを使用した場合の動作をアサートするundiciのバージョン別テストを追加しました (#4026) (27507bc)
• >=4.1.4をテストするためにmongodb-esmテストをリファクタリング (#4023) (d85767f)
• globへの依存を排除し、代わりにfs.globを使用（#4019）（204f124）
• サポートされていなかったため、バージョン<5.2.0ではカスタムディスパッチャーの使用をスキップするように、undici.Agent（エージェント）のバージョン別テストを更新しました(#4029) (08cd079)

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

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

メモ

⚠ 重大な変更

このバージョンの 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/ )