← Volver al blog
Observabilidad

Diagnósticos del widget: qué captura y por qué (con total transparencia)

8 min de lectura · Observabilidad

Cuando integrás el widget de Lumentia en tu web, querés saber exactamente qué se agrega, qué datos se mueven y por qué. Este post lo explica sin letra chica: todo es opt-in y está desactivado por defecto.

La idea: no se streamea nada, se guarda un búfer local

La observabilidad tradicional graba y envía todo, todo el tiempo. Lumentia hace lo contrario: el widget mantiene un búfer temporal en el navegador del visitante (los últimos ~60 segundos de consola, red, errores JS y grabación de pantalla). Si no pasa nada, ese búfer se descarta y no llega a ningún servidor.

Cuándo se envía algo

Solo bajo tres disparadores:

El envío usa sendBeacon (sobrevive al cierre de la pestaña) o fetch keepalive.

Qué se captura

Privacidad por diseño: enmascarado y retención

Antes de enviar, el widget enmascara claves sensibles en cuerpos y URLs: password, token, secret, api_key, authorization, cookie, card_number, etc.

En Lumentia, cada replay tiene vencimiento (TTL) —por defecto 30 días, luego se borra automáticamente— y una cuota mensual de minutos. Si se excede la cuota, se descarta el video y se conservan los logs de texto (lo esencial).

Correlación frontend ↔ backend

Para unir el error del navegador con el traceback de tu backend, el widget puede inyectar el header X-Lumentia-Session en las peticiones de tu app (same-origin siempre, cross-origin opt-in). Tu backend solo tiene que loguearlo.

Contexto de conversación

Además de los diagnósticos, podés inyectar contexto en el chat para que la IA responda mejor: campos automáticos (URL, título, idioma…) y contexto custom en runtime con window.Lumentia.pushContext({...}), con límites de tamaño controlados por Lumentia.

Quién controla qué

El resultado: una vista 360 (grabación + logs + errores + chat) sin sacrificar la privacidad de tus visitantes ni tu factura.