Notre agent PHP auto-instrumente votre code afin que vous puissiez commencer monitoring l'application. Voici les procédures standard pour installer notre agent PHP sur Ubuntu ou Debian sur une architecture x86_64. (Ce n'est pas la même chose que les procédures Ubuntu et Debian pour l' agent d'infrastructure.) Pour l'installation sur l'architecture aarch64, veuillez utiliser la méthode du fichier tar . Pour les autres situations, consultez les procédures de l'agent PHP pour les installations PHP non standard.
Versions PHP
Le nom du package pour l'agent PHP de New Relic est newrelic-php5
. Bien que le nom du package fasse référence à PHP 5, ce package fonctionne pour toutes les versions PHP prises en charge.
Recommandé : Utiliser apt
Il s'agit de la méthode recommandée pour l'installation et la maintenance de New Relic.
Important
Exécutez les commandes de cette procédure en tant que root.
Configurer le référentiel apt de New Relic
La configuration du référentiel apt de New Relic n'est requise qu'une seule fois par système. Pour ce faire, effectuez ces deux tâches :
Ajoutez le référentiel apt
http://apt.newrelic.com/debian/
àsources.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.listCette commande ajoute
deb [signed-by=/usr/share/keyrings/download.newrelic.com-newrelic.gpg] http://apt.newrelic.com/debian/ newrelic non-free
à/etc/apt/sources.list.d/newrelic.list
. Il crée le fichier s'il n'existe pas.Faites confiance à la clé GPG de New Relic :
bash$wget -O- https://download.newrelic.com/548C16BF.gpg | sudo gpg --dearmor -o /usr/share/keyrings/download.newrelic.com-newrelic.gpgCette commande installe la clé GPG de New Relic utilisée par
apt
pour vérifier les signatures du package danshttp://apt.newrelic.com/debian/
apt référentiel ajouté à l'étape précédente.
Mettre à jour la liste package locaux
Exécutez la commande suivante en tant que root :
$sudo apt-get update
Installer l'agent PHP
Exécutez la commande suivante pour installer directement depuis le référentiel New Relic :
$sudo apt-get install newrelic-php5
Installation non standard : terminer installation manuellement
Si vous n'utilisez pas le package PHP par défaut d'Ubuntu ou de Debian, le package newrelic-php5
peut ne pas être en mesure de configurer PHP automatiquement. Vous pouvez voir cette erreur :
Please run newrelic-install as root to complete installation.
Si c'est le cas, exécutez la commande suivante :
$sudo newrelic-install install
Configurez le nom de votre application et la clé de licence New Relic
Le processus installation vous demande le nom de votre application et votre clé de licence. Votre apparaît dans la section des informations de compte de Account settings. Pour une installation sans tête, vous pouvez également préconfigurer votre clé de licence et le nom de application en utilisant debconf
.
Redémarrez votre serveur Web ou FastCGI Process Manager (FPM)
Générez du trafic pour votre application et attendez quelques minutes que votre application envoie des données à New Relic. Ensuite, vérifiez les performances de votre application dans New Relic UI l' .
Optionnel : installationsans surveillance
Pour exécuter une installation sans surveillance, vous pouvez utiliser le mode non interactif. Incluez l'indicateur -y
pour répondre automatiquement yes
à toute prompt lors package installation de . Par exemple:
$DEBIAN_FRONTEND=noninteractive apt-get -y install newrelic-php5
Manuel : Utilisation dpkg
Important
Si vous utilisez dpkg
, vous devez installer manuellement les mises à jour. C'est pourquoi New Relic recommande la méthodeapt
pour l'installation et la maintenance. Exécutez les commandes de cette procédure en tant que root.
Pour installer l'agent PHP manuellement à l'aide de dpkg
:
Copiez l'URL pour le téléchargement du package
Copiez l'URL complète des derniers packages newrelic-daemon
, newrelic-php5-common
et newrelic-php5
du référentiel de New Relic
Télécharger le package
Exécutez la commande wget
suivante, en remplaçant https://LINK_TO_PACKAGE
par l'URL complète du package :
$wget -L https://LINK_TO_PACKAGE
Installer l'agent PHP
Exécutez la commande d'installation en tant que root, en remplaçant X.X.X.X
par la version actuelle :
$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
Configurez le nom de votre application et la clé de licence New Relic
Le processus installation vous demande le nom de votre application et votre clé de licence. Votre apparaît dans la section des informations de compte de Account settings. Pour une installation sans tête, vous pouvez également préconfigurer votre clé de licence et le nom de application en utilisant debconf
.
Redémarrez votre serveur Web ou FastCGI Process Manager (FPM)
Générez du trafic pour votre application et attendez quelques minutes que votre application envoie des données à New Relic. Ensuite, vérifiez les performances de votre application dans New Relic UI l' .
Ce document vous a-t-il aidé lors de votre installation ?
Sans tête : préconfigurer la clé de licence et le nom de l'application
Pour une installation sans tête, vous devez prendre des mesures pour préconfigurer votre et le nom deapplication . Vous devez utiliser le package php5 par défaut fourni par votre distribution. Pour préconfigurer la clé de licence et le nom de l'application, définissez les valeurs dans votre base de données debconf
à l'aide de debconf-set-selections
.
Important
Ces paramètres seront ignorés si vous n'utilisez pas de package PHP. Vous serez invité à exécuter newrelic-install
.
Ces clés se trouvent dans le package newrelic-php5
:
Nom | Type |
---|---|
Le nom de votre application. Cette chaîne définit | chaîne |
Votre . Cette chaîne définit | chaîne |
Par exemple, vous pouvez exécuter ces commandes pour préconfigurer le nom de votre application et votre clé de licence :
$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