Node.jsエージェントの更新

Node.js 20 の公式パリティ サポートを追加しました。

速報: Node.js 14 のサポートが終了しました。

• 詳細については、当社の サポートポリシー をご覧ください。

速報: ESM ローダーが Node.js 20 をサポートするように更新されました。

• アプリケーションを実行するときは、 --experimental-loader 引数と -r 引数の両方を使用する必要があります。
• node --experimental-loader newrelic/esm-loader.mjs -r newrelic path/to/app.js

速報: デフォルトのコンテキスト マネージャーが AsyncLocalContextManager になるように更新されました。

• 以前のデフォルトの LegacyContextManager は、 config.feature_flag.legacy_context_manager の機能フラグを trueに設定することで復元できます。
• 環境変数を使用したい場合は、 NEW_RELIC_FEATURE_FLAG_LEGACY_CONTEXT_MANAGER を trueに設定できます。
• このコンテキスト マネージャーは将来のバージョンでは削除される予定であることに注意してください。この従来のコンテキスト マネージャーの使用に戻す必要がある場合は、 New Relic サポート または GitHub の問題に報告してください。

速報: shim.handleCATHeaders の名前が shim.handleMqTracingHeadersに変更されました。

New Relic の依存関係を、Node.js バージョンのサポートが更新されたバージョンに更新する

• @newrelic/aws-sdk v7.0.0
• @newrelic/koa v8.0.0
• @newrelic/native-metrics v10.0.0
• @newrelic/スーパーエージェント v7.0.0
• @newrelic/test-utilities v8.0.0

• 同じ解決された moduleName に対して複数のインストルメンテーション フック (onRequire、onResolved) を登録する機能が追加されました。

• これは最初からエージェントの制限でした。
• API を使用して api.instrument、api.instrumentDatastore、api.instrumentWebframework、api.instrumentMessages、または api.instrumentConglomerate を計測した場合、既存の計測フックがオーバーライドされます。
• その結果、Node.js エージェントが設計どおりに機能しなくなります。

速報: config.transaction_tracer.record_sql のデフォルトをオフから難読化に更新しました。これは、SQL ステートメントはキャプチャされますが、難読化されることを意味します。

速報: ルート (URL) パラメータは、トランザクション、ルート セグメント、およびスパンの request.parameters.route.* 属性として保存されるようになりました。

• クエリ パラメーターは、request.parameters.* というプレフィックスが付いた属性として使用できます。トランザクションとスパンについて。
• ルート パラメーターは、request.parameters.route.* というプレフィックスが付いた属性として使用できます。トランザクションとスパンについて。
• ルート パラメーター (別名 URL パラメーター) はさまざまな Web フレームワークの共通機能であり、API ルート定義の一部としてプレースホルダーを作成できます。

速報: WebFrameworkShim クラスから CaptureUrlParams を削除しました。

非推奨の通知: shim.unwrap および shim.unwrapOnce は、複数回ラップされたアイテムをラップ解除しようとすると機能しなくなります。

• これは、同じモジュールを複数回インストゥルメントできるようになったので、登録されているすべてのインスツルメンテーションを破壊せずに安全にラップを解除することができないためです。次のメジャー リリースでは shim.unwrap と shim.unwrapOnce を削除する予定です。

New Relic の依存関係を、Node.js バージョンのサポートが更新されたバージョンに更新する

• @newrelic/aws-sdk v7.0.0
• @newrelic/koa v8.0.0
• @newrelic/native-metrics v10.0.0
• @newrelic/スーパーエージェント v7.0.0
• @newrelic/test-utilities v8.0.0

Node.js 18 の公式パリティ サポートが追加されました。

速報: Node.js 12 のサポートを終了しました。

• 詳細については、当社の サポートポリシー をご覧ください。

速報：「証明書」設定（通常はプロキシを使用）を使用する場合、エージェントには New Relic 証明書バンドルが自動的に含まれなくなりました。

• 「証明書」構成 (通常はプロキシを使用) を使用する場合、エージェントには New Relic 証明書バンドルが含まれなくなりました。これにより現在の環境が破壊される場合は、Mozilla から提供されているような CA バンドルを入手することをお勧めします。

速報: エージェントは、ポート 443 への外部 HTTPS リクエストを行うときにポートを除外し、仕様および他のエージェントに準拠するようになりました

• デフォルトの HTTPS ポートを使用する場合、以前の外部セグメントはExternal/example.com:443という名前になります。
• 外部セグメントの名前はExternal/example.comになります。

速報: await_support機能フラグを介して非同期フック ベースの promise コンテキスト トラッキングを無効にする機能を削除しました。これにより、従来の Promise インストルメンテーションも削除されます。

• await_support機能フラグをリリースしました。エージェントは、async_hooks に依存して async promise の伝播を追跡するようになりました。最終的な結果は、 feature_flag.await_supportを false に設定した場合、レガシー インストルメンテーションは promise チェーン内のすべての関数を個別のセグメントとして追跡します。

BREAKING : 古いoracle npm パッケージのインストルメンテーションを削除しました。

BREAKING : pgの最小バージョンを 8.2.x に更新しました。これは、Node.js 14 以降で実行される最も初期のサポート バージョンです。

BREAKING : サポートされる hapi の最小バージョンを v20.0.0 に更新しました。

• v20.0.0 より前のすべてのバージョンは、セキュリティ上の理由から、hapi によって非推奨になっています。サポート ポリシーを参照してください。

New Relic の依存関係を、Node.js バージョンのサポートが更新されたバージョンに更新する

• @newrelic/aws-sdk v5.0.0
• @newrelic/koa v7.0.0
• @newrelic/native-metrics v9.0.0
• @newrelic/superagent v6.0.0
• @newrelic/test-utilities v7.0.0

Node.js 16 の公式パリティ サポートが追加されました。

BREAKING : Node.js v10.x サポートを削除しました。

• 詳細については、当社の サポートポリシー をご覧ください。

BREAKING : 機能フラグとしてserverless_modeを削除しました。

• 標準のserverless_mode構成はまだ存在します。

BREAKING: エージェントは、「certificates」設定を使用した場合、New Relic の証明書バンドルを自動的に含めなくなりました (一般的にプロキシで使用されます)。

• これにより現在の環境が壊れていることがわかった場合は、機能フラグを利用して、この機能を一時的に復元できます。構成例: feature_flag: { certificate_bundle: true } 。この場合、Mozilla などの環境用の証明書バンドルを取得することをお勧めします。New Relic バンドルと機能フラグは、次のメジャー リリースで完全に削除されます。
• config.feature_flags.certificate_bundleのデフォルトをfalseに設定しました。

New Relic Dependencies を更新された Node.js バージョンのサポートを含むバージョンに更新する

• @newrelic/aws-sdk v4.0.1
• @newrelic/koa v6.0.1
• @newrelic/native-metrics v7.0.1
• newrelic/superagent v5.0.1
• @newrelic/test-utilities v6.0.0

速報非推奨のhttpResponseCode 、 response.status 、 httpResponseMessageの http 応答属性を削除しました

• v6.4.2-v6.14.0: agent v6.4.2以降、これらの属性は非推奨とされていましたが、新しい属性への移行期間を設けるために残されました。
• v7: http 応答属性のレポートが有効になっている場合、 http.statusCodeとhttp.statusTextがレポートされます。

BREAKING非推奨のsetIgnoreTransaction API メソッドを削除しました

• v5 - v6: agent v5.0.0以降、このメソッドは非推奨とされていましたが、新しいメソッドへの移行期間として残してありました。
• v7:アプリケーションは API メソッドtransactionHandle.ignore()を使用する必要があります。

BREAKING api.custom_parameters_enabled構成アイテムと関連する環境変数NEW_RELIC_API_CUSTOM_PARAMETERSを削除しました。

• newrelic.addCustomAttributeとnewrelic.addCustomAttributesを有効にするには、アプリケーションで構成api.custom_attributes_enabledまたは関連する環境変数NEW_RELIC_API_CUSTOM_ATTRIBUTESを使用する必要があります。

BREAKING非推奨の Distributed Tracing API メソッドcreateDistributedTracePayload()と acceptDistributedTracePayload()

• v6.4.0-v6.14.0: agent v6.4.0以降、これらのメソッドは非推奨とされていましたが、新しいメソッドへの移行期間として残してあります。
• v7:アプリケーションは API メソッドtransactionHandle.insertDistributedTraceHeaders(headers)およびtransactionHandle.acceptDistributedTraceHeaders(transportType, headers) を使用する必要があります。これらのメソッドを使用すると、Node.js エージェントは、 transactionHandle.acceptDistributedTraceHeaders(headers)を呼び出すときに W3C のtraceparentおよびtracestateヘッダーを受け入れ、 transactionHandle.insertDistributedTraceHeaders(headers)を呼び出すときに New Relic 分散トレース ヘッダーと共に W3C ヘッダーを含めます。 distributed_tracing.exclude_newrelic_header:trueを使用してヘッダー形式を無効にします。

New Relic Dependencies を更新された Node.js バージョンのサポートを含むバージョンに更新する

• @newrelic/aws-sdk v3.0.0
• @newrelic/koa v5.0.0
• @newrelic/native-metrics v6.0.0
• @newrelic/superagent v4.0.0
• @newrelic/test-utilities v5.0.0

Koaフレームワークの公式計測モジュールをv3.0.0にアップグレードしました。

• v6: @koa/router v8.0.2までのサポートを追加しました。現在、@koa/router v8.0.3 以降はサポートされていません。
• v6: Node.js v12 のサポートが追加され、Node.js v6、7、および 9 のサポートが削除されました。サポートされる最小バージョンは Node.js v8 です。
• また、GithubにあるNew Relicの Koa Release Notesもご覧ください。 。

非推奨のmax_samples_per_minute構成パラメーターを削除しました。これはmax_samples_stored動作に置き換えられました

• v1 - v5: max_samples_per_minuteは、エージェントが 1 分あたりに収集するイベントの最大数を定義しました。以前にアプリケーションでmax_samples_per_minuteを上限として使用していた場合、サーバー上でデータがドロップされないように、しきい値を有効な最大値まで下げる必要がある場合があります。10k 未満をお勧めします。
• v5:エージェント v5 以前では、エージェントがNew Relic コレクターと通信できない場合にエージェントが保存するイベントの最大数をmax_samples_storedで定義していました。
• v6: max_samples_storedの新しい動作は、エージェントが 1 分あたりに収集するイベントの最大数を定義します。この数よりも多い場合、エージェントは統計的サンプリングを収集します。この構成の使用法は、他の APM エージェントと一致しています。
• トラブルシューティングのヒント:イベント データが欠落している場合は、 max_samples_storedの値を増やすか、デフォルト値に戻してください。max_samples_storedの値は 10,000 を超えてはなりません。

非推奨のaddCustomParameterメソッドを削除しました。

• v2 - v4: agent v2.7.0以降、これらのメソッドは非推奨とされていましたが、新しいメソッドへの移行期間として残してあります。
• v5:アプリケーションは API メソッドnewrelic.addCustomAttribute()およびnewrelic.addCustomAttributes()を使用する必要があります。これらは、古い方法のドロップイン代替品です。

非推奨のcreate*Transactionメソッドを削除しました。

• v2 - v4: agent v2.0.2以降、これらのメソッドは非推奨とマークされていましたが、新しいメソッドへの移行期間として残してあります。
• v5:アプリケーションは API メソッドnewrelic.startWebTransaction()およびnewrelic.startBackgroundTransaction()に更新する必要があります。
• トラブルシューティングのヒント：これらの新しい方法は、古い方法のドロップイン代替ではありません。これらの新しい方法に移行する前に、カスタムインストルメンテーションガイドを確認してください。

非推奨のcreateTracerメソッドを削除しました。

• v3 - v4:エージェント v3.3.0 以降、このメソッドはnewrelic.startSegment()を支持して非推奨としてマークされました。
• v5:アプリケーションはnewrelic.startSegment()に更新する必要があります。

node-cassandra-cqlインストルメンテーションを削除しました。

• v4: npm パッケージnode-cassandra-cqlを使用するアプリケーションは、Cassandra のデータストア メトリックを取得します。
• v5: Cassandra データストア メトリックを取得するには、アプリケーションをcassandra-driverパッケージに移行する必要があります。このモジュールは、同じ開発者によって積極的に維持されています。node-cassandra-cqlパッケージは 2014 年 2 月に放棄され、 cassandra-driverパッケージが採用されました。

非推奨のcapture_paramsおよびignored_params構成を削除しました。

• v2 - v4: agent v2.7.0 以降、これらの設定パラメータでは警告が記録され、その値は自動的に新しい属性設定にアップグレードされます。
• v5: 警告は記録されますが、設定は無視され、自動アップグレードは行われなくなります。
• トラブルシューティングのヒント:アプリケーションのパラメーターがignored_params構成にリストされている場合は、それらをattributes.excludeに移動する必要があります。