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

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

BREAKING: Node.js 14 のサポートを廃止しました。

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

BREAKING: ESM ローダーを更新して Node.js 20 をサポートしました。

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

BREAKING: デフォルトのコンテキスト マネージャーを AsyncLocalContextManager に更新しました。

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

BREAKING: 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 エージェントが設計どおりに機能しなくなります。

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

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

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

BREAKING: WebFrameworkShim クラスから captureUrlParams を削除しました。

DEPRECATION NOTICE: 複数回ラップされたアイテムをアンラップしようとすると、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 の公式パリティ サポートが追加されました。

BREAKING: Node.js 12 のサポートを廃止しました。

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

BREAKING: エージェントは、「証明書」設定 (通常はプロキシを使用) を使用するときに、 New Relic証明書バンドルを自動的に含めなくなりました。

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

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

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

BREAKING: await_support機能フラグを介して非同期フックベースの 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

BREAKING 非推奨のhttpResponseCode 、 response.status 、 httpResponseMessage HTTP レスポンス属性を削除しました

• v6.4.2-v6.14.0:

  エージェント v6.4.2 以降、これらの属性は非推奨としてマークされましたが、新しい属性への移行期間を設けるために残されました。

• v7:

  http 応答属性レポートが有効になっている場合、 http.statusCodeとhttp.statusTextレポートされます。

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

• v5 - v6:

  エージェント 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 非推奨のディストリビューティッド（分散）トレーシングAPIメソッドcreateDistributedTracePayload()と acceptDistributedTracePayload()

• v6.4.0-v6.14.0:

  エージェント v6.4.0 以降、これらのメソッドは非推奨としてマークされましたが、新しいメソッドへの移行期間を設けるために残されました。

• v7:

  アプリケーションは API メソッドtransactionHandle.insertDistributedTraceHeaders(headers)とtransactionHandle.acceptDistributedTraceHeaders(transportType, headers) を使用する必要があります。 これらのメソッドを使用すると、Node.js エージェントは、transactionHandle.acceptDistributedTraceHeaders(headers) を呼び出すときに W3C の traceparent および tracestate ヘッダーを受け入れ、distributed_tracing.exclude_newrelic_header:true を使用して New Relictrack ヘッダー形式が無効にされていない限り、transactionHandle.insertDistributedTraceHeaders(headers) を呼び出すときに W3C ヘッダーをNew Relic New Relicティッド（分散）トレーシング ヘッダーとともに含めるようになります。

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 以前では、 max_samples_stored 、エージェントがNew Relic コレクターと通信できない場合に保存するイベントの最大数を定義しました。

• v6:

  max_samples_storedの新しい動作は、エージェントが 1 分あたりに収集するイベントの最大数を定義します。 この数を超える場合、エージェントは統計サンプルを収集します。 この設定の使用方法は、他のAPMエージェントと一致しています。

• Troubleshooting tips:

  イベント データが不足している場合は、 max_samples_storedの値を増やすか、デフォルト値に戻します。 max_samples_storedの値は 10,000 を超えてはなりません。

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

• v2 - v4:

  エージェント v2.7.0 以降、これらのメソッドは非推奨としてマークされましたが、新しいメソッドへの移行期間を設けるために残されました。

• v5:

  アプリケーションは API メソッドnewrelic.addCustomAttribute()とnewrelic.addCustomAttributes()を使用する必要があります。 これらは古い方法の代替品です。

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

• v2 - v4:

  エージェント v2.0.2 以降、これらのメソッドは非推奨としてマークされましたが、新しいメソッドへの移行期間を設けるために残されました。

• v5:

  アプリケーションは API メソッドnewrelic.startWebTransaction()およびnewrelic.startBackgroundTransaction()に更新する必要があります。

• Troubleshooting tips:

  これらの新しい方法は、古い方法に代わるものではありません。 これらの新しい方法に移行する前に、カスタムインストゥルメンテーション ガイドを確認してください。

非推奨の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:

  エージェント v2.7.0 以降では、これらの設定引数によって警告がログに記録され、値は新しい属性設定に自動的にアップグレードされるようになりました。

• v5:

  警告は引き続きログに記録されますが、設定は無視され、自動アップグレードは行われなくなります。

• Troubleshooting tips:

  アプリケーションがignored_params設定 にリストされている場合は、それらをattributes.excludeに移動する必要があります。