Integração da API do Zabbix com o Telegram

Introdução

A API do Zabbix é extremamente versátil, e aliada às diversas funções dessa excelente ferramenta de monitoramento, podemos tornar seu uso ainda mais versátil. 

Ao longo deste artigo, pretendo mostrar a utilização de dois Bots desenvolvidos na linguagem Python, e aliada a API do Telegram, mostrar uma outra forma de utilização além do que conhecemos no Front-end. 

Motivação: porque usar um Bot no Telegram para consultar alertas?

A resposta para essa pergunta é simples, o Telegram possui uma API extensamente documentada e de fácil acesso, permitindo criar-se um “Front-End” para ações simples de maneira prática e móvel, além de ser extensamente documentada. Assim como a API do Zabbix, ambas possuem bastante material para ser usado por quem está iniciando na programação. 

Uso Prático:

O primeiro Bot tem como objetivo servir como um assistente “reativo” para alertas que ocorrem no monitoramento. O Zabbix já possui integração nativa ao Telegram, no entanto, como o Bot necessita de interação do usuário, é utilizado um sistema de mensageria a fim de termos maior gerencia das mensagens. 

Exemplo 1: 

Media Type personalizado do tipo Script. 

O exemplo abaixo ilustra algumas ações pré-definidas a fim de agilizar a interação do usuário com o problema vigente em seu ambiente: 

• Realizar o acknowledge no incidente. 
• Não validar o alerta. 
• Executar um script para verificar um possível top ofensor de consumo de CPU, Memória, disco e etc. 

Exemplo de script no Zabbix:

• Exemplo de Script executado no host: 

Exemplo de saída do script no terminal e enviada via API Telegram:

A integração com este bot faz uso de Tags do Zabbix.Um exemplo de como é enviada a Action no Zabbix e quais Tags são utilizadas:

No Back-End, há um outro script para a recepção da mensagem e com o devido tratamento, formata os campos necessários:

Exemplo de saída:

Realizando acknowledge no evento:

Alterando a mensagem no evento.

Por meio das chamadas de API que executam os scripts, é possível criar infinitas possiblidades de verificações diretamente no Host, sendo possível criar Scripts em Bash, PowerShell e qualquer linguagem de programação suportada pelo Host.

Após executar o Script, sua saída é exibida no Telegram, podendo agilizar atendimentos ou análises iniciais:

Exemplo 2:

O segundo Bot tem um uso mais consultivo e utiliza-se somente da API do Zabbix integrado ao Telegram, seu objetivo é realizar consultas para determinados tipos de incidentes.

Nas diferentes opções é possível saber quais os tipos de incidentes que a API deve consultar.

As Tags possibilitam realizar o “mapeamento” dos incidentes e assim facilitar a sua consulta, uma vez que a API é muito versátil em seus objetos de pesquisa.

Alertas de CPU, Disco e Memória e indisponibilidade no ambiente:

Alertas por grupos de hosts:

Assista abaixo um vídeo do Bot em funcionamento:

Conclusão

Ambos os Bots apresentados utilizam simples funções da API, desde a execução de scripts previamente configurados no Zabbix, até a realização de consultas que poderiam ser ainda mais complexas e trazendo dados mais específicos.

Outras funções da API podem ser exploradas, como o envio de dados históricos, criação e remoção de hosts, diretamente pelo dispositivo móvel, desde que devidamente configurado, é possível expandir ainda mais o uso dessa robusta ferramenta de monitoramento.

Este foram simples exemplos de possíveis integrações do Zabbix com outras linguagens de programação por meio de uso de sua API, não se esgotando as possibilidades, mas encorajando o desenvolvimento de soluções inteligentes e de utilidade para a comunidade em geral.