O que é a Detecção por Prefixo de Branch?
A detecção por prefixo de branch é o método padrão que o DevStats usa para identificar incidentes automaticamente do seu provedor Git. Quando um pull request é mergeado de uma branch com um prefixo configurado, o DevStats o registra como um incidente e o usa para calcular sua Taxa de Falha de Mudança (CFR) e Tempo Médio de Recuperação (MTTR).
Nenhuma entrada manual é necessária. Desde que sua equipe siga convenções de nomenclatura de branches, os incidentes são capturados automaticamente.
Prefixos Suportados
Por padrão, o DevStats detecta os seguintes prefixos:
| Prefixo | Exemplo de branch |
|---|---|
hotfix/ |
hotfix/login-crash |
bugfix/ |
bugfix/payment-timeout |
Ambos podem ser habilitados simultaneamente ou individualmente. A configuração é feita em Configurações → Incidentes.
Hotfix vs Bugfix
Embora ambos os prefixos sejam suportados, recomendamos usar apenas hotfix/ como sua convenção de incidentes. Veja o motivo:
| Hotfix | Bugfix | |
|---|---|---|
| Propósito | Corrige um problema crítico já em produção | Corrige um problema não crítico para um próximo release |
| Urgência | Imediato, implantado diretamente em produção | Planejado, parte de um ciclo de release normal |
| Conta como incidente | Sim | Não recomendado |
| Afeta MTTR | Sim | Infla o MTTR com correções não críticas |
| Afeta CFR | Sim | Infla o CFR com falhas fora de produção |
Usar bugfix/ como prefixo de incidente infla tanto o MTTR quanto o CFR com correções que nunca foram emergências de produção, tornando suas métricas DORA menos precisas.
Como Configurar
1. Vá para Configurações → Incidentes
2. Em Prefixo de Branch, selecione os prefixos que deseja usar como indicadores de incidente:
- Hotfix + Bug: ambos os prefixos contam como incidentes
- Apenas Hotfix: recomendado
- Apenas Bug
3. Você pode aplicar a configuração globalmente ou por repositório.
Recomendamos usar Apenas Hotfix para manter suas métricas MTTR e CFR focadas em incidentes reais de produção.