New Relic の Node.js エージェントは、Node.js の仮想マシン (V8) から主要な メトリクスのタイムスライスデータ を収集します。これらのメトリクスは、Node.js の VM の動作を把握し、アプリケーションのパフォーマンスを向上させるのに役立ちます。また、エージェントは CPU メトリクスを収集しますが、これはしばしばガベージコレクション（GC）メトリクスと一緒に分析されます。
何が必要
New Relic では、ガベージ コレクション、メモリ、CPU に関連する Node.js VM メトリクス タイムスライス データを収集するために、追加のネイティブ モジュールが必要です。Node.js v6.1.0 以降New Relic Node.js エージェントがprocess.cpuUsage()で収集するため、CPU メトリックを収集するためにネイティブ モジュールは必要ありません。
ネイティブモジュールを使用できるのは
- New Relic Node.js バージョン 1.35.1 以上
- Node.js v4 以降
- npm v2.0.0 以降
展開プラットフォームでネイティブ モジュールをコンパイルするには、 node-gypパッケージの手順に従います。ネイティブ Node.js モジュールをインストールするための前提条件は次のとおりです。
プラットフォーム | 前提条件 |
|---|---|
Unix/Linux | Python（v2.7推奨、v3.x.xは未サポート）、make、C/C++コンパイラ（GCCなど） |
マックOS | Python（v2.7推奨、v3.x.xは未サポート）、Xcode |
ウィンドウズ | Python（v2.7推奨、v3.x.xは未サポート）、Visual C++ビルド環境 |
当社のNode.jsエージェントのインストールに問題がある場合は、 installation troubleshooting の手順に従ってください。
ネイティブモジュールのインストール
New Relic Node.js エージェントの v2.0.0 以降、ネイティブモジュールはオプションの依存関係となり、自動的にインストールされるようになりました。
インストール中、ネイティブ モジュールは最初にターゲット マシン上のソースからビルドを試みます。ビルドが失敗した場合、Node.js はスタック トレースをコンソールに出力しますが、通常は無視できます。サポートされているバージョンの Node を実行している Linux 環境の場合、エージェントはビルド済みバイナリのダウンロードとインストールを試みます。
エージェントがビルド済みのバイナリをダウンロードしてインストールしようとするのを防ぐことができます。代わりに、ネイティブ モジュールのビルドのみを試みます。これを行うには、npm または Yarn を使用してインストールする前に、 NR_NATIVE_METRICS_NO_DOWNLOAD 環境変数を true に設定します。
$export NR_NATIVE_METRICS_NO_DOWNLOAD=true$npm install @newrelic/native-metrics$yarn add @newrelic/native-metricsまたは、npm で機能する --no-download フラグを使用します。
$npm install @newrelic/native-metrics --no-downloadNR_NATIVE_METRICS_NO_DOWNLOAD=trueまたは--no-downloadフラグが設定された状態でビルドが失敗した場合、オプションのネイティブモジュールはインストールされません。
両方の環境変数が設定されている場合、 NR_NATIVE_METRICS_NO_BUILDはNR_NATIVE_METRICS_NO_DOWNLOADをオーバーライドします。
古いバージョンを使用している場合は、 最新のエージェントバージョンにアップグレードするか、ネイティブモジュールを手動でインストールしてください。
Windowsユーザー： 以下のコマンドを実行してください。
bash$npm install --global windows-build-toolsこのステップがうまくいかない場合は、GitHub の node-gyp モジュールのオプション2に従って、手動でのインストール手順を確認してください。
[* ネイティブ・メトリクス・モジュールをインストールするには、以下のいずれかの方法を使用します。
npm install @newrelic/native-metrics --saveコマンドを実行します。また
モジュールをアプリの
package.jsonファイルに追加します。* アプリを再起動します。](https://github.com/nodejs/node-gyp#option-2)
$npm install newrelic --no-optional$yarn add newrelic --ignore-optionalビルド済みバイナリー [#prebuilt-binaries]
$export NR_NATIVE_METRICS_NO_BUILD=true$export NR_NATIVE_METRICS_DOWNLOAD_HOST=http://your-internal-cache/$export NR_NATIVE_METRICS_REMOTE_PATH=path/to/download/folder/$npm install @newrelic/native-metrics$yarn add @newrelic/native-metricsNode.jsのVMデータを見る [#view-data]
Node.js VM データを含む厳選されたチャートを表示するには、 ****one.newrelic.com > All capabilities > APM & services > (アプリを選択) > Node VMsに移動します。詳細については、 「Node.js VM 統計ページ」を参照してください。
データはメトリクスとイベントでも利用できます。
測定内容
ヒント
Node.js のすべてのバージョンですべてのデータを収集できるわけではありません。一般に、Node.js の最新の LTS バージョンを使用している場合、最も完全なデータを取得できます。