Criar um ouvinte de webhook

O assistente Novo ouvinte de webhook cria um ouvinte a partir de uma Fonte de Dados em três etapas: Urgência, Alertas e Revisão. Os alertas são identificados pela key que o seu sistema envia no payload.

Antes de começar

É preciso ter uma fonte cadastrada em Ajustes › Fontes de Dados; sem isso o assistente avisa Cadastre uma fonte de dados em Ajustes antes de criar ouvintes. Veja Criar uma fonte de dados.

Diferente do Zabbix, uma fonte de webhook não tem catálogo de triggers. O que o assistente lista são os alertas que a fonte já recebeu, agrupados pela key. Uma fonte recém-criada ainda não tem nada para listar, e por isso existe o caminho de digitar a key à mão.

Passo a passo

Urgência Escolha Sirene, Crítico, Padrão ou Silencioso, o Tom e, em Avisos, Avisar em recorrências, Avisar quando resolver e o Som da resolução. A urgência vem primeiro porque a Sirene muda o que a etapa Alertas oferece; veja Urgências e sons.
Alertas Com mais de uma fonte, escolha a Fonte no topo. Depois, uma de três formas: ligue Todos os alertas desta fonte (qualquer alerta, inclusive os que nunca chegaram); digite chaves em Chaves adicionadas à mão e toque em Adicionar; ou marque itens em Alertas já recebidos, que mostra título, host, key e quantas vezes cada um chegou, com busca. Se a fonte ainda não recebeu nada, o app avisa Nenhum alerta recebido desta fonte ainda. A fonte inteira pode ser ouvida mesmo assim.
Revisão Dê o Nome (sugerido pelo nome da fonte), confira o Resumo e, se você é Admin, o Compartilhamento. Toque em Criar ouvinte.

Sem repetição. Uma chave digitada à mão vale para qualquer host; por isso o mesmo alerta, já recebido num host específico, aparece travado como coberto por ela e não é gravado de novo. O botão de fechar do topo cancela a criação de qualquer etapa.

A relação com a key

A key é a identidade estável de um problema na fonte: o mesmo problema deve chegar sempre com a mesma key, e é ela que agrupa ocorrências, conta recorrências e permite resolver. O ouvinte casa pela mesma identidade. Um alerta do catálogo vira um gatilho de key + host; uma key digitada à mão vira um gatilho de key em qualquer host. Alertas enviados sem key chegam soltos e só são alcançados por um ouvinte de fonte inteira. Veja Ciclo de vida do alerta e a key.

Gatilho	Casa com	Disponível na Sirene
Todos os alertas desta fonte	Qualquer alerta da fonte, com ou sem key, de qualquer host	Não
Alerta do catálogo	A key daquele alerta, no host em que ele chegou	Sim, se tiver key
Key adicionada à mão	A key digitada, em qualquer host	Sim

Fonte nova e Sirene. Uma fonte que ainda não recebeu alertas não tem catálogo e a Sirene não aceita fonte inteira. Digitar a key à mão é o único caminho para um ouvinte Sirene numa fonte recém-criada.

O que muda com a Sirene

Com a urgência Sirene, a etapa Alertas mostra o aviso Sirene: no máximo 10 alertas identificados (com key). Envios com severidade abaixo de 5 são recusados pela API nesses alertas. A linha Todos os alertas desta fonte desaparece, alertas sem key ficam de fora e o teto de 10 vale para o ouvinte inteiro.

A severidade é garantida no recebimento: quando um alerta de problema cai numa key coberta por ouvinte Sirene com severity menor que 5, a API responde 422 e explica o motivo; com severity: 5, a resposta ganha siren_listener: true. Resoluções passam sempre. Veja Sirene: o alerta máximo e Referência do payload.

No painel web