Table of Contents
11 Verificações externas
Visão geral
A verificação externa é uma verificação executada pelo Zabbix server por meio da execução de um script shell ou de um binário. No entanto, quando os hosts são monitorados por um Zabbix proxy, as verificações externas são executadas pelo proxy.
As verificações externas não exigem que nenhum agent esteja em execução no host monitorado.
A sintaxe da chave do item é:
Onde:
| ARGUMENTO | DEFINIÇÃO |
|---|---|
| script | Nome de um script shell ou de um binário. |
| parâmetro(s) | Parâmetros de linha de comando opcionais. |
Se você não quiser passar nenhum parâmetro para o script, pode usar:
O Zabbix server ou proxy pesquisará o diretório especificado para scripts externos e executará o comando (consulte o parâmetro ExternalScripts no arquivo de configuração do Zabbix server/proxy). O comando será executado sob o mesmo usuário do Zabbix server/proxy, portanto, quaisquer permissões de acesso ou variáveis de ambiente devem ser tratadas em um script wrapper, se necessário. As permissões no comando também devem permitir que esse usuário o execute. Somente comandos no diretório especificado estão disponíveis para execução.
Não use excessivamente as verificações externas, pois cada script exige o início de um processo fork pelo Zabbix server/proxy, e a execução de muitos scripts pode diminuir significativamente o desempenho do Zabbix.
Exemplo de uso
Executando o script check_oracle.sh com o primeiro parâmetro '-h'. O segundo parâmetro será substituído pelo endereço IP ou nome DNS, dependendo da seleção nas propriedades do host.
Assumindo que o host está configurado para usar o endereço IP, o server/proxy do Zabbix executará:
Resultado da verificação externa
O valor de retorno de uma verificação externa é uma saída padrão juntamente com um erro padrão produzido pela verificação.
Um item que retorna texto (caracter, log ou tipo de informação texto) não ficará não suportado em caso de saída de erro padrão.
O valor de retorno é limitado a 16MB (incluindo espaços em branco à direita que são truncados); limites do banco de dados também se aplicam.
Se o script solicitado não for encontrado ou o Zabbix server/proxy não tiver permissões para executá-lo, o item ficará não suportado e uma mensagem de erro correspondente será exibida.
Em caso de timeout, o item ficará não suportado, uma mensagem de erro correspondente será exibida e o processo criado para o script será encerrado.