Nosso agente PHP auto-instrumenta seu código para que você possa iniciar o monitoramento do aplicativo. Estes são os procedimentos padrão para instalar nosso agente PHP no Ubuntu ou Debian na arquitetura x86_64. (Isso não é igual aos procedimentos do Ubuntu e do Debian para o agente de infraestrutura.) Para instalação na arquitetura aarch64, use o método de arquivo tar . Para outras situações, consulte os procedimentos do agente PHP para instalação não padrão do PHP.
Versões PHP
O nome do pacote do agente PHP da New Relic é newrelic-php5
. Embora o nome do pacote faça referência ao PHP 5, este pacote funciona para todas as versões suportadas do PHP.
Uso recomendado apt
Este é o método recomendado para instalação e manutenção do New Relic.
Importante
Execute os comandos neste procedimento como root.
Configure o repositório apt New Relic
A configuração do repositório apt do New Relic só é necessária uma vez por sistema. Para fazer isso, conclua estas duas tarefas:
Adicione
http://apt.newrelic.com/debian/
repositório apt asources.list
:bash$echo 'deb [signed-by=/usr/share/keyrings/download.newrelic.com-newrelic.gpg] http://apt.newrelic.com/debian/ newrelic non-free' | sudo tee /etc/apt/sources.list.d/newrelic.listEste comando adiciona
deb [signed-by=/usr/share/keyrings/download.newrelic.com-newrelic.gpg] http://apt.newrelic.com/debian/ newrelic non-free
a/etc/apt/sources.list.d/newrelic.list
. Ele cria o arquivo se ele não existir.Confie na chave GPG da New Relic:
bash$wget -O- https://download.newrelic.com/548C16BF.gpg | sudo gpg --dearmor -o /usr/share/keyrings/download.newrelic.com-newrelic.gpgEste comando instala a chave GPG do New Relic usada por
apt
para verificar assinaturas de pacotes no repositório apthttp://apt.newrelic.com/debian/
adicionado na etapa anterior.
Atualizar a lista de pacotes locais
Execute o seguinte comando como root:
$sudo apt-get update
Instale o agente PHP
Execute o seguinte comando para instalar diretamente do repositório New Relic:
$sudo apt-get install newrelic-php5
Instalação fora do padrão: Conclua a instalação manualmente
Se você não estiver usando os pacotes PHP padrão do Ubuntu ou Debian, o pacote newrelic-php5
poderá não conseguir configurar o PHP automaticamente. Você pode ver este erro:
Please run newrelic-install as root to complete installation.
Nesse caso, execute o seguinte comando:
$sudo newrelic-install install
Configure o nome do seu aplicativo e a chave de licença do New Relic
O processo de instalação solicita o nome do aplicativo e a chave de licença. Seu aparece na seção de informações da conta de Account settings. Para instalação headless, você também pode pré-configurar sua chave de licença e nome do aplicativo usando debconf
.
Reinicie seu servidor web ou FastCGI Process Manager (FPM)
Gere tráfego para seu aplicativo e aguarde alguns minutos para que seu aplicativo envie dados para o New Relic. Em seguida, verifique o desempenho do seu aplicativo na interface do New Relic.
Opcional: instalação autônoma
Para executar uma instalação autônoma, você pode usar o modo não interativo. Inclua o sinalizador -y
para responder automaticamente yes
a qualquer prompt durante a instalação do pacote. Por exemplo:
$DEBIAN_FRONTEND=noninteractive apt-get -y install newrelic-php5
Manual: Usar dpkg
Importante
Se você usar dpkg
, deverá instalar as atualizações manualmente. É por isso que a New Relic recomenda o métodoapt
para instalação e manutenção. Execute os comandos neste procedimento como root.
Para instalar o agente PHP manualmente usando dpkg
:
Copie o URL para o download do pacote
Copie o URL completo dos pacotes newrelic-daemon
, newrelic-php5-common
e newrelic-php5
mais recentes do repositório da New Relic
Baixe o pacote
Execute o seguinte comando wget
, substituindo https://LINK_TO_PACKAGE
pelo URL completo do pacote:
$wget -L https://LINK_TO_PACKAGE
Instale o agente PHP
Execute o comando de instalação como root, substituindo X.X.X.X
pela versão atual:
$dpkg -i newrelic-php5-common_X.X.X.X_all.deb newrelic-daemon_X.X.X.X_amd64.deb newrelic-php5_X.X.X.X_amd64.deb
Configure o nome do seu aplicativo e a chave de licença do New Relic
O processo de instalação solicita o nome do aplicativo e a chave de licença. Seu aparece na seção de informações da conta de Account settings. Para instalação headless, você também pode pré-configurar sua chave de licença e nome do aplicativo usando debconf
.
Reinicie seu servidor web ou FastCGI Process Manager (FPM)
Gere tráfego para seu aplicativo e aguarde alguns minutos para que seu aplicativo envie dados para o New Relic. Em seguida, verifique o desempenho do seu aplicativo na interface do New Relic.
Este documento ajudou você na instalação?
Headless: pré-configure a chave de licença e o nome do aplicativo
Para instalação headless, você precisa seguir as etapas para pré-configurar seu e o nome do aplicativo. Você deve usar os pacotes php5 padrão fornecidos pela sua distribuição. Para pré-configurar a chave de licença e o nome do aplicativo, defina valores em seu banco de dados debconf
usando debconf-set-selections
.
Importante
Essas configurações serão ignoradas se você não estiver usando um pacote PHP. Você será solicitado a executar newrelic-install
.
Essas chaves estão localizadas no pacote newrelic-php5
:
Nome | Tipo |
---|---|
O nome do seu aplicativo. Esta string define | corda |
Seu . Esta string define | corda |
Por exemplo, você pode executar estes comandos para pré-configurar o nome do seu aplicativo e a chave de licença:
$echo newrelic-php5 newrelic-php5/application-name string "My App Name" | debconf-set-selections$echo newrelic-php5 newrelic-php5/license-key string "YOUR_LICENSE_KEY" | debconf-set-selections