telegram-scripts

Coleção de scripts para o envio de Alertas do Zabbix para o Telegram, e outros para auxílio de tarefas. Faça do seu telegram um verdadeiro terminal, onde você poderá executar comandos diretamente em seu host!

Obtenha gráficos do Zabbix
Execute ping para verificar a disponibilidade de sites e hosts
Consulte os nomes através do nslookup
Veja o valor corrente do dolar
Verifique se um serviço está disponível checando o status da porta TCP ou UDP
E muito mais vindo aí!

Instalação

Clone o repositório

git clone https://github.com/rauhmaru/telegram-scripts.git
cd telegram-scripts

Configure o vars.conf

vars.conf

Onde são armazenadas as variáveis utilizadas pelo tg-grafico.sh e tg-notifica.sh, como por exemplo, URL, login, senha, diretório de armazenamento das imagens e cookie. Observações:

Seu preenchimento é obrigatório
O usuário deve possuir acesso ao frontend do Zabbix
A senha desse usuário não pode conter o caractere = issue #1

batbot.sh

Responsável por executar os scripts no servidor. Através de um bot, ele ouve as requisições e as executa, conforme o comando pré-programado. O comando é executado no terminal do host e seu STDOUT é direcionado para o Telegram.

Link para o projeto: https://github.com/theMiddleBlue/BaTbot

tg-grafico.sh

Esse script é executado pelo batbot, recebendo o ITEMID como parâmetro e retornando um gráfico para o solicitante.

tg-notifica.sh

Disparado através das ações das triggers, é quem notifica o usuário. Adicione esse script no diretório de alertscripts.

Como configurar alertas no Zabbix

Para identificar qual o seu diretório de Alert Scripts, execute o comando: egrep ^AlertScripts /etc/zabbix/zabbix_server.conf

Obtendo gráficos do Zabbix pelo telegram

Para a geração de gráficos, não é necessário que os scripts vars.conf, tg-grafico.sh e batbot estejam no servidor do Zabbix. Eles podem estar em qualquer host, portanto que consigam acesso a interface web do Zabbix. As consultas são feitas através do método HTTP POST.

CONFIGURAÇÃO

Esse procedimento é feito em duas etapas:

01 - Configurar o zabbix para que gere as notificações e envie os ITEM ID

No Servidor Zabbix

Verifique qual o seu diretório de AlertScriptsPath:

grep ^AlertScript /etc/zabbix/zabbix_server.conf

Por exemplo:

[root@finarfin tmp]# grep ^AlertScript /etc/zabbix/zabbix_server.conf
AlertScriptsPath=/usr/lib/zabbix/alertscripts

Acesse o diretório e baixe os scripts:

cd /usr/lib/zabbix/alertscripts
git clone https://github.com/rauhmaru/telegram-scripts.git
mv telegram-scripts/{vars.conf,tg-notifica.sh} .
chmod +x tg-notifica.sh

No Zabbix Web

Crie o tipo de mídia

Logado no Zabbix Server como Super-Administrador, clique em Administração > Tipos de mídias e depois em Criar tipo de mídia. Defina:

Nome: telegram
Tipo: Script
Nome do script: tg-notifica.sh
Ativo: sim

Crie o usuário telegram

Em Administração > Usuários, clique em Criar usuário Na guia Usuário, defina o apelido telegram. Fique a vontade com os outros parâmetros. Coloque-o em um grupo que tenha acesso as notificações que deseja emitir. O Zabbix administrators é uma sugestão. Na guia Mídia, clique em adicionar. Defina:

Tipo: telegram
Enviar para: Esse campo não será usado. Preencha como quiser.
Quando ativo: Período de notificação. O padrão é 24/7.
Ativo: Sim

Defina as ações

Nome: Telegram
Na guia Configuração > Ações, clique em Criar ação
Na guia Ação, defina o nome telegram.
No campo Assunto padrão, defina:

*[{TRIGGER.STATUS} - {HOST.NAME}]*

No campo Mensagem padrão, defina, por exemplo:

{TRIGGER.NAME}
{ITEM.NAME1}: {ITEM.VALUE1}
IP: {HOST.IP}
Verificado às {TIME}, em {EVENT.DATE}
ITEM ID: {ITEM.ID}

Recuperação:

Marque o campo Mensagem de recuperação
- No campo Assunto de recuperação, defina: