Validar o recebimento de eventos
Confira, da instância até a Gestão de Eventos, se os problemas de uma integração estão chegando como esperado.
Depois de conectar uma ferramenta de monitoramento, vale confirmar que um problema real percorre todo o caminho: sai da ferramenta, é recebido pela instância e aparece na Gestão de Eventos com a origem, o recurso e a prioridade esperados. Este guia usa o Zabbix como exemplo.
Antes de começar
- Uma instância do Zabbix com Eventos ligado.
- Combine com o responsável pelo Zabbix um problema de teste em um host conhecido. Anote o horário, o nome do problema e o host.
- Escolha um host que esteja dentro dos Grupos de host importados, com severidade igual ou acima da Severidade mínima e fora de janelas de manutenção.
1. Confira a instância
Abra a instância em Integrações → Zabbix. No cabeçalho, o estado deve
ser Saudável. Se não for, clique em Testar conexão e veja qual
etapa falhou.
Na Visão geral, confira se o cartão Eventos está Ligado e se a Última sincronização é recente.
Na aba Eventos, em Rotinas, confira o Último sucesso do Polling incremental e da Reconciliação dos abertos. Se houver Último erro ou falhas seguidas, a mensagem indica a causa.
2. Provoque o problema de teste
Dispare o problema combinado no Zabbix. Sem webhook, ele chega na próxima consulta, em até um minuto pelo padrão. Com o webhook configurado, a seção Webhook mostra o Último recebido em segundos. Se tiver pressa, use Sincronizar agora.
3. Localize o evento na Gestão de Eventos
Acesse Gestão de Eventos → Eventos e procure o evento pelo nome do
problema e pelo horário. Os eventos do Zabbix aparecem com o ícone do
Zabbix na coluna de origem.
Abra o detalhe do evento e compare com o que foi enviado:
- o nome e a mensagem do problema;
- o Recurso, com o host do Zabbix (nome, nome visível e IP);
- a prioridade, que segue o mapeamento Severidade → prioridade da instância.
Em Processamento, confira o Status e a Mensagem. Se uma política transformou o evento em alerta, siga o vínculo para o alerta ou o incidente relacionado.
Para entender o que mais o detalhe mostra, veja Conferir o contexto de um evento.
4. Confira a recuperação
Resolva o problema no Zabbix. A recuperação chega como um novo evento, ligado ao problema original, e encerra o alerta correspondente. Se a opção Reconhecer o alerta quando reconhecido no Zabbix estiver ligada, um acknowledge feito no Zabbix também reconhece o alerta na plataforma.
Resultado esperado
O problema de teste aparece em Eventos com o host e a prioridade corretos, e a recuperação fecha o alerta. Receber o evento, abrir um alerta e criar um incidente são etapas diferentes: as duas últimas dependem das políticas de eventos aplicadas. Veja os conceitos de Gestão de Eventos.
Se o evento não aparecer
| Sintoma | O que verificar |
|---|---|
| A instância está em Erro ou o teste de conexão falha | Endereço do Zabbix, token ou senha e, se houver, o runner. Ajuste na aba Conexão. |
| A instância está Pausada | Clique em Retomar. |
| As rotinas mostram Último erro | Leia a mensagem: costuma indicar permissão insuficiente do usuário do Zabbix ou o Zabbix fora do ar. |
| O problema existe no Zabbix, mas não foi importado | Severidade abaixo da Severidade mínima ou host fora dos Grupos de host configurados. |
| O contador Sem CI aumentou | O evento chegou, mas o host não corresponde a nenhum item de configuração no CMDB. O evento aparece sem vínculo de CI. |
| O webhook não registra Último recebido | Veja o código que o Zabbix recebeu em Webhook do Zabbix. Os eventos continuam chegando pela consulta periódica. |
| O evento chegou, mas não abriu alerta | Uma política de eventos ou de blackout pode ter suprimido o alerta. Confira em Processamento. |