Email_Graph_ZABBIX

Em caso de dúvida, sugestão ou dificuldade junte-se a nós no Grupo do Telegram <class="noteimportant">Gráfico no Email.

Envio de itens alarmados no ZABBIX por email com gráficos.

O "How to" foi testado no ZABBIX 2.4 e no 3.0 com base em Debian.

#Requisitos: 1 - Ter o POSTFIX instalado e configurado, caso não tenha, <class="noteimportant">Clique aqui.

2 - Baixar os módulos MIME::Lite e WWW::Mechanize.
Ex:

CentOS 6.x e 7

yum install perl-WWW-Mechanize perl-MIME-Lite

Debian

$ sudo apt-get install libmime-lite-perl libwww-mechanize-perl

3 - Adicione o arquivo “email.pl“ na pasta de scripts do ZABBIX.
Caso queira mudar a pasta padrão, edite a linha “AlertScriptsPath=” no “zabbix_server.conf” e aponte para uma de sua preferência.

#Edite os parâmetros:

• “my $server_ip” = 'http://127.0.0.1/zabbix' - URL de acesso ao FRONT com "http://"
• “my $usuario” = 'Admin';
• “my $senha” = 'zabbix';

OBS: O usuário que você declarar no campo “my $usuario” precisa ter permissão de no mínimo leitura no ambiente.

Comando para teste

A estrutura do comando para realização de teste é:
Script, Email, Assunto, Nome-do-Item#ID-do-Item#CorEmHex#PeriodoDoGrafico#CorpoDoEmail.
Ex:
./email.pl SeuEmail@Provedor.com "Assunto" "NomeDoItem#123456#00C800#3600#CorpoDoEmail"
OBS:
1 - ”123456” é um número fictício para exemplificar, busque uma ID válida em seu ambiente para realização do teste;
2 - "00C800" é o verde "padrão" do zabbix em Hexadecimal;
3 - "3600" é o periodo de 1h do gráfico em segundos.

#Configurando o envio

Com o script adicionado no local indicado acima, precisamos realizar algumas configurações no Front do ZABBIX, no "Tipo de Mídia", (em Administração > Tipo de Mídia) e a "Ação" (em Configuração > Ações).

Tipo de Mídia

Zabbix 2.4

Zabbix 3.0

OBS: Na versão 3.0, se faz obrigatório a utilização das macros {ALERT.SENDTO}, {ALERT.SUBJECT} e {ALERT.MESSAGE}, em caso de dúvidas, leia a Documentação Aqui.

Configurando o usuário

Criando a Ação:

A “Mensagem Padrão” na aba “Ação” está sendo executada no formato “HTML”, então você pode realizar a formatação que desejar, somente com uma “exigência”, as quatro primeiras linhas devem permanecer com as macros/variáveis abaixo ilustradas, podendo editar da quinta linha em diante. (as macros/variáveis com # ao lado)

Exemplificando sobre o HTML, abaixo começou com um parágrafo, e o {HOST.HOST} coloquei em negrito.

Imagem da Mensagem na Ação:

Modelo Mensagem Padrão

{ITEM.NAME}#
{ITEM.ID}#
00C800#
3600#
Foi detectado um evento no equipamento {HOST.HOST}.

Resultado:

#Conclusão

1 - Este script é para agilizar a analise e ficar visualmente mais agradável o recebimento dos alarmes.

2 - Caso você monitore itens de log, e queira receber invés do gráfico vazio "sem dados", receber somente o texto descrito na "Mensagem Padrão", basta iniciar o nome do item com log, pode ser em caixa alta ou não.