projeto crowdsourcing - notificações pelo telegram
TRANSCRIPT
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 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 – [email protected], 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.
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
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
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
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
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
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
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
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
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
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