Node.js agent release notesRSS

Notes

Features

• Added support for native Next.js OTEL instrumentation via the Hybrid Agent (#4040) (1944f39)

Bug fixes

• Updated label parser to handle empty values in an object key (#4004) (73c00d7)

Code refactoring

• Migrate @hapi/hapi and @hapi/vision to subscriber-based (#3995) (54c60a8)
• Refactored koa instrumentation to subscribe to events emitted (#4016) (e1f6c27)
• Updated MiddlewareWrapper maybeHandleError to only mark error as handled if there was a previously stored error (#4032) (1b21cc8)

Documentation

• Removed linked to @newrelic/apollo-server-plugin as instrumentation was merged into agent (#4003) (9afd9cb)
• Moved apollo-server docs to the docs website (#3994) (11ca2ae)
• Updated compatibility report (#4028) (b16ad6e) (#4014) (3efa1ff) (#4002) (33a8236)

Miscellaneous chores

• Deprecate instrumentLoadedModule API (#4034) (306ff86)
• Added audit logging for OTEL metrics (#4018) (494c836)
• Added OTEL rule to support Prisma 7 (#4013) (c142c60)
• Fix ordering of OTEL rules (#4025) (150476a)
• Refactored OTEL transform rules (#3999) (48ff739)
• Fixed node-version in CI workflow (#4042) (dd05ea9)
• Updated codecov action (#4039) (31b9c84)
• Updated remote-method to use audit method of logger (#4038) (0e4507e)
• Added baseline instructions for Claude bot (#4036) (c8f6649)
• Updated dependencies
  • Removed unused dev dependencies (#4005) (e00f7d3)
  • Updated @apm-js-collab/tracing-hooks to 0.9.1 (#4043) (f05e5d4)
  • Updated commander to latest (#4021) (83b1d58)
  • Updated nock to latest (#4022) (9bf79ab)
  • Updated sinon to latest (#4020) (0ced304)
  • Updated protobufjs to latest (#4006) (45c61f3)
  • Upgraded glob to 13 (#4008) (3053545)
  • Upgraded got and rimraf to latest (#4007) (b967593)

Tests

• Add stable http.request shim so AWS test agent setup works with smithy >=4.7.3 (#4010) (c5fd80a)
• Added an undici versioned test to assert behavior with using a self signed cert and undici.Agent (#4026) (27507bc)
• Refactor mongodb-esm tests to test >=4.1.4 (#4023) (d85767f)
• Removed reliance on glob in lieu of fs.glob (#4019) (204f124)
• Updated undici.Agent versioned test to skip using custom dispatcher on versions <5.2.0 as it was not supported (#4029) (08cd079)

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

メモ

⚠ 重大な変更

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