Projeto Crowdsourcing
Alertas de notificações por
Telegram no Zabbix 3
Rio de Janeiro, 26 de abril de 2016.
Objetivo:
Este projeto tem por objetivo auxiliar na configuração de envio de notificações
através do aplicativo Telegram d...
Processo de instalação
Para o correto funcionamento do envio de notificações do Zabbix pelo Telegram, será
necessário cria...
Após ser inserido um nome válido, o BotFather informará o toker API de seu bot. Salve
este código pois precisaremos dele p...
Para que um bot do Telegram envie qualquer mensagem através do Zabbix, ele precisa
primeiro estabelecer uma conexão segura...
Neste ponto da instalação será necessário inserir o código API gerado no momento da
criação do bot, como na imagem abaixo:...
Agora será necessário realizar as seguintes configurações no portal web do Zabbix:
 Criar “Tipo de Mídia” para o Telegram...
 Nome: Nome da mídia. Pode ser usado qualquer nome de sua preferência;
 Tipo: Deverá ser alterado para “script”;
 Nome ...
usuário. Clique depois em “Mídia” e depois em “Adicionar”.
Altere o tipo de mídia para “telegram” (como criado anteriormen...
Agora, vamos configurar a “Ação” de envio de notificações. Para isso, vá em
CONFIGURAÇÃO > AÇÕES, e clique em “Criar Ação”...
Deverão ser configurados os seguintes campos:
 Enviar para usuários: selecionar o usuário que receberá as notificações;
...
Depois de todos os passos, já está configurado e funcionando o envio de notificações
através do aplicativo telegram. Como ...
Figura 21 – Notificação enviada
Próximos SlideShares
Carregando em…5
×

Projeto crowdsourcing - Notificações pelo telegram

1.160 visualizações

Publicada em

Documentação explicativa de como configurar o envio de notificações do Zabbix 3 através do aplicativo telegram

Publicada em: Tecnologia
  • Seja o primeiro a comentar

Projeto crowdsourcing - Notificações pelo telegram

  1. 1. Projeto Crowdsourcing Alertas de notificações por Telegram no Zabbix 3 Rio de Janeiro, 26 de abril de 2016.
  2. 2. Objetivo: Este projeto tem por objetivo auxiliar na configuração de envio de notificações através do aplicativo Telegram de um servidor Zabbix 3.0. Justificativa Com o lançamento da 3ª geração do Zabbix, algumas aplicações que comumente eram usadas para realizar o envio de notificações pararam de funcionar, surgindo assim a necessidade da adequação das configurações à nova forma como o sistema trata tais ações. Neste documento, mostraremos como configurar o envio de notificações tanto através de mensagens de e-mail como através do aplicativo de mensagens instantâneas Telegram. Responsável Técnico Marcos Farias – mcassiojr@gmail.com, Rio de Janeiro, Brasil Patrocinador 2MTI Tecnologia e Serviços – http://www.2mti.com.br Requisitos Este procedimento foi testado e homologado para os sistemas Debian e Ubuntu, nas arquiteturas 32 e 64 bits. Todas as dependências dos sistemas são resolvidas pelo próprio instalador, diminuindo a complexidade do processo. É necessário ainda o sistema Zabbix 3.0 devidamente instalado, configurado e funcional para a execução deste procedimento.
  3. 3. Processo de instalação Para o correto funcionamento do envio de notificações do Zabbix pelo Telegram, será necessário criar um bot que executará a entrega das mensagens. Para isso procure pelo BotFather no aplicativo Telegram. Após encontrar, inicie o processo de criação de bot com a seguinte mensagem: /newbot Como informado, deverá ser dado o nome ao seu novo bot. Agora deverá ser informado um nome de usuário para seu novo bot. Obrigatoriamente deverá terminar com a palavra “bot”. Figura 1 – Criando um bot Figura 2 – Criando o nome de usuário para o bot
  4. 4. Após ser inserido um nome válido, o BotFather informará o toker API de seu bot. Salve este código pois precisaremos dele para configurar as notificações no servidor do Zabbix. Clique seu novo bot (telegrama.me/xxxxxxx.bot) e depois em “Iniciar” para iniciá-lo. Figura 3 – Final processo de criação do bot Figura 4 – Iniciando o bot
  5. 5. Para que um bot do Telegram envie qualquer mensagem através do Zabbix, ele precisa primeiro estabelecer uma conexão segura com quem vai receber as notificações. Para estabelecer essa comunicação, envie uma mensagem qualquer em modo “Privado” para o seu bot. Seu bot já está devidamente configurado. Agora vamos configurar o servidor. Agora, abra o terminal do servidor Zabbix e digite os seguintes comandos para baixar o script para configuração do Telegram: wget ftp://scripts.2mti.com.br:2117/confTelegram.sh chmod +x confTelegram.sh ./confTelegram.sh Figura 5 – Estabelecendo conexão segura com o bot Figura 6 – Baixando e configurando o script no servidor
  6. 6. Neste ponto da instalação será necessário inserir o código API gerado no momento da criação do bot, como na imagem abaixo: Figura 7 – Iniciando configuração no servidor Figura 8 – Configuração da Chave API do BOT no servidor
  7. 7. Agora será necessário realizar as seguintes configurações no portal web do Zabbix:  Criar “Tipo de Mídia” para o Telegram;  Criar “Ação” de notificação;  Adicionar “Mídia” ao usuário que receberá as notificações. Para criar um novo tipo de mídia, acesse o portal do Zabbix e vá em ADMINISTRAÇÃO > TIPOS DE MÍDIAS. Depois clique em “Criar tipos de mídia”. Figura 9 – Final do script no servidor Figura 10 – Criando novo tipo de mídia no portal Zabbix
  8. 8.  Nome: Nome da mídia. Pode ser usado qualquer nome de sua preferência;  Tipo: Deverá ser alterado para “script”;  Nome do script: Nome do arquivo que foi configurado no servidor Zabbix. Deve ser, obrigatoriamente, “zbxtg.py”;  Parâmetros do script: Devem ser adicionados os parâmetros como na imagem, caso contrário as notificações não serão enviadas. Insira {ALERT.SENDTO}, {ALERT.SUBJECT} e {ALERT.MESSAGE} respectivamente. Após adicionar o novo “Tipo de Mídia”, agora vamos configurar a mídia ao usuário que receberá as notificações. No portal, vá em ADMINISTRAÇÃO > USUÁRIOS e entre no Figura 10 – Criando novo tipo de mídia no portal Zabbix Figura 11 – Novo tipo de mídia adicionado no portal Zabbix Figura 12 – Adicionando nova mídia ao usuário
  9. 9. usuário. Clique depois em “Mídia” e depois em “Adicionar”. Altere o tipo de mídia para “telegram” (como criado anteriormente) e adicione o usuário do telegrama que receberá as notificações no formato “@usuario“, como a imagem abaixo, e clique em “Adicionar”. Depois, clique em “Atualizar”. Figura 13 – Adicionando nova mídia ao usuário Figura 14 – Adicionando nova mídia ao usuário
  10. 10. Agora, vamos configurar a “Ação” de envio de notificações. Para isso, vá em CONFIGURAÇÃO > AÇÕES, e clique em “Criar Ação”. Primeiramente, dê um nome para a ação. Agora clique em “Condições” e configure de acordo com sua necessidade. Após isso, clique em “Operações” e “Nova”. Figura 15 – Criando ação de notificação Figura 16 – Criando ação de notificação
  11. 11. Deverão ser configurados os seguintes campos:  Enviar para usuários: selecionar o usuário que receberá as notificações;  Enviar apenas para: Selecionar telegrama (mídia criada no passo anterior). Após, clicar “Adicionar” na tela acima, clique novamente em “Adicionar”, como a imagem abaixo. Figura 17 – Criando ação de notificação Figura 18 – Confirmando a criando ação de notificação
  12. 12. Depois de todos os passos, já está configurado e funcionando o envio de notificações através do aplicativo telegram. Como resultado, temos as notificações enviadas como abaixo: Figura 19 – Ação criada. Figura 20 – Notificação enviada
  13. 13. Figura 21 – Notificação enviada

×