O que são Incidentes?
No DevStats, um incidente representa uma falha crítica de produção que exigiu remediação imediata, como um hotfix ou uma interrupção de serviço. O rastreamento preciso de incidentes é essencial para calcular duas métricas chave do DORA: Tempo Médio de Recuperação (MTTR) e Taxa de Falha de Mudança (CFR).
Como Funciona
O DevStats oferece os métodos abaixo para rastrear incidentes. Para calcular MTTR e CFR, usa a fonte configurada: Git Provider ou incidentes registrados. API e cadastro manual podem ser usados juntos.
| Método | Como funciona | Ideal para |
|---|---|---|
| Prefixo de branch | Detecta automaticamente branches com prefixos como hotfix/ ou bugfix/ do seu provedor Git |
Equipes que seguem convenções de nomenclatura de branches |
| PR Rollback | Detecta automaticamente Revert PRs merged no branch de deploy como incidentes | Equipes que usam o botão nativo de Revert do Git Provider |
| Interface Incident Management | Incidentes registrados manualmente através da interface DevStats, seja como incidentes resolvidos passados ou rastreamento ativo em tempo real | Equipes sem ferramentas de incidentes externas |
| API | Incidentes submetidos programaticamente de uma ferramenta externa através da API de Incidentes DevStats | Equipes com fluxos de trabalho de gerenciamento de incidentes existentes |
| Datadog | Sincroniza incidentes automaticamente da sua conta Datadog via API | Equipes que usam o Datadog como plataforma de gerenciamento de incidentes |
Quais dados são rastreados por incidente
| Campo | Descrição |
|---|---|
| Nome | Nome do incidente |
| Descrição | O que aconteceu |
| Repositório | O repositório afetado |
| started_at | Quando o incidente começou (ISO 8601) |
| resolved_at | Quando foi resolvido (ISO 8601) — se nulo, o incidente é considerado ativo |
| detected_by | Como foi detectado: monitoramento automatizado, clientes ou interno |
Como os incidentes afetam suas métricas
Para incidentes registrados, o MTTR é calculado como a média de resolved_at - started_at. Com Git Provider, o DevStats estima o intervalo de recuperação a partir dos PRs e deploys. Incidentes ativos sem resolved_at são excluídos até serem resolvidos. Quanto mais incidentes você rastrear e resolver, mais preciso seu MTTR se torna.
A Taxa de Falha de Mudança conta PRs classificados como hotfix/bug, PRs de rollback ou incidentes registrados, conforme a configuração. Veja Métricas DORA para o cálculo completo da CFR.
Rastrear Incidentes
Detecte incidentes automaticamente a partir de convenções de nomenclatura de branches como hotfix/ ou bugfix/.
Interface Incident ManagementRegistre incidentes resolvidos ou declare e rastreie incidentes ativos em tempo real através da interface DevStats.
API de IncidentesSubmeta e atualize incidentes programaticamente de suas ferramentas existentes.
PR RollbackDetecte incidentes automaticamente a partir de Revert PRs merged no branch de deploy, sem configuração de prefixo de branch.
DatadogSincronize incidentes automaticamente do Datadog para alimentar CFR e MTTR no DevStats.