• ログイン今すぐ開始

本書は、お客様のご参考のために原文の英語版を機械翻訳したものです。

英語版と齟齬がある場合、英語版の定めが優先するものとします。より詳しい情報については、本リンクをご参照ください。

問題を作成する

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

New Relic の最新の機能、拡張機能、重要なセキュリティパッチを最大限に活用するために、Node.js エージェントを最新バージョンにアップデートすることをお勧めします。特定のエージェントのアップデートに関する詳細については、 Node.js エージェントのリリースノート を参照してください。リリースノートには、該当する場合にはダウンロードリンクと、最新バージョンをダウンロードして インストールするための手順が記載されています

  • newrelicモジュールがpackage.jsonにリストされている場合は、 npm installを実行します。
  • newrelicモジュールのみをターゲットにする場合は、 npm update newrelicを実行します。

推奨: 更新したバージョンを運用に移す前にテストしてみてください。問題が発生した場合は、Node.js エージェント トラブルシューティング手順 に従ってください。

Node.js エージェント バージョン 9 にアップグレードする

Node.js バージョン 9 にアップグレードする前に、主な変更点についてこの情報を確認してください。

Node.js エージェント v9 の主な変更点

コメントコメント

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 に更新しました。

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バージョンのサポート

Node.js 14 は、New Relic Node.js v9 エージェントでサポートされている最も古いバージョンです。Node.js 12 および 13 は v9 ではサポートされていません。Node.js 13 以前を実行しているお客様には、次の 2 つのオプションがあります。

  • サポートされているバージョンの Node.js にアップグレードして、New Relic Node.js v9 エージェントの新機能を活用してください。
  • アップデート エージェント バージョンでのみ利用可能な新機能を使用する機能なしで、New Relic Node.js v8 エージェントにとどまります。

ヒント

できるだけ早く Node.js の新しいバージョンにアップグレードしてください。New Relic Node.js エージェントの次のメジャー バージョンでは、Node.js 14 のサポートが削除される可能性があります。

Node.jsエージェントバージョン8へのアップグレード

Node.jsのバージョン8にアップグレードする前に、主要な変更点についてこの情報を確認してください。

Node.jsエージェントv8での主な変更点

コメントコメント

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

Node.jsバージョンのサポート

Node.js v12 は、New Relic Node.js v8 エージェントでサポートされている最も古いバージョンです。Node.js 10 および 11 は v8 ではサポートされていません。Node.js 11 以前を実行しているお客様には、次の 2 つのオプションがあります。

  • サポートされているバージョンの Node.js にアップグレードして、New Relic Node.js v8 エージェントの新機能を活用してください。
  • New Relic Node.js v7エージェントのままでは、エージェントのバージョンを更新した場合にのみ利用できる新機能を使用することができません。

ヒント

できるだけ早く Node.js の新しいバージョンにアップグレードしてください。New Relic Node.js エージェントの次のメジャー バージョンでは、Node.js 12 のサポートが削除される可能性があります。

Node.jsエージェントバージョン7へのアップグレード

Node.jsのバージョン7にアップグレードする前に、主要な変更点についてこの情報を確認してください。

Node.jsエージェントv7での主な変更点

コメントコメント

速報非推奨のhttpResponseCoderesponse.statushttpResponseMessageの http 応答属性を削除しました

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

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

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

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

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

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

Node.jsバージョンのサポート

Node.js v10 は、New Relic Node.js v7 エージェントでサポートされている最も古いバージョンです。Node.js 8 および 9 は v7 ではサポートされていません。Node.js 9 以前を実行しているお客様には、次の 2 つのオプションがあります。

  • サポートされているバージョンの Node.js にアップグレードして、New Relic Node.js v7 エージェントの新機能を活用してください。
  • New Relic Node.js v6 エージェントのままでは、エージェントのバージョンを更新したときにのみ利用できる新機能を使用できません。

Node.js 10 は更新を受け取りません。できるだけ早く Node.js の新しいバージョンにアップグレードしてください。Node.js 10 のサポートは、New Relic Node.js エージェント v8 で廃止されました。

Node.jsエージェントバージョン6へのアップグレード

Node.jsエージェント・バージョン6にアップグレードする前に、主要な変更点についてこの情報を確認してください。

Node.jsエージェントv6の主な変更点

コメントコメント

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 を超えてはなりません。

Node.jsバージョンのサポート

Node.js 8 は、New Relic Node.js v6 エージェントでサポートされている最も古いバージョンです。Node.js 6、7、9 は v6 ではサポートされていません。Node.js 6、7、および 9 を実行しているお客様には、次の 2 つのオプションがあります。

  • サポートされているバージョンの Node.js にアップグレードして、New Relic Node.js v6 エージェントの新機能を活用してください。
  • New Relic Node.js v5エージェントのままでは、エージェントのバージョンを更新したときにのみ利用できる新機能を使用できません。

Node.js 8 は更新を受け取らなくなりましたが、New Relic は当面の間、これらのバージョンの Node.js を引き続きサポートします。

ヒント

できるだけ早く Node.js の新しいバージョンにアップグレードしてください。New Relic Node.js エージェントの次のメジャー バージョンでは、Node.js 8 のサポートが削除される可能性があります。

Node.jsエージェントバージョン5へのアップグレード

Node.js agent v5 にアップグレードする前に、主要な変更点についてこの情報を確認してください。また、New Relic の Node.js v5 移行ガイド(GitHub )もご覧ください。

Node.js v5 エージェントの主な変更点

コメントコメント

非推奨の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に移動する必要があります。

Node.jsバージョンのサポート

Node.js 6 は、New Relic Node.js v5 エージェントでサポートされている最も古いバージョンです。Node.js 4 および 5 は v5 ではサポートされていません。Node.js 4 または 5 を実行しているお客様には、次の 2 つのオプションがあります。

  • サポートされているバージョンの Node.js にアップグレードして、New Relic Node.js v5 エージェントの新機能を活用してください。
  • New Relic Node.js v4 エージェントのままでは、エージェントのバージョンを更新したときにのみ利用できる新機能を使用できません。

Node.js 7 および 9 は更新を受け取らなくなりましたが、New Relic は当面の間、これらのバージョンの Node.js を引き続きサポートします。

ヒント

できるだけ早く Node.js の新しいバージョンにアップグレードしてください。New Relic Node.js エージェントの次のメジャー バージョンでは、Node.js 6 および 7 のサポートが削除される可能性があります。

v5での機能フラグ

New Relic for Node.js v5.の時点で。

  • custom_instrumentation: この機能は構成できなくなりました。
  • custom_metrics: この機能は構成できなくなりました。
  • synthetics: この機能は構成できなくなりました。
  • native_metrics: この機能は、 plugins.native_metrics.enabled構成値によって制御されるようになりました。

Node.jsエージェントバージョン4へのアップグレード

Node.js agent v4 にアップグレードする前に、主要な変更点についてこの情報を確認してください。また、New Relic の Node.js v4 移行ガイドを GitHub でご覧いただけます。

Node.jsエージェントバージョン3へのアップグレード

Node.js エージェント agent v3 にアップグレードする前に、主要な変更点についてこの情報を確認してください。また、New Relic の Node.js v3 移行ガイド(GitHub )もご覧ください。

Node.jsエージェントバージョン2へのアップグレード

Node.js agent v2 にアップグレードする前に、主要な変更点についてこの情報を確認してください。また、New Relic の Node.js v2 移行ガイドを GitHub でご覧いただけます。

Copyright © 2023 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.