11 Vérifications externes
Vue d'ensemble
Une vérification externe est une vérification exécutée par le serveur Zabbix en lançant un script shell ou un binaire. Toutefois, lorsque des hôtes sont supervisés par un proxy Zabbix, les vérifications externes sont exécutées par le proxy.
Les vérifications externes ne nécessitent pas qu'un agent soit exécuté sur l'hôte supervisé.
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[] or
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 server/proxy Zabbix).
La commande sera exécutée sous le même utilisateur que le serveur/proxy Zabbix ; ainsi, les autorisations d'accès ou les variables d'environnement doivent être gérées dans un script wrapper, si nécessaire.
Les autorisations sur la commande doivent également permettre à cet utilisateur de l'exécuter.
Seules les commandes présentes dans le répertoire spécifié peuvent être exécutées.
N'abusez pas des vérifications externes, car chaque script nécessite le démarrage 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é.