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 |
Com Average ou Percentile, o painel Controls permite escolher pelo menos duas etapas para incluir no total. Mode utiliza as cinco etapas.
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
Use Controls para selecionar Average, Mode ou Percentile e habilitar Trendline ou Regression line.
Em PR Cycle Time Stages, escolha quais etapas de Coding, Pickup, Review, Merge e Deploy contribuem para o total. Mantenha pelo menos duas etapas selecionadas. Mode sempre utiliza as cinco etapas e desabilita a seleção de etapas. Salvar uma seleção de etapas diferente retorna ao card geral de PR Cycle Time.
Clique no botão de ajustes na barra Controls e selecione Save após escolher as opções. Consulte o guia de Controls para mais detalhes.
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.