O que é
Alert API. Cada alerta vira um alerta no Opsgenie com o id como alias, então repetição não empilha.
Configurar
Cerca de 5 minutos até um canal funcionando.
- 01Crie uma integração API. Opsgenie → Teams → o time → Integrations → Add integration → “API”. Copie a API key e confira que “Create and update access” está ligado.
- 02Cole a chave, escolha a região e Teste. Testar cria um alerta com a tag datarunner-test na prioridade mais baixa e fecha.
- 03Ponha numa rota de alerta. Monitoramento → Rotas de alerta → adicione este canal como etapa. Severidade vira prioridade: critical → P1, major → P2, minor → P3, o resto P4.
Campos
| Campo | Obrigatório | O que é |
|---|---|---|
| API key | Sim | De uma integração API com acesso de criar/atualizar. |
| Região EU | Não | Ligado para contas em app.eu.opsgenie.com. |
| Prioridade padrão | Não | Usada nas entregas de relatório. Alerta mapeia a própria severidade. P1 — crítica · P2 — alta · P3 — moderada · P4 — baixa · P5 — informativa |
O que vai em Target
Não usado. O roteamento para times é configurado na integração do Opsgenie.
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 lê a lista de alertas com a API key (uma leitura, nenhum alerta criado). Uma chave da região errada falha aqui, não no plantão.
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
Conta hospedada na Europa precisa marcar “Região EU” — o api.opsgenie.com padrão responde 401 para chave EU, o que parece exatamente uma chave errada.