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 a partir do agente PHP versão 9.2.0 do New Relic .

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 oficial" do Docker para php como php:fpm ou php:cli.
2. Para instalar o agente, baixe o pacote do agente PHP no site de download 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çacom 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, use uma "imagem oficial" do Docker para php como php:fpm ou php:cli.
2. Para instalar o agente, baixe o pacote do agente PHP no site de download da New Relic e execute o script newrelic-install com o argumento install .
3. Defina o nome do aplicativo e chave de licençapor meio das entradas newrelic.license e newrelic.appname no arquivo newrelic.ini .

FROM php:fpm

# Install the latest New Relic PHP Agent
RUN \
    cd /tmp \
    # Discover the latest released version:
    && export NEW_RELIC_AGENT_VERSION=$(curl -s https://download.newrelic.com/php_agent/release/ | grep -o '[1-9][0-9]\?\(\.[0-9]\+\)\{3\}' | head -n1) \
    # Discover libc provider
    && export NR_INSTALL_PLATFORM=$(ldd --version 2>&1 | grep -q musl && echo "linux-musl" || echo "linux") \
    # Download the discovered version:
    && curl -o newrelic-php-agent.tar.gz https://download.newrelic.com/php_agent/release/newrelic-php5-${NEW_RELIC_AGENT_VERSION}-${NR_INSTALL_PLATFORM}.tar.gz \
    # Install the downloaded agent:
    && tar xzf newrelic-php-agent.tar.gz \
    && NR_INSTALL_USE_CP_NOT_LN=1 NR_INSTALL_SILENT=0 ./*/newrelic-install install \
    # Configure the agent to use license key from NEW_RELIC_LICENSE_KEY env var:
    && sed -ie 's/[ ;]*newrelic.license[[:space:]]=.*/newrelic.license=${NEW_RELIC_LICENSE_KEY}/' $(php-config --ini-dir)/newrelic.ini \
    # Configure the agent to use app name from NEW_RELIC_APP_NAME env var:
    && sed -ie 's/[ ;]*newrelic.appname[[:space:]]=.*/newrelic.appname=${NEW_RELIC_APP_NAME}/' $(php-config --ini-dir)/newrelic.ini \
    # Cleanup temporary files:
    && rm newrelic-php-agent.tar.gz && rm -rf newrelic-php5-*-linux