Store health monitor
El monitor de salud de la tienda es un módulo opcional que vigila en segundo plano las señales operativas de tu tienda y te avisa cuando algo deja de funcionar. A diferencia de la auditoría de la tienda (comprobaciones de cumplimiento bajo demanda) y del registro de incidentes (un registro manual), este módulo se ejecuta según una programación y evalúa por sí mismo tres señales: errores fatales del front-end, la tasa de fallos en la finalización de compra y una anomalía de ventas (“hay tráfico pero no hay pedidos”).
La detección es pasiva: el módulo observa eventos reales de WooCommerce y el historial de pedidos. Nunca realiza pedidos sintéticos, por lo que no puede crear pedidos falsos ni cobrar tarjetas. La contrapartida es que un problema de pago se detecta una vez que lo encuentra un cliente real, no de forma proactiva.
Activar el módulo
Section titled “Activar el módulo”El módulo está desactivado de forma predeterminada. Actívalo en WooCommerce > Polski > Módulos (“Store health monitor”). Una vez activado, las comprobaciones se ejecutan cada 5 minutos mediante WP-Cron. El panel se encuentra en WooCommerce > Polski > Informes y herramientas > Store health. Requiere el permiso manage_woocommerce.
Sensores
Section titled “Sensores”| Sensor | Qué vigila |
|---|---|
| Errores fatales (front-end) | Errores fatales de PHP en las páginas de la tienda (controlador shutdown). Los errores fatales del administrador y del cron se ignoran. Se consideran activos durante 15 minutos tras producirse. |
| Finalización de compra / pagos | La proporción de finalizaciones de compra fallidas en las últimas 2 horas. Observa la finalización de compra clásica, la de bloques (Store API) y el estado de pedido “fallido”. |
| Anomalía de ventas | Compara los pedidos de la hora completa anterior con el número habitual para el mismo día de la semana y hora durante las últimas 8 semanas. Se evalúa como máximo una vez por hora. |
Estados
Section titled “Estados”| Estado | Significado | Color |
|---|---|---|
| OK | Todo está dentro del rango normal | verde |
| Degradado | Se ha superado un umbral, pero no es una caída total | naranja |
| Caída | Un problema grave (p. ej., un error fatal o ninguna venta) | rojo |
El estado general es el peor estado entre todos los sensores.
Cómo funcionan los umbrales
Section titled “Cómo funcionan los umbrales”- Finalización de compra / pagos: se genera una alerta cuando la tasa de fallos alcanza el umbral (30 % de forma predeterminada). Por encima de 1,5 veces el umbral, el estado escala de “Degradado” a “Caída”. La tasa se ignora hasta que se observa un número mínimo de finalizaciones de compra (5 de forma predeterminada).
- Anomalía de ventas: solo se informa de “Caída” cuando para esa hora es habitual al menos el número de pedidos del umbral (3 de forma predeterminada) pero no ha llegado ninguno en la última hora completa.
Alertas
Section titled “Alertas”Cuando el estado empeora respecto a la comprobación anterior, el módulo envía una alerta. Para un problema en curso, la alerta se repite solo tras un período de enfriamiento (60 minutos de forma predeterminada), de modo que no recibas avisos cada 5 minutos.
| Canal | Detalles |
|---|---|
| Correo electrónico | Se envía a la dirección de alertas (de forma predeterminada, el correo del administrador del sitio). |
| Webhook | Opcional. Envía una carga útil JSON {"text": ...} (compatible con Slack/Discord). |
Con un estado “Caída”, el evento también se registra en el registro de incidentes de seguridad, si ese módulo está activado, de modo que la caída tenga una traza de auditoría junto a los incidentes registrados manualmente.
El panel “Store health” muestra el estado general, la hora de la última comprobación (UTC) y una tabla con cada sensor, su estado y una línea de detalle. El botón Ejecutar comprobación ahora fuerza una evaluación inmediata. Cuando el estado no es “OK”, aparece un aviso de administrador con un enlace al panel.
Ajustes
Section titled “Ajustes”Los ajustes se encuentran en la tarjeta del módulo, en WooCommerce > Polski > Módulos.
| Ajuste | Predeterminado | Descripción |
|---|---|---|
| Correo electrónico de alertas | correo del administrador del sitio | Dónde enviar las alertas de salud. |
| URL del webhook de alertas | (vacío) | Webhook JSON opcional (Slack/Discord). |
| Umbral de fallos en la finalización de compra (%) | 30 | Alertar cuando esta proporción de finalizaciones de compra falle en las últimas 2 horas. |
| Muestra mínima de finalizaciones de compra | 5 | Ignorar la tasa de fallos hasta que se produzcan al menos estas finalizaciones de compra. |
| Umbral de anomalía de ventas | 3 | Alertar solo cuando este número de pedidos es habitual para la hora pero no llega ninguno. |
| Enfriamiento de alertas (minutos) | 60 | Tiempo mínimo entre alertas repetidas para un problema en curso. |
REST API
Section titled “REST API”GET /wp-json/polski/v1/store-healthDevuelve el estado actual (estado general, sensores, marca de tiempo de la comprobación). Requiere el permiso manage_woocommerce.
Resolución de problemas
Section titled “Resolución de problemas”Las alertas no llegan - comprueba la configuración de correo electrónico de WordPress. Considera un plugin SMTP (p. ej., WP Mail SMTP) en lugar del wp_mail() predeterminado.
El sensor de finalización de compra muestra “datos insuficientes” - es normal en tiendas con poco tráfico. La tasa solo se evalúa una vez que se alcanza la muestra mínima de finalizaciones de compra.
La anomalía de ventas nunca se activa - el módulo necesita el historial de pedidos de semanas anteriores para esa hora. En una tienda nueva, el valor habitual es bajo y no se alcanza el umbral.
Las comprobaciones no se ejecutan - WP-Cron se ejecuta con el tráfico del sitio. En tiendas con poco tráfico, considera un cron del sistema (wp-cron.php activado por el cron del servidor).
Informar de problemas: github.com/wppoland/polski/issues