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

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

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

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

BREAKING: エージェントは、「certificates」設定を使用した場合、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に移動する必要があります。