This is the documentation page for an unsupported version of Zabbix.
Is this not what you were looking for? Switch to the current version or choose one from the drop-down menu.

10 Paramètres Utilisateurs

Les fonctionnalités des agents Zabbix peuvent être améliorées en definissant des paramètres utilisateurs (UserParameter) dans le fichier de configuration de l'agent.

Les paramètres utilisateurs sont des commandes, exécutées pas l'agent zabbix.

10.1 Paramètres utilisateurs simples

Dans le but de définir un nouveau paramètre pour la supervision, une ligne doit être ajoutée au fichier de configuration de l'agent zabbix qui doit être redémarré.

Le paramètre utilisateur possède la syntaxe suivante:

UserParameter=clé,commande
Paramètre Description
clé Clé d'item unique.
Commande La commande qui doit être exécutée pour évaluer la valeur de la clé.
Exemple 1

Commande simple

UserParameter=ping,echo 1

L'agent retournera toujours '1' pour l'item avec la clé 'ping'.

Exemple 2

Exemple plus complexe

UserParameter=mysql.ping,mysqladmin -uroot ping|grep alive|wc –l

L'agent retournera '1', si le serveur MySQL tourne et '0' dans le cas contraire.

10.2 Paramètres utilisateur flexibles

Les paramètres utilisateur flexibles peuvent être utilisés pour plus de contrôle et de fléxibilité.

Pour des paramètres utilisateur flexibles,

UserParameter=clé[*],commande
Paramètre Description
Clé Clé d'item unique. Le symbole [*] spécifie que cette clé accepte les paramètres.
Commande La commande qui doit être exécutée pour évaluer la valeur de la clé.
Zabbix analyse le contenu de [] et substitue $1,…,$10 dans la commande.

Il n'est pas permis de passer des paramètres flexibles contenants ces symboles:
\ ' " ` * ? [ ] { } ~ $ ! & ; ( ) < > | # @ \0

Exemple 1

Quelque chose de très simple

UserParameter=ping[*],echo $1

Nous pouvons définir un nombre illimité d'items pour tout superviser en ayant le format ping[quelque chose].

  • ping[0] – retournera toujours '0'
  • ping[aaa] – retournera toujours 'aaa'
Exemple 2

Ajoutons un peu plus de sens!

UserParameter=mysql.ping[*],mysqladmin –u$1 –p$2 ping|grep alive|wc –l

Ce paramètre peut être utilisé pour superviser la disponibilité d'une base de données MySQL. Nous pouvons passer le nom d'utilisateur et le mot de passe:

mysql.ping[zabbix,our_password]
Exemple 3

Combien de lignes correspondent à une expression régulière dans un fichier?

UserParameter=wc[*],grep "$2" $1|wc -l

Ce paramètre peut être utilisé pour calculer le nombre de lignes d'un fichier.

wc[/etc/passwd,root]
       wc[/etc/services|zabbix]

Notez que Zabbix agent daemon ne supporte pas les paramètres utilisateurs avec -t ou -p inversés. Voir manpage pour plus d'informations.