# Salud del SDK

> Confirma que el SDK está recibiendo tráfico real de clientes y descubre rápido cuándo deja de reportar.

URL: https://docs.proteside.com/es/docs/guide/sdk-health

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.

*Imagen: Estado con atajos (1), dominios con tráfico real (2), indicadores de 48 h (3) y eventos por hora (4).*

## 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](https://docs.proteside.com/es/docs/guide/settings/pages), en los estados
  **SDK no detectado** y **Solo verificación sintética**.
* **Ajustes de protección**: [Protección del pago](https://docs.proteside.com/es/docs/guide/settings/payment-protection).

## 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](https://docs.proteside.com/es/docs/guide/settings/payment-protection): el modo está en el paso **Cómo debe reaccionar el SDK**, y el
modo desarrollador y el canal están en **Opciones para el equipo técnico**, en el mismo paso.

Los datos se agregan por hora. Recarga la página para actualizar.

## Verificación sintética
En los planes con reportes PCI DSS (Business y Enterprise), verificaciones periódicas, en el servidor y con navegador
automatizado, complementan el monitoreo continuo y cumplen la evaluación semanal exigida por el 11.6.1. Esas
verificaciones no cuentan como tráfico real: por eso la página muestra la **Última verificación sintética** aparte, y
una tienda que solo recibe esas verificaciones aparece como **Solo verificación sintética**.

## Alerta SDK silencioso
Si un dominio que venía recibiendo tráfico real se queda sin sesiones de cliente, Proteside abre, en un plazo de un día,
una alerta **SDK Silencioso** (severidad media) en [Alertas](https://docs.proteside.com/es/docs/guide/alerts), 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".

> **Nota**
>
> Si las sesiones se detienen porque el modo desarrollador está activado, la alerta puede abrirse igual.

Las tiendas con poco movimiento pueden pasar un día 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](https://docs.proteside.com/es/docs/guide/settings/payment-protection).

### 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](https://docs.proteside.com/es/docs/integration/verify).

### 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](https://docs.proteside.com/es/docs/integration/troubleshooting).

### 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.

## Próximos pasos
- [Verificar la instalación](https://docs.proteside.com/es/docs/integration/verify): Confirma en el navegador que el SDK está activo.
- [Solución de problemas](https://docs.proteside.com/es/docs/integration/troubleshooting): Causas comunes de un SDK silencioso o sin datos.
- [Alertas](https://docs.proteside.com/es/docs/guide/alerts): Atiende la alerta SDK silencioso.
