Agente PHP y Heroku

Heroku es una solución de plataforma como servicio (PaaS) para alojar aplicaciones web en varios idiomas, incluido PHP. Con New Relic, puedes extender Heroku con métrica de APMy monitoreo de browser.

Prepara tu solicitud

Antes de instalar el agente PHP, asegúrese de que su aplicación web PHP esté instalada y ejecutándose en Heroku. Para obtener más información, consulte Introducción a PHP en Heroku.

Instalar el agente PHP

Después de implementar su aplicación PHP en Heroku, instale nuestro agente PHP:

En unos minutos, los datos deberían empezar a aparecer en su página APM Summary . Si no aparecen datos, consulte los procedimientos de verificación y resolución de problemas en este documento.

Configurar el agente en Heroku

Heroku configura automáticamente las variables de entorno predeterminadas para su aplicación. Para personalizar su configuración, cree y cargue un archivo newrelic.ini en Heroku:

1. Descargue una copia "limpia" de newrelic.ini_.heroku [INI | 16KB].

2. Cambie el nombre del archivo de newrelic.ini_.heroku a newrelic.ini.

3. Copie newrelic.ini al directorio raíz del repositorio de su proyecto.

4. Personalice su configuración como se describe en Configuración del agente PHP.

   Advertencia

   No cambie newrelic.license, newrelic.loglevel o newrelic.appname. Estas configuraciones están configuradas por el cinturón de herramientas Heroku.

5. Confirme los cambios de su archivo de configuración en su repositorio y envíe sus cambios a Heroku.

6. Indique a Heroku que use su archivo de configuración personalizado a través de este comando del cinturón de herramientas de Heroku:

   bash

   Copia

   $
   heroku config:set NEW_RELIC_CONFIG_FILE=newrelic.ini

Nombra tu aplicación

Para garantizar que las métricas de cada aplicación se informen por separado, asigne a cada aplicación un nombre descriptivo. El nombre de su aplicación por defecto es PHP Application on Heroku.

New Relic usa el nombre de la aplicación para agregar datos. Si no cambia este nombre, New Relic agregará los datos de cada aplicación PHP adicional que instale con este mismo nombre.

1. Para nombrar su aplicación, ejecute este comando del cinturón de herramientas de Heroku:

   bash

   Copia

   $
   heroku config:set NEW_RELIC_APP_NAME='YOUR_APP_NAME'

2. Para verificar el cambio de nombre de su aplicación, ejecute:

   bash

   Copia

   $
   heroku run env | grep NEW_RELIC_APP_NAME

Verifique que el símbolo de confirmación devuelva el nuevo nombre de la aplicación:

NEW_RELIC_APP_NAME=YOUR_APP_NAME

Verifica tu instalación

Para verificar que Heroku haya instalado el complemento New Relic, ejecute este comando del cinturón de herramientas de Heroku:

$
heroku run env | grep NEW_RELIC

Esto generará una lista de variables de entorno de New Relic en Heroku. El agente utiliza estas variables de entorno para determinar a qué cuenta informar los datos. Deberías ver al menos las siguientes variables:

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

También puedes usar phpinfo para verificar que tu aplicación se esté instrumentando.

Resolución de problemas el agente en Heroku

Para solucionar problemas del agente PHP en Heroku, examine su archivo de registro, que está almacenado en el log del servidor web de Heroku.

1. Para ver el log del servidor web, ejecute este comando del cinturón de herramientas de Heroku:

   bash

   Copia

   $
   heroku logs -t | tee newrelic.log

2. Utilice el archivo de registro para solucionar el problema.

3. Si necesita más ayuda, obtenga asistencia en support.newrelic.com.

El agente PHP tiene por defecto el nivel de registros warning . El soporte de New Relic también puede solicitar el registro en el nivel verbosedebug de registros. Para cambiar el nivel de registros a verbosedebug, ejecute este comando del cinturón de herramientas de Heroku:

$
heroku config:set NEW_RELIC_LOG_LEVEL=verbosedebug

$
heroku config:unset NEW_RELIC_LOG_LEVEL