Configuration de la surveillance de PHP

Vous devez configurer Monitoring Agent for PHP pour qu'il puisse collecter des données de l'application PHP surveillée.

Avant de commencer

Veillez à bien installer le package php-process. Si vous utilisez la commande yum install pour installer PHP, exécutez la commande yum install php-process pour installer le package php-process.
Vérifiez que le serveur HTTPD Apache est démarré avant de configurer l'agent.
Ouvrez le fichier de configuration httpd.conf du serveur HTTP Apache et assurez-vous que les options mod_status et ExtendedStatus On sont activées. Par exemple :
```
ExtendedStatus On
<Location /server-status>
		SetHandler server-status
		Order deny,allow
		Allow from all
		Allow from 127.0.0.1
</Location>
```
Dans l'exemple donné, http://127.0.0.1/server-status doit fonctionner pour que l'agent fonctionne correctement.
Remarque : Lynx ou Links doit être installé sous Linux pour que l'agent obtienne les données de surveillance.

Vérifiez que la commande apachectl status fonctionne sur le serveur Apache surveillé sans que le code de la commande apachectl ne soit modifié. Lynx doit être installé pour que la commande apachectl status fonctionne correctement.

Pourquoi et quand exécuter cette tâche

Afin d'éviter tout problème de droits lorsque vous configurez l'agent, veillez à utiliser le même ID d'utilisateur superutilisateur ou non superutilisateur que celui utilisé pour installer l'agent. Si vous avez installé votre agent en tant qu'utilisateur sélectionné et que vous voulez le configurer en tant qu'utilisateur, voir Configuration des agents en tant qu'utilisateur non superutilisateur. Si vous avez installé et configuré votre agent en tant qu'utilisateur sélectionné et que vous voulez le démarrer en tant qu'un autre utilisateur, voir Démarrage des agents en tant qu'utilisateur non superutilisateur.

L'Agent PHP est un agent d'instance multiple. Vous devez créer la première instance et démarrer l'agent manuellement. Le nom de système géré inclut le nom d'instance que vous spécifiez, nom_instance:nom_hôte:cp par exemple, où cp est le code produit à deux caractères. Il est limité à 32 caractères. Le nom d'instance que vous entrez est limité à 28 caractères, moins la longueur de votre nom d'hôte. Par exemple, si vous indiquez PHP2 comme nom d'instance, le nom du système géré est PHP2:hostname:PJ.

Important : Si vous indiquez un nom d'instance long, le nom du système géré est tronqué et le code d'agent ne s'affiche pas correctement.

Procédure

Si votre environnement est identique aux paramètres par défaut, vous pouvez utiliser le chemin d'exécution binaire par défaut, le chemin d'accès au fichier php.ini par défaut et le port par défaut pour configurer l'agent :
1. Entrez :
  rép_install/bin/php-agent.sh config nom_instance rép_install/samples/php_silent_config.txt
  Où nom_instance est le nom à attribuer à l'instance, et rép_install est le répertoire d'installation de l'Agent PHP. Le répertoire d'installation par défaut est /opt/ibm/apm/agent.
2. Pour démarrer l'agent, entrez la commande suivante :
  rép_install/bin/php-agent.sh start nom_instance
Pour configurer l'agent en éditant le fichier de réponses silencieux et en exécutant le script sans intervenir, procédez comme suit :
1. Ouvrez rép_install/samples/php_silent_config.txt dans un éditeur de texte.
2. Pour Location of PHP execution binary, vous pouvez spécifier le répertoire où se trouve l'exécution PHP. L'emplacement par défaut est /usr/local/bin.
3. Pour Location of PHP INI file, vous pouvez spécifier le répertoire où se trouve le fichier php.ini. L'emplacement par défaut est /etc.
4. Pour Web server port, vous pouvez indiquer le numéro de port du serveur Web qui exécute WordPress. La valeur par défaut est 80.
5. Pour Application DocumentRoot, vous pouvez spécifier le DocumentRoot de l'application PHP WordPress. Utilisez une virgule pour séparer plusieurs enregistrements. Pour permettre à l'agent de localiser tous les enregistrements d'événements, utilisez la valeur par défaut ALL.
6. Sauvegardez et fermez le fichier php_silent_config.txt, puis entrez :
  rép_install/bin/php-agent.sh config nom_instance rép_install/samples/php_silent_config.txt
  Où instance_name est le nom à attribuer à l'instance, et rép_install est le répertoire d'installation de l'Agent PHP. Le répertoire d'installation par défaut est /opt/ibm/apm/agent.
7. Pour démarrer l'agent, entrez la commande suivante :
  rép_install/bin/php-agent.sh start nom_instance
Pour configurer l'agent en exécutant le script et en répondant aux invites, procédez comme suit :
1. Entrez :
  rép_install/bin/php-agent.sh config nom_instance
  Où nom_instance est le nom à attribuer à l'instance, et rép_install est le répertoire d'installation de l'Agent PHP.
2. A l'invite Edit Monitoring Agent for PHP settings, entrez 1 pour continuer.
3. A l'invite Location of PHP execution binary, appuyez sur Entrée pour accepter l'emplacement par défaut ou indiquez un emplacement de votre choix.
4. A l'invite Location of PHP INI file, appuyez sur Entrée pour accepter l'emplacement par défaut ou indiquez un emplacement de votre choix.
5. A l'invite Web server port, appuyez sur Entrée pour accepter la valeur par défaut ou indiquez un autre numéro de port.
6. A l'invite Application DocumentRoot, appuyez sur Entrée pour accepter la valeur par défaut ou indiquez le DocumentRoot de l'application PHP WordPress. Vous pouvez utiliser une virgule pour séparer plusieurs enregistrements.
7. Pour démarrer l'agent, entrez la commande suivante :
  rép_install/bin/php-agent.sh start nom_instance

Résultats

L'agent évalue uniquement les performances des requêtes PHP dans les applications WordPress. Le chargement CSS et JS n'est pas évalué. L'agent n'utilise pas les arguments d'URL pour identifier les URL.

Que faire ensuite

Vous pouvez vérifier que les données de l'Agent PHP s'affichent dans la console Cloud APM.

Vous devez vous assurer que le plug-in WordPress de l'agent est activé. Pour assurer l'activation, procédez comme suit :

Dans un navigateur Web, entrez l'URL http://hostname:port/wp-admin/.
Accédez à la page d'administration en sélectionnant Plugins > Installed Plugins.
Vérifiez que le plug-in Agent PHP est activé. Le plug-in de l'Agent PHP est répertorié en tant qu'agent WordPress. En général, le plug-in est déjà activé. Si ce n'est pas le cas, cliquez sur Activate.