Selecionar repositórios e sincronizar
Depois de conectar um provedor de código (GitHub ou Azure DevOps), você escolhe quais repositórios a plataforma vai acompanhar. Só os repositórios ativados geram métricas.
Visão geral#
A conexão dá à Mensor acesso de leitura aos seus repositórios, mas nada é sincronizado até você selecionar e ativar. Isso te dá controle: acompanhe apenas alguns repositórios ou todos, e ajuste a seleção quando quiser. Cada repositório ativado vira um destino de sincronização.
A plataforma lê somente metadados (PRs, reviews, commits, CI, etc.). O conteúdo do código-fonte não é armazenado, e o acesso é somente leitura.
Selecionar#
- Na tela de seleção, marque os repositórios desejados (você pode acompanhar apenas alguns ou todos).
- Clique em Ativar para confirmar.
Você pode ajustar a seleção depois em Integrações (ou na tela de Repositórios). Ativar mais repositórios dispara a sincronização deles; desativar para de acompanhá-los.
No Azure DevOps, os repositórios aparecem como org/projeto/repo por causa da hierarquia
organização › projeto › repositório. A busca ajuda quando há centenas de repos.
Acompanhar a sincronização#
Ao ativar, a plataforma dispara um full sync (primeira carga completa) por repositório, em segundo plano, e mostra o progresso em tempo real. Cada repositório passa por estes status:
| Status | O que significa |
|---|---|
| PENDING | Na fila, aguardando o worker iniciar |
| RUNNING | Importando dados (barra de progresso = itens processados / total) |
| DONE | Sincronização concluída |
| FAILED | Houve um erro (a mensagem é exibida; tente novamente) |
Quanto tempo leva#
A primeira carga roda em segundo plano e pode levar de alguns segundos a alguns minutos, dependendo do volume de histórico do repositório (quantidade de PRs, commits, runs de CI, etc.). Repositórios grandes e antigos demoram mais; você pode continuar usando o app enquanto o full sync roda.
O que é importado#
Para cada repositório ativo, a plataforma importa:
- Pull requests (com timestamps de ciclo).
- Reviews e comentários.
- Commits.
- Deployments.
- Workflow runs (CI / Actions).
- Issues e milestones.
- Projects v2 (sprints).
- Alertas de segurança (Dependabot + code scanning).
- CODEOWNERS.
Mantendo atualizado#
Após o full sync, webhooks processam novos eventos de forma incremental; você não precisa re-sincronizar manualmente. Métricas e dashboards refletem os dados mais recentes ao aplicar os filtros.
No Azure DevOps, o tempo real usa Service Hooks provisionadas automaticamente quando você ativa essa opção; veja Conectar o Azure DevOps.
Solução de problemas (FAQ)#
Um repositório ficou em FAILED#
A mensagem de erro é exibida no status. Tente novamente ativando o repositório de novo. Se persistir, verifique o status da integração em Integrações: se estiver EXPIRED ou ERROR, reconecte o provedor e repita a ativação.
O full sync está demorando muito#
É esperado para repositórios com histórico grande. O processo roda em segundo plano e segue de RUNNING para DONE conforme os itens são processados. Acompanhe a barra de progresso.
Ativei um repositório, mas não vejo métricas#
Aguarde o status chegar a DONE. As métricas aparecem conforme a primeira carga é concluída; depois disso, os webhooks mantêm tudo atualizado.
Quero parar de acompanhar um repositório#
Desative-o na seleção (em Integrações ou na tela de Repositórios). Ele deixa de gerar métricas novas.
Próximos passos#
- Abra o Overview e dashboards para ver as métricas.
- Organize seus times.
- Se usar planejamento, conecte o Jira e veja os insights do Jira.