Instalação do agente PHP: PHP não padrão (avançado)

Se você estiver usando uma instalação PHP não padrão, siga este procedimento para instalar corretamente o New Relic. Isso é comum em instâncias onde o instalador padrão não encontra sua instalação do PHP (por exemplo, se você tiver PHP autocompilado ou uma stack PHP autocontida).

Requisitos

Use a versão de linha de comando do PHP (php -i) ou observe a saída de phpinfo() para determinar:

• A versão da extensão PHP (20090626, 20100525, 20121212, 20131226, 20151012 ou 20160303)
• O diretório de instalação da extensão ou módulo
• Se a sua versão do PHP foi compilada ou não com suporte ZTS (Zend Thread Safety)

As opções ZTS aplicam-se apenas às versões 9.17 e anteriores do agente PHP. ZTS não está disponível para PHP versões 9.18 ou superior.

Use o script newrelic-install da linha de comando (recomendado)

1. Aponte New Relic para o diretório correto usando qualquer uma destas opções:

   Adicione sua localização PHP ao seu PATH

   O script de instalação precisa ser capaz de localizar sua linha de comando php ou php-config. Você pode adicionar o diretório que contém esses programas ao seu PATH atual.

   Defina o NR_INSTALL_PATH

   Esta pode ser uma lista de diretórios separados por dois pontos para instalação do PHP, além daqueles em seu PATH. Certifique-se de que esses diretórios contenham php ou php-config. Por exemplo:

   bash

   Copiar

   $
   NR_INSTALL_PATH=/u/php/5.3/bin; export NR_INSTALL_PATH
   $
   newrelic-install

   Defina o NR_INSTALL_PHPLIST

   Opcional: Use uma lista separada por dois pontos para definir os locais exatos (diretórios) onde pesquisar. Esta opção irá ignorar PATH e NR_INSTALL_PATH. Por exemplo:

   bash

   Copiar

   $
   NR_INSTALL_PHPLIST=/usr/local/bin:u/php/5.3/bin; export NR_INSTALL_PHPLIST
   $
   newrelic-install

2. Chame o script newrelic-install de seu diretório. Dependendo do seu servidor e dos seus caminhos, o script de instalação pode encontrar outras versões do PHP no seu sistema. Selecione sua versão específica na lista.

Para obter mais informações, consulte Script de instalação do PHP.

Instale o New Relic manualmente

Se não quiser usar o script de instalação, você poderá executar uma instalação totalmente manual. Certifique-se de coletar informações sobre a instalação do PHP. Você pode revisar e obter os valores apropriados do seu phpinfo(). Em seguida, crie e vincule ou copie os arquivos manualmente.

Obtenha o parâmetro de instalação do phpinfo()

Se esse processo não funcionar, você poderá obter as informações corretas do seu phpinfo() e transmitir as configurações apropriadas ao seu sistema como variáveis de ambiente.

Use estas informações para executar os comandos a seguir para instalar o módulo PHP. Certifique-se de ajustar os valores do exemplo às suas configurações reais.

$
NRBASEDIR=/usr/lib/newrelic-php5; export NRBASEDIR
$
    MODULEDIR=/usr/lib/php/modules; export MODULEDIR
$
    ARCH=x64; export ARCH
$
    PHPAPI=20090626; export PHPAPI
$
    PHPZTS="-zts"; export PHPZTS
$
    rm -f $MODULEDIR/newrelic.so
$
    ln -s $NRBASEDIR/agent/$ARCH/newrelic-${PHPAPI}${PHPZTS}.so \
>
      $MODULEDIR/newrelic.so

Configuração manual

A próxima etapa é a configuração.

1. Copie o $NRBASEDIR/scripts/newrelic.ini.template para o diretório de onde a instalação do PHP lê arquivos de configuração adicionais e renomeie-o como newrelic.ini.

   Para determinar o destino, observe a saída phpinfo() do item, chamada Scan this dir for additional .ini files. Se o diretório listado for (none), adicione as configurações deste arquivo aos arquivos de configuração PHP listados (geralmente php.ini).

2. Substitua a configuração da chave de licença no seu arquivo newrelic.ini pelo seu chave de licença. Altere também quaisquer outras sessões conforme necessário (por exemplo, newrelic.appname).

3. Copie $NRBASEDIR/daemon/newrelic-daemon.$architecture para /usr/bin/newrelic-daemon.

   Dependendo do seu sistema, $architecture será x86 ou x64.

4. Reinicie seu despachante/servidor web.

5. Verifique se seu site está funcionando corretamente. Se não estiver, remova newrelic.ini ou o newrelic.so que você criou e reinicie seu despachante/servidor web novamente para restaurar a operação antiga.

6. Examine os arquivos de log do servidor web/despachante (não newrelic) para ajudar a determinar o problema. Se ainda precisar de ajuda, obtenha suporte em support.newrelic.com.

Verifique a instalação

Verifique se o agente está instalado após a reinicialização, investigando a página phpinfo() para uma seção newrelic . Se parecer que o agente foi instalado com sucesso, verifique seu sistema para verificar se dois processos newrelic-daemon estão em execução:

• Para sistemas baseados em RedHat:

  bash

  Copiar

  $
  ps -aef | grep newrelic-daemon

• Para sistemas baseados em Debian:

  bash

  Copiar

  $
  ps aux | grep newrelic-daemon

Gere algum tráfego em seu aplicativo e aguarde de três a cinco minutos para que os resultados cheguem em sua página APM Summary .