• ログイン今すぐ開始

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

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

問題を作成する

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 18 の公式パリティ サポートが追加されました。

BREAKING : Node 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 に更新しました。これは、ノード 14 以降で実行される最も初期のサポート バージョンです。

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

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

  • @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 14 は、New Relic Node.js v9 エージェントでサポートされている最も古いバージョンです。ノード 12 と 13 は v9 ではサポートされていません。ノード 13 以前を実行しているお客様には、次の 2 つのオプションがあります。

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

ヒント

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

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

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

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

コメントコメント

Node 16の公式パリティサポートを追加

BREAKING: Dropped Node v10.x support.

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のバージョンサポートが更新されたバージョンに更新する。

  • @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 v12 は、New Relic Node.js v8 エージェントがサポートする最も古いバージョンです。Node 10 および 11 は v8 ではサポートされていません。Node 11以前のバージョンをお使いのお客様には2つの選択肢があります。

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

ヒント

できるだけ早く、新しいバージョンのNodeにアップグレードしてください。New Relic Node.js エージェントの次のメジャーバージョンでは、おそらく Node 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のバージョンサポートが更新されたバージョンに更新する。

  • @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 v10 は、New Relic Node.js v7 エージェントがサポートする最も古いバージョンです。Node 8および9はv7ではサポートされていません。 Node 9以前のバージョンをお使いのお客様には2つの選択肢があります。

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

Node 10はアップデートを受け取りません 。できるだけ早く、新しいバージョンのNodeにアップグレードしてください。Node 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 v12のサポートを追加し、Node v6, 7, 9のサポートを削除しました。サポートされる最小のバージョンはNode 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 8 は、New Relic Node.js v6 エージェントがサポートする最も古いバージョンです。Node 6、7、9はv6ではサポートされていません。Node 6、7、9をお使いのお客様には2つの選択肢があります。

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

Node 8 はもはやアップデートを受けることはありません が、New Relic は当面の間、これらのバージョンの Node のサポートを継続します。

ヒント

できるだけ早く、新しいバージョンのNodeにアップグレードしてください。New Relic Node.js エージェントの次のメジャーバージョンでは、おそらく Node 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 6 は、New Relic Node.js v5 エージェントでサポートされる最も古いバージョンです。Node 4と5はv5ではサポートされていません。 Node 4または5をお使いのお客様には2つの選択肢があります。

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

Node 7 と 9 はもうアップデートを受けていません。 しかし、New Relic は当面の間、これらのバージョンの Node をサポートし続けます。

ヒント

できるだけ早く、新しいバージョンのNodeにアップグレードしてください。New Relic Node.js エージェントの次のメジャーバージョンでは、おそらく Node 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 © 2022 New Relic株式会社。

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