Confluence e Notion

Crie automaticamente páginas de postmortem no Confluence ou Notion após a resolução de um incidente, documentando a timeline, causa raiz e itens de ação.

Visão geral

Assim que um incidente é marcado como resolvido no Batida, um documento de postmortem é gerado e publicado na sua base de conhecimento configurada. Isso garante que todo incidente seja documentado sem esforço manual dos respondentes.

Templates de postmortem

Você pode personalizar o template de postmortem usado para as páginas geradas. Templates suportam variáveis como \<%= incident.title %>, \<%= incident.id %>, \<%= incident.duration %> e \<%= timeline %> para conteúdo dinâmico.

Configuração do Confluence

Pré-requisitos

• Um site Confluence Cloud (server/data center não é suportado)
• Um API token gerado em configurações da conta Atlassian

Configuração

1. Vá em Configurações > Integrações > Confluence no painel do Batida.
2. Insira a URL do site Confluence (ex.: https://sua-equipe.atlassian.net/wiki).
3. Insira seu email e API token do Confluence.
4. Selecione a página pai onde as páginas de postmortem serão criadas.
5. Escolha o template de postmortem (padrão ou personalizado).
6. Clique em Salvar e Verificar.

URL do site:  https://sua-equipe.atlassian.net/wiki
Email:        voce@empresa.com
API Token:    ATATT3xFfGF0...
Página Pai:   Postmortems (ID: 123456)

Estrutura da página gerada

# Postmortem: INC-42 - Pico de latência na API

## Resumo
Breve descrição do impacto do incidente.

## Timeline
| Hora (UTC) | Evento |
|------------|-------|
| 14:30 | Incidente aberto |
| 14:35 | Investigador atribuído |
| 14:50 | Causa raiz identificada |
| 15:10 | Mitigação aplicada |
| 15:30 | Incidente resolvido |

## Causa Raiz
...

## Itens de Ação
- [ ] Implementar rate limiting no gateway de API
- [ ] Adicionar threshold de alerta de CPU em 80%
- [ ] Atualizar runbook para failover de banco de dados

Configuração do Notion

Pré-requisitos

• Uma Integração Notion criada em notion.so/my-integrations
• A integração conectada a um banco de dados Notion para postmortems

Configuração

1. No Notion, crie um banco de dados com colunas para metadados de incidente (Título, Severidade, Data, Status).
2. Compartilhe o banco de dados com sua Integração Notion.
3. Vá em Configurações > Integrações > Notion no painel do Batida.
4. Insira o token da Integração Notion (começa com ntn_ ou secret_).
5. Selecione o banco de dados de destino na lista de bancos de dados compartilhados.
6. Clique em Salvar e Verificar.

Token de Integração: ntn_xxxxxxxxxxxxxxxxxxxxxxxxxxxx
ID do Banco de Dados: abc123def456...

Entrada do banco de dados gerada

O Batida cria uma nova página no banco de dados selecionado com as seguintes propriedades:

Propriedade do Notion	Valor
Título	INC-42: Pico de latência na API
Severidade	Crítica
Data	2026-04-20
Status	Postmortem Completo
Duração	1h 0m
Responsável	Jane Doe

O conteúdo da página inclui a timeline completa, análise de causa raiz e itens de ação.

Troubleshooting

• "Não autorizado" (Confluence): Verifique o API token e email. Garanta que a conta tem permissão para criar páginas sob a página pai selecionada.
• "Não foi possível encontrar o banco de dados" (Notion): Confirme se a Integração Notion foi convidada para o banco de dados. Abra o banco de dados no Notion, clique em Compartilhar e adicione a integração.
• Páginas não criadas: Verifique o log de atividade da integração em Configurações > Integrações para mensagens de erro detalhadas. Garanta que o gatilho de postmortem está ativado para os níveis de severidade esperados.