Zabbix Documentation 4.4

3.04.04.4 (current)| In development:5.0 (devel)| Unsupported:1.82.02.22.43.23.44.2Guidelines

User Tools

Site Tools


pt:manual:config:items:itemtypes:external

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

pt:manual:config:items:itemtypes:external [2019/04/02 06:04] (current)
Line 1: Line 1:
 +==== - #11 Verificações externas ====
 +
 +=== - 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 [[pt:​manual:​appendix:​config:​zabbix_server|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.
 +
 +<note warning>​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.</​note>​
 +
 +=== - 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"​
 +
 +=== - 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).
 +
 +<note important>​O item passará a ficar como não suportado caso ocorra um erro no '​output'​.</​note>​
 +
 +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.