Timeline e historico

A timeline e um registro cronologico de tudo que acontece durante um incidente. Ela fornece uma trilha de auditoria completa para postmortems, revisoes de compliance e transparencia operacional.

O que e registrado

Toda acao significativa em um incidente gera um evento na timeline:

Tipo de evento	Descricao
Mudanca de status	Incidente movido para um novo status (ex: Investigando para Identificado)
Mudanca de severidade	Severidade do incidente atualizada (ex: P2 elevado para P1)
Atribuicao de Comandante	Um novo Comandante e atribuido ou reatribuido
Atribuicao de Responder	Um Responder e adicionado ou removido do incidente
Comentario	Um membro da equipe adiciona uma nota ou atualizacao
Atualizacao externa	Atualizacao de status page publicada ou notificacao de stakeholder enviada
Evento de integracao	Atividade de ferramentas conectadas (Jira, Slack, PagerDuty, etc.)

Visualizando a timeline

Abra qualquer pagina de detalhes do incidente e role ate a secao Timeline. Os eventos sao exibidos em ordem cronologica inversa com os mais recentes no topo.

Cada evento mostra:

• Timestamp -- data e hora exata em UTC, com seu fuso horario local exibido ao lado.
• Ator -- o usuario ou sistema que acionou o evento.
• Descricao -- resumo legivel do que aconteceu.
• Metadados -- contexto adicional como valores anteriores e novos para mudancas.

Adicionando comentarios

Qualquer membro da equipe atribuido ao incidente pode adicionar comentarios. Comentarios suportam formatacao markdown e podem incluir blocos de codigo, links e imagens.

Comentarios sao uteis para:

• Compartilhar descobertas da investigacao conforme surgem.
• Registrar decisoes e suas justificativas.
• Fornecer estimativas e atualizacoes de progresso.
• Documentar workarounds que foram tentados.

Filtros e busca

Use a barra de filtros acima da timeline para estreitar eventos por tipo:

• Filtre por tipo de evento (mudancas de status, comentarios, atribuicoes, etc.).
• Filtre por ator para ver apenas acoes de um membro especifico da equipe.
• Pesquise dentro de comentarios e descricoes usando busca de texto completo.

Timeline em postmortems

Quando voce cria um postmortem a partir de um incidente, o Batida importa a timeline completa como referencia. Isso da ao autor do postmortem um registro completo para trabalhar, reduzindo o tempo necessario para reconstruir o que aconteceu.

Acesso via API

Recupere eventos da timeline programaticamente:

GET /api/v1/incidents/{incident_id}/timeline
Authorization: Bearer <token>

Resposta:

{
  "events": [
    {
      "id": "evt_001",
      "type": "status_change",
      "actor": "usr_abc123",
      "description": "Status alterado de Investigando para Identificado",
      "previous_value": "investigating",
      "new_value": "identified",
      "created_at": "2026-04-20T14:45:00Z"
    }
  ],
  "pagination": {
    "total": 24,
    "page": 1,
    "per_page": 50
  }
}