Agente PHP e Heroku

Heroku é uma solução de plataforma como serviço (PaaS) para hospedagem de aplicativos web em diversas linguagens, incluindo PHP. Com o New Relic, você pode estender o Heroku com métricas de APMe monitoramento de browser.

Prepare seu aplicativo

Antes de instalar o agente PHP, certifique-se de que seu aplicativo web PHP esteja instalado e em execução no Heroku. Para obter mais informações, consulte Introdução ao PHP no Heroku.

Instale o agente PHP

Após implantar seu aplicativo PHP no Heroku, instale nosso agente PHP:

Dentro de alguns minutos, os dados deverão começar a aparecer na sua página Summary do APM. Caso não apareça nenhum dado, consulte os procedimentos de verificação e resolução de problemas neste documento.

Configure o agente no Heroku

O Heroku configura automaticamente variáveis de ambiente padrão para seu aplicativo. Para personalizar suas configurações, crie e faça upload de um arquivo newrelic.ini para o Heroku:

1. Baixe uma cópia "limpa" de newrelic.ini_.heroku [INI | 16KB].

2. Renomeie o arquivo de newrelic.ini_.heroku para newrelic.ini.

3. Copie newrelic.ini para o diretório raiz do repositório do seu projeto.

4. Personalize suas configurações conforme descrito em Configuração do agente PHP.

   Cuidado

   Não altere newrelic.license, newrelic.loglevel ou newrelic.appname. Essas configurações são definidas pelo cinto de ferramentas Heroku.

5. Envie as alterações do arquivo de configuração para o seu repositório e envie-as para o Heroku.

6. Instrua o Heroku a usar seu arquivo de configuração personalizado por meio deste comando do Toolbelt do Heroku:

   bash

   Copiar

   $
   heroku config:set NEW_RELIC_CONFIG_FILE=newrelic.ini

Nomeie seu aplicativo

Para garantir que as métricas de cada aplicativo sejam relatadas separadamente, atribua um nome descritivo a cada aplicativo. O nome do seu aplicativo é padronizado como PHP Application on Heroku.

New Relic usa o nome do aplicativo para agregar dados. Se você não alterar esse nome, o New Relic agregará os dados de cada aplicativo PHP adicional que você instalar com o mesmo nome.

1. Para nomear seu aplicativo, execute este comando do cinto de ferramentas Heroku:

   bash

   Copiar

   $
   heroku config:set NEW_RELIC_APP_NAME='YOUR_APP_NAME'

2. Para verificar a mudança de nome do seu aplicativo, execute:

   bash

   Copiar

   $
   heroku run env | grep NEW_RELIC_APP_NAME

Verifique se o prompt de confirmação retorna o novo nome do aplicativo:

NEW_RELIC_APP_NAME=YOUR_APP_NAME

Verifique sua instalação

Para verificar se o Heroku instalou o complemento New Relic, execute este comando do cinto de ferramentas do Heroku:

$
heroku run env | grep NEW_RELIC

Isso irá gerar uma lista de variáveis de ambiente New Relic no Heroku. O agente usa essas variáveis de ambiente para determinar para qual conta os dados serão relatados. Você deverá ver pelo menos as seguintes variáveis:

NEW_RELIC_LICENSE_KEY="YOUR_LICENSE_KEY"
NEW_RELIC_LOG_LEVEL="warning"
NEW_RELIC_APP_NAME="YOUR_APP_NAME"

Você também pode usar phpinfo para verificar se seu aplicativo está sendo instrumentado.

Resolução de problemas o agente no Heroku

Para solucionar problemas do agente PHP no Heroku, examine seu arquivo de log, que está armazenado no log do servidor web Heroku.

1. Para visualizar o log do servidor web, execute este comando do Heroku Toolbelt:

   bash

   Copiar

   $
   heroku logs -t | tee newrelic.log

2. Use o arquivo de log para solucionar o problema.

3. Se precisar de mais assistência, obtenha suporte em support.newrelic.com.

O agente PHP usa como padrão o nível de log warning . O suporte da New Relic também pode solicitar log no nível de log verbosedebug . Para alterar o nível de log para verbosedebug, execute este comando do Toolbelt do Heroku:

$
heroku config:set NEW_RELIC_LOG_LEVEL=verbosedebug

$
heroku config:unset NEW_RELIC_LOG_LEVEL