• /
  • EnglishEspañolFrançais日本語한국어Português
  • ログイン今すぐ開始

Node.jsエージェントのインストール

|View as Markdown (English)

Node.jsエージェントは、npmリポジトリとGitHubで公開されています。

ヒント

Dockerを使用する場合は、DockerでのNode.jsエージェントのインストールをご覧ください。

前提条件

開始する前に、これらの要件を確認してください。

要件

詳細

New Relicアカウント

New Relicアカウントとが必要です。開始する前に準備しておいてください。

Node.jsのバージョン

サポート対象のNode.jsのバージョンについては、Node.jsエージェントの互換性と要件をご覧ください。

エージェントのインストール

アプリケーションディレクトリにエージェントパッケージをインストールしてください。

bash
$
npm install newrelic

重要

Next.jsを使用している場合は、Next.jsハイブリッドエージェントインストゥルメンテーションガイドを参照してください。

次に、パッケージからデフォルトの設定ファイルをアプリケーションのルートにコピーします。

bash
$
cp node_modules/newrelic/newrelic.js .

エージェントの設定

アプリケーションのルートにあるnewrelic.jsを開きます。本番環境に移行する前に、次の2つの設定を必ず変更してください。

  1. license_keyにを設定してください。
  2. app_nameにわかりやすいアプリケーション名を設定してください。
exports.config = {
app_name: ['Your Application Name'],
license_key: 'YOUR_LICENSE_KEY',
// ...
}

ファイルを編集する代わりに、環境変数を使用してこれらを設定することもできます。

bash
$
NEW_RELIC_APP_NAME="Your Application Name"
$
NEW_RELIC_LICENSE_KEY="YOUR_LICENSE_KEY"

エージェントを起動する

起動コマンドに-r newrelicを追加して、他のrequireステートメントの前にエージェントをロードします。

bash
$
node -r newrelic ./your-app.js

アプリケーションがESMを使用している場合は、--import newrelic/esm-loader.mjsオプションを追加します。

bash
$
node --import newrelic/esm-loader.mjs -r newrelic ./your-app.js

Next.jsアプリケーションの場合は、NODE_OPTIONS='-r newrelic' next start経由でエージェントを読み込みます。

Nest.jsでnest startコマンドを使用してアプリケーションを起動する場合は、起動バイナリを「nest start --exec 'node -r newrelic'」と変更してNew Relicエージェントを読み込みます。Nest.jsアプリケーションの例はこちら。

データが送信されていることを確認する

エージェントのバージョンが14.9.0以上の場合は、このコマンドを実行して設定を検証できます。

bash
$
npx newrelic validate-config --config-file ./newrelic.js
  1. アプリケーションに少なくとも2つのリクエストを送信します。

  2. 2~3分待ってから、one.newrelic.com > APMを開き、アプリケーション名で検索します。

ヒント

アプリケーションが表示されない場合は、Node.jsインストレーションのトラブルシューティングをご覧ください。

Copyright © 2026 New Relic株式会社。

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