Git Analytics — Guia do usuário

Para que serve o módulo «Git Analytics»

O módulo coleta e mostra analytics dos seus projetos GitLab — pipelines, merge requests, commits e métricas de time — sem precisar abrir a interface web do GitLab. Todos os dados sincronizam para um banco local em um cronograma, então você continua trabalhando offline e tem visão unificada de vários projetos/times em uma única tela.

Apenas GitLab (cloud gitlab.com e self-hosted). GitHub está reservado como tipo de provedor no código, mas o adaptador ainda não está implementado.

O que você obtém:

Visão unificada de CI/CD — todo pipeline dos projetos selecionados em uma tabela com filtros por status e busca por branch.
Métricas de code review — Lead Time, Cycle Time e tempo de vida médio dos MR; taxa de sucesso de pipelines.
Estatísticas por desenvolvedor — commits, inserções/remoções, número de MR e comentários por contribuidor + métricas derivadas (velocity, impact, collaboration, delivery rate, cycle efficiency, work-life balance).
Revisão por IA dos MR novos — revisores IA configuráveis com prompt e provedor próprios, executados automaticamente ou sob demanda, com resultados salvos junto ao MR.
Cache local — os dados ficam no banco criptografado do YoBench, disponíveis para filtragem e análise sem rede.

Parâmetros de conexão do projeto

Ao adicionar um novo projeto você especifica:

Tipo de provedor — gitlab (atualmente a única opção funcional).
Nome de exibição — como o projeto aparece em filtros e tabelas.
Base URL — URL da API: https://gitlab.com para cloud ou sua URL self-hosted.
Caminho do projeto — por exemplo group/subgroup/project.
Token privado — token para a API do GitLab. Precisa de leitura no repositório, MRs e pipelines.
URL Git — URL de clone (HTTPS ou SSH); usada para processamento local parcial (leitura de diffs).
Chave SSH (opcional) — quando a URL Git é SSH.
Ativado — flag de atividade para a sincronização.
Auto-revisão de MR novos — quando ligado, MRs novos disparam automaticamente os revisores IA designados.

Configurações globais do módulo

Configuradas em Configurações → Git Analytics:

Ativar Git Analytics (gitAnalyticsEnabled) — interruptor principal do agendador. Desativado por padrão — enquanto não for ligado, projetos não sincronizam automaticamente.
Intervalo de sincronização (minutos) (gitAnalyticsPollMinutes) — com que frequência o agendador consulta a API. Padrão 60 minutos.

Tudo mais — tokens, revisores IA, auto-revisão — é configurado por projeto ou por revisor.

Revisores IA

A revisão por IA é construída em torno da entidade «revisor». Cada revisor tem:

Nome — exibido no dropdown Revisão ao lado de um MR.
Provedor IA — qual provedor do registro AI Chat usar.
Prompt — instruções para analisar o diff (estilo de revisão, áreas de foco, formato de saída).

Revisores são vinculados a projetos nas configurações. Com Auto-revisão ligado, na primeira sincronização de um MR novo:

O módulo busca o diff via API do GitLab.
Metadados do MR + diff são enviados aos revisores designados em sequência.
Cada resultado de revisão é salvo no banco e aparece no painel Revisão ao lado do MR.

Você também pode disparar uma revisão manualmente para qualquer MR — o botão Revisão abre um painel com seleção de revisor e resultado.

Recursos da UI

A tela principal tem quatro sub-abas Analytics.

Pipelines

Tabela de pipelines dos projetos selecionados no período.

Colunas: ID, branch, status (success / failed / running / canceled), source (push / merge / api), data de criação, duração.

Resumo no topo: total de pipelines, sucesso, falhos, taxa de sucesso, duração média.

Filtros: por status, busca por branch. Clicar em uma linha abre um painel com jobs e trace.

Merge Requests

Tabela de MR com métricas de ciclo de vida.

Colunas: #, título, autor, branch, estado, data de criação, data de merge, Lead Time, Cycle Time, número de comentários.

Resumo: MRs criados, mergeados, tempo de vida médio, merge rate.

Filtros: por estado (opened / merged / closed), busca por título ou branch. O botão Revisão roda ou exibe a revisão IA de um MR específico.

Project Stats

Métricas do projeto selecionado no período: commits, inserções/remoções, número de MR, pipelines, branches, contribuidores. Gráfico de atividade por dia.

People Stats

Tabela por contribuidor: commits, inserções, remoções, MRs criados, MRs mergeados, comentários. Ordenável por qualquer coluna. Métricas estendidas: velocity, impact, collaboration, delivery rate, cycle efficiency, work-life balance.

Filtros de período e projetos

Toolbar no topo da página:

Período — semana / mês / trimestre / ano / tudo. Padrão: mês.
Seletor de projetos — um ou vários; vazio significa «todos os projetos ativados».

Fluxo de uso

1. Adicione um projeto

Abra o módulo Git Analytics no menu lateral esquerdo.
Mude para a aba Configurações.
Clique em Adicionar projeto.
Preencha Base URL, Caminho, Token, Nome, URL Git.
Opcionalmente ative Auto-revisão de MR novos.
Salve.

2. Ative a sincronização automática

Em Configurações → Git Analytics ligue o interruptor principal e defina o intervalo em minutos. Sem ele, projetos só atualizam ao clicar em Sincronizar.

3. Sincronize os dados

Um botão Sincronizar no topo da página consulta todos os projetos ativados: puxa pipelines, MRs, commits e branches. O progresso aparece em Logs.

4. Explore as analytics

Alterne entre as sub-abas Pipelines / Merge Requests / Project Stats / People Stats. Aplique filtros de período e projetos.

5. Configure as revisões IA

Crie um revisor IA: nome, provedor IA, prompt.
Vincule o revisor a um projeto.
Ative Auto-revisão de MR novos — MRs futuros serão analisados automaticamente.
Para MRs existentes, use o botão Revisão na lista.

Próximos passos

Configure os provedores de IA — sem eles a revisão por IA não funciona.
Use o Tracker para gerenciar tarefas em paralelo à analytics de código.
Times grandes podem somar o Health Check para monitoramento separado de uptime das instâncias do GitLab.

Ajuda e feedback

Encontrou um bug ou quer pedir um adaptador para GitHub/Bitbucket? Escreva para nós pelo formulário de contato.