Solução de Problemas
Esta página cobre os problemas mais comuns ao usar o AICockpit Adoption e como resolvê-los. A maioria dos problemas está relacionada à autenticação, à configuração do provedor, ao escopo de repositórios ou à ausência de dados sincronizados.
O Dashboard Não Mostra Dados
Sintoma: O dashboard carrega, mas exibe estados vazios ou nenhum resultado de análise.
Possíveis causas e soluções:
- Nenhuma organização selecionada — Selecione uma organização no menu suspenso do cabeçalho. O dashboard só carrega dados para a organização ativa.
- Provedor não configurado — Abra Configurações e conclua a configuração do provedor antes de executar a sincronização.
- Nenhum repositório selecionado — Verifique se pelo menos um repositório está ativo na aba Repositórios de Configurações.
- Sincronização não executada — O dashboard requer um job de sincronização concluído para o período selecionado. Acesse Sincronização e execute um job primeiro.
A Autenticação Fica Carregando
Sintoma: A aplicação permanece em estado de carregamento após o fluxo de login ser concluído.
Possíveis causas e soluções:
- Redirect URI incorreta — A redirect URI de SSO configurada para o ambiente pode não corresponder à URL da aplicação. Entre em contato com seu administrador para verificar a configuração.
- Fluxo do provedor de identidade incompleto — A sessão do navegador pode não ter concluído a autenticação no provedor. Limpe o cache do navegador e tente novamente.
- Conflito de sessão — Saia de qualquer sessão existente e tente fazer login novamente.
A Validação do Provedor ou a Sincronização Falha
Sintoma: Salvar as configurações do provedor ou iniciar um job de sincronização retorna um erro.
Possíveis causas e soluções:
- Nome de workspace ou owner incorreto — Verifique o nome do workspace ou da organização na aba Provedor de Configurações.
- Token inválido ou expirado — Gere um novo token de acesso ou app password e atualize-o nas Configurações.
- Permissões insuficientes nos repositórios — Confirme que o token tem acesso de leitura aos repositórios selecionados.
Os Repositórios Não Aparecem
Sintoma: A lista de repositórios em Configurações está vazia após salvar a configuração do provedor.
Possíveis causas e soluções:
- Configuração do provedor inválida — Um nome de workspace incorreto ou um token expirado impede a aplicação de recuperar o catálogo de repositórios. Verifique e salve as configurações do provedor novamente.
- Nenhum repositório no workspace — Confirme que o workspace configurado contém pelo menos um repositório acessível com as credenciais fornecidas.
A Atribuição dos Contribuidores Parece Incompleta
Sintoma: O dashboard exibe a atividade dos repositórios, mas alguns contribuidores estão ausentes ou não são reconhecidos.
Possíveis causas e soluções:
- Mapeamento de usuários ausente — Faça upload de um arquivo CSV de mapeamento na aba Mapeamento de Configurações para reconciliar identidades do versionamento com identidades de telemetria.
- Identidades incompatíveis — Confirme que os valores de identidade do provedor no CSV correspondem exatamente aos usernames do repositório e que os e-mails mapeados correspondem às identidades de telemetria esperadas pela aplicação.
Ainda Precisa de Ajuda?
Se o problema não estiver listado aqui ou persistir após seguir os passos acima, entre em contato com o administrador da plataforma ou abra uma solicitação de suporte pelo canal adequado para sua organização.