O que é a Funcionalidade PR Cycle Time?
O PR Cycle Time Dashboard fornece uma visão abrangente de quanto tempo leva para pull requests (PRs) progredirem do primeiro commit ao deploy. Ele divide o ciclo de vida do PR em cinco etapas-chave: Coding, Pickup, Review, Merge e Deploy. Isso permite que as equipes analisem cada fase em detalhe, identifiquem gargalos e otimizem seu pipeline de entrega.
Como Funciona
O PR Cycle Time mede o tempo total do primeiro commit até quando o pull request é implantado em produção. A métrica é dividida em cinco etapas:
| Etapa | Início | Fim |
|---|---|---|
| Coding | Primeiro commit | PR é criado |
| Pickup | PR é criado | Primeira interação de revisão (como comentário na discussão ou comentário inline no código) |
| Review | Primeira interação de revisão (como comentário na discussão ou comentário inline no código) | Revisão final antes do merge |
| Merge | Última atividade humana de revisão | PR é mergeado |
| Deploy | PR é mergeado | Commit de merge aparece na branch de deploy |
Cada etapa pode ser habilitada ou desabilitada individualmente no painel de Controles. Etapas desabilitadas são excluídas do total.
Se sua equipe não usa uma branch de deploy dedicada ou não conectou uma fonte de dados de deploy, a etapa de Deploy não será rastreada.
Métricas
PR Cycle Time
- O quê: Tempo total do primeiro commit ao deploy em produção.
- Como usar: Cycle times mais curtos significam entrega mais rápida. Rastreie a média ao longo do tempo para definir benchmarks e identificar onde o processo está desacelerando.
- Interface:
Coding Time
- O quê: Tempo do primeiro commit até a criação do PR.
- Como usar: Tempos de codificação longos geralmente indicam tarefas muito grandes. Dividi-las em partes menores reduz a complexidade e facilita as revisões.
- Interface:
Pickup Time
- O quê: Tempo de quando o PR é marcado como pronto para revisão até o primeiro revisor iniciar.
- Como usar: Tempos de pickup altos travam a entrega. Se consistentemente altos, ajuste as atribuições de revisão ou aumente a capacidade de revisores.
- Interface:
Review Time
- O quê: Tempo do primeiro comentário de revisão até a revisão final antes do merge.
- Como usar: Revisões estendidas indicam expectativas pouco claras ou gargalos de revisores. Padronizar o processo e definir diretrizes claras ajuda a manter essa etapa dentro do prazo.
- Interface:
Merge Time
- O quê: Tempo da última atividade de revisão até o PR ser mergeado.
- Como usar: Valores altos indicam fricção após a aprovação, atrasos de CI, filas de merge ou etapas manuais. Paralelizar execuções de CI ou reduzir verificações obrigatórias pode ajudar.
- Interface:
Deploy Time
- O quê: Tempo do merge do PR até o commit de merge aparecer na branch de deploy.
- Como usar: Tempos de deploy longos atrasam a entrega de valor aos usuários. Automatizar etapas do pipeline ou aumentar a frequência de deploy reduz significativamente esse tempo.
- Interface:
PR Cycle Time Dashboard
A funcionalidade de PR Cycle Time inclui um gráfico de barras que representa visualmente as diferentes métricas em um período selecionado. Cada barra representa uma decomposição das diferentes métricas para o período selecionado, que pode ser dividido em dias, semanas ou meses. Abaixo do gráfico, você encontra uma lista de todos os PRs. Se clicar na seta ao lado de um dos PRs, terá uma visão detalhada daquele PR.
Filtros
Use o Filtro de Squad para visualizar métricas de PR Cycle Time para squads individuais. Se quiser uma visão mais ampla de todas as equipes, selecione o filtro "Todos" para ver a distribuição de todos os squads de uma vez.
O Filtro de Data permite visualizar dados para períodos específicos. Você pode filtrar pelo último mês, trimestre ou 365 dias. Se precisar de controle mais granular, pode filtrar por um intervalo de datas personalizado.
Use o Filtro de Players para focar em membros individuais da equipe ou um grupo específico dentro do seu squad. Você pode selecionar um membro para uma visualização detalhada, um grupo de membros se formam um sub-squad, ou todos os membros para uma visão geral das métricas de PR Cycle Time de todo o squad.
Use o Filtro de Repositório para focar em repositórios específicos ou visualizar métricas de PR Cycle Time em todos os repositórios. Este filtro é particularmente útil para isolar padrões e desempenho em bases de código individuais, especialmente ao trabalhar em múltiplos repositórios. Examinar PR Cycle Time por repositório permite identificar gargalos, otimizar práticas de revisão e deploy, e garantir consistência em fluxos de trabalho em diferentes partes da sua base de código.
Use o Filtro de Tipo de Issue para focar em tipos específicos de issues, como Features, Bugs, Melhorias ou Hotfixes. Este filtro ajuda a rastrear quanto tempo leva para mover cada tipo de issue pelo ciclo de PR, da criação ao deploy. Monitorar esses tempos é especialmente importante para issues críticas como hotfixes e bugs, garantindo que sejam tratados e implantados rapidamente para manter estabilidade do produto e minimizar impacto nos usuários.
Controles no PR Cycle Time Dashboard
A barra lateral de Controles aprimora o PR Cycle Time Dashboard permitindo análise mais profunda dos dados de pull request através de métricas estatísticas avançadas como Média, Moda e Percentil. Essas métricas fornecem múltiplas perspectivas sobre duração de PR, ajudando as equipes a identificar padrões típicos de desempenho, detectar anomalias e entender distribuição de tempo ao longo do ciclo de vida do PR.
Além disso, os Controles permitem aos usuários personalizar o cálculo do PR Cycle Time habilitando ou desabilitando etapas individuais: Coding, Pickup, Review, Merge e Deploy. Quando uma etapa é desmarcada, sua duração é excluída do PR Cycle Time total.
O painel também inclui ferramentas visuais como Linha de Tendência e Linha de Regressão, que ajudam a destacar padrões de desempenho e previsões potenciais.
Explore Melhores Práticas
Conclusão
O PR Cycle Time Dashboard é uma ferramenta poderosa para rastrear e otimizar a eficiência do seu processo de pull request. Focando em cada etapa do ciclo de vida do PR, as equipes podem identificar gargalos, otimizar fluxos de trabalho e, em última análise, entregar valor aos usuários de forma mais rápida e confiável.