O que é
Events API v2. Cada alerta abre um incidente no serviço da chave de integração; o id do alerta é a chave de deduplicação.
Configurar
Cerca de 5 minutos até um canal funcionando.
- 01Adicione uma integração Events API v2 ao serviço. PagerDuty → Services → o serviço → Integrations → Add integration → “Events API V2”. Copie a Integration Key (32 caracteres hex).
- 02Cole a chave e Teste. Testar enfileira um evento de severidade baixa e resolve na hora, então ninguém é acordado. Chave errada responde 400.
- 03Ponha numa rota de alerta. Monitoramento → Rotas de alerta → adicione este canal como etapa, normalmente a segunda: Slack primeiro, PagerDuty quando ninguém reconhece dentro do prazo.
Campos
| Campo | Obrigatório | O que é |
|---|---|---|
| Chave de integração | Sim | A routing_key de uma integração Events API v2. (32 hex characters) |
| Severidade padrão | Não | Usada nas entregas de relatório. Alerta leva a própria. critical · error · warning · info |
O que vai em Target
Não usado. O serviço de destino é decidido pela chave de integração.
Target é opcional neste canal. — não usado
Testar
Cada canal tem o botão Testar na lista de canais (Configurações → Canais). O resultado fica guardado — data, status e o erro do provedor quando houve — e um canal nunca testado aparece marcado na lista.
Testar dispara um incidente de severidade "info" no serviço da routing key e o resolve em seguida. Você verá um incidente resolvido em segundos na lista — é a prova de que a chave chega ao serviço certo.
Conferir de ponta a ponta
- 01Relatório: abra um relatório, adicione este canal em Destinos (com o Target, se o canal pede), clique em Executar agora e abra a execução. O log diz por qual canal cada destinatário foi e o que o provedor respondeu.
- 02Alerta: em Monitoramento → Rotas de alerta, crie uma rota com este canal como passo de escalação. A rota casa por severidade e origem; a primeira que casar vence.
- 03Para disparar um alerta sem derrubar nada: crie um monitor HTTP apontando para uma URL que responde erro (por exemplo https://httpstat.us/500) com intervalo curto. Quando ele cair, o alerta sai pela rota; apague o monitor depois. A mensagem traz um link de reconhecimento — clique nele e a escalação para.
- 04Regras de relatório (linhas novas, valor fora da faixa) chegam pela mesma rota, com origem "regra de relatório".
O que mais costuma dar errado
A chave tem que vir de uma integração “Events API v2” num serviço — chave de REST API ou de integração v1 é recusada com 400. A severidade aqui é o padrão dos relatórios; alerta mapeia a própria (critical → critical, major → error, o resto warning).