O que é a Funcionalidade Incident Management?
A Ferramenta de Incident Management permite que equipes sem software dedicado de gerenciamento de incidentes rastreiem e resolvam incidentes diretamente no DevStats. Isso garante o cálculo preciso de métricas-chave como o Tempo Médio de Recuperação (MTTR), um componente crítico do Dashboard de DORA Metrics.
Ao declarar incidentes ativos e marcá-los como resolvidos, as equipes podem manter um registro confiável do tratamento de incidentes e tempos de resposta. Esta ferramenta é projetada para equipes que desejam melhorar seu processo de resposta a incidentes e monitorar seu MTTR de forma eficaz, mesmo sem ferramentas externas.
Pré-requisitos para Criação Manual
- Abra Settings → Incidents.
- Selecione API or DevStats Incident Management como fonte de incidentes.
- Clique em Save Settings e abra Incidents.
Essa fonte permite tanto o envio via API quanto o gerenciamento manual. Não é necessário um token de API para criar incidentes pela interface. Os botões Declare Active Incident e Create Resolved Incident ficam ocultos quando a fonte selecionada é Git Provider, Incident.io ou Datadog.
Como Funciona
O Incident Management alimenta diretamente o cálculo do MTTR nas DORA metrics. Para cada incidente resolvido elegível, o DevStats usa a diferença entre os horários de início e resolução para calcular o tempo de recuperação.
| Campo | Descrição |
|---|---|
| started_at | Quando o incidente começou |
| resolved_at | Quando o incidente foi resolvido |
Com Average selecionado, o MTTR é a média de resolved_at - started_at dos incidentes resolvidos elegíveis. O incidente deve corresponder aos filtros de repositório/squad, começar no início do período selecionado ou depois dele e ser resolvido até o fim desse período. Incidentes sem data de resolução são considerados ativos e excluídos do cálculo até serem resolvidos.
Incidentes podem ser criados de três formas:
| Método | Quando usar |
|---|---|
| Incidentes Resolvidos (interface) | Registrar incidentes que já foram detectados e resolvidos |
| Incidentes Ativos (interface) | Declarar e rastrear incidentes em tempo real conforme ocorrem |
| API | Enviar incidentes programaticamente de uma ferramenta externa de gerenciamento de incidentes |
Usando a Interface do DevStats
O DevStats oferece duas opções para gerenciar incidentes pela interface do usuário:
Usando a API do DevStats
Se você usa uma ferramenta externa de gerenciamento de incidentes, pode enviar e atualizar incidentes programaticamente via API do DevStats. Isso permite integrar o rastreamento de incidentes diretamente nos seus fluxos de trabalho existentes sem usar a interface do DevStats.