Referência do payload
Esta é a referência técnica do que enviar para uma Fonte de Dados (webhook). Seu sistema deve fazer um POST para a URL da fonte com um corpo JSON no formato abaixo.
Requisição
Método POST para a URL da sua fonte, autenticado pelo token da fonte, com Content-Type: application/json. O corpo é um único objeto JSON descrevendo o alerta.
Corpo do alerta
Criação/ativação de um incidente
{
"key": "disco-cheio2",
"host": "OLT-GRA-07",
"title": "CPU / acima de 90% de uso",
"severity": 4,
"message": "Uso em 92% — diminuir processos",
"status": "problem"
}
Resolver/descartar um incidente
{
"key": "disco-cheio2",
"status": "resolved"
}
Reativar um incidente (reincidência)
{
"key": "disco-cheio2",
"host": "OLT-GRA-07",
"title": "CPU / acima de 90% de uso",
"severity": 4,
"message": "Uso em 92% — diminuir processos",
"status": "problem"
}
Campos
- key — identificador único do alerta. Será usado caso queira resolver ou registrar recorrências. (opcional)
- host — equipamento ou entidade do problema.
- title — titulo do incidente
- severity — Severidade do incidente, sendo mapeada em:
- Informação
- Atenção
- Média
- Alta
- Desastre
- message — Conteúdo do incidente, como detalhes
- status — Status do incidente, onde são possíveis somente dois:
problem: Incidente ativo, condição de problema.
resolved: Incidente resolvido, condição de resolução.
Duplicação x recorrência: A visão de recorrência ou resolução de incidentes só é possível no uso correto da chave key.
Resolvendo um alerta
Quando o problema deixa de existir na origem, envie o sinal de resolução correspondente do seu sistema. O Sentrya marca o incidente como resolvido e o retira da lista de ativos — o histórico é preservado.
