PS PrestaShop Débutant

Surveillance et Alertes PrestaShop (DataFirefly Monitor)

Installer DataFirefly Monitor 2.0.0 sur PrestaShop 1.7.8 à 9, planifier le cron, régler les canaux d'alerte, les pages surveillées et les règles, et comprendre chaque détection.

Mis à jour Version du module 2.0.0

DataFirefly Monitor surveille votre boutique PrestaShop en continu et vous prévient quand elle tombe, plante, ralentit ou n’encaisse plus. Il désigne le module le plus probablement en cause, envoie une seule alerte par problème et vous dit quand tout est rentré dans l’ordre. Cette documentation porte sur la version 2.0.0.

Tableau de bord : problème critique en cours, alertes ouvertes et indicateurs de la boutique
Tableau de bord : problème critique en cours, alertes ouvertes et indicateurs de la boutique

Installation et mise à jour

Prérequis

  • PrestaShop 1.7.8 à 9.x, multiboutique et multilingue
  • PHP 7.1 à 8.5, avec cURL (recommandé)
  • Une tâche cron toutes les 5 minutes (recommandé, voir plus bas)

Installation

  1. Dans le back-office, ouvrez Modules > Gestionnaire de modules, cliquez sur Installer un module et envoyez dfmonitor-2.0.0.zip.
  2. Le module crée ses tables et l’onglet Paramètres avancés > Supervision & alertes. Le bouton Configurer du module y mène directement.
  3. À l’installation, l’e-mail de la boutique est pris comme destinataire et le statut Erreur de paiement est choisi comme statut d’échec. Les logs PrestaShop écrits avant l’installation ne sont pas importés.

Mise à jour depuis la 1.x

Envoyez le nouveau zip par-dessus l’ancien : le script de mise à jour ajoute les nouvelles colonnes et les nouveaux réglages sans toucher à vos données. L’historique des erreurs, les alertes, les notifications, vos réglages et votre jeton cron sont conservés : l’URL de cron que vous utilisez déjà continue de fonctionner.

Tableau de bord

L’en-tête résume l’état de la boutique en une phrase : Tout fonctionne, un avertissement ou un problème critique. Dessous, les alertes ouvertes avec leurs boutons Prendre en compte et Fermer, puis six indicateurs : disponibilité sur 24 heures, temps de réponse sur 1 heure (p95), erreurs PHP sur 24 heures, paiements échoués, commandes du jour comparées à l’activité habituelle, et serveur.

Le bandeau de disponibilité montre les 24 dernières heures par tranches de 15 minutes. La carte Pages surveillées liste la page d’accueil et les pages supplémentaires avec leur dernier code HTTP, leur temps de réponse et leur disponibilité sur 24 heures.

Disponibilité sur 24 heures et pages surveillées avec texte attendu, code HTTP et temps de réponse
Disponibilité sur 24 heures et pages surveillées avec texte attendu, code HTTP et temps de réponse

Deux graphiques montrent le temps de réponse (moyenne et p95) et les erreurs PHP par heure sur 24 heures, suivis des dernières erreurs et des types de pages les plus lents.

Graphiques du temps de réponse (moyenne et p95) et des erreurs PHP par heure, types de pages les plus lents
Graphiques du temps de réponse (moyenne et p95) et des erreurs PHP par heure, types de pages les plus lents

Tâche cron

Les erreurs fatales et les échecs de paiement sont signalés en temps réel. Tout le reste (disponibilité, temps de réponse, commandes, santé du serveur, rapport) est évalué par une tâche planifiée à lancer toutes les 5 minutes.

Cron serveur (recommandé)

*/5 * * * * php /chemin/vers/prestashop/modules/dfmonitor/cron.php

La commande exacte, avec le chemin de votre serveur, est affichée dans Réglages > Vérifications planifiées avec un bouton Copier. Lancez-la avec l’utilisateur du serveur web. cron.php refuse tout appel qui ne vient pas de la ligne de commande.

Cron par URL

Si votre hébergeur n’autorise que les crons web, appelez l’URL affichée dans le même onglet depuis votre panneau d’hébergement ou un service comme cron-job.org. Le jeton peut aussi être envoyé dans l’en-tête X-Dfmonitor-Token. Sans le bon jeton, l’adresse répond 403 et ne révèle rien. Avec, la réponse ne donne que le statut, la durée et le nombre d’alertes ouvertes : aucun chemin, aucune version, aucun message d’erreur. Les vérifications tournent au plus une fois par minute par cette URL, et Générer un nouveau jeton invalide le précédent.

Vérifications planifiées : cron serveur, URL de cron protégée par jeton, heartbeat externe et rétention
Vérifications planifiées : cron serveur, URL de cron protégée par jeton, heartbeat externe et rétention

Sans cron

Avec PHP-FPM, l’option Solution de repli sans cron lance les vérifications depuis le trafic des visiteurs quand aucun cron n’a tourné depuis 10 minutes, après l’envoi de la page. Le test de disponibilité et le heartbeat ne tournent pas dans ce mode. Avec Apache mod_php, un cron est indispensable.

Heartbeat externe

Le module ne peut pas signaler une panne complète du serveur. Créez un contrôle sur Healthchecks.io ou Better Stack et collez son URL dans URL de heartbeat : elle est appelée à chaque passage du cron, et le service vous prévient quand les appels s’arrêtent.

Canaux de notification

Activez autant de canaux que vous voulez dans Réglages > Canaux de notification. Chaque canal a une sévérité minimale (avertissement et critique, ou critique uniquement) et un bouton Enregistrer et envoyer un test. Le résultat du dernier envoi s’affiche sous le nom du canal.

Canaux d'alerte : e-mail, Telegram, Slack, Discord et webhook, jetons enregistrés et masqués
Canaux d'alerte : e-mail, Telegram, Slack, Discord et webhook, jetons enregistrés et masqués

Les secrets ne sont plus jamais réaffichés. Une fois enregistrés, les webhooks Slack et Discord, le jeton Telegram, l’URL du webhook et son secret, et l’URL de heartbeat sont masqués : le champ reste vide avec un indice comme https://hooks.slack.com/...7f3a. Laissez-le vide pour garder la valeur, saisissez-en une nouvelle pour la remplacer, ou cliquez sur Supprimer.

E-mail

Saisissez un ou plusieurs destinataires séparés par des virgules. Les e-mails utilisent la configuration e-mail de PrestaShop (Paramètres avancés > E-mail). La Langue des alertes vaut pour tous les canaux ; par défaut, c’est la langue de la boutique. Les e-mails existent en français, anglais, espagnol, allemand, italien, néerlandais, polonais et portugais.

E-mail d'alerte d'une erreur fatale PHP avec origine probable et bouton pour acquitter
E-mail d'alerte d'une erreur fatale PHP avec origine probable et bouton pour acquitter

Telegram

  1. Dans Telegram, ouvrez @BotFather, envoyez /newbot et suivez les instructions.
  2. Collez le jeton reçu dans Jeton du bot.
  3. Envoyez un message à votre bot, ou ajoutez-le à un groupe, puis cliquez sur Détecter mon chat : l’ID du chat se remplit tout seul.

Slack et Discord

Slack : Apps > Incoming Webhooks > Add to Slack, choisissez le canal et copiez l’URL qui commence par https://hooks.slack.com/. Discord : Paramètres du serveur > Intégrations > Webhooks > Nouveau webhook, puis Copier l’URL du webhook.

Webhook

Pour Zapier, Make, n8n, un outil d’astreinte ou votre propre script. Un POST JSON est envoyé pour chaque nouvelle alerte, rappel et résolution, avec l’en-tête X-DataFirefly-Event (open, repeat, resolved, test). Le corps contient event, alert (id, key, type, severity, title, message, occurrences, first_at, last_at, ack_url), shop et sent_at. Avec un secret de signature, chaque requête porte X-DataFirefly-Signature: sha256=…, le HMAC SHA-256 du corps brut.

Par sécurité, les adresses du réseau privé, du serveur lui-même et des services de métadonnées cloud sont refusées, et les redirections ne sont pas suivies. Si votre outil est hébergé sur votre propre réseau, activez Autoriser un webhook sur le réseau privé ; les adresses de métadonnées cloud restent refusées.

Règles d’alerte

  • Rappel pour une alerte en cours : délai entre deux notifications sur le même problème (60 minutes par défaut). Un problème qui s’aggrave, d’avertissement à critique, est notifié tout de suite.
  • Nombre maximum de notifications par heure : 20 par défaut, 0 pour aucune limite. Une alerte envoyée sur plusieurs canaux compte une seule fois. Un message retenu apparaît comme Retenu dans le journal et part plus tard.
  • Résoudre après : nombre de vérifications correctes de suite avant de fermer une alerte (2 par défaut), pour qu’une valeur qui oscille autour d’un seuil n’envoie pas des messages d’ouverture et de résolution en boucle.
  • Message de résolution : un message part quand un problème notifié disparaît.
  • Confidentialité : les adresses e-mail présentes dans les messages d’erreur sont masquées dans Slack, Telegram, Discord et le webhook (activé par défaut).
  • Heures calmes : sur la plage choisie, seules les alertes critiques partent ; les avertissements attendent la fin de la plage.
  • Rapport récapitulatif par e-mail : désactivé, quotidien ou chaque lundi, à l’heure choisie.
Règles d'alerte : rappel, limite horaire, résolution après plusieurs contrôles, confidentialité et heures calmes
Règles d'alerte : rappel, limite horaire, résolution après plusieurs contrôles, confidentialité et heures calmes

Pause

Le bouton Pause suspend les notifications pendant 30 minutes, 2 heures, 8 heures ou 24 heures, par exemple pendant une mise à jour. Les problèmes restent détectés et enregistrés ; ceux encore ouverts à la fin de la pause sont notifiés.

Ce que le module détecte

Erreurs PHP

Le module capte les erreurs fatales et les avertissements (et, en option, les notices et dépréciations) sur la boutique et, si l’option est active, dans le back-office. Les erreurs identiques sont regroupées. Une nouvelle erreur fatale déclenche une alerte critique immédiate ; elle expire sans message après 24 heures sans nouvelle occurrence. Une alerte de pic part au-delà de 100 erreurs et avertissements en 15 minutes (réglable, 0 pour désactiver). Les logs PrestaShop de gravité 3 et 4 sont importés à chaque passage du cron. Chaque erreur reçoit une origine probable : module, thème, override, template compilé ou cœur ; quand l’erreur survient dans le cœur, c’est le premier module de la pile d’appels qui est retenu.

Temps de réponse

Le temps de réponse est mesuré sur les vraies visites. La Part des pages mesurées va de 1 à 100 % ; chaque page mesurée coûte une écriture en base. Une alerte part quand le 95e centile sur 15 minutes dépasse le seuil (3000 ms par défaut), à partir de 20 pages mesurées, et elle se résout quand le p95 repasse 10 % sous le seuil. Une alerte critique part quand plus de 5 % des requêtes finissent en erreur serveur sur 15 minutes, avec au moins 5 erreurs.

Disponibilité et pages surveillées

À chaque passage du cron serveur, le module charge la page d’accueil et jusqu’à 5 pages de votre choix : une catégorie, un produit, le panier, la page contact… Une page est en ligne quand elle répond HTTP 2xx ou 3xx (après 3 redirections au plus), 401 ou 429. Elle est hors service quand elle ne répond pas, répond 5xx ou un autre 4xx, ne contient pas le texte attendu que vous avez défini ou, pour la page d’accueil, est vide. Après 2 échecs de suite (réglable), une alerte critique s’ouvre. Le contrôle est suspendu en mode maintenance.

Test de disponibilité : page d'accueil avec texte attendu et jusqu'à 5 pages de la boutique
Test de disponibilité : page d'accueil avec texte attendu et jusqu'à 5 pages de la boutique

Seules les adresses sur les domaines de votre boutique sont acceptées : le module n’appelle jamais un autre site pour ce contrôle. Utilisez Enregistrer et tester les pages maintenant pour les vérifier tout de suite. Si le serveur ne joint pas sa propre adresse publique (certains hébergeurs, Docker, un proxy), indiquez l’adresse locale du serveur web dans Adresse de connexion, par exemple 127.0.0.1:80 : l’adresse de la page et son en-tête Host restent les mêmes.

Paiements et commandes

  • Échecs de paiement : commandes passées à l’un des statuts choisis dans la dernière heure, par module de paiement (seuil de 3 par défaut). Le contrôle tourne aussi dès qu’une commande change de statut, après l’envoi de la réponse : il ne ralentit jamais la commande.
  • Conversion au paiement : part des paniers arrivés à l’étape de paiement devenus commandes, sur une fenêtre de 2 heures, comparée à la part habituelle sur 28 jours. Elle démarre après environ 40 paniers d’historique.
  • Chute de commandes : commandes des 3 dernières heures (réglable) comparées à la même tranche horaire des 4 semaines précédentes. Ignorée quand moins de 4 commandes sont attendues.
  • Sensibilité : faible, moyenne (recommandée) ou élevée.
Paiements et commandes : statuts de paiement échoué, conversion au paiement et chute de commandes
Paiements et commandes : statuts de paiement échoué, conversion au paiement et chute de commandes

Santé du serveur

  • Certificat SSL : lu toutes les 6 heures. Avertissement 14 jours avant l’expiration (réglable), critique à 3 jours.
  • Espace disque : avertissement sous 2048 Mo libres (réglable), critique sous le quart de ce seuil.
  • Surveillance du cron : dès qu’un cron serveur a tourné, une alerte part après 30 minutes sans passage.
Santé du serveur : expiration du certificat SSL, espace disque et surveillance de la tâche cron
Santé du serveur : expiration du certificat SSL, espace disque et surveillance de la tâche cron

Gérer les alertes

Un problème ouvre une seule alerte, mise à jour tant qu’il dure. L’onglet Alertes affiche un bilan sur 30 jours (alertes, alertes critiques, temps moyen de résolution, messages envoyés), l’historique avec la durée de chaque incident, et le journal de chaque envoi.

Historique des alertes avec bilan sur 30 jours et temps moyen de résolution
Historique des alertes avec bilan sur 30 jours et temps moyen de résolution
  • Prendre en compte : arrête les rappels. Le message de résolution est quand même envoyé.
  • Fermer : ferme l’alerte. Si le problème est toujours là, une nouvelle alerte s’ouvre à la vérification suivante.
Journal des notifications envoyées par e-mail, Slack et Telegram, avec le résultat de chaque envoi
Journal des notifications envoyées par e-mail, Slack et Telegram, avec le résultat de chaque envoi

Acquitter depuis le téléphone

Chaque notification d’alerte contient un lien Acquitter et arrêter les rappels, signé pour cette alerte. Il ouvre une page de confirmation sur la boutique, pensée pour le téléphone, et l’alerte n’est acquittée qu’une fois confirmée : les antivirus de messagerie qui ouvrent les liens ne peuvent donc pas l’acquitter à votre place.

Page d'acquittement ouverte depuis le téléphone : arrêter les rappels sans se connecter
Page d'acquittement ouverte depuis le téléphone : arrêter les rappels sans se connecter

Page des erreurs PHP

Filtrez par gravité ou par origine et cherchez un message, un fichier ou une page. Une erreur dépliée montre la page, le contrôleur, les dates, le message complet et la pile d’appels. Copier le rapport pour un développeur copie un texte avec les versions de PrestaShop et PHP, le fichier, l’origine, la page, les occurrences, le message et la pile d’appels. Mettre en sourdine continue de compter l’erreur mais n’alerte plus jamais dessus.

Journal des erreurs PHP : module responsable, pile d'appels et rapport à copier pour un développeur
Journal des erreurs PHP : module responsable, pile d'appels et rapport à copier pour un développeur

Droits

Un employé dont le profil n’a que le droit voir sur Supervision & alertes consulte tous les écrans en lecture seule : les champs sont désactivés et les actions (lancer, pause, acquitter, réglages) sont refusées.

Données et confidentialité

  • Les adresses de pages sont enregistrées sans paramètres d’URL, et la pile d’appels sans arguments de fonctions.
  • Le chemin du serveur et le nom du dossier d’administration sont retirés de tout texte enregistré ou envoyé.
  • Les jetons de bot et les chemins de webhook sont masqués dans le journal des notifications.
  • L’historique est purgé après 30 jours par défaut (7 à 365 jours), par petits lots ; les alertes closes sont gardées au moins 90 jours.

Limites connues

  • Le test de disponibilité part du serveur lui-même : il ne voit pas une panne réseau ou DNS extérieure. Le heartbeat externe couvre ce cas.
  • Une erreur fatale survenue avant le chargement des modules n’est pas captée par le gestionnaire d’erreurs ; le test de disponibilité et le taux de 5xx la signalent.
  • Les pages Symfony du back-office ne passent pas par le hook qui capte les erreurs du back-office.
  • La conversion au paiement repose sur le hook displayPaymentTop. Si votre tunnel en une page ne l’appelle pas, désactivez ce contrôle : la chute de commandes reste active.

Dépannage

Le test e-mail échoue

Vérifiez la configuration dans Paramètres avancés > E-mail et envoyez un test depuis cette page. L’erreur exacte s’affiche après le test et dans l’onglet Alertes.

La page d’accueil apparaît hors service alors que la boutique fonctionne

Le serveur ne joint sans doute pas sa propre adresse publique. Renseignez Adresse de connexion (par exemple 127.0.0.1:80) et cliquez sur Enregistrer et tester les pages maintenant.

« Aucun cron serveur détecté » reste affiché

Seuls le cron en ligne de commande et l’URL de cron comptent. Lancez la commande à la main en SSH : elle affiche un rapport JSON. Si elle échoue, vérifiez le chemin de PHP CLI avec votre hébergeur.

Le test du webhook répond « adresse refusée »

L’URL pointe vers le réseau privé ou vers le serveur lui-même. Utilisez une adresse publique, ou activez Autoriser un webhook sur le réseau privé si votre outil est hébergé sur votre propre réseau.

Cette page vous a-t-elle été utile ?

Toujours bloqué ? Contactez le support