• /
  • EnglishEspañol日本語한국어Português
  • EntrarComeçar agora

Esta tradução de máquina é fornecida para sua comodidade.

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

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).

Importante

Como parte do processo de instalação, altere o nome padrão do aplicativo para um nome significativo.

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:

  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.

phpinfo()

Notas

PHPAPI

Isso é rotulado como PHP Extension no cabeçalho phpinfo() .

ARCH

Isso pode ser determinado executando file /path/to/php.

  • Se você vir uma referência a ELF-32, então ARCH é x86.
  • Se você vir uma referência a ELF-64, então ARCH é x64.

MODULEDIR

Isso é rotulado como extension_dir na seção PHP Core.

PHPZTS

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

Para determinar se o ZTS está compilado, procure a configuração Thread Safety na parte superior da saída phpinfo() .

  • Se estiver desativado, PHPZTS estará vazio.
  • Se estiver ativado, então PHPZTS será a string -zts, que inclui um hífen à esquerda conforme observado.

NRBASEDIR

Este é o diretório base do diretório de instalação do agente New Relic; por exemplo, /usr/lib/newrelic-php5 ou o diretório onde você extraiu o arquivo tar para instalações tarball.

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.

bash
$
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 . 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
    $
    ps -aef | grep newrelic-daemon
  • Para sistemas baseados em Debian:

    bash
    $
    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 .

Este documento ajudou você na instalação?

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.