Solución de Problemas
Esta página cubre los problemas más comunes al usar AICockpit Adoption y cómo resolverlos. La mayoría de los problemas están relacionados con la autenticación, la configuración del proveedor, el alcance de repositorios o la ausencia de datos sincronizados.
El Dashboard No Muestra Datos
Síntoma: El dashboard carga, pero muestra estados vacíos o ningún resultado de análisis.
Posibles causas y soluciones:
- Ninguna organización seleccionada — Seleccione una organización en el menú desplegable del encabezado. El dashboard solo carga datos para la organización activa.
- Proveedor no configurado — Abra Configuraciones y complete la configuración del proveedor antes de ejecutar la sincronización.
- Ningún repositorio seleccionado — Verifique que al menos un repositorio esté activo en la pestaña Repositorios de Configuraciones.
- Sincronización no ejecutada — El dashboard requiere un trabajo de sincronización completado para el período seleccionado. Acceda a Sincronización y ejecute un trabajo primero.
La Autenticación Permanece Cargando
Síntoma: La aplicación permanece en estado de carga después de que el flujo de inicio de sesión se completa.
Posibles causas y soluciones:
- URI de redirección incorrecta — La URI de redirección de SSO configurada para el entorno puede no coincidir con la URL de la aplicación. Comuníquese con su administrador para verificar la configuración.
- Flujo del proveedor de identidad incompleto — La sesión del navegador puede no haber completado la autenticación en el proveedor. Limpie el caché del navegador e intente nuevamente.
- Conflicto de sesión — Cierre cualquier sesión existente e intente iniciar sesión nuevamente.
La Validación del Proveedor o la Sincronización Falla
Síntoma: Guardar la configuración del proveedor o iniciar un trabajo de sincronización devuelve un error.
Posibles causas y soluciones:
- Nombre de workspace u owner incorrecto — Verifique el nombre del workspace o de la organización en la pestaña Proveedor de Configuraciones.
- Token inválido o expirado — Genere un nuevo token de acceso o contraseña de aplicación y actualícelo en Configuraciones.
- Permisos insuficientes en los repositorios — Confirme que el token tiene acceso de lectura a los repositorios seleccionados.
Los Repositorios No Aparecen
Síntoma: La lista de repositorios en Configuraciones está vacía después de guardar la configuración del proveedor.
Posibles causas y soluciones:
- Configuración del proveedor inválida — Un nombre de workspace incorrecto o un token expirado impide que la aplicación recupere el catálogo de repositorios. Verifique y guarde la configuración del proveedor nuevamente.
- Ningún repositorio en el workspace — Confirme que el workspace configurado contiene al menos un repositorio accesible con las credenciales proporcionadas.
La Atribución de los Colaboradores Parece Incompleta
Síntoma: El dashboard muestra la actividad de los repositorios, pero algunos colaboradores están ausentes o no son reconocidos.
Posibles causas y soluciones:
- Mapeo de usuarios ausente — Cargue un archivo CSV de mapeo en la pestaña Mapeo de Configuraciones para conciliar identidades del versionamiento con identidades de telemetría.
- Identidades incompatibles — Confirme que los valores de identidad del proveedor en el CSV coinciden exactamente con los nombres de usuario del repositorio y que los correos electrónicos mapeados corresponden a las identidades de telemetría esperadas por la aplicación.
¿Aún Necesita Ayuda?
Si el problema no está listado aquí o persiste después de seguir los pasos anteriores, comuníquese con el administrador de la plataforma o abra una solicitud de soporte a través del canal adecuado para su organización.