• ログイン

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

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

問題を作成する

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

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

  • newrelic モジュールが package.json に記載されている場合は、 npm install を実行してください。
  • newrelic モジュールだけをターゲットにしたい場合は、 npm update newrelic を実行します。

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

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を利用して一時的にこの機能を復活させることができます。設定例: feature_flag:{ certificate_bundle: true }。 。この場合、Mozilla から提供されているような、あなたの環境に合った証明書バンドルを入手することをお勧めします。New Relic のバンドルと feature flag は、次のメジャーリリースで完全に削除される予定です。
  • 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での主な変更点

コメント

BREAKING 非推奨の削除 httpResponseCode, response.status and httpResponseMessage httpレスポンス属性

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

BREAKING 削除された非推奨 setIgnoreTransaction APIメソッド

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

BREAKING api.custom_parameters_enabled configuration item and associated environment variable NEW_RELIC_API_CUSTOM_PARAMETERS を削除しました。

BREAKING 非推奨のDistributed Tracing APIメソッド、 creationDivertTracePayload() and acceptDivertTracePayload()を削除しました。

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

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: agent v5 以下では、 max_samples_stored エージェントが New Relic collector と通信できない場合に保存するイベントの最大数を定義していました。
  • 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 メソッドを削除しました。

node-cassandra-cql instrumentationを削除しました。

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

非推奨の capture_paramsignored_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 © 2023 New Relic株式会社。

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