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:
- Un error de JavaScript o una promesa rechazada.
- Una respuesta HTTP 4xx/5xx de tu propia API.
- El visitante abre el chat o envía un mensaje.
El envío usa sendBeacon (sobrevive al cierre de la pestaña) o fetch keepalive.
Qué se captura
- Consola del navegador.
- Red (fetch/XHR): método, URL, payload y respuesta.
- Errores JS no capturados, con su stack.
- Grabación de pantalla (rrweb), con los campos de formulario enmascarados.
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é
- Vos: habilitás/deshabilitás diagnósticos y contexto, y elegís qué capturar.
- Lumentia: ventana de retención, cuota mensual, TTL y límites de contexto (por plan/cliente), para protegerte de costos y abusos.
El resultado: una vista 360 (grabación + logs + errores + chat) sin sacrificar la privacidad de tus visitantes ni tu factura.