projeto crowdsourcing - notificações pelo telegram

Download Projeto crowdsourcing - Notificações pelo telegram

Post on 29-Jan-2018

1.188 views

Category:

Technology

1 download

Embed Size (px)

TRANSCRIPT

  1. 1. Projeto Crowdsourcing Alertas de notificaes por Telegram no Zabbix 3 Rio de Janeiro, 26 de abril de 2016.
  2. 2. Objetivo: Este projeto tem por objetivo auxiliar na configurao de envio de notificaes atravs do aplicativo Telegram de um servidor Zabbix 3.0. Justificativa Com o lanamento da 3 gerao do Zabbix, algumas aplicaes que comumente eram usadas para realizar o envio de notificaes pararam de funcionar, surgindo assim a necessidade da adequao das configuraes nova forma como o sistema trata tais aes. Neste documento, mostraremos como configurar o envio de notificaes tanto atravs de mensagens de e-mail como atravs do aplicativo de mensagens instantneas Telegram. Responsvel Tcnico Marcos Farias mcassiojr@gmail.com, Rio de Janeiro, Brasil Patrocinador 2MTI Tecnologia e Servios 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 dependncias dos sistemas so resolvidas pelo prprio instalador, diminuindo a complexidade do processo. necessrio ainda o sistema Zabbix 3.0 devidamente instalado, configurado e funcional para a execuo deste procedimento.
  3. 3. Processo de instalao Para o correto funcionamento do envio de notificaes do Zabbix pelo Telegram, ser necessrio criar um bot que executar a entrega das mensagens. Para isso procure pelo BotFather no aplicativo Telegram. Aps encontrar, inicie o processo de criao 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 usurio para seu novo bot. Obrigatoriamente dever terminar com a palavra bot. Figura 1 Criando um bot Figura 2 Criando o nome de usurio para o bot
  4. 4. Aps ser inserido um nome vlido, o BotFather informar o toker API de seu bot. Salve este cdigo pois precisaremos dele para configurar as notificaes no servidor do Zabbix. Clique seu novo bot (telegrama.me/xxxxxxx.bot) e depois em Iniciar para inici-lo. Figura 3 Final processo de criao do bot Figura 4 Iniciando o bot
  5. 5. Para que um bot do Telegram envie qualquer mensagem atravs do Zabbix, ele precisa primeiro estabelecer uma conexo segura com quem vai receber as notificaes. Para estabelecer essa comunicao, 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 configurao do Telegram: wget ftp://scripts.2mti.com.br:2117/confTelegram.sh chmod +x confTelegram.sh ./confTelegram.sh Figura 5 Estabelecendo conexo segura com o bot Figura 6 Baixando e configurando o script no servidor
  6. 6. Neste ponto da instalao ser necessrio inserir o cdigo API gerado no momento da criao do bot, como na imagem abaixo: Figura 7 Iniciando configurao no servidor Figura 8 Configurao da Chave API do BOT no servidor
  7. 7. Agora ser necessrio realizar as seguintes configuraes no portal web do Zabbix: Criar Tipo de Mdia para o Telegram; Criar Ao de notificao; Adicionar Mdia ao usurio que receber as notificaes. Para criar um novo tipo de mdia, acesse o portal do Zabbix e v em ADMINISTRAO > TIPOS DE MDIAS. Depois clique em Criar tipos de mdia. Figura 9 Final do script no servidor Figura 10 Criando novo tipo de mdia no portal Zabbix
  8. 8. Nome: Nome da mdia. Pode ser usado qualquer nome de sua preferncia; Tipo: Dever ser alterado para script; Nome do script: Nome do arquivo que foi configurado no servidor Zabbix. Deve ser, obrigatoriamente, zbxtg.py; Parmetros do script: Devem ser adicionados os parmetros como na imagem, caso contrrio as notificaes no sero enviadas. Insira {ALERT.SENDTO}, {ALERT.SUBJECT} e {ALERT.MESSAGE} respectivamente. Aps adicionar o novo Tipo de Mdia, agora vamos configurar a mdia ao usurio que receber as notificaes. No portal, v em ADMINISTRAO > USURIOS e entre no Figura 10 Criando novo tipo de mdia no portal Zabbix Figura 11 Novo tipo de mdia adicionado no portal Zabbix Figura 12 Adicionando nova mdia ao usurio
  9. 9. usurio. Clique depois em Mdia e depois em Adicionar. Altere o tipo de mdia para telegram (como criado anteriormente) e adicione o usurio do telegrama que receber as notificaes no formato @usuario, como a imagem abaixo, e clique em Adicionar. Depois, clique em Atualizar. Figura 13 Adicionando nova mdia ao usurio Figura 14 Adicionando nova mdia ao usurio
  10. 10. Agora, vamos configurar a Ao de envio de notificaes. Para isso, v em CONFIGURAO > AES, e clique em Criar Ao. Primeiramente, d um nome para a ao. Agora clique em Condies e configure de acordo com sua necessidade. Aps isso, clique em Operaes e Nova. Figura 15 Criando ao de notificao Figura 16 Criando ao de notificao
  11. 11. Devero ser configurados os seguintes campos: Enviar para usurios: selecionar o usurio que receber as notificaes; Enviar apenas para: Selecionar telegrama (mdia criada no passo anterior). Aps, clicar Adicionar na tela acima, clique novamente em Adicionar, como a imagem abaixo. Figura 17 Criando ao de notificao Figura 18 Confirmando a criando ao de notificao
  12. 12. Depois de todos os passos, j est configurado e funcionando o envio de notificaes atravs do aplicativo telegram. Como resultado, temos as notificaes enviadas como abaixo: Figura 19 Ao criada. Figura 20 Notificao enviada
  13. 13. Figura 21 Notificao enviada