Node.jsエージェントは、npmリポジトリとGitHubで公開されています。
ヒント
Dockerを使用する場合は、DockerでのNode.jsエージェントのインストールをご覧ください。
前提条件
開始する前に、これらの要件を確認してください。
要件 | 詳細 |
|---|---|
New Relicアカウント | New Relicアカウントとが必要です。開始する前に準備しておいてください。 |
Node.jsのバージョン | サポート対象のNode.jsのバージョンについては、Node.jsエージェントの互換性と要件をご覧ください。 |
エージェントのインストール
アプリケーションディレクトリにエージェントパッケージをインストールしてください。
$npm install newrelic重要
Next.jsを使用している場合は、Next.jsハイブリッドエージェントインストゥルメンテーションガイドを参照してください。
次に、パッケージからデフォルトの設定ファイルをアプリケーションのルートにコピーします。
$cp node_modules/newrelic/newrelic.js .エージェントの設定
アプリケーションのルートにあるnewrelic.jsを開きます。本番環境に移行する前に、次の2つの設定を必ず変更してください。
license_keyにを設定してください。app_nameにわかりやすいアプリケーション名を設定してください。
exports.config = { app_name: ['Your Application Name'], license_key: 'YOUR_LICENSE_KEY', // ...}ファイルを編集する代わりに、環境変数を使用してこれらを設定することもできます。
$NEW_RELIC_APP_NAME="Your Application Name"$NEW_RELIC_LICENSE_KEY="YOUR_LICENSE_KEY"エージェントを起動する
起動コマンドに-r newrelicを追加して、他のrequireステートメントの前にエージェントをロードします。
$node -r newrelic ./your-app.jsアプリケーションがESMを使用している場合は、--import newrelic/esm-loader.mjsオプションを追加します。
$node --import newrelic/esm-loader.mjs -r newrelic ./your-app.jsNext.jsアプリケーションの場合は、NODE_OPTIONS='-r newrelic' next start経由でエージェントを読み込みます。
Nest.jsでnest startコマンドを使用してアプリケーションを起動する場合は、起動バイナリを「nest start --exec 'node -r newrelic'」と変更してNew Relicエージェントを読み込みます。Nest.jsアプリケーションの例はこちら。
データが送信されていることを確認する
エージェントのバージョンが14.9.0以上の場合は、このコマンドを実行して設定を検証できます。
$npx newrelic validate-config --config-file ./newrelic.jsアプリケーションに少なくとも2つのリクエストを送信します。
2~3分待ってから、one.newrelic.com > APMを開き、アプリケーション名で検索します。
ヒント
アプリケーションが表示されない場合は、Node.jsインストレーションのトラブルシューティングをご覧ください。
関連記事
- Node.jsエージェントの互換性と要件 — サポート対象のNode.jsバージョンとフレームワーク。
- Node.jsエージェントの設定 — 利用可能なすべての設定。
- Dockerにインストール — コンテナ固有のインストレーション手順。
- Node.jsエージェントの更新 — 新しいバージョンへのアップグレード方法。