Diagnóstico por síntoma
Empieza por alcance, versión y política. No resuelvas un vacío habilitando captura amplia ni compartiendo secretos.
En esta página
No veo datos o no puedo consultar
| Síntoma | Comprueba | Evita |
|---|---|---|
| Sin proyectos | Invitación, usuario activo y grant exacto de org/proyecto/entorno. | Asumir que login o rol admin concede datos. |
| Ventana vacía | Fechas UTC de recepción, entorno y filtros. Captura/habilitación pueden ser desconocidas. | Concluir que está sano o que no existen errores. |
| 401 / 403 | Sesión vigente, scope y revocación/expiración. | Usar credenciales de otra persona para saltar el límite. |
| 400 / cursor inválido | Reinicia desde la primera página con filtros coherentes; el cursor liga el scope y expira. | Reutilizarlo en otra organización, entorno o stream. |
| 429 | Reduce concurrencia/ventana y espera según el contrato. | Lanzar un bucle de reintentos ilimitado. |
| 501 / 503 | Habilitación, readiness y disponibilidad con el responsable. | Mostrar éxito vacío o activar flags desde un navegador. |
El SDK está inactivo o no envía
| Síntoma | Siguiente comprobación |
|---|---|
| reason=ssr | Instala en el navegador; no dentro de una solicitud de servidor. |
| invalid_config | Revisa tipos/campos, política local, rutas y origen. No vuelques el objeto si contiene secretos. |
| already_installed | Identifica el registro antiguo, detén y reinstala explícitamente; otro bundle no amplía sus métodos. |
| Logs rechazados | structuredLogs, nivel mínimo, código/atributos permitidos y grant de ingest del servidor. |
| Counters cero | Cobertura de ruta, instalación a tiempo, muestreo, consentimiento/política y generación realmente instalada. |
| failed / ACK inválido | CSP/CORS, red, cuota, timeout, shape ACK/batchId y versión de collector; sin bodies/headers en logs de diagnóstico. |
| Offline o cierre | La cola es volátil. No prometas recuperar datos después del cierre o crash. |
En Node, installNodeSDK inactivo sigue ejecutando la función del host. En navegador, el fallo del collector no debe impedir que la aplicación continúe. Un contador local de envío no es una prueba de salud.
El formulario no aparece o conserva una sesión anterior
- Revisa elegibilidad real, scope, expiry/revision, ABI, origen exacto y contrato de transporte. El endpoint gestionado vigente no es universal.
- Confirma que el adaptador notificó síncronamente el cambio de sesión/organización. Debe destruir pendientes/drafts antes del nuevo montaje.
- Distingue bootstrap local instalado de iframe remoto. Un asset nuevo no añade permisos ni corrige código del host antiguo.
- Comprueba el sandbox para apertura externa del footer y la CSP de frames. No añadas navegación superior, wildcard de origen o permisos nuevos para ocultar una incompatibilidad.
- No consideres aceptado un reporte con timeout. Conserva el ID sólo si el contenido no cambió y vuelve a revisar la sesión antes de reintentar.
Pedir ayuda con contexto seguro
Comparte por el canal autorizado: versión/pin y hash del artefacto, scope permitido, plantilla de ruta, hora/ventana y código de error. Si tu equipo permite IDs técnicos, usa sólo los necesarios. No adjuntes credenciales, cookies, cuerpos, datos clínicos ni mensajes de clientes no aprobados.