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

Node.js エージェントを使用して、Docker コンテナーで Node.js アプリケーションのデプロイを計装できます。 このドキュメントでは、 New Relicでインストレーションした Dockerized Node.js アプリケーションを構築、構成、デプロイする方法について説明します。

Node.js エージェント インストレーションに関する一般的なヘルプが必要な場合は、メイン インストレーション手順を参照してください。

コンテナの計測

設定をいくつか変更し、 New Relic環境変数を既存の Dockerfile に追加することで、Node.js エージェントを使用して Docker 化されたアプリを計装できます。

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

   "newrelic": "latest",

   コピー

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

2. node開始コマンドにエージェントを挿入して、アプリケーションを計装します。 コンテナの設定によっては、node コマンドが呼び出されたときに、Node.js -r / --requireフラグを使用してnewrelicモジュールを最初に含めるようにENTRYPOINT編集できる場合があります。 Dockerfile にこれらの開始コマンドのいずれかが含まれている場合は、次のように変更できます。

   • node YOUR_PROGRAM.jsをに変更します node -r newrelic YOUR_PROGRAM.js
   • ENTRYPOINT ['node', 'YOUR_PROGRAM.js']をに変更します ENTRYPOINT ['node', '-r', 'newrelic', 'YOUR_PROGRAM.js']
   • CMD ['node', 'YOUR_PROGRAM.js']をに変更します CMD ['node', '-r', 'newrelic', 'YOUR_PROGRAM.js']
   • npm startなどのプログラムを実行するための npm スクリプトがある場合は、 npm pkg set scripts.start="node -r newrelic your-program.js"を実行することでこのスクリプトをプログラムで変更できます。
   • プログラムの実行方法を制御できない場合は、エントリ ファイルの先頭にrequire('newrelic')を追加することで、プログラム内の他のモジュールの前にnewrelicモジュールをロードできます。

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オプションで起動することで他の設定オプションを設定できます。 以下のこともできます:

• 以下のスニペットのように、環境変数 ( NEW_RELIC_NAME_OF_FEATURE_FLAG_ENABLED ) を使用して機能フラグを有効にします。 NAME_OF_FEATURE_FLAG機能フラグの大文字の名前に置き換えます。

  bash

  コピー

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

• ENVディレクティブを使用して Dockerfile で構成オプションを設定します。

  ENV NEW_RELIC_NAME_OF_FEATURE_FLAG_ENABLED=true \
      NEW_RELIC_LOG=stdout
      # etc.

  コピー