Documentation
Table of Contents
11 Verifica??es externas
Vis?o geral
Verifica??o externa ¨¦ uma verifica??o executada pelo Áú»¢¶Ä²© Server pela execu??o de um script shell ou um bin¨¢rio. No entanto, quando hosts s?o monitorados por um Áú»¢¶Ä²© Proxy, as verifica??es externas s?o executadas pelo Proxy.
As verifica??es externas n?o requerem qualquer agente em execu??o no host sendo monitorado.
A sintaxe da chave do item ¨¦:
Onde:
| ARGUMENTO | DEFINI??O |
|---|---|
| script | Nome de um script shell ou um bin¨¢rio. |
| par?metro(s) | Par?metros de linha de comando opcionais. |
Se voc¨º n?o quer passar nenhum par?metro para o script voc¨º pode usar:
O Áú»¢¶Ä²© Server consultar¨¢ o diret¨®rio definido como localiza??o para scripts externos (par?metro 'ExternalScripts' no arquivo de configura??o do Áú»¢¶Ä²© Server) e executar¨¢ o comando. O comando ser¨¢ executado com o mesmo usu¨¢rio com o qual o Áú»¢¶Ä²© Server est¨¢ sendo executado, ent?o quaisquer permiss?es de acesso ou vari¨¢veis de ambiente devem ser manipuladas em scripts agrupados (wrapper script), se necess¨¢rio, e as permiss?es para o comando devem permitir execu??o para o usu¨¢rio. Apenas comandos no diret¨®rio especificado ficam dispon¨ªveis para execu??o.
N?o abuse de verifica??es externas! Como cada script requer iniciar um processo filho (fork) pelo Áú»¢¶Ä²© Server, a execu??o de muitos scripts pode diminuir muito a performance do Áú»¢¶Ä²©.
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 Áú»¢¶Ä²© ir¨¢ executar:
Resultado de verifica??o externa
O valor de retorno da verifica??o externa ¨¦ a sa¨ªda padr?o junto com a sa¨ªda de erro padr?o (a sa¨ªda completa com espa?os em branco finais removidos ¨¦ retornada desde o Áú»¢¶Ä²© 2.0).
Um item texto (tipo de informa??o caracter, log ou texto) n?o se tornar¨¢ n?o suportado no caso de haver dados na sa¨ªda de erro padr?o.
No caso de o script requisitado n?o ser encontrado ou o Áú»¢¶Ä²© Server n?o possuir permiss?es para execut¨¢-lo, o item se tornar¨¢ n?o suportado e a mensagem de erro correspondente ser¨¢ apresentada. No caso de tempo esgotado, o item ser¨¢ marcado tamb¨¦m como n?o suportado, uma mensagem de erro relacionada ser¨¢ apresentada e o processo filho para o script ser¨¢ destru¨ªdo.