Crash Snapshot Lite

Crash Snapshot Lite – Capture gratuite des erreurs en production pour PrestaShop 9

Crash Snapshot Lite est un module de diagnostic gratuit pour PrestaShop 9 qui capture les erreurs PHP, Symfony et PrestaShop prises en charge au niveau de l’application en production, sans transformer la boutique en écran de debug complet. Il enregistre un instantané d’incident assaini dans le Back Office afin qu’une erreur aléatoire puisse être analysée après son apparition.

Capturer les erreurs applicatives sans activer le debug complet

Une fois le runtime Crash Snapshot chargé, les exceptions prises en charge peuvent être capturées automatiquement. Les erreurs fatales et d’arrêt utilisent d’abord un spool privé sur fichier, puis une requête normale ou le cron de maintenance peut importer ces incidents dans la base de données.

Voir les informations nécessaires à l’analyse

Chaque incident peut contenir un message d’erreur assaini, le type d’erreur ou d’exception, le fichier et la ligne, une trace de pile sûre, le contexte Front Office / Back Office / API, des informations de requête et des détails d’environnement tels que la version de PrestaShop, la version de PHP, le thème, l’ID de la boutique et l’utilisation mémoire.

Protéger les données sensibles des requêtes

Crash Snapshot adopte volontairement une approche prudente concernant les données capturées. Les secrets connus, cookies, en-têtes d’autorisation, corps bruts de requête et arguments de pile ne sont pas enregistrés par défaut. Un filtre de confidentialité supprime également les valeurs sensibles des chaînes de diagnostic avant leur enregistrement.

Regrouper les pannes répétées par empreinte

Les occurrences répétées du même problème sont regroupées sous une même empreinte d’incident. Au lieu de remplir le tableau de bord de lignes dupliquées, Crash Snapshot augmente le compteur d’occurrences et met à jour la dernière date d’apparition.

Workflow des incidents dans le Back Office

• Rechercher les incidents par code d’incident, message, fichier ou route.
• Filtrer par contexte Front Office, Back Office ou API.
• Filtrer par état traité / non traité et par champs de diagnostic de base.
• Ouvrir une vue détaillée de l’incident avec des diagnostics assainis.
• Copier un instantané de diagnostic pour le dépannage.
• Marquer les incidents comme traités ou supprimer des incidents individuellement.
• Utiliser des vues d’incidents limitées à la boutique dans les environnements multiboutiques.

Contrôle de santé intégré et auto-test sûr

Le panneau de diagnostic vérifie l’écouteur d’exceptions, le gestionnaire d’arrêt, le répertoire de spool privé, le stockage en base de données, le filtre de confidentialité et le nettoyage de rétention. Un auto-test sûr crée volontairement des incidents synthétiques clairement identifiés afin de vérifier la chaîne de capture, l’import du spool et le filtrage des données sensibles.

Cron de maintenance pour un traitement prévisible du spool fatal

Le module génère une URL cron privée protégée par jeton. Son exécution environ toutes les cinq minutes importe les incidents fatals/d’arrêt depuis le spool privé et effectue le nettoyage de rétention. Les exceptions applicatives normales sont enregistrées immédiatement lorsque la base de données est disponible ; le cron ne parcourt donc pas le trafic normal de la boutique à la recherche d’erreurs.

Ce qui n’est volontairement pas inclus dans Lite

Lite n’essaie pas d’identifier le module, le thème ou la base de données le plus probablement à l’origine d’un incident, de corréler un incident avec les changements récents de modules/cache, de classifier les détails SQLSTATE, de créer des bundles de support téléchargeables ni d’envoyer des alertes e-mail/webhook. Ces workflows sont réservés à Crash Snapshot Pro.

Compatibilité et limitations importantes

• Conçu pour PrestaShop 9.
• Nécessite PHP 8.1+.
• Aucun override du cœur de PrestaShop n’est utilisé.
• Les incidents capturés sont des diagnostics au niveau de l’application et ne remplacent pas les logs du serveur web, de PHP-FPM ou du système d’exploitation.
• Les erreurs qui surviennent avant le bootstrap PHP/PrestaShop/module, les crashs PHP-FPM brutaux, les arrêts du système pour manque de mémoire et les erreurs 502/503 en amont peuvent se produire avant que Crash Snapshot puisse les capturer.
• La désinstallation conserve les données d’incident capturées ; la purge destructive est une action explicite séparée.

Questions fréquentes

Crash Snapshot capturera-t-il toutes les erreurs HTTP 500 ?

Non. Il capture les pannes applicatives prises en charge après le chargement de son runtime. Une panne qui survient avant le démarrage de PrestaShop ou du module ne peut pas être garantie dans Crash Snapshot.

Enregistre-t-il les mots de passe, cookies ou corps de requête ?

Les secrets connus, cookies, en-têtes d’autorisation, corps bruts de requête et arguments de pile ne sont pas enregistrés par défaut. Le filtre de confidentialité assainit également les chaînes de diagnostic avant stockage.

Pourquoi le module possède-t-il une URL cron ?

Le cron est un chemin de maintenance. Il importe les incidents fatals/d’arrêt d’abord écrits dans le spool privé et exécute le nettoyage de rétention. Il ne parcourt pas les pages normales à la recherche d’erreurs.

Puis-je passer de Lite à Pro plus tard ?

Oui. Lite et Pro utilisent le même modèle de stockage des incidents Crash Snapshot. Pro étend le schéma de diagnostic et devient l’édition active sans nécessiter un historique d’incidents séparé.