Webhook do Zabbix
Configure o Zabbix para avisar a plataforma em segundos sobre problemas, recuperações e reconhecimentos.
Por padrão, a plataforma consulta o Zabbix a cada minuto. Com o webhook, o Zabbix avisa a plataforma no momento em que um problema abre, é atualizado ou se recupera, e o evento chega em segundos.
O webhook só avisa: ao receber o aviso, a plataforma busca o evento oficial no próprio Zabbix antes de registrá-lo. Por isso a consulta periódica e a reconciliação continuam valendo, e nenhum evento depende só do webhook.
Antes de começar
- Uma instância do Zabbix com o recurso Eventos ligado.
- Papel Editor ou superior na plataforma.
- Acesso de administrador ao Zabbix. Os passos abaixo seguem o Zabbix 7.0, com os menus em inglês.
1. Gerar o token na plataforma
Abra a instância do Zabbix e vá à aba Eventos, seção Webhook. Ligue Receber webhook do Zabbix.
Clique em Gerar token. A janela Copie agora mostra a URL do webhook.
Copie a URL e clique em Já copiei.
A URL contém o token e só é exibida uma vez. Se você a perder, use Rotacionar para gerar outra.
Clique em Ver passos e script para abrir, na própria tela, os Parâmetros e o Script do media type que serão usados no Zabbix. Use Copiar para levar o script sem erros de digitação.
2. Configurar o Zabbix
Media type
Em Alerts → Media types → Create media type, crie um media type do tipo
Webhook com o nome Platform intake:
- adicione todos os parâmetros listados em Parâmetros, com os mesmos nomes e valores;
- cole o Script do media type;
- em Timeout, use
10s; - em Options, defina Attempts como
3e Attempt interval como10s; - deixe Process tags desligado.
Salve e mantenha o media type habilitado.
Usuário dedicado
Em Users → Users → Create user, crie um usuário só para a integração
(ex.: platform-intake). Coloque-o em um grupo com permissão de leitura
nos grupos de hosts que a instância importa: o Zabbix não dispara o
webhook para hosts que o usuário não enxerga.
Na aba Media desse usuário, adicione o media type Platform intake, com
a URL do webhook em Send to e ativo para todas as severidades.
Associe o media type somente a esse usuário. Associado a todos os usuários, o Zabbix envia um aviso por usuário a cada evento.
Action
Em Alerts → Actions → Trigger actions → Create action, crie uma ação
com condições equivalentes ao que a instância importa (grupos de hosts e
severidade mínima). Em Operations, Recovery operations e Update
operations, adicione Send message para o usuário platform-intake
pelo media type Platform intake.
3. Testar
Provoque um problema em um host monitorado ou use o botão Test do media type no Zabbix. Em poucos segundos, a seção Webhook da instância passa a mostrar Último recebido com o horário do aviso. Para conferir o evento na plataforma, siga Validar o recebimento.
Se o Zabbix registrar falha no envio, o código de resposta indica a causa:
| Resposta | Significado |
|---|---|
202 | Aviso aceito. |
401 | Token incorreto, revogado ou expirado. Confira a URL em Send to. |
409 | A instância está pausada ou o webhook está desligado. |
Rotacionar e revogar o token
A lista de tokens mostra o estado de cada um (Ativo, Revogado ou Expirado), quando foi Criado e o Último uso.
- Rotacionar gera uma URL nova. A anterior continua valendo por mais 5 minutos: atualize o Send to do usuário no Zabbix dentro desse prazo.
- Revogar invalida a URL na hora. O Zabbix passa a receber
401, e a plataforma continua trazendo os eventos pela consulta periódica.