Docs/Ferramentas/Incident Management

Incident Management

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.

Como Funciona

O Incident Management alimenta diretamente o cálculo do MTTR nas DORA metrics. Cada incidente tem um horário de início e fim, e o DevStats usa a diferença entre eles para calcular o Tempo Médio de Recuperação (MTTR).

Campo Descrição
started_at Quando o incidente começou
resolved_at Quando o incidente foi resolvido

O MTTR é calculado como a média de resolved_at - started_at em todos os incidentes resolvidos. 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:

Como: Criar Incidentes Resolvidos (Opção 1)

Passo 1: Navegue até a aba "Incidentes Resolvidos". Clique no botão "Criar Incidente Resolvido" para começar a registrar o incidente.

Passo 2: Preencha os detalhes do incidente. Insira o nome do incidente, uma descrição, a data de início e fim, e o repositório relacionado. Indique como o incidente foi detectado:

  • Monitoramento automatizado: Detectado por ferramentas que monitoram sua aplicação.
  • Clientes: Reportado por um cliente com problemas.
  • Interno: Identificado por um membro da equipe.

Passo 3: Salve o incidente. Clique em "Salvar" para registrar o incidente resolvido. Ele será instantaneamente incluído no cálculo do MTTR.

Como: Declarar e Rastrear Incidentes Ativos (Opção 2)

Passo 1: Navegue até a aba "Incidentes Ativos". Clique no botão "Declarar Incidente Ativo" para começar a registrar o incidente.

Passo 2: Preencha os detalhes do incidente. Insira o nome do incidente, uma descrição, o status, a data de início e o repositório relacionado. Indique como o incidente foi detectado:

  • Monitoramento automatizado: Detectado por ferramentas que monitoram sua aplicação.
  • Clientes: Reportado por um cliente com problemas.
  • Interno: Identificado por um membro da equipe.

Passo 3: Salve o incidente. Clique em "Salvar" para registrar o incidente ativo no sistema.

Passo 4: Marque o incidente como resolvido. Clique no botão "Editar" do incidente que deseja atualizar. Altere o status para "Resolvido" e defina o campo "Resolvido Em" com a data e hora corretas da resolução. Uma vez salvo, a métrica MTTR será atualizada de acordo.

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.