Aller au contenu principal

Installer le profiler PHP / Magento / OroCommerce

Le module PHP DEM se présente sous la forme d'une extension PHP et vous permettra de remonter des informations concernant le temps d'exécution de chaque partie de votre CMS.

Pré-requis​

Le profiler nécessite l’installation de l’agent système. Référez-vous à la page dédiée pour installer les agents systèmes.

Compatibilité​

DistributionVersion OSVersion PHPModule PHP DEM
DebianBuster (10)7.3/7.4/8.0/8.1/8.2/8.31.3.4
DebianBullseye (11)7.3/7.4/8.0/8.1/8.2/8.31.3.4
DebianBookworm (12)7.4/8.0/8.1/8.2/8.31.3.4
UbuntuJammy (22.04)7.3/7.4/8.0/8.1/8.2/8.31.3.4
UbuntuKinetic (22.10)7.3/7.4/8.0/8.1/8.2/8.31.3.4
UbuntuLunar (23.04)7.3/7.4/8.0/8.1/8.2/8.31.3.4
CentOS77.3/7.41.3.3 (beta repo)

Installation​

Le module PHP est à installer sur chaque serveur exécutant votre application PHP.

Installer le module PHP DEM pour Debian / Ubuntu​

Il vous faudra avoir ajouté les dépôts DEM, vous avez déjà dû le faire lors de l'installation de l'agent.

En fonction de votre version de PHP, il vous faudra installer le package correspondant. Voici quelques exemples:

  • Pour PHP 7.3:

    apt install php73-quanta-mon

  • Pour PHP 7.4:

    apt install php74-quanta-mon

  • Pour PHP 8.0:

    apt install php80-quanta-mon

  • Pour PHP 8.1:

    apt install php81-quanta-mon

  • Pour PHP 8.2:

    apt install php82-quanta-mon

Vous devrez ensuite activer l'extension avec la commande:

phpenmod quanta_mon

Installer le module PHP DEM pour CentOS / RedHat​

Il vous faudra avoir ajouté les dépôts DEM, vous avez déjà dû le faire lors de l'installation de l'agent.

En fonction de votre version de PHP, il vous faudra installer le package correspondant, par exemple:

  • Pour PHP 7.2:

    yum install php72-quanta-mon

  • Pour PHP 7.3:

    yum install php73-quanta-mon

  • Pour PHP 7.4:

    yum install php74-quanta-mon

Vous devrez ensuite activer l'extension avec la commande:

phpenmod quanta_mon

Installer le module PHP pour les autres OS​

Nous ne supportons pas officiellement de packages pour les autres OS. Néanmoins vous pouvez compiler vous-même le module, les sources sont disponibles sur Github.

Configurez l'URL de votre backoffice si vous utilisez Magento​

Si vous utilisez Magento et qu'une URL customisée est utilisée pour accéder au backoffice Magento (c'est-à-dire une URL qui ne commence pas par "/admin/")

Il est nécessaire de modifier la configuration du module afin que les évènements de type "Magento" remontent correctement dans DEM.

Ce fichier se trouve généralement ici pour Debian/Ubuntu:

/etc/php<VERSION>/mods-available/quanta_mon.ini

et là pour Centos:

/etc/php.d/quanta_mon.ini

Cela peut néanmoins varier en fonction de votre installation PHP.

Par exemple, si l'URL de votre backoffice est "http://admin.monsite.com/admin_123456/" vous devez entrer le paramètre suivant :

quanta_mon.admin_url="/admin_123456/"

Redémarrage du serveur web​

Après l'installation du module, il vous faudra redémarrer le service web pour que l'extension PHP soit chargée et activée.

  • Par exemple si vous utilisez Apache sous Debian :

    systemctl restart apache2

  • Si vous utilisez PHP-FPM, la commande sera par exemple:

    systemctl restart php8.2-fpm

Vérification du bon fonctionnement​

Lorsque tout est installé, et que le scénario de navigation web est créé dans DEM, allez dans le menu Scénario Web, puis cliquez sur "+ détails" dans la légende sur l'une des pages nécessitant l'exécution de PHP (exemple : une page Panier qui n'est généralement jamais en cache).

Vous devriez alors voir l'onglet "Application" (autrement cet onglet est grisé) des informations concernant le temps passé dans PHP.

Dans le cas d'utilisation d'un CMS Magento (v1 ou 2) ou de la plateforme OroCommerce, le code couleur est différent. Il est orange pour Magento et jaune pour OroCommerce

Les métriques avancées (Apache, MySQL, Redis, etc…) sont à installer à part. Référez-vous à la page dédiée