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 エージェントパッケージをダウンロードし、 newrelic-install スクリプトを install_daemon 引数を指定して実行します。
2. --address と --watchdog-foreground の引数を使って、デーモンを起動します。

--address 引数は、デーモンが接続を受け付けるポートを設定します。 --watchdog-foreground 引数は、デーモンがフォアグラウンドで実行されるようにします。

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

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

1. コンテナ内にPHPがインストールされていることを確認します。例えば、 php:7.1 のような公開されたDockerイメージを使用します。
2. エージェントをインストールするには、New Relic の tar ファイルダウンロードサイト から PHP エージェントパッケージをダウンロードし、 newrelic-install スクリプトを 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 エージェントパッケージをダウンロードし、 newrelic-install スクリプトを 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