Monitorización y Alertas PrestaShop (DataFirefly Monitor)
Instalar DataFirefly Monitor 2.0.0 en PrestaShop 1.7.8 a 9, programar el cron, configurar los canales de alerta, las páginas vigiladas y las reglas, y entender cada detección.
DataFirefly Monitor vigila su tienda PrestaShop de forma continua y le avisa cuando cae, falla, se ralentiza o deja de cobrar. Indica el módulo con más probabilidad de ser el responsable, envía una sola alerta por problema y le avisa cuando todo vuelve a la normalidad. Esta documentación corresponde a la versión 2.0.0.

Instalación y actualización
Requisitos
- PrestaShop 1.7.8 a 9.x, multitienda y multiidioma
- PHP 7.1 a 8.5, con cURL (recomendado)
- Una tarea cron cada 5 minutos (recomendado, ver más abajo)
Instalación
- En el back office, abra Módulos > Gestor de módulos, haga clic en Subir un módulo y envíe
dfmonitor-2.0.0.zip. - El módulo crea sus tablas y la pestaña Parámetros Avanzados > Supervisión y alertas. El botón Configurar del módulo lleva directamente a ella.
- En la instalación, el email de la tienda se usa como destinatario y el estado Error en el pago se elige como estado de fallo. Los logs de PrestaShop escritos antes de la instalación no se importan.
Actualización desde la 1.x
Suba el nuevo zip sobre el anterior: el script de actualización añade las nuevas columnas y ajustes sin tocar sus datos. El historial de errores, las alertas, las notificaciones, sus ajustes y su token de cron se conservan, así que la URL de cron que ya usa sigue funcionando.
Panel
La cabecera resume el estado de la tienda en una frase: Todo funciona, un aviso o un problema crítico. Debajo están las alertas abiertas con sus botones Confirmar recepción y Cerrar, y seis indicadores: disponibilidad en 24 horas, tiempo de respuesta en 1 hora (p95), errores PHP en 24 horas, pagos fallidos, pedidos de hoy comparados con la actividad habitual y servidor.
La banda de disponibilidad muestra las últimas 24 horas en tramos de 15 minutos. La tarjeta Páginas vigiladas lista la página de inicio y las páginas adicionales con su último código HTTP, su tiempo de respuesta y su disponibilidad en 24 horas.

Dos gráficos muestran el tiempo de respuesta (media y p95) y los errores PHP por hora en 24 horas, seguidos de los últimos errores y de los tipos de página más lentos.

Tarea cron
Los errores fatales y los fallos de pago se notifican en tiempo real. Todo lo demás (disponibilidad, tiempo de respuesta, pedidos, salud del servidor, informe) lo evalúa una tarea programada que debe ejecutarse cada 5 minutos.
Cron del servidor (recomendado)
*/5 * * * * php /ruta/a/prestashop/modules/dfmonitor/cron.php
El comando exacto, con la ruta de su servidor, aparece en Ajustes > Comprobaciones programadas con un botón Copiar. Ejecútelo con el usuario del servidor web. cron.php rechaza toda llamada que no venga de la línea de comandos.
Cron por URL
Si su alojamiento solo permite crons web, llame a la URL que aparece en la misma pestaña desde su panel de alojamiento o un servicio como cron-job.org. El token también puede enviarse en la cabecera X-Dfmonitor-Token. Sin el token correcto la dirección responde 403 y no revela nada. Con él, la respuesta solo da el estado, la duración y el número de alertas abiertas: ninguna ruta, versión ni mensaje de error. Las comprobaciones se ejecutan como máximo una vez por minuto por esta URL, y Generar un nuevo token invalida el anterior.

Sin cron
Con PHP-FPM, la opción Alternativa sin cron lanza las comprobaciones desde el tráfico de visitantes cuando ningún cron se ha ejecutado en 10 minutos, después de enviar la página. La comprobación de disponibilidad y el heartbeat no se ejecutan en este modo. Con Apache mod_php, el cron es imprescindible.
Heartbeat externo
El módulo no puede avisar de una caída completa del servidor. Cree un control en Healthchecks.io o Better Stack y pegue su URL en URL de heartbeat: se llama en cada ejecución del cron, y el servicio le avisa cuando las llamadas se detienen.
Canales de notificación
Active tantos canales como quiera en Ajustes > Canales de notificación. Cada canal tiene una severidad mínima (aviso y crítico, o solo crítico) y un botón Guardar y enviar una prueba. El resultado del último envío aparece bajo el nombre del canal.

Los secretos nunca se vuelven a mostrar. Una vez guardados, los webhooks de Slack y Discord, el token de Telegram, la URL del webhook y su secreto, y la URL de heartbeat quedan ocultos: el campo queda vacío con una pista como https://hooks.slack.com/...7f3a. Déjelo vacío para conservar el valor, escriba uno nuevo para sustituirlo o haga clic en Eliminar.
Introduzca uno o varios destinatarios separados por comas. Los emails usan la configuración de email de PrestaShop (Parámetros Avanzados > Email). El Idioma de las alertas se aplica a todos los canales; por defecto es el idioma de la tienda. Los emails existen en español, inglés, francés, alemán, italiano, neerlandés, polaco y portugués.

Telegram
- En Telegram, abra @BotFather, envíe
/newboty siga las instrucciones. - Pegue el token recibido en Token del bot.
- Envíe un mensaje a su bot, o añádalo a un grupo, y haga clic en Detectar mi chat: el ID del chat se rellena solo.
Slack y Discord
Slack: Apps > Incoming Webhooks > Add to Slack, elija el canal y copie la URL que empieza por https://hooks.slack.com/. Discord: Ajustes del servidor > Integraciones > Webhooks > Nuevo webhook y luego Copiar URL del webhook.
Webhook
Para Zapier, Make, n8n, una herramienta de guardia o su propio script. Se envía un POST JSON por cada nueva alerta, recordatorio y resolución, con la cabecera X-DataFirefly-Event (open, repeat, resolved, test). El cuerpo contiene event, alert (id, key, type, severity, title, message, occurrences, first_at, last_at, ack_url), shop y sent_at. Con un secreto de firma, cada petición lleva X-DataFirefly-Signature: sha256=…, el HMAC SHA-256 del cuerpo en bruto.
Por seguridad, se rechazan las direcciones de la red privada, del propio servidor y de los servicios de metadatos cloud, y no se siguen las redirecciones. Si su herramienta está alojada en su propia red, active Permitir un webhook en la red privada; las direcciones de metadatos cloud siguen rechazadas.
Reglas de alerta
- Recordatorio de una alerta en curso: intervalo entre dos notificaciones sobre el mismo problema (60 minutos por defecto). Un problema que empeora, de aviso a crítico, se notifica en el acto.
- Máximo de notificaciones por hora: 20 por defecto, 0 para no limitar. Una alerta enviada a varios canales cuenta una vez. Un mensaje retenido aparece como Retenido en el registro y se envía más tarde.
- Resolver tras: número de comprobaciones correctas seguidas antes de cerrar una alerta (2 por defecto), para que un valor que oscila alrededor de un umbral no envíe mensajes de apertura y resolución en bucle.
- Mensaje de resolución: se envía un mensaje cuando desaparece un problema notificado.
- Privacidad: las direcciones de email presentes en los mensajes de error se ocultan en Slack, Telegram, Discord y el webhook (activado por defecto).
- Horas tranquilas: durante la franja elegida solo se envían las alertas críticas; los avisos esperan al final de la franja.
- Informe resumen por email: desactivado, diario o cada lunes, a la hora elegida.

Pausa
El botón Pausa suspende las notificaciones durante 30 minutos, 2 horas, 8 horas o 24 horas, por ejemplo durante una actualización. Los problemas se siguen detectando y registrando; los que siguen abiertos al terminar la pausa se notifican.
Qué detecta el módulo
Errores PHP
El módulo captura los errores fatales y los avisos (y, opcionalmente, notices y deprecations) en la tienda y, si la opción está activa, en el back office. Los errores idénticos se agrupan. Un nuevo error fatal dispara una alerta crítica inmediata; caduca sin mensaje tras 24 horas sin nueva ocurrencia. Se lanza una alerta de pico por encima de 100 errores y avisos en 15 minutos (ajustable, 0 para desactivar). Los logs de PrestaShop de gravedad 3 y 4 se importan en cada ejecución del cron. Cada error recibe un origen probable: módulo, tema, override, plantilla compilada o núcleo; cuando el error ocurre en el núcleo, se toma el primer módulo de la pila de llamadas.
Tiempo de respuesta
El tiempo de respuesta se mide en las visitas reales. El Porcentaje de páginas medidas va de 1 a 100 %; cada página medida cuesta una escritura en la base de datos. Se lanza una alerta cuando el percentil 95 en 15 minutos supera el umbral (3000 ms por defecto), a partir de 20 páginas medidas, y se resuelve cuando el p95 vuelve a estar un 10 % por debajo del umbral. Se lanza una alerta crítica cuando más del 5 % de las peticiones acaban en error de servidor en 15 minutos, con al menos 5 errores.
Disponibilidad y páginas vigiladas
En cada ejecución del cron del servidor, el módulo carga la página de inicio y hasta 5 páginas a su elección: una categoría, un producto, el carrito, la página de contacto… Una página está en línea cuando responde HTTP 2xx o 3xx (tras 3 redirecciones como máximo), 401 o 429. Está caída cuando no responde, responde 5xx u otro 4xx, no contiene el texto esperado que haya definido o, para la página de inicio, está en blanco. Tras 2 fallos seguidos (ajustable) se abre una alerta crítica. El control se suspende en modo mantenimiento.

Solo se aceptan direcciones de los dominios de su tienda: el módulo nunca llama a otro sitio para este control. Use Guardar y probar las páginas ahora para comprobarlas al momento. Si el servidor no llega a su propia dirección pública (algunos alojamientos, Docker, un proxy), indique la dirección local del servidor web en Dirección de conexión, por ejemplo 127.0.0.1:80: la dirección de la página y su cabecera Host no cambian.
Pagos y pedidos
- Fallos de pago: pedidos que pasaron a uno de los estados elegidos en la última hora, por módulo de pago (umbral de 3 por defecto). El control también se ejecuta en cuanto un pedido cambia de estado, después de enviar la respuesta: nunca ralentiza el pedido.
- Conversión del checkout: proporción de carritos que llegaron al paso de pago y se convirtieron en pedidos, en una ventana de 2 horas, comparada con la proporción habitual en 28 días. Empieza tras unos 40 carritos de historial.
- Caída de pedidos: pedidos de las últimas 3 horas (ajustable) comparados con la misma franja de las 4 semanas anteriores. Se omite cuando se esperan menos de 4 pedidos.
- Sensibilidad: baja, media (recomendada) o alta.

Salud del servidor
- Certificado SSL: se lee cada 6 horas. Aviso 14 días antes de caducar (ajustable), crítico a 3 días.
- Espacio en disco: aviso por debajo de 2048 MB libres (ajustable), crítico por debajo de una cuarta parte de ese umbral.
- Vigilancia del cron: en cuanto se ha ejecutado un cron del servidor, se lanza una alerta tras 30 minutos sin ejecución.

Gestionar las alertas
Un problema abre una sola alerta, actualizada mientras dura. La pestaña Alertas muestra un balance de 30 días (alertas, alertas críticas, tiempo medio de resolución, mensajes enviados), el historial con la duración de cada incidente y el registro de cada envío.

- Confirmar recepción: detiene los recordatorios. El mensaje de resolución se sigue enviando.
- Cerrar: cierra la alerta. Si el problema sigue ahí, se abre una nueva alerta en la siguiente comprobación.

Confirmar desde el móvil
Cada notificación de alerta contiene un enlace Confirmar y detener recordatorios, firmado para esa alerta. Abre una página de confirmación en la tienda, pensada para el móvil, y la alerta solo se confirma cuando usted lo valida: los antivirus de correo que abren los enlaces no pueden confirmarla en su lugar.

Página de errores PHP
Filtre por gravedad u origen y busque un mensaje, un archivo o una página. Un error desplegado muestra la página, el controlador, las fechas, el mensaje completo y la pila de llamadas. Copiar el informe para un desarrollador copia un texto con las versiones de PrestaShop y PHP, el archivo, el origen, la página, las ocurrencias, el mensaje y la pila de llamadas. Silenciar sigue contando el error pero no vuelve a alertar sobre él.

Permisos
Un empleado cuyo perfil solo tiene el permiso ver en Supervisión y alertas consulta todas las pantallas en modo de solo lectura: los campos están desactivados y las acciones (lanzar, pausa, confirmar, ajustes) se rechazan.
Datos y privacidad
- Las direcciones de página se guardan sin parámetros de URL, y la pila de llamadas sin argumentos de funciones.
- La ruta del servidor y el nombre de la carpeta de administración se eliminan de todo texto guardado o enviado.
- Los tokens de bot y las rutas de webhook se ocultan en el registro de notificaciones.
- El historial se purga tras 30 días por defecto (7 a 365 días), en pequeños lotes; las alertas cerradas se guardan al menos 90 días.
Límites conocidos
- La comprobación de disponibilidad sale del propio servidor: no ve una caída de red o DNS exterior. El heartbeat externo cubre ese caso.
- Un error fatal producido antes de cargar los módulos no lo capta el gestor de errores; la comprobación de disponibilidad y la tasa de 5xx lo señalan.
- Las páginas Symfony del back office no pasan por el hook que capta los errores del back office.
- La conversión del checkout se basa en el hook
displayPaymentTop. Si su checkout en una página no lo llama, desactive este control: la caída de pedidos sigue activa.
Solución de problemas
La prueba de email falla
Revise la configuración en Parámetros Avanzados > Email y envíe una prueba desde esa página. El error exacto aparece tras la prueba y en la pestaña Alertas.
La página de inicio aparece caída aunque la tienda funciona
Probablemente el servidor no llega a su propia dirección pública. Rellene Dirección de conexión (por ejemplo 127.0.0.1:80) y haga clic en Guardar y probar las páginas ahora.
«No se ha detectado ningún cron del servidor» sigue apareciendo
Solo cuentan el cron por línea de comandos y la URL del cron. Ejecute el comando a mano por SSH: muestra un informe JSON. Si falla, compruebe la ruta de PHP CLI con su alojamiento.
La prueba del webhook responde «dirección rechazada»
La URL apunta a la red privada o al propio servidor. Use una dirección pública, o active Permitir un webhook en la red privada si su herramienta está alojada en su propia red.