Skip to main content

Visão geral

O Zabbix não tem formato de webhook padronizado. A integração usa uma media type do tipo webhook que monta o payload canônico do aciona.me a partir das macros do evento.

Pré-requisitos

  • Zabbix com permissão de administração para criar media types e actions.
  • Um serviço criado no aciona.me e vinculado a um time com escala ativa.

1. Crie a fonte de alerta no aciona.me

Em Fontes de alerta, crie uma fonte do tipo Zabbix. Copie a URL e o token.

2. Crie a media type

Em Administration → Media types → Create media type:
  • Type: Webhook
  • Parameters:
Ajuste o domínio do deeplink para o seu Zabbix. Valide o script em um ambiente de teste antes de aplicar em produção.

3. Crie a action

Em Configuration → Actions → Trigger actions, crie uma action cuja operação envie a notificação pela media type do aciona.me.
A action precisa disparar em PROBLEM e RECOVERY. O Zabbix já faz isso por padrão — só confirme que não há condição filtrando apenas PROBLEM. Sem o evento de recovery, os acionamentos nunca fecham sozinhos.

4. Teste

Force um trigger a disparar (ou use um trigger de teste) e confirme o acionamento no painel. Depois faça o trigger voltar ao normal e confirme a resolução automática.

Como os campos são traduzidos

Estado

value tem precedência sobre status.

Severidade

Serviço

A pista de serviço vem do {HOST.NAME}. Crie no aciona.me serviços com os mesmos nomes visíveis dos hosts, ou configure um serviço padrão na fonte.

Campos obrigatórios

triggerId e name são obrigatórios. Sem eles, a requisição é recusada com 400.

Solução de problemas

A action está filtrada apenas para PROBLEM. Remova a condição para que ela também dispare em RECOVERY.
Faltam trigger_id ou event_name nos parâmetros da media type. Confira as macros configuradas.
Veja os logs do Zabbix server (Zabbix.log grava com nível 3 e 4). Confirme que o servidor tem saída HTTPS para ingress.aciona.me.