Visão Geral
Equipes de alto desempenho entregam valor continuamente, não apenas codando mais rápido, mas reduzindo fricção entre desenvolvimento e deploy. O relatório de Pull Request Cycle Time no DevStats fornece visibilidade total de como o trabalho se move do primeiro commit à produção, ajudando as equipes a identificar gargalos, medir desempenho de entrega e fazer melhorias orientadas por dados no seu fluxo de engenharia.
Por que Importa
O Pull Request Cycle Time mede o tempo entre o primeiro commit e o deploy.
Um cycle time mais curto significa entrega mais rápida e oportunidades mais frequentes para validar suposições, melhorar qualidade e reduzir risco.
Esta métrica é influenciada por vários fatores:
- Processo de revisão e disponibilidade de revisores
- Quantidade de trabalho em progresso
- Testes manuais ou handoffs de QA
- Dependências entre equipes
- Complexidade da base de código e troca de contexto
Cycle Time é uma métrica de nível de sistema, não uma medida de desempenho individual. Tempos mais longos para engenheiros seniores frequentemente indicam que estão lidando com trabalho mais complexo ou transversal, não ineficiência.
Requisitos de Configuração
Para começar a melhorar seu fluxo de PR no DevStats, certifique-se de que:
- Seu Provedor Git está conectado
- Pelo menos um squad está configurado
- Seus deploys estão sendo rastreados, automaticamente ou (opcional) através da API
- Seus incidentes estão sendo rastreados corretamente, via prefixo de branch, (opcional) Gerenciador de Incidentes ou API.
Usando o DevStats
Navegar pelo Dashboard
Abra o PR Cycle Time Dashboard na seção Fluxo.
Este dashboard fornece uma visão detalhada de como os pull requests progridem da criação ao deploy, permitindo que as equipes monitorem velocidade de entrega e eficiência do fluxo de trabalho em tempo real.
Entender as Etapas
Cada etapa no ciclo de vida do PR representa uma parte-chave do processo de desenvolvimento: Coding Time – do primeiro commit à criação do PR Pickup Time – da criação do PR até a primeira revisão Review Time – da primeira revisão até a última revisão Merge Time – da última revisão até o primeiro merge Deploy Time – do primeiro merge até o PR ser mergeado na branch de deploy
Essas métricas mostram onde o tempo está sendo gasto e ajudam a identificar qual fase contribui mais para o cycle time total.
Analisar Seus Dados
Use filtros por equipe, repositório ou intervalo de datas para focar sua análise em contextos específicos.
Combine esses filtros com o painel de Controles para selecionar medidas estatísticas (ex: Percentil 85) e visualizar como o desempenho de entrega evolui entre as etapas. Aprofunde-se em pull requests específicos para entender onde ocorrem atrasos e descobrir causas raízes como gargalos de revisão ou filas de merge longas.
Você também pode mudar a visualização do gráfico para o modo Scatter para visualizar pull requests individuais como pontos de dados.
Isso ajuda a identificar rapidamente outliers, como PRs que levaram significativamente mais tempo para completar, e discuti-los com sua equipe para analisar padrões ou causas subjacentes.
Exemplo: Analisando PR Cycle Time
No exemplo abaixo, estamos olhando o squad PiperChat nos últimos 30 dias, com todos os players e branches ativos incluídos.
O PR Cycle Time médio é de 5 dias e 20 horas, o que significa que, em média, leva pouco menos de seis dias para um pull request se mover da criação ao deploy.
Decomposição por Etapa
-
Coding Time (20h 58m) → Tempo gasto escrevendo código antes de abrir um pull request.
-
Pickup Time (1d 12h) → Tempo entre a criação do pull request e a primeira revisão.
-
Review Time (1d 4h) → Duração da primeira revisão até a aprovação ou merge.
-
Merge Time (7h 34m) → Tempo da aprovação até o merge em uma branch.
-
Deploy Time (1d 22h) → Tempo entre essa primeira branch e o merge na branch de deploy.
O gráfico codificado por cores mostra como cada etapa contribui para o PR Cycle Time total ao longo das semanas. Aqui, o Review Time aumentou 28%, sugerindo um gargalo na fase de revisão, enquanto o Deploy Time diminuiu 65%, indicando melhoria na eficiência de release.
Configuração Recomendada
Nas configurações do PR Cycle Time Dashboard, recomendamos selecionar o percentil 85 como medida estatística em vez da média padrão.
O percentil 85 fornece uma representação mais estável e realista do tempo de entrega, filtrando outliers de pull requests excepcionalmente longos ou curtos. Essa abordagem ajuda as equipes a definir expectativas baseadas em desempenho consistente em vez de casos excepcionais.
Você pode ajustar essa configuração no painel de Controles: Abra o painel → em Medida Estatística, selecione Percentil (85). Esta configuração alinha suas métricas de PR com as melhores práticas DORA, dando uma compreensão mais clara do desempenho típico de entrega e reduzindo ruído na análise de tendências de longo prazo.
Diagnosticando Gargalos
Tendências de Cycle Time frequentemente revelam ineficiências de processo. Neste exemplo:
- A etapa de Revisão é consistentemente a mais lenta, sugerindo feedback atrasado ou sobrecarga de revisores.
- Os tempos de Codificação e Merge permanecem estáveis, indicando que ritmo de desenvolvimento e fluxos de merge estão saudáveis.
- O Deploy Time caiu drasticamente, mostrando que melhorias em automação ou CI/CD aceleraram os releases.
Para otimizar ainda mais seu fluxo, revise o PR Size no Code Review Dashboard. Pull requests menores são mais fáceis de revisar, reduzem carga cognitiva e se movem pelo pipeline mais rápido. Como a fase de revisão é frequentemente o gargalo mais comum, manter PRs pequenos e focados ajuda a melhorar tanto a velocidade quanto a qualidade da entrega.
Você também pode usar o Aging Branches Report para monitorar trabalho em progresso e prevenir gargalos antes que aconteçam.
Cada ponto representa uma branch aberta — sua posição mostra a etapa atual (ex: Codificação, Revisão, Merge), enquanto a intensidade da cor indica há quanto tempo permanece ali. Clicando em um círculo, você pode ver informações detalhadas da branch, incluindo há quantos dias está aberta e em qual etapa está atualmente.
Esta visibilidade em tempo real permite que as equipes priorizem revisões e merges para branches mais antigas, garantindo um fluxo de entrega equilibrado e previsível.
Você também pode visitar a visualização de Benchmarks na seção Snapshot para comparar seu PR Cycle Time com padrões da indústria.
Isso ajuda a contextualizar o nível de desempenho da sua equipe, de Elite (<42 horas) a Precisa de Foco (>188 horas), e identificar metas de melhoria realistas baseadas em benchmarks globais de engenharia.
Tomando Ação
O DevStats ajuda você a transformar métricas em ações de melhoria:
- Use o PR Cycle Time Dashboard em retrospectivas para identificar etapas lentas.
- Revise o Aging Branches Report diariamente para manter o fluxo saudável.
- Defina metas claras de revisão e merge para sua equipe (ex: "Revisar dentro de 24h, Merge dentro de 2 dias").
- Combine insights com DORA metrics para conectar melhorias de fluxo de PR com desempenho real de entrega.
Visibilidade contínua permite decisões mais rápidas, menos atrasos e um caminho mais suave do código à produção.