3 Scripts de alerta customizados

Visão geral

Se você não estiver satisfeito com os tipos de mídia existentes para o envio de alertas há um caminho alternativo. Você pode criar um script que lidará com a notificação do seu jeito.

Scripts de alerta são executados no Zabbix Server. Estes scripts estão localizados no diretório definido pela variável AlertScriptsPath no arquivo de configuração do Server.

Aqui temos um exemplo de script de alerta:

#!/bin/bash
       
       to=$1
       subject=$2
       body=$3
       
       cat <<EOF | mail -s "$subject" "$to"
       $body
       EOF

A partir da versão 3.4 o Zabbix verifica pelo código de saída dos comandos e scripts executados. Qualquer código de saída diferente de 0 é considerado como um erro de execução de comando. Neste caso o Zabbix tentará repetir a execução falha.

Variáveis de ambiente não são preservadas ou criadas para o script, então elas devem ser manipuladas de forma explícita.

Configuração

Para configurar scripts de alerta customizados como o tipo de mídia:

Vá até Administração → Tipos de mídia
Clique em Criar tipo de mídia

A aba Tipo de mídia contém atributos de tipo de mídia gerais:

Todos os campos de entrada obrigatórios estão marcados com um asterisco vermelho.

Os seguintes parâmetros são específicos para o tipo de mídia script:

Parâmetro	Descrição
Nome do script	Informe o nome do script.
Parâmetros do script	Adicione parâmetros de linha de comando ao script. As macros {ALERT.SENDTO}, {ALERT.SUBJECT} e {ALERT.MESSAGE} são suportadas nos parâmetros de script. Customização de parâmetros de script é suportada desde o Zabbix 3.0.

Consulte os parâmetros de tipo de mídia comuns para detalhes em como configurar opções de mensagens padrão e processamento de alerta.

Mesmo que um script de alerta não use mensagens padrão, os modelos de mensagem para tipos de operação usados por este tipo de mídia ainda precisam ser definidos, caso contrário a notificação não será enviada.

Como o processamento paralelo de tipos de mídia está implementada desde o Zabbix 3.4.0, é importante notar que com mais de um tipo de mídia script configurado, estes scripts podem ser processados em paralelo pelos processos de alerta. O número total de processos de alerta é limitado pelo parâmetro StartAlerters.

Media type testing

To test a configured script media type:

Locate the relevant script in the list of media types.
Click on Test in the last column of the list (a testing window will open).
Edit the script parameter values, if needed (editing affects the test procedure only, the actual values will not be changed).
Click on Test.

Mídia de usuário

Uma vez que o tipo de mídia é configurado, vá até a seção Administração → Usuários e edite o perfil do usuário associando a mídia deste tipo ao usuário. As etapas para configuração de mídia de usuário, sendo comum para todos os tipos de mídia, são descritas na página Tipos de mídia.

Note que quando definindo a mídia de usuário, o campo Enviar para não pode estar vazio. Se este campo não será usado no script de alerta, entre qualquer combinação de caracteres suportados para atender aos requisitos de validação.

Documentation

3 Scripts de alerta customizados

Visão geral

Configuração

Media type testing

Mídia de usuário