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

当社の Node.js エージェントを使用して、Docker コンテナにデプロイされた Node.js アプリケーションをインストルメントすることができます。このドキュメントでは、New Relic でインストルメントされた Docker 化された Node.js アプリケーションを構築、設定、デプロイする方法を説明します。

コンテナの計測

既存のDockerfileを少し追加するだけで、弊社のNode.jsエージェントで使用することができます。環境変数を設定した新しいDockerイメージを実行して、エージェントを設定します。

1. newrelicをpackage.jsonに追加します。

   "newrelic": "latest",

   コピー

   特定のバージョンをインストールするか、 package.json形式で提供されるその他のオプションを使用してください。過去のエージェント バージョンについては、Node.js エージェントのリリース ノートを確認してください。

2. コンテナの設定方法に応じて、 node -r newrelic YOUR_PROGRAM.jsを実行して、最初に Node.js -r/--require フラグを使用して newrelic モジュールを含めるように ENTRYPOINT を編集できます。プログラムの実行方法を制御できない場合は、 require('newrelic')を追加することで、プログラム内の他のモジュールよりも前に newrelic モジュールをロードできます。

   Next.js の場合は、 newrelicの代わりに @newrelic/next を使用します。

   ヒント

   npm startなどのプログラムを実行するための npm スクリプトがある場合は、 npm pkg set scripts.start="node -r newrelic your-program.js"を実行することでこのスクリプトをプログラムで変更できます。

   重要

   Node.js エージェントがv7.2.0より古い場合は、環境変数NEW_RELIC_NO_CONFIG_FILE=trueを Dockerfile に追加して、構成ファイルなしでエージェントを実行できるようにする必要があります。構成設定と優先順位の詳細については、ここを参照してください。

3. 通常の方法でDockerイメージを構築します。

4. エージェントを有効にして Docker アプリを実行するには、 ライセンスキーアプリ名を 環境変数としてdocker runコマンドに追加します。

   bash

   コピー

   $
   docker run -e NEW_RELIC_LICENSE_KEY=YOUR_LICENSE_KEY \
   >
          -e NEW_RELIC_APP_NAME="YOUR_APP_NAME" \
   >
          YOUR_IMAGE_NAME:latest

その他の設定オプション

アプリケーション名またはライセンス キーの設定に加えて、 -eオプションを使用してコンテナを開始することにより、他の構成オプションを設定できます。たとえば、 分散トレースを有効にするには、次を使用します。

$
docker run -e NEW_RELIC_LICENSE_KEY=YOUR_LICENSE_KEY \
>
        -e NEW_RELIC_APP_NAME="YOUR_APP_NAME" \
>
        -e NEW_RELIC_DISTRIBUTED_TRACING_ENABLED=true \
>
        YOUR_IMAGE_NAME:latest

ENVディレクティブを使用して、Dockerfile で構成オプションを設定することもできます。

ENV NEW_RELIC_DISTRIBUTED_TRACING_ENABLED=true \
    NEW_RELIC_LOG=stdout
    # etc.