Proteside Salud del SDK
Confirma que el SDK está recibiendo tráfico real de clientes y descubre rápido cuándo deja de reportar.
La protección solo existe donde se ejecuta el SDK. La página Salud del SDK muestra si el SDK está reportando tráfico real de clientes en las páginas de pago, separado de la verificación sintética que hace Proteside, y qué dominios dejaron de reportar.
Estado del SDK
La franja de la parte superior (1) muestra el estado actual, con la fecha de la Última sesión de cliente y de la Última verificación sintética.
| Estado | Significado | Qué hacer |
|---|---|---|
| SDK activo | Sesiones reales de clientes reportaron en las últimas 24 horas. | Nada. |
| SDK silencioso | Hay historial de tráfico real, pero ninguna sesión de cliente en las últimas 24 horas. | Revisa si el snippet sigue publicado (ver abajo). |
| SDK no detectado | Todavía no se recibió ningún evento. | Instala el snippet en las páginas de pago. |
| Solo verificación sintética | Solo el verificador sintético de Proteside envió eventos; ningún cliente real pasó por el checkout con el SDK. | Revisa si el snippet está publicado en el checkout de producción. |
| SDK en pausa (modo desarrollador) | El modo desarrollador está activado y el SDK no ejecuta protecciones. | Desactiva el modo desarrollador en Protección del pago cuando termines las pruebas. |
Los atajos de la derecha llevan a:
- Alerta de SDK silencioso abierta…: la alerta abierta, cuando existe.
- Ver instalación: el snippet de instalación, en Páginas y Dominios, en los estados SDK no detectado y Solo verificación sintética.
- Ajustes de protección: Protección del pago.
Dominios con tráfico real
El cuadro Dominios con tráfico real (2) lista los dominios que tuvieron sesiones de clientes en los últimos 30 días, sin contar la verificación sintética:
- Reportando: hubo una sesión en las últimas 24 horas.
- Sin sesiones en 24 h: el dominio dejó de reportar. Normalmente hay una alerta SDK Silencioso abierta para él.
Las columnas Última sesión y Sesiones (30 d) ayudan a ver si el dominio tenía movimiento antes de detenerse.
Indicadores de las últimas 48 horas
Los cuatro indicadores (3) suman las últimas 48 horas de tráfico real:
- Eventos (48 h): todo lo que envió el SDK.
- Sesiones (48 h): envíos que incluyeron una vista de página. Es una aproximación, no el número exacto de visitantes.
- Lecturas de encabezados (48 h): lecturas de los headers de seguridad de la página, que se usan en las evidencias PCI DSS.
- Reportes CSP (48 h): reportes de violación de CSP recibidos.
Eventos por hora
El gráfico Eventos por hora (4) tiene una barra por hora en las últimas 48 horas, en la zona horaria de la tienda. Las barras vacías significan que no hubo ninguna sesión en esa hora. Pasa el mouse sobre una barra para ver los eventos, las sesiones, los headers y los reportes CSP de esa hora.
Un hueco en el gráfico durante el horario comercial es señal de que algo cambió en el sitio, como una publicación que quitó el snippet.
Versiones del SDK
El cuadro Versiones del SDK muestra las versiones vistas en los últimos 7 días, con la cantidad de eventos y cuándo se vio cada una por última vez. El conteo viene de una muestra de los eventos, así que sirve para comparar versiones, no como total.
Más de una versión activa suele deberse a la caché del navegador o del CDN después de una actualización. Si sigue así durante días, verifica si alguna página tiene un snippet antiguo.
Configuración
El cuadro Configuración muestra el Canal de release (stable o latest), el Modo desarrollador y el Modo de protección (Monitorear o Bloquear). Para cambiarlos, ve a Protección del pago.
Los datos se agregan por hora. Recarga la página para actualizar.
Verificación sintética
En los planes con reportes PCI DSS (Standard en adelante), Proteside visita periódicamente el checkout de la tienda con un navegador propio, sin sesión de cliente. Esa visita confirma que el snippet está en la página, pero no cuenta como tráfico real: por eso la página muestra la Última verificación sintética aparte, y una tienda que solo recibe esa visita aparece como Solo verificación sintética.
Alerta SDK silencioso
Cada hora, Proteside verifica los dominios que tuvieron tráfico real en los últimos 30 días. Si alguno pasa 24 horas sin ninguna sesión de cliente, abre una alerta SDK Silencioso (severidad media) en Alertas, una por dominio, y envía la notificación a los canales configurados.
Cuando vuelve el tráfico, la alerta se resuelve automáticamente, con la indicación "Resuelta automáticamente".
La verificación solo se ejecuta para tiendas activas y con la suscripción al día. No tiene en cuenta el modo desarrollador: si las sesiones se detienen con el SDK en pausa, la alerta puede abrirse igual.
Las tiendas con poco movimiento pueden pasar 24 horas sin clientes reales en el checkout. En ese caso, confirma la instalación y resuelve o silencia la alerta.
Cuando el SDK aparece silencioso o no detectado
Revisa el modo desarrollador
En el cuadro Configuración, verifica si el Modo desarrollador está Activado. Si lo está, el SDK está en pausa: desactívalo en Protección del pago.
Abre el checkout
Abre la página de pago de la tienda en una ventana de incógnito y verifica que el snippet esté en el código de la página. Las publicaciones de tema, los cambios de plataforma y los cambios en el gestor de etiquetas suelen quitar el snippet.
Prueba en el navegador
En la consola del navegador, ejecuta Proteside.getStatus() y verifica que initialized sea true. El paso a paso
está en Verificar la instalación.
Investiga la causa
Si el SDK carga pero no llega nada al dashboard, las causas más comunes son una clave del SDK cambiada, una CSP que bloquea la comunicación con Proteside o una suscripción inactiva. Consulta Solución de problemas.
Recarga la página
Los datos se agregan por hora. Después de la corrección, haz una compra de prueba o entra al checkout y recarga la Salud del SDK en algunos minutos.
Quién puede verla
Todos los roles de la tienda ven esta página. Es de solo lectura.