Crash Snapshot Lite

Crash Snapshot Lite – Captura gratuita de errores en producción para PrestaShop 9

Crash Snapshot Lite es un módulo gratuito de diagnóstico para PrestaShop 9 que captura errores compatibles de PHP, Symfony y PrestaShop a nivel de aplicación en producción, sin convertir la tienda en una pantalla de depuración completa. Guarda una instantánea saneada del incidente en el Back Office para poder investigar un error aleatorio después de que ocurra.

Captura errores de aplicación sin activar la depuración completa

Una vez cargado el runtime de Crash Snapshot, las excepciones compatibles pueden capturarse automáticamente. Los errores fatales y de apagado usan primero un spool privado basado en archivos; después, una solicitud normal o el cron de mantenimiento puede importar esos incidentes a la base de datos.

Consulta la información necesaria para investigar

Cada incidente puede incluir un mensaje de error saneado, el tipo de error o excepción, archivo y línea, una traza de pila segura, contexto de Front Office / Back Office / API, información de la solicitud y detalles del entorno como versión de PrestaShop, versión de PHP, tema, ID de tienda y uso de memoria.

Protege los datos sensibles de las solicitudes

Crash Snapshot es deliberadamente conservador con los datos capturados. Los secretos conocidos, cookies, cabeceras de autorización, cuerpos de solicitud sin procesar y argumentos de la pila no se almacenan por defecto. Un filtro de privacidad también elimina valores sensibles de las cadenas de diagnóstico antes de guardarlas.

Agrupa fallos repetidos por huella

Las apariciones repetidas del mismo problema se agrupan bajo una única huella de incidente. En lugar de llenar el panel con filas duplicadas, Crash Snapshot incrementa el contador de apariciones y actualiza la hora de la última detección.

Flujo de trabajo de incidentes en el Back Office

• Buscar incidentes por código, mensaje, archivo o ruta.
• Filtrar por contexto de Front Office, Back Office o API.
• Filtrar por estado revisado / no revisado y campos básicos de diagnóstico.
• Abrir una vista detallada del incidente con diagnósticos saneados.
• Copiar una instantánea de diagnóstico para solucionar problemas.
• Marcar incidentes como revisados o eliminar incidentes individuales.
• Usar vistas de incidentes limitadas por tienda en entornos multitienda.

Estado de captura integrado y autoprueba segura

El panel de diagnóstico comprueba el listener de excepciones, el manejador de apagado, el directorio privado de spool, el almacenamiento en base de datos, el filtro de privacidad y la limpieza de retención. Una autoprueba segura crea de forma intencionada incidentes sintéticos claramente marcados para verificar el flujo de captura, la importación del spool y el saneamiento de privacidad.

Cron de mantenimiento para un procesamiento predecible del spool fatal

El módulo genera una URL cron privada protegida con token. Ejecutarla aproximadamente cada cinco minutos importa los incidentes fatales/de apagado desde el spool privado y realiza la limpieza de retención. Las excepciones normales de la aplicación se guardan inmediatamente cuando la base de datos está disponible, por lo que el cron no escanea el tráfico normal de la tienda buscando errores.

Qué no se incluye intencionadamente en Lite

Lite no intenta identificar el módulo, tema o origen de base de datos más probable, correlacionar un incidente con cambios recientes de módulos/caché, clasificar detalles SQLSTATE, crear paquetes de soporte descargables ni enviar alertas por email/webhook. Esos flujos están reservados para Crash Snapshot Pro.

Compatibilidad y limitaciones importantes

• Diseñado para PrestaShop 9.
• Requiere PHP 8.1+.
• No utiliza overrides del core de PrestaShop.
• Los incidentes capturados son diagnósticos a nivel de aplicación, no sustituyen los logs del servidor web, PHP-FPM ni del sistema operativo.
• Los errores que ocurren antes del bootstrap de PHP/PrestaShop/módulo, los bloqueos duros de PHP-FPM, cierres por falta de memoria del sistema y fallos 502/503 aguas arriba pueden producirse antes de que Crash Snapshot pueda capturarlos.
• La desinstalación conserva los datos de incidentes capturados; la purga destructiva es una acción explícita separada.

Preguntas frecuentes

¿Crash Snapshot capturará todos los HTTP 500?

No. Captura fallos compatibles a nivel de aplicación después de que su runtime se haya cargado. No se puede garantizar que un fallo que ocurra antes de que PrestaShop o el módulo arranquen aparezca en Crash Snapshot.

¿Almacena contraseñas, cookies o cuerpos de solicitud?

Los secretos conocidos, cookies, cabeceras de autorización, cuerpos de solicitud sin procesar y argumentos de la pila no se guardan por defecto. El filtro de privacidad también sanea las cadenas de diagnóstico antes de almacenarlas.

¿Por qué el módulo tiene una URL cron?

El cron es una ruta de mantenimiento. Importa incidentes fatales/de apagado que primero se escribieron en el spool privado y ejecuta la limpieza de retención. No recorre páginas normales buscando errores.

¿Puedo pasar de Lite a Pro más adelante?

Sí. Lite y Pro utilizan el mismo modelo de almacenamiento de incidentes Crash Snapshot. Pro amplía el esquema de diagnóstico y se convierte en la edición activa sin requerir un historial de incidentes separado.