7 Vérification externe
Aperçu
Une vérification externe est une vérification exécutée par le serveur Zabbix en lançant un script shell ou un binaire. Cependant, lorsque les hôtes sont surveillés par un proxy Zabbix, les vérifications externes sont exécutées par le proxy.
Les vérifications externes ne nécessitent aucun agent en cours d'exécution sur un hôte surveillé.
La syntaxe de la clé d'élément est la suivante :
script[<parameter1>,<parameter2>,...]Où :
| ARGUMENT | DÉFINITION |
|---|---|
| script | Nom d'un script shell ou d'un binaire. |
| parameter(s) | Paramètres de ligne de commande facultatifs. |
Si vous ne souhaitez transmettre aucun paramètre au script, vous pouvez utiliser :
script[] ou
scriptLe serveur Zabbix ou le proxy recherchera le répertoire spécifié pour les scripts externes et exécutera la commande (voir le paramètre ExternalScripts dans le fichier de configuration du serveur/proxy Zabbix).
La commande sera exécutée sous le même utilisateur que le serveur/proxy Zabbix, donc les permissions d'accès ou les variables d'environnement doivent, si nécessaire, être gérées dans un script d'encapsulation.
Les permissions sur la commande doivent également autoriser cet utilisateur à l'exécuter.
Seules les commandes situées dans le répertoire spécifié sont disponibles à l'exécution.
N'utilisez pas excessivement les vérifications externes, car chaque script nécessite le lancement d'un processus fork par le serveur/proxy Zabbix, et l'exécution d'un grand nombre de scripts peut réduire considérablement les performances de Zabbix.
Exemple d'utilisation
Exécution du script check_oracle.sh avec le premier paramètre '-h'. Le deuxième paramètre sera remplacé par l'adresse IP ou le nom DNS, selon la sélection dans les propriétés de l'hôte.
check_oracle.sh["-h","{HOST.CONN}"]En supposant que l'hôte soit configuré pour utiliser une adresse IP, le serveur/proxy Zabbix exécutera :
check_oracle.sh '-h' '192.168.1.4'Résultat de la vérification externe
La valeur de retour d’une vérification externe correspond à la sortie standard ainsi qu’à la sortie d’erreur standard produites par la vérification.
Un élément qui renvoie du texte (type d’information caractère, journal ou texte) ne deviendra pas non pris en charge en cas de sortie sur la sortie d’erreur standard.
La valeur de retour est limitée à 16 Mo (y compris les espaces de fin qui sont tronqués) ; les limites de la base de données s’appliquent également.
Si le script demandé est introuvable ou si le serveur/proxy Zabbix n’a pas les autorisations nécessaires pour l’exécuter, l’élément deviendra non pris en charge et un message d’erreur correspondant sera affiché.
En cas de dépassement du délai d’attente, l’élément deviendra non pris en charge, un message d’erreur correspondant sera affiché et le processus créé pour le script sera terminé.