Docker e outros ambientes de contêiner: instale o agente PHP

Você pode instalar o agente PHP em um contêiner Docker ou outro contêiner para monitor um ou mais aplicativos PHP. Isso é suportado para contêineres que atendam ao padrão de compatibilidade do agente e requisitos do PHP.

Opções de contêiner

O agente PHP requer dois componentes para funcionar: o agente PHP (um para cada aplicativo) e um daemon, que agrega os dados enviados de um ou mais agentes e os envia para a New Relic. Por isso, existem duas opções de habilitação do agente PHP para ambientes de contêiner:

• Instale agente e daemon em contêineres diferentes. Esta é a configuração recomendada.
• Instale o agente e o daemon no mesmo contêiner. Isto pode ser útil se você quiser reduzir o número de contêineres.

Instale agente e daemon em contêineres diferentes

A instalação do agente e daemon em diferentes contêineres é suportada no PHP agnet versões 9.2 e superiores.

Para ver um exemplo de aplicativo, acesse o Fórum de suporte da New Relic. Se você estiver usando contêineres de aplicativos de curta duração, recomendamos usar um contêiner separado para o daemon do agente PHP.

Configure o contêiner daemon

Se você usar Docker, poderá extrair nossa imagem do daemon do Docker Hub:

1. Execute este comando: docker pull newrelic/php-daemon.
2. Para personalizar a imagem, siga as etapas no Docker Hub.

Você também pode construir sua própria imagem do daemon:

1. Para instalar o daemon, baixe o pacote do agente PHP no site de download do arquivo tar da New Relic e execute o script newrelic-install com o argumento install_daemon .
2. Inicie o daemon usando os argumentos --address e --watchdog-foreground .

O argumento --address define uma porta para o daemon aceitar conexões. O argumento --watchdog-foreground garante que o daemon seja executado em primeiro plano.

Configure o contêiner do agente PHP

Para configurar o contêiner do agente PHP para Docker:

1. Certifique-se de que uma instalação do PHP esteja disponível no contêiner. Por exemplo, use uma imagem Docker publicada como php:7.1.

2. Para instalar o agente, faça download do pacote do agente PHP no site de download do arquivo tar da New Relic e execute o script newrelic-install com o argumento install .

3. No arquivo newrelic.ini , defina o nome do aplicativo e

   chave de licença

   com as entradas newrelic.appname e newrelic.license .

4. Aponte o agente para o daemon definindo a opção newrelic.daemon.address no arquivo newrelic.ini . Certifique-se de que o valor desta opção seja HOST:PORT, onde HOST é o nome ou endereço IP do host onde o daemon está sendo executado e PORT é o número da porta onde o daemon está escutando

Instale o agente e o daemon no mesmo contêiner

Para configurar o agente PHP e o daemon no mesmo contêiner Docker :

1. Certifique-se de que uma instalação do PHP esteja disponível no contêiner. Por exemplo: você pode usar uma imagem Docker publicada como php:7.1.

2. Para instalar o agente, faça download do pacote do agente PHP no site de download do arquivo tar da New Relic e execute o script newrelic-install com o argumento install .

3. Defina o nome do aplicativo e

   chave de licença

   por meio das entradas newrelic.license e newrelic.appname no arquivo newrelic.ini .

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