Ajuda Skynova

Menu

Guia de Integração — Zabbix com Nextcloud Talk

Avatar
Gustavo Oliveira
  • Atualizado

Objetivo

Permitir que o Zabbix envie alertas automaticamente para um canal do Talk, ajudando o suporte a receber avisos de incidentes em tempo real.

 

Base de conhecimento https://github.com/MartinixH/zabbix-media-nextcloud

O arquivo Media Type se encontra anexado no final do guide.

1. Importar o Media Type no Zabbix

  1. Acesse o painel do Zabbix
  2. Vá em Alertas → Tipos de mídias

  3. Clique em Importar

  4. Selecione o arquivo que foi feito download  zbx_nextcloud_mediatype.yaml 

  5. Confirme a importação

  6. Após importado, edite o tipo de mídia Nextcloud Talk e preencha:
    • password: Senha do usuario do Talk 
    • sendto: Código do canal do Talk (gerado automaticamente quando cria a sala, ex: drnmw5qk)
    • serverurl:URL do seu servidor Nextcloud (ex: https://skybox.skymail.net.br)
    • user: Usuário autorizado a enviar mensagens pelo Talk (geralmente um e-mail válido no domínio do Nextcloud)

Obs: Para conseguir o Código do canal do Talk, basta criar uma sala no talk e copiar o ID da sala que fica no final da url, segue ex com o código drnmw5qk

 

Segue um exemplo da MediaType editada:

 

2. Associar a mídia ao usuário

É obrigatório vincular a mídia “Nextcloud” ao  usuário do zabbix  para que os alertas sejam enviados.

  1. Vá em Usuários → Usuários

  2. Clique em Admin (ou outro usuário que receberá os alertas)

  3. Acesse a aba Mídia e clique em Adicionar

  4. Escolha o tipo Nextcloud

  5. No campo Enviar para, insira o e-mail do usuário no Nextcloud:

  6. Marque todas as severidades desejadas

  7. Deixe Ativo e clique em Adicionar

 

3. Criar ação de alerta

  1. Vá em Configuração → Ações → Criar ação.
  2. Nomeie a ação como Alerta Talk ou algum nome de sua preferência.

  3. Em Condições, foi definido que o  Host igual TESTE-GUSTA

  4. Em Operações, clique em adicionar, e defina os detalhes da operação de envio, no meu caso deixei conforme abaixo:

 

Assunto da mensagem (alerta):

 Alerta Zabbix: {HOST.NAME} - {TRIGGER.NAME}

Corpo da mensagem (alerta):

 Host: {HOST.NAME}
Problema: {TRIGGER.NAME}
Severidade: {TRIGGER.SEVERITY}
Estado: {TRIGGER.STATUS}
 
 
4. Se achar necessário, adicione também uma operação de recuperação para receber um e-mail quando o alerta for resolvido:

No meu caso ficou conforme abaixo:

 
Assunto da mensagem (recuperação):
 
 Normalizado: {HOST.NAME} - {TRIGGER.NAME}
 
Corpo da mensagem (recuperação):
 Host: {HOST.NAME}
Situação normalizada ({TRIGGER.NAME})
 
 
 
 

4. Testar a integração

Opção 1 – Testar o tipo de mídia diretamente

  1. Vá em Alertas → Tipos de mídias → Nextcloud

  2. Clique em Testar (ícone de balão ao lado do nome).

Opção 2 – Testar com evento real

 

  1. Selecione um host monitorado.

  2. Pare temporariamente o serviço do agente Zabbix (ou outro serviço monitorado).

  3. Aguarde o trigger acionar e o alerta ser enviado.

  4. Depois religue o serviço e veja se a mensagem de recuperação também chega.

     

    Fim.

     

 
 

Artigos relacionados