Node.jsエージェントには、最も一般的なNode.jsフレームワーク、アプリケーションサーバー、データベース、およびメッセージキューシステムのビルトイン・インストゥルメンテーションが含まれています。追加設定なしでインストゥルメントされていないフレームワークとライブラリに関しては、Node.jsエージェントAPIでエージェントを拡張できます。
Node.js用エージェントは、Node Package Manager(npm)リポジトリとGitHubで公開されています。New RelicのNode.jsエージェントを試してみませんか?New Relicアカウントを作成します。
エージェントのインストール要件
エージェントをインストールする前に、お使いのシステムが最小要件を満たしていることを確認してください。パフォーマンスを最大化するために、Node.jsの最新のアクティブな長期サポート(LTS)バージョンを使用してください。
Node.jsエージェントは、次のオペレーティングシステムに対応しています。
- Linux
- SmartOS
- MacOS 10.7以上
- Windows Server 2008以降、推奨時間範囲は次のとおりです。実際のリリース日は異なる可能性があります。
また、以下のホスティングサービスにも対応しています。
標準的な データ収集のセキュリティ対策として、アプリサーバーはSHA-2(256ビット)をサポートしている必要があります。SHA-1はサポートされていません。
当社は、以下のアクティブな長期サポートスケジュールの開始により、Node.jsリリースの最新偶数バージョンをサポートします。バージョンサポートポリシーは、一般的な有効期限(EOL)ポリシーを置き換えません。
提案される時間範囲を以下に示します。実際のリリース日は異なる可能性があります。
Node.jsのバージョン | アクティブな長期サポート(LTS)開始日 | サポート付きNode.jsエージェントの初期リリース日 |
---|
18 | 2022年10月 | 2022年8月3日、Node.jsエージェントのv9.0.0を使用 |
16 | 2021年10月 | Node.jsエージェントv8.0.0を含む2021年7月26日 |
14 | 2020年10月 | 2020年11月9日、Node.jsエージェントv7.0.0 |
古いNode.jsバージョンのEOLの推奨時間範囲を以下に示します。実際のリリース日は異なる可能性があります。
Node.jsのバージョン | 有効期限(EOL)日 | Node.jsエージェントのサポート終了の初期リリース日 |
---|
12 | 2022年4月 | 2022年8月3日現在、Node.jsエージェントのv9を使用したNode.js 12のサポートを終了しました。 |
10 | 2021年4月 | 2021年7月26日現在で、Node.jsエージェントのv8を使用したNode.js 10のサポートを終了しました。この移行の簡単な準備方法などの詳細については、サポートフォーラムの投稿を参照してください。 |
Node.jsを備えたインストゥルメント
インストール後、エージェントはサポートされているNode.jsライブラリとフレームワークのカタログを使用して自動インストゥルメントします。これにより、ウェブアプリケーションやサーバーに固有の詳細情報に即座にアクセスできます。
未対応のフレームワークまたはライブラリの場合、Node.jsエージェントAPIを使用してエージェントを自身でインストゥルメントする必要があります。
Node.jsエージェントは、以下のデータストアに対するNode.jsアプリケーション呼び出しのパフォーマンスを監視します。
- grpc-jsライブラリは、単項、ストリーミング、双方向のクライアント呼び出しでサポートされています。
Node.jsエージェントは、ネイティブhttp
モジュールをインストゥルメントします。
また、人気のあるundiciクライアントも実験的なサポートを受けています。undiciを使用するには、feature_flag.undici_instrumentation = true
をnewrelic.js
設定ファイルで設定してください。
aws-sdkを使用したAmazon Web Services(AWS)へのすべての呼び出しが追跡されます。
TypeScriptはJavaScriptにコンパイルできるプログラミング言語です。インストール後、Node.jsエージェントはTypeScriptアプリを自動インストゥルメントし、すぐにパフォーマンスデータにアクセスできるようにします。
ESモジュールは、共有/再利用のためにJavaScriptコードをパッケージ化するための公式標準です。Node.jsエージェントは、Node.jsバージョン16.12.0以降およびエージェントのバージョン9.1.0以降を実行する、ESモジュールアプリケーションの実験的サポートを提供します。以降およびエージェントのバージョン9.1.0以降追加情報と手順については、ESモジュールのドキュメントを参照してください。
Express 4.6.0以上
Restify
Connect
Hapi
Koa 2.0.0以上(エージェントとともに外部モジュールがロードされます)
Fastify
Nest.js 8.0.0以降(nest start
コマンドを使用してアプリケーションを起動する場合は、スタートアップバイナリを変更してNew Relicエージェントnest start --exec 'node -r newrelic'
を読み込みます)
Next.js 12.0.9〜13.3.0(ミドルウェア インストゥルメンテーションには12.2.0以降が必要)
サポートされているフレームワークをデフォルトのルーターとともに使用している場合、Node.jsエージェントはフレームワークのルート名をそのまま読み取ることができます。ただし、フレームワークが提供する名前より固有な名前が必要な場合は、New RelicがNode.jsトランザクションネーミングAPI によって提供する1つ以上のツールを使用できます。
有効期限(EOL)の通知
2021年11月に、いくつかの機能のサポートを終了しました。これには、Node.jsエージェント用のHapi 19.2より前のOracle Driver PackageとHapiバージョンが含まれています。この移行の簡単な準備方法などの詳細については、サポートフォーラムの投稿を参照してください。
Node.jsエージェントはその他の機能と統合し、スタック全体でのオブザーバビリティを実現します。