# - \#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 [arquivo de configuração do
Zabbix Server](/pt/manual/appendix/config/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.

::: notewarning
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.
:::

#### - 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).

::: noteimportant
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.