PagerDuty

Integração bidirecional com o PagerDuty: crie incidentes no PagerDuty a partir de alertas do Batida e ingira alertas do PagerDuty no Batida via webhook.

Configuração

Batida para PagerDuty (saída)

1. Vá em Configurações > Integrações > PagerDuty no painel do Batida.
2. Insira sua API key do PagerDuty (em PagerDuty > Integrações > API Access Keys).
3. Insira o ID do serviço PagerDuty onde os incidentes devem ser criados.
4. Insira o ID da política de escalonamento PagerDuty.
5. Clique em Salvar e Verificar.

API Key:           y_NbAkKf_3i...
ID do Serviço:     PB12345
Política Escalonamento: PHERO123

PagerDuty para Batida (entrada)

1. No PagerDuty, vá em Services > seu serviço > Integrações.
2. Adicione uma nova integração Custom Event Transform ou Events API V2.
3. Copie a chave de integração.
4. No Batida, cole a chave de integração em Configurações > Integrações > PagerDuty > Webhook de Entrada.
5. Opcionalmente configure regras de mapeamento alerta-para-incidente (ex.: agrupar por service key).

URL do webhook no Batida:
https://app.batida.io/api/webhooks/pagerduty/<chave_de_integracao>

Sincronização bidirecional

Ative ambas as direções para um fluxo de trabalho de incidentes totalmente unificado. O Batida pode ser a fonte de verdade enquanto o PagerDuty cuida do agendamento de plantão e alertas por telefone.

Saída: Batida aciona o PagerDuty

Quando um incidente é aberto no Batida (manualmente ou via webhook de alerta), um incidente PagerDuty é criado com:

Campo do Batida	Campo do PagerDuty
Título do incidente	Summary do incidente
Descrição	Detalhes do incidente
Severidade	Prioridade (critical = P1, high = P2, ...)
Respondente atribuído	Assigned to (se o usuário existir no PagerDuty)

Transições de status (resolução, reconhecimento) são sincronizadas com o PagerDuty.

Entrada: Alertas do PagerDuty criam incidentes no Batida

Quando o PagerDuty envia um alerta ao Batida, o payload é normalizado e um incidente Batida é criado:

1. O PagerDuty dispara um alerta.
2. O Batida recebe o payload do webhook.
3. O alerta é normalizado no schema de incidentes do Batida.
4. Um novo incidente é criado (ou agrupado em um existente).

Exemplo de mapeamento de payload de entrada

{
  "incident": {
    "incident_number": 42,
    "title": "Uso de CPU acima de 95% no prod-web-01",
    "status": "triggered",
    "priority": {
      "summary": "P1"
    },
    "service": {
      "name": "production-web"
    }
  }
}

Deduplicação

Quando o PagerDuty envia múltiplos alertas para o mesmo serviço, o Batida os agrupa em um único incidente usando a incident_key do PagerDuty (chave de deduplicação). Você pode personalizar a lógica de agrupamento nas configurações da integração.

Troubleshooting

• "API key inválida": Regenere a API key no PagerDuty e reinsira no Batida.
• Webhooks de entrada não chegando: Verifique se a chave de integração corresponde exatamente. Confira as regras de firewall para garantir tráfego dos IPs do PagerDuty ao Batida.
• Incidentes criados em duplicidade: Revise a configuração da chave de deduplicação. Garanta que o campo incident_key está sendo usado corretamente.