Zabbix Documentation 5.0

3.04.04.45.0 (current)| In development:5.2 (devel)| Unsupported:1.82.02.22.43.23.44.2Guidelines

User Tools

Site Tools


Sidebar

pt:manual:config:items:itemtypes:external

11 Verificações externas

11.1 Visão geral

Uma verificação externa é executada pelo Zabbix Server através de um 'shell script' ou outro binário.

A verificação externa não necessita de nenhum agente de monitoração sendo executado no host monitorado.

A sintaxe da chave do item é:

script[<parameter1>,<parameter2>,...]

Onde:

Argumento Definição
script Nome do shell script ou do binário.
parameter(s) Parâmetros opcionais da linha de comando.

Se você não precisar definir nenhum parâmetro, você poderá usar:

script[] ou
script

O Zabbix Server irá procurar no diretório definido no parâmetro de scripts externos ('ExternalScripts' no arquivo de configuração do Zabbix Server) e executará o comando. O comando será executado com as permissões do mesmo usuário que o Zabbix Server estiver sendo executado, então as permissões de acesso e variáveis de ambiente deverão estar definidas ou ser tratadas pelo script invocado. Esta opção só executa comandos disponíveis neste diretório.

Evite utilizar-se demais desta forma de monitoração! Cada script iniciado precisa de uma cópia do processo do Zabbix Server, muitos scripts sendo executados em paralelo poderão reduzir muito a performance do Zabbix Server.

11.2 Exemplo de utilização

Executando o script check_oracle.sh com o primeiro parâmetro: “-h”. O segundo parâmetro será substituido pelo endereço IP ou nome de DNS dependendo das definições do host monitorado.

check_oracle.sh["-h","{HOST.CONN}"]

Assumindo que o host esteja configurado para utilizar o IP o Zabbix poderia executar:

check_oracle.sh "-h" "192.168.1.4"

11.3 Resultado da verificação externa

O valor retornado por esta verificação será o conteúdo exibido pelo script para a saida padrão (desde o Zabbix 2.0 será devolvida a saida completa, inclusive com os espaços em branco à direita).

O item passará a ficar como não suportado caso ocorra um erro no 'output'.

Caso o script requisitado não exista no Zabbix Server ou ele não tenha permissão para executa-lo, o item passará ao estado de 'não suportado' e o erro correspondente será exibido na lista de itens. Caso exceda o tempo para execução (timeout), o item será marcado como 'não suportado', e uma mensagem de erro será apresentada no item, a execução do script será abortada.