Node.js用エージェントは、Node Package Manager（npm）リポジトリとGitHubで公開されています。Node.jsエージェントをインストールする前に、お使いのアプリケーションが以下のシステム要件を満たしていることを確認します。
New Relicアカウントをまだお持ちでない場合は、New Relicアカウントを新たに作成します。永久無料です。
Node.jsバージョンのサポート
ヒント
パフォーマンスを最大化するために、Node.jsの最新のアクティブな長期サポート（LTS）バージョンを使用してください。
新しいNode.jsリリースのサポート
当社は、以下のアクティブな長期サポートスケジュールの開始により、Node.jsリリースの最新偶数バージョンをサポートします。バージョンサポートポリシーは、一般的な有効期限（EOL）ポリシーを置き換えません。
提案される時間範囲を以下に示します。実際のリリース日は異なる可能性があります。
Node.jsのバージョン | アクティブな長期サポート（LTS）開始日 | サポート付きNode.jsエージェントの初期リリース日 |
|---|---|---|
18 | 2022年10月 | 2022年4月～10月 |
16 | 2021年10月 | Node.jsエージェントv8.0.0を含む2021年7月26日 |
EOLに到達するNode.jsリリースのサポート終了日
新しい長期サポートエージェントバージョンのサポートが利用可能になると、同じ期間中に有効期限を迎えるNode.jsエージェントのバージョンのサポートは同時に終了します。
提案される時間範囲を以下に示します。実際のリリース日は異なる可能性があります。
Node.jsのバージョン | 有効期限（EOL）日 | Node.jsエージェントのサポート終了の初期リリース日 |
|---|---|---|
12 | 2022年4月 | 2022年4月～10月 |
10 | 2021年4月 | 2021年7月26日現在で、Node.jsエージェントのv8を使用したNode.js 10のサポートを終了しました。この移行の簡単な準備方法などの詳細については、エクスプローラーハブの投稿を参照してください。 |
Node.js 12のエラー
Node.js 12の場合、以下の変更によってNode.jsエージェントが影響を受けます。
未処理の拒否となったエラーは、拒否されたpromise作成時にアクティブであったトランザクションに絞り込まれません。これは、init非同期hookのトリガーに責任を有するpromiseはそのpromiseのwrapインスタンス上を通過しないためです。これによって、スケジュールされていたトランザクションに指定のpromise拒否を関連付けるリンクが遮断されます。
サポートされているNode.jsフレームワーク
サポートされているフレームワークをデフォルトのルーターとともに使用している場合、Node.jsエージェントはフレームワークのルート名をそのまま読み取ることができます。ただし、フレームワークが提供する名前より固有な名前が必要な場合は、New RelicがNode.jsトランザクションネーミングAPI によって提供する1つ以上のツールを使用できます。
有効期限（EOL）の通知
2021年11月には、いくつかの機能のサポートを終了します。これには、Node.jsエージェント用のHapi 19.2より前のOracle Driver PackageとHapiバージョンが含まれています。この移行の簡単な準備方法などの詳細については、エクスプローラーハブの投稿を参照してください。
プロセッサ
- New Relicノードエージェントは、AWS Graviton2での動作テストおよび検証を含む、ほとんどのプロセッサ上で動作するように構築されています
オペレーティングシステム
- Linux
- SmartOS
- MacOS 10.7以上
- Windows Server 2008以上
データストア
Node.jsエージェントは、以下のデータストアに対するNode.jsアプリケーション呼び出しのパフォーマンスを監視します。
インスタンスの詳細
さまざまなデータベースとデータベースドライバを対象にインスタンスの詳細を収集します。APMにおいて特定のインスタンスおよびデータベース情報の種類が見えるかどうかは、エージェントのバージョンによって異なります。
New RelicのNode.jsエージェントのバージョン1.31.0以上では、以下をサポートします。
データベース |
| 最小モジュールバージョン | エージェントの最小バージョン |
|---|---|---|---|
4.0.0 | 1.31.0 | ||
2.0.0 | 1.31.0 | ||
2.1.0 | 1.32.0 | ||
2.4.1 | 1.32.0 | ||
1.0.0 | 1.33.0 |
現在、New Relicエージェントにリストされてないデータストアからインスタンスレベルの情報をリクエストするには、support.newrelic.comまでお問い合わせください。
メッセージキュー
メッセージキューのインストゥルメンテーションは、New Relic Node.js エージェントv2以上でのみ使用可能です。現在サポートされているメッセージキューのインストゥルメンテーション：
amqplib
他のメッセージキューライブラリには、カスタムインストゥルメンテーションを使用します。
ホスティングサービス
プロセスマネージャ
一般に、Node.jsの起動、停止、および再開を処理するプロセスマネージャは（Foreverなど）、Node.jsエージェントと互換性がある必要があります。PM2を使用している場合、PM2の最小サポートバージョンは2.0です。
セキュリティ要件
標準的な データ収集のセキュリティ対策として、アプリサーバーはSHA-2（256ビット）をサポートしている必要があります。SHA-1はサポートされていません。
エージェントを他のNew Relic機能に接続する
Node.jsエージェントはその他の機能と統合し、スタック全体でのオブザーバビリティを実現します。
製品 | インテグレーション |
|---|---|
自動インストゥルメンテーションを有効化すると、Node.jsエージェントはBrowserモニタリングの利点を追加できます。Browserモニタリングのインジェクションを有効にした後、Node.jsエージェントを使用してBrowserモニタリングをインストールするためのガイドに従うだけです。これらの手順が完了したら、APMの概要ページでBrowserデータを表示、特定のアプリに対してAPMとBrowserデータ間を素早く切り替えできます。設定オプションと手動インストゥルメンテーションについては、BrowserモニタリングとNode.jsエージェントを参照してください。 | |
インフラストラクチャとAPMエージェントを同じホストにインストールすると、自動的に相互に検出します。その後、APM UIにホストのリストを表示し、インフラストラクチャUIでAPMアプリでインフラストラクチャホストをフィルタリングできます。詳細については、インフラストラクチャモニターにおけるAPMデータを参照してください。 | |
Node.jsエージェントは、NRQLクエリのデフォルトのイベントと属性を送信します。高度な分析のために、カスタムイベントを記録することもできます。 | |
合成トランザクショントレースは、合成モニターからのリクエストを基盤となるAPMトランザクションに接続します。 |