Dockerなどのコンテナ環境PHPエージェントのインストール

PHP エージェントを Docker コンテナまたは他のコンテナにインストールして、1 つ以上の PHP アプリケーションを監視できます。これは、 PHP エージェントの要件を満たすコンテナでサポートされています。

コンテナオプション

PHP エージェントが動作するには、PHP エージェント (アプリケーションごとに 1 つ) と、1 つまたは複数のエージェントから送信されたデータを集約して New Relic に送信する デーモン という 2 つのコンポーネントが必要です。このため、コンテナ環境で PHP エージェントを有効にするには 2 つのオプションがあります。

• エージェントとデーモンを別々のコンテナにインストールします。 これは推奨されるセットアップです。
• エージェントとデーモンを同じコンテナにインストールします。 コンテナの数を減らしたい場合に便利かもしれません。

エージェントとデーモンを別々のコンテナにインストール

要件：

• PHPエージェントの要件を満たす
• PHPエージェントバージョン9.2以上

アプリケーションの例を見るには、 New Relic's Explorers Hub にアクセスしてください。短時間動作のアプリケーションコンテナを使用する場合は、 PHP エージェントのデーモン用に別のコンテナを使用することをお勧めします。

デーモン・コンテナの設定

Dockerを使用している場合は、 Docker Hub からデーモンイメージを引き出すことができます。

1. 次のコマンドを実行します： docker pull newrelic/php-daemon 。
2. イメージをカスタマイズするには、 Docker Hub の手順に従ってください。

また、独自のデーモンイメージを構築することもできます。

1. デーモンをインストールするには、New RelicのtarファイルダウンロードサイトからPHPエージェントパッケージをダウンロードし、 install_daemon引数を指定してnewrelic-installスクリプトを実行します。
2. --addressおよび--watchdog-foreground引数を使用してデーモンを起動します。

--address引数は、デーモンが接続を受け入れるためのポートを設定します。 --watchdog-foreground引数は、デーモンがフォアグラウンドで実行されることを保証します。

PHP エージェントコンテナの設定

PHPのエージェントコンテナをDocker用に設定するには、以下の手順に従います。

1. コンテナでPHPインストールが利用可能であることを確認してください。たとえば、 php:7.1のような公開されたDockerイメージを使用します。
2. エージェントをインストールするには、New RelicのtarファイルダウンロードサイトからPHPエージェントパッケージをダウンロードし、 install引数を指定してnewrelic-installスクリプトを実行します。
3. newrelic.iniファイルで、アプリケーション名とライセンスキーをnewrelic.appnameおよびnewrelic.licenseエントリで設定します。
4. newrelic.iniファイルでnewrelic.daemon.addressオプションを設定して、エージェントをデーモンにポイントします。このオプションの値がHOST:PORTであることを確認してください。ここで、 HOSTはデーモンが実行されているホストの名前またはIPアドレスであり、 PORTはデーモンがリッスンしているポート番号です。

エージェントとデーモンを同じコンテナにインストール

PHPのエージェントとデーモンを同じDockerコンテナにセットアップするには、次のようにします。

1. コンテナでPHPインストールが利用可能であることを確認してください。例： php:7.1のような公開されたDockerイメージを使用できます。
2. エージェントをインストールするには、New RelicのtarファイルダウンロードサイトからPHPエージェントパッケージをダウンロードし、 install引数を指定してnewrelic-installスクリプトを実行します。
3. newrelic.iniファイルのnewrelic.licenseおよびnewrelic.appnameエントリを介してアプリケーション名とライセンスキーを設定します。

FROM php:7.1

RUN \
  curl -L PHP_AGENT_URL | tar -C /tmp -zx && \
  export NR_INSTALL_USE_CP_NOT_LN=1 && \
  export NR_INSTALL_SILENT=1 && \
  /tmp/newrelic-php5-*/newrelic-install install && \
  rm -rf /tmp/newrelic-php5-* /tmp/nrinstall* && \
  sed -i \
      -e 's/"REPLACE_WITH_REAL_KEY"/"YOUR_LICENSE_KEY"/' \
      -e 's/newrelic.appname = "PHP Application"/newrelic.appname = "YOUR_APPLICATION_NAME"/' \
      -e 's/;newrelic.daemon.app_connect_timeout =.*/newrelic.daemon.app_connect_timeout=15s/' \
      -e 's/;newrelic.daemon.start_timeout =.*/newrelic.daemon.start_timeout=5s/' \
      /usr/local/etc/php/conf.d/newrelic.ini