Projeto crowdsourcing - Notificações pelo telegram

13
Projeto Crowdsourcing Alertas de notificações por Telegram no Zabbix 3 Rio de Janeiro, 26 de abril de 2016.

Transcript of Projeto crowdsourcing - Notificações pelo telegram

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

Figura 21 – Notificação enviada