agent PHP et Heroku

Heroku est une solution de plateforme en tant que service (PaaS) pour l'hébergement d'applications Web dans différents langages, dont PHP. Avec New Relic, vous pouvez étendre Heroku avec des métriques de APMet monitoring de navigateurs.

Préparez votre application

Avant d'installer l'agent PHP, assurez-vous que votre application Web PHP est installée et exécutée sous Heroku. Pour plus d'informations, consultez Premiers pas avec PHP sur Heroku.

Installer l'agent PHP

Après avoir déployé votre application PHP sur Heroku, installez notre agent PHP :

Dans quelques minutes, les données devraient commencer à apparaître sur votre page APM Summary . Si aucune donnée n'apparaît, consultez les procédures de vérification et de dépannage dans ce document.

Configurer l'agent sur Heroku

Heroku configure automatiquement les variables d'environnement par défaut pour votre application. Pour personnaliser vos paramètres, créez et téléchargez un fichier newrelic.ini sur Heroku :

1. Téléchargez une copie « propre » de newrelic.ini_.heroku [INI | 16 Ko].

2. Renommez le fichier de newrelic.ini_.heroku à newrelic.ini.

3. Copiez newrelic.ini dans le répertoire racine de votre référentiel de projet.

4. Personnalisez vos paramètres comme décrit dans Configuration de l'agent PHP.

   Prudence

   Ne modifiez pas newrelic.license, newrelic.loglevel ou newrelic.appname. Ces paramètres sont configurés par la ceinture à outils Heroku.

5. Validez les modifications de votre fichier de configuration dans votre référentiel et transmettez vos modifications à Heroku.

6. Demandez à Heroku d'utiliser votre fichier de configuration personnalisé via cette commande de la ceinture d'outils Heroku :

   bash

   Copier

   $
   heroku config:set NEW_RELIC_CONFIG_FILE=newrelic.ini

Nommez votre application

Pour garantir que les métriques de chaque application sont signalées séparément, attribuez à chaque application un nom descriptif. Le nom de votre application par défaut est PHP Application on Heroku.

New Relic utilise le nom de l'application pour agréger les données. Si vous ne modifiez pas ce nom, New Relic regroupera les données de chaque application PHP supplémentaire que vous installerez sous ce même nom.

1. Pour nommer votre application, exécutez cette commande Heroku toolbelt :

   bash

   Copier

   $
   heroku config:set NEW_RELIC_APP_NAME='YOUR_APP_NAME'

2. Pour vérifier le changement de nom de votre application, exécutez :

   bash

   Copier

   $
   heroku run env | grep NEW_RELIC_APP_NAME

Vérifiez que l’ prompt de confirmation renvoie le nouveau nom de l’application :

NEW_RELIC_APP_NAME=YOUR_APP_NAME

Vérifiez votre installation

Pour vérifier qu'Heroku a installé le module complémentaire New Relic, exécutez cette commande Heroku toolbelt :

$
heroku run env | grep NEW_RELIC

Cela générera une liste de variables d'environnement New Relic dans Heroku. L'agent utilise ces variables d'environnement pour déterminer à quel compte signaler les données. Vous devriez voir au moins les variables suivantes :

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

Vous pouvez également utiliser phpinfo pour vérifier que votre application est instrumentée.

dépannage l' agent sur Heroku

Pour dépanner agent l' PHP sur Heroku, examinez votre fichier de log, qui est stocké dans le Heroku du serveur Web log.

1. Pour afficher le log du serveur Web, exécutez cette commande Heroku toolbelt :

   bash

   Copier

   $
   heroku logs -t | tee newrelic.log

2. Utilisez le fichier de log pour résoudre le problème.

3. Si vous avez besoin d'aide supplémentaire, obtenez de l'aide sur support.newrelic.com.

L'agent PHP est par défaut au niveau de log warning. Le support New Relic peut également demander un log au niveau de log verbosedebug. Pour changer le niveau de log à verbosedebug, exécutez cette commande Heroku toolbelt :

$
heroku config:set NEW_RELIC_LOG_LEVEL=verbosedebug

$
heroku config:unset NEW_RELIC_LOG_LEVEL