Docs/Casos de Uso/Rastreamento de incidentes

Rastreamento de incidentes

Visão Geral

O DevStats pode detectar e calcular automaticamente a Change Failure Rate vinculando deploys e incidentes através dos seus fluxos de trabalho existentes. As equipes podem adaptar este processo com base no seu nível atual de automação e práticas de desenvolvimento.

Usando Prefixos de Branch

Se sua equipe usa padrões de nomenclatura de branches, o DevStats pode detectar e classificar automaticamente correções de produção com base nos prefixos selecionados. Na aba Configurações → Incidentes, você pode configurar as Configurações de Incidentes para definir quais prefixos representam branches de recuperação de produção.

As equipes podem optar por rastrear:

  • Ambos hotfix + bugfix,
  • Apenas hotfix, ou
  • Apenas bugfix.

Esses prefixos ajudam o DevStats a reconhecer quando um deploy foi acionado para resolver um problema ou defeito, fornecendo uma maneira simples e consistente de detectar falhas relacionadas à produção.

Você também pode aplicar essas regras de prefixo a todos os repositórios ou selecionar repositórios específicos, dando às equipes flexibilidade para alinhar o rastreamento com sua estrutura de deploy.

bugfix e hotfix servem propósitos diferentes: um bugfix aborda problemas menores para releases futuros, enquanto um hotfix tem como alvo problemas críticos de produção que requerem deploy imediato. Apenas hotfixes devem ser contados como incidentes.

Gerenciando Incidentes no DevStats

As equipes podem gerenciar incidentes automaticamente via API de Incidentes ou manualmente através do Incident Management, dependendo do seu fluxo de trabalho e nível de automação. Ambas as opções garantem dados precisos e rastreáveis para cálculos de Change Failure Rate e MTTR.

Para equipes com pipelines automatizados, a API de Incidentes pode ser usada para registrar incidentes programaticamente e associá-los a deploys específicos. Isso permite rastreamento em tempo real de falhas e resoluções, fornecendo cálculos de Change Failure Rate mais precisos e atualizados.

Se a automação ainda não está implementada, incidentes também podem ser criados manualmente no Incident Management. Neste caso, as equipes podem atribuir incidentes à equipe de produto ou funcionalidade relevante, mantendo responsabilidade e transparência para correções de produção.

Distinguindo Tipos de Correção

É importante distinguir entre uma correção simples e um hotfix. Uma correção simples aborda um problema ou bug menor que não impacta a produção ou pode esperar pelo próximo ciclo de release, enquanto um hotfix tem como alvo um defeito crítico de produção que requer deploy imediato. Apenas o último deve ser contado na Change Failure Rate, pois reflete um incidente afetando usuários finais ou confiabilidade do sistema.

Tabela Resumo

Método Descrição Ideal Para Notas
Prefixos de Branch (hotfix, bugfix) O DevStats detecta automaticamente branches com esses prefixos para classificar deployments que corrigem issues anteriores. Equipes que seguem convenções consistentes de nomenclatura Git. Ideal para automação simples sem configuração adicional. Ajuda a distinguir entre correções de rotina e hotfixes críticos.
API de Incidentes Incidentes são reportados ao DevStats via chamadas de API, que informam a plataforma sobre falhas e seus deployments relacionados. Equipes com automação CI/CD ou sistemas de monitoramento. Permite rastreamento contínuo de falhas e tempos de recuperação. Recomendado para equipes maduras que buscam dados precisos e automatizados.
Gerenciamento de Incidentes (Manual) Incidentes são declarados manualmente no dashboard do DevStats. Equipes sem automação ou em início de adoção DORA. Permite entrada manual de incidentes e atribuição à equipe de produto ou feature responsável para accountability.