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.

1 Agent Zabbix

Aperçu

Ces vérifications utilisent la communication avec l'agent Zabbix pour la collecte de données.

Il existe des vérifications passives et actives d'agents. Lorsque vous configurez un élément, vous pouvez sélectionner le type requis :

  • Zabbix agent - pour les vérifications passives
  • Zabbix agent (active) - pour les vérifications actives

Clés d'élément supportées

Le tableau fournit des détails sur les clés d'élément que vous pouvez utiliser avec les éléments d'agent Zabbix.

Voir aussi :

** Paramètres obligatoires et facultatifs **

Les paramètres sans chevrons sont obligatoires. Les paramètres marqués avec des chevrons < > sont facultatifs.

Clé
Description Valeur de retour Paramètres Commentaires
agent.hostname
Nom de l'hôte. Chaîne Retourne la valeur actuelle correspondant au nom de l'agent dans le fichier de configuration.
agent.ping
Vérification de la disponibilité de l'agent. Rien - indisponible

1 - disponible
Utiliser la fonction de déclencheur nodata() pour vérifier l'indisponibilité de l'hôte.
agent.version
Version de l'agent Zabbix. Chaîne Exemple de valeur de retour :
1.8.2
kernel.maxfiles
Nombre maximum de fichiers ouverts supporté par l'OS. Entier
kernel.maxproc
Nombre maximum de processus supporté par l'OS. Entier
log[file,<regexp>,<encoding>,<maxlines>,<mode>,<output>,<maxdelay>]
Supervision de fichier de log. Log file - chemin d'accès complet et nom du fichier de log
regexp - expression régulière4 décrivant le motif requis
encoding - encodage du texte
maxlines - nombre maximum de nouvelles lignes par seconde que l'agent enverra au serveur ou proxy Zabbix. Ce paramètre remplace la valeur de 'MaxLinesPerSecond' dans zabbix_agentd.conf
mode - valeurs possibles :
all (par défaut), skip - ignorer le traitement des anciennes données (affecte uniquement les éléments nouvellement créés).
output - un modèle de mise en forme de sortie optionnel. La séquence d'échappement \0 est remplacée par la partie du texte correspondant (à partir du premier caractère où la correspondance commence jusqu'au dernier caractère où la correspondance se termine) alors qu'une séquence d'échappement \N (où N=1...9) est remplacée par le Nième groupe correspondant (ou une chaîne vide si le N dépasse le nombre de groupes capturés).
maxdelay - délai maximum en secondes. Type : flottant. Valeurs : 0 - (par défaut) n'ignore jamais les lignes de fichiers de log ; > 0.0 - ignore les anciennes lignes afin d'obtenir les lignes les plus récentes analysées dans les secondes "maxdelay". Lire les notes maxdelay avant de l'utiliser !
L'élément doit être configuré en tant que vérification active.
Si le fichier est manquant ou que les permissions sur le fichier empêche l'accès, l'élément devient non supporté.

Si le champ output est laissé vide - la ligne entière contenant la correspondance du texte est retournée. Notez que tous les types d'expressions régulières globales sauf 'Résultat est VRAI’ retournent toujours toute la ligne correspondante et le paramètre output est ignoré.

L'extraction de contenu à l'aide du paramètre output a lieu sur l'agent.

Exemples :
=> log[/var/log/syslog]
=> log[/var/log/syslog,error]
=> log[/home/zabbix/logs/logfile,,,100]

En utilisant le paramètre outputpour extraire un nombre depuis un enregistrement du journal :
=> log[/app1/app.log,"task run [0-9.]+ sec, processed ([0-9]+) records, [0-9]+ errors",,,,\1] → correspondra à l'enregistrement "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" et renverra seulement '6080' au serveur. Car une valeur numérique a été envoyée, le "Type d'information"pour cet élément peut être positionné sur "Numérique (non signé)"et la valeur pourra être utilisée dans les graphiques, les déclencheurs etc.

En utilisant le paramètre outputpour transformer l'enregistrement avant d'être envoyé au serveur :
=> log[/app1/app.log,"([0-9 :-]+) task run ([0-9.]+) sec, processed ([0-9]+) records, ([0-9]+) errors",,,,"\1 RECORDS: \3, ERRORS: \4, DURATION: \2"] → correspondra à l'enregistrement "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" et envoie l'enregistrement modifié "2015-11-13 10:08:26 RECORDS: 6080, ERRORS: 0, DURATION: 6.08" au serveur.

Le paramètre mode est supporté depuis Zabbix 2.0.
Le paramètre output est supporté depuis Zabbix 2.2.
Le paramètre maxdelay est supporté depuis Zabbix 3.2.

Voir aussi des informations supplémentaires sur la supervision des fichiers de log.
log.count[file,<regexp>,<encoding>,<maxproclines>,<mode>,<maxdelay>]
Compte le nombre de lignes qui correspondent dans le fichier de log. Entier file - chemin d'accès complet et nom du fichier de log
regexp - expression régulière4 décrivant le modèle requis
encoding - encodage du texte
maxproclines - nombre maximum de nouvelles lignes par seconde que l’agent va analyser. La valeur par défaut est 10*'MaxLinesPerSecond' dans zabbix_agentd.conf.
mode - valeurs possibles :
all (par défaut), skip - ignorer le traitement des anciennes valeurs (affecte uniquement les éléments nouvellement créés).
maxdelay - délai maximum en secondes. Type : flottant. Valeurs : 0 - (par défaut) n’ignore jamais les lignes du fichier de log ; > 0.0 - ignore les anciennes lignes afin d’obtenir les lignes les plus récentes analysées dans les "maxdelay" secondes. Lire les notes concernant maxdelay avant de l’utiliser !
L’élément doit être configuré en tant que vérification active.
Si le fichier est manquant ou que les permissions sur le fichier en empêche l'accès, l'élément devient non supporté.

Voir aussi les informations supplémentaires sur la supervision des fichiers de log.

Cet élément n'est pas supporté pour les journaux d'événements Windows.

Supporté depuis Zabbix 3.2.0.
logrt[file_regexp,<regexp>,<encoding>,<maxlines>,<mode>,<output>,<maxdelay>,<options>]
Surveillance du fichier de log avec prise en charge de la rotation. Log file_regexp - chemin absolu vers le fichier et l'expression régulière décrivant le modèle de nom de fichier
regexp - expression régulière4 décrivant le motif requis
encoding - encodage du texte
maxlines - nombre maximum de nouvelles lignes par seconde que l'agent enverra au serveur ou proxy Zabbix. Ce paramètre remplace la valeur de 'MaxLinesPerSecond' dans zabbix_agentd.conf
mode - valeurs possibles :
all (par défaut), skip - ignorer le traitement des anciennes données (affecte uniquement les éléments nouvellement créés).
output - un modèle de mise en forme de sortie optionnel. La séquence d'échappement \0 est remplacée par la partie du texte correspondant (à partir du premier caractère où la correspondance commence jusqu'au dernier caractère où la correspondance se termine) alors qu'une séquence d'échappement \N (où N=1...9) est remplacée par le Nième groupe correspondant (ou une chaîne vide si N dépasse le nombre de groupes capturés).
maxdelay - délai maximum en secondes. Type : flottant. Valeurs : 0 - (par défaut) n'ignore jamais les lignes de fichier de log ; > 0.0 - ignore les anciennes lignes afin d'obtenir les lignes les plus récentes analysées dans les "maxdelay" secondes. Lire les notes liées à maxdelay avant de l'utiliser !
options - type de rotation de fichier de log file rotation. Valeurs possibles :
rotate (par défaut), copytruncate. Notez que copytruncate ne peut pas être utilisé avec maxdelay. Dans ce cas maxdelay doit être 0 ou non spécifié. Voir les notes liées à copytruncate.
L’élément doit être configuré en tant que vérification active.
La rotation de fichier de log est basée sur la date de dernière modification des fichiers.

Si le paramètre output est laissé vide la ligne entière contenant le texte recherché est retourné. Notez que tous les types d'expressions régulières globales sauf 'Résultat est VRAI’ retournent toujours toute la ligne correspondante et le paramètre output est ignoré.

L'extraction de contenu à l'aide du paramètre output a lieu sur l'agent.

Exemples :
=> logrt["/home/zabbix/logs/^logfile[0-9]{1,3}$",,,100] → %% correspondra à un fichier comme "logfile1" (ne correspondra pas à ".logfile1")%%
=> logrt["/home/user/^logfile_.*_[0-9]{1,3}$","pattern_to_match","UTF-8",100] → %% collectera les données d’un fichier comme "logfile_abc_1" ou "logfile__001".%%

En utilisant le paramètre outputpour extraire un nombre de l'enregistrement :
=> logrt[/app1/^test.*log$,"task run [0-9.]+ sec, processed ([0-9]+) records, [0-9]+ errors",,,,\1] → correspondra à l'enregistrement "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" et renverra seulement '6080' au serveur. Car une valeur numérique a été envoyée, le "Type d'information"pour cet élément peut être positionné sur "Numérique (non signé)"et la valeur pourra être utilisée dans les graphiques, les déclencheurs, etc.

En utilisant le paramètre outputpour transformer un enregistrement avant d'être envoyé au serveur :
=> logrt[/app1/^test.*log$,"([0-9 :-]+) task run ([0-9.]+) sec, processed ([0-9]+) records, ([0-9]+) errors",,,,"\1 RECORDS: \3, ERRORS: \4, DURATION: \2"] → correspondra à l'enregistrement "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" et envoie l'enregistrement modifié "2015-11-13 10:08:26 RECORDS: 6080, ERRORS: 0, DURATION: 6.08" au serveur.

Le paramètre mode est supporté depuis Zabbix 2.0.
Le paramètre output est supporté depuis Zabbix 2.2.
Le paramètre maxdelay est supporté depuis Zabbix 3.2.
Le paramètre options est supporté depuis Zabbix 4.0.

Voir aussi des informations supplémentaires sur la supervision des fichiers de log.
logrt.count[file_regexp,<regexp>,<encoding>,<maxproclines>,<mode>,<maxdelay>,<options>]
Nombre de lignes correspondantes dans la surveillance des fichiers de logs avec prise en charge de la rotation. Entier file_regexp - chemin absolu vers le fichier et l'expression régulière4 décrivant le modèle de nom de fichier
regexp - expression régulière4 décrivant le modèle de contenu requis
encoding - encodage du texte
maxproclines - nombre maximum de nouvelles lignes par seconde que l'agent va analyser. La valeur par défaut est 10*'MaxLinesPerSecond' dans zabbix_agentd.conf.
mode - valeurs possibles:
all (par défaut), skip - ignorer le traitement des anciennes données (affecte uniquement les éléments nouvellement créés).
maxdelay - délai maximum en secondes. Type: float. Valeurs : 0 - (par défaut) n'ignore jamais les lignes de fichier journal ; > 0.0 - ignore les anciennes lignes afin d'obtenir les lignes les plus récentes analysées dans les secondes "maxdelay". Lire les notes de maxdelayavant de l'utiliser!
options - type de rotation de fichier de log. Valeurs possibles :
rotate (par défaut), copytruncate. Notez que copytruncate ne peut pas être utilisé avec maxdelay. Dans ce cas maxdelay doit être 0 ou non spécifié. Voir les notes liées à copytruncate.

L’élément doit être configuré en tant que vérification active.
La rotation de fichier de log est basée sur la date de dernière modification des fichiers.

Le paramètre options est supporté depuis Zabbix 4.0.

Cet élément n'est pas supporté pour les journaux d'événements Windows.

Supporté depuis Zabbix 3.2.0.
net.dns[<ip>,name,<type>,<timeout>,<count>,<protocol>]
Vérifie si le service DNS fonctionne. 0 - le DNS est arrêté (le serveur n'a pas répondu ou la résolution DNS a échoué)

1 - le DNS est OK
ip - adresse IP du serveur DNS (laissez vide pour le serveur DNS par défaut, ignoré sous Windows)
name - nom du serveur DNS à interroger
type - type d'enregistrement à interroger (par défaut, SOA )
timeout (ignoré sous Windows) - délai d'expiration de la requête en secondes (la valeur par défaut est 1 seconde)
count (ignoré sous Windows) - nombre d'essais pour la requête (la valeur par défaut est 2)
protocol - le protocole utilisé pour effectuer des requêtes DNS : udp (par défaut) ou tcp
Exemple:
=> net.dns[8.8.8.8,zabbix.com,MX,2,1]

Les valeurs possibles pour type sont :
ANY, A, NS, CNAME, MB, MG, MR, PTR, MD, MF, MX, SOA, NULL, WKS (sauf pour Windows), HINFO, MINFO, TXT, SRV.

Les noms de domaine internationalisés ne sont pas supportés, veuillez utiliser les noms codés IDNA à la place.

Le paramètre protocol est supporté depuis Zabbix 3.0.
Le type d'enregistrement SRV est pris en charge depuis les versions d'agent Zabbix 1.8.6 (Unix) et 2.0.0 (Windows).

Nom avant Zabbix 2.0 (toujours supporté) : net.tcp.dns
net.dns.record[<ip>,name,<type>,<timeout>,<count>,<protocol>]
Effectue une requête DNS. Chaîne de caractères avec le type d'information demandé ip - adresse IP du serveur DNS (laissez vide pour le serveur DNS par défaut, ignoré sous Windows)
name - nom DNS à interroger
type - type d' enregistrement à interroger (par défaut, SOA)
timeout (ignoré sous Windows) - délai d'expiration de la requête en secondes (la valeur par défaut est 1 seconde)
count (ignoré sous Windows) - nombre d'essais pour la requête (la valeur par défaut est 2)
protocol - le protocole utilisé pour effectuer des requêtes DNS : udp (par défaut) ou tcp
Example:
=> net.dns.record[8.8.8.8,zabbix.com,MX,2,1]

Les valeurs possible pour type sont :
ANY, A, NS, CNAME, MB, MG, MR, PTR, MD, MF, MX, SOA, NULL, WKS (sauf pour Windows), HINFO, MINFO, TXT, SRV

Les noms de domaine internationalisés ne sont pas supportés, veuillez utiliser les noms codés IDNA à la place.

Le paramètre protocol est supporté depuis Zabbix 3.0.
Le type d'enregistrement SRV est pris en charge depuis les versions d'agent Zabbix 1.8.6 (Unix) et 2.0.0 (Windows).

Nom avant Zabbix 2.0 (toujours supporté) : net.tcp.dns.query
net.if.collisions[if]
Nombre de collisions hors de la fenêtre. Entier if - nom de l’interface réseau
net.if.discovery
Liste des interfaces réseaux. Utilisé pour la découverte de bas niveau. Objet JSON Supporté depuis l’agent Zabbix version 2.0.

Sur FreeBSD, OpenBSD et NetBSD supporté depuis l’agent Zabbix version 2.2.

Certaines versions Windows (par exemple, Server 2008) peuvent nécessiter l'installation des dernières mises à jour pour prendre en charge les caractères non ASCII dans les noms d'interface.
net.if.in[if,<mode>]
Statistiques du trafic entrant sur l'interface réseau. Entier if - nom de l’interface réseau (Unix); Description complète de l'interface réseau ou adresse IPv4 (Windows)
mode - valeurs possibles :
bytes - nombre d’octets (par défault)
packets - nombre de paquets
errors - nombre d’erreurs
dropped - nombre de paquets perdus
overruns (fifo) - le nombre d’erreur du buffer FIFO
frame - le nombre d'erreurs de trames de paquets
compressed - le nombre de paquets compressés transmis ou reçus par le pilote de périphérique
multicast - le nombre de trames de multidiffusion reçues par le pilote de périphérique
Sous Windows, l'élément obtient des valeurs à partir des compteurs 64 bits, si disponibles. Les compteurs de statistiques d'interface 64 bits ont été introduits dans Windows Vista et Windows Server 2008. Si les compteurs 64 bits ne sont pas disponibles, l'agent utilise des compteurs 32 bits.

Les noms d'interface multi-octets sous Windows sont pris en charge depuis la version de l'agent Zabbix 1.8.6.

Exemples :
=> net.if.in[eth0,errors]
=> net.if.in[eth0]

Vous pouvez obtenir des descriptions d'interface réseau sur Windows avec les éléments net.if.discovery et net.if.list.

Vous pouvez utiliser cette clé lors de l’étape de pré-traitement Change per second pour obtenir des statistiques en octets par seconde.
net.if.out[if,<mode>]
Statistiques du trafic sortant sur l'interface réseau. Entier if - nom de l’interface réseau (Unix); Description complète de l'interface réseau ou adresse IPv4 (Windows)
mode - valeurs possibles :
bytes - nombre d’octets (par défaut)
packets - nombre de paquets
errors - nombre d’erreurs
dropped - nombre de paquets perdus
overruns (fifo) - le nombre d’erreur du buffer FIFO
collisions (colls) - le nombre de collision détectées sur l’interface
carrier - le nombre de pertes carrier détectées par le pilote de périphérique 
compressed - le nombre de paquets compressés transmis par le pilote de périphérique
Sous Windows, l'élément obtient des valeurs à partir des compteurs 64 bits, si disponibles. Les compteurs statistiques d'interface 64 bits ont été introduits dans Windows Vista et Windows Server 2008. Si les compteurs 64 bits ne sont pas disponibles, l'agent utilise des compteurs 32 bits. 

Les noms d'interface multi-octets sous Windows sont pris en charge depuis la version de l'agent Zabbix 1.8.6.

Exemples :
=> net.if.out[eth0,errors]
=> net.if.out[eth0]

Vous pouvez obtenir des descriptions d'interface réseau sur Windows avec net.if.discovery ou net.if.list items.

Vous pouvez utiliser cette clé lors de l’étape de pré-traitement Change per second pour obtenir des statistiques en octets par seconde.
net.if.total[if,<mode>]
Somme des statistiques du trafic entrant et sortant sur l'interface réseau. Entier if - nom de l’interface réseau (Unix); Description complète de l'interface réseau ou adresse IPv4 (Windows)
mode - valeurs possibles :
bytes - nombre d’octets (par défaut)
packets - nombre de paquets
errors - nombre d’erreurs
dropped - nombre de paquets perdus
overruns (fifo) - le nombre d’erreur du buffer FIFO
compressed - le nombre de paquets compressés transmis par le pilote de périphérique
Sous Windows, l'élément obtient des valeurs à partir des compteurs 64 bits, si disponibles. Les compteurs statistiques d'interface 64 bits ont été introduits dans Windows Vista et Windows Server 2008. Si les compteurs 64 bits ne sont pas disponibles, l'agent utilise des compteurs 32 bits. 

Exemples :
=> net.if.total[eth0,errors]
=> net.if.total[eth0]

Vous pouvez obtenir des descriptions d'interface réseau sur Windows avec net.if.discovery ou net.if.list items.

Vous pouvez utiliser cette clé lors de l’étape de pré-traitement Change per second pour obtenir des statistiques en octets par seconde.

Notez que les paquets perdus ne sont pris en charge que si net.if.in et net.if.out fonctionnent pour les paquets perdus sur votre plate-forme.
net.tcp.listen[port]
Vérifie si ce port TCP est dans l'état LISTEN. 0 - il n'est pas dans l'état d'écoute

1 - il est en état d'écoute
port - numéro du port TCP Exemple :
=> net.tcp.listen[80]

Sous Linux supporté depuis l'agent Zabbix version 1.8.4 

Depuis Zabbix 3.0.0, sur les noyaux Linux 2.6.14 et supérieurs, les informations sur l'écoute des sockets TCP sont obtenues à partir de l'interface NETLINK du noyau, si possible. Sinon, les informations sont récupérées à partir des fichiers /proc/net/tcp et /proc/net/tcp6.
net.tcp.port[<ip>,port]
Vérifie s'il est possible d'établir une connexion TCP avec le port spécifié. 0 - connexion impossible

1 - connexion possible
ip - adresse IP (par défaut 127.0.0.1)
port - numéro de port
Exemple :
=> net.tcp.port[,80] → peut être utilisé pour tester la disponibilité du serveur Web exécuté sur le port 80.

Pour des tests de performances TCP simples, utilisez net.tcp.service.perf[tcp,<ip>,<port>]

Notez que ces vérifications peuvent entraîner des messages supplémentaires dans les fichiers de log du démon système (les sessions SMTP et SSH étant généralement loggées).

Ancien nom : check_port[*]
net.tcp.service[service,<ip>,<port>]
Vérifie si le service est en cours d'exécution et accepte les connexions TCP. 0 - le service est arrêté

1 - le service fonctionne
service - l’un parmi :
ssh, ldap, smtp, ftp, http, pop, nntp, imap, tcp, https, telnet (voir les détails)
ip -adresse IP (par défaut 127.0.0.1)
port - numéro du port (par défaut, le numéro de port du service standard est utilisé)
Exemple :
=> net.tcp.service[ftp,,45] → peut être utilisé pour tester la disponibilité du serveur FTP sur le port TCP 45. 

Notez que ces vérifications peuvent entraîner des messages supplémentaires dans les fichiers de log du démon système (les sessions SMTP et SSH étant généralement loggées). 

La vérification des protocoles cryptés (comme IMAP sur le port 993 ou POP sur le port 995) n'est actuellement pas supportée. Pour contourner ce problème, utilisez net.tcp.port pour les vérifications similaires.

La vérification de l'agent LDAP et HTTPS par Windows n'est actuellement pas prise en charge.

Notez que la vérification de telnet recherche une invite de connexion (avec ‘:’ à la fin).

Voir aussi les problèmes connus concernant la vérification du service HTTPS.

Les services https et telnet sont supportés depuis Zabbix 2.0.

Ancien nom : check_service[*]
net.tcp.service.perf[service,<ip>,<port>]
Vérifie les performances du service TCP. 0 - le service est arrêté

seconds - le nombre de secondes passées à se connecter au service
service - l’un parmi :
ssh, ldap, smtp, ftp, http, pop, nntp, imap, tcp, https, telnet (voir les détails)
ip - adresse IP (défaut 127.0.0.1)
port - numéro du port (par défaut, le numéro de port de service standard est utilisé)
Exemple :
=> net.tcp.service.perf[ssh] → peut être utilisé pour tester la vitesse de la réponse initiale du serveur SSH.

La vérification des protocoles cryptés (comme IMAP sur le port 993 ou POP sur le port 995) n'est actuellement pas prise en charge. Pour résoudre ce problème, utilisez net.tcp.service.perf[tcp,<ip>,<port>] pour les vérifications de ce type.

La vérification de l'agent LDAP et HTTPS par Windows n'est actuellement pas prise en charge.

Notez que la vérification de telnet recherche une invite de connexion (avec ‘:’ à la fin).

Voir aussi les problèmes connus concernant la vérification du service HTTPS.

Les services https et telnet sont supportés depuis Zabbix 2.0

Ancien nom : check_service_perf[*]
net.udp.listen[port]
Vérifie si ce port UDP est en état LISTEN. 0 - il n'est pas en état LISTEN

1 - il est en état LISTEN
port - numéro de port UDP Exemple :
=> net.udp.listen[68]

Sur Linux, supporté depuis l’agent Zabbix en version 1.8.4
net.udp.service[service,<ip>,<port>]
Vérifie si le service est en cours d'exécution et répond aux demandes UDP. 0 - le service est arrêté

1 - le service fonctionne
service - ntp (voir les détails)
ip - adresse IP (par défaut 127.0.0.1)
port - numéro du port (par défaut, le numéro de port du service standard est utilisé)
Exemple :
=> net.udp.service[ntp,,45] → peut être utilisé pour tester la disponibilité du service NTP sur le port UDP 45.

Cet élément est supporté depuis Zabbix 3.0.0, mais le service ntp était disponible pour les éléments net.tcp.service[] dans les versions précédentes.
net.udp.service.perf[service,<ip>,<port>]
Vérifie les performances du service UDP. 0 - le service est arrêté

seconds - le nombre de secondes passées à attendre la réponse du service
service - ntp (voir les détails)
ip - adresse IP (par défaut 127.0.0.1)
port - numéro du port (par défaut, le numéro de port du service standard est utilisé)
Exemple :
=> net.udp.service.perf[ntp] → peut être utilisé pour tester le temps de réponse du service NTP.

Cet élément est supporté depuis Zabbix 3.0.0, mais le service ntp était disponible pour l’élément net.tcp.service[] dans les versions précédentes.
proc.cpu.util[<name>,<user>,<type>,<cmdline>,<mode>,<zone>]
Pourcentage d’utilisation du processeur Flottant name - nom du processus (par défaut tous les processus)
username - nom de l’utilisateur (par défaut tous les utilisateurs)
type - type d’utilisation CPU :
total (défaut), utilisateur, system
cmdline - filtrer par ligne de commande (il s’agit d’une expression régulière4)
mode - mode de récupération des données : avg1 (défaut), avg5, avg15
zone - zone cible : current (défaut), all. Ce paramètre est supporté uniquement sur les plateformes Solaris.
Exemples :
=> proc.cpu.util[,root] → Utilisation du processeur de tous les processus s'exécutant sous l'utilisateur ‘’root’’
=> proc.cpu.util[zabbix_server,zabbix] → Utilisation du processeur de tous les processus zabbix_server exécutés sous l'utilisateur zabbix

La valeur renvoyée est basée sur le pourcentage d'utilisation du cœur du processeur unique. Par exemple, l'utilisation du processeur d'un processus utilisant deux cœurs est de 200%.

Les données d'utilisation du processeur sont recueillies par un collecteur qui prend en charge le maximum de 1024 requêtes uniques (par nom, utilisateur et ligne de commande). Les requêtes non accessibles au cours des dernières 24 heures sont supprimées du collecteur.

Cette clé est supportée depuis Zabbix 3.0.0 et est disponible sur plusieurs plateformes (voir les éléments supportés par plateforme).
proc.mem[<name>,<user>,<mode>,<cmdline>,<memtype>]
Mémoire utilisée par le processus en octets. Entier - avec mode comme max, min, sum

Flottant - avec mode comme avg
name - nom du processus (par défaut all processes)
user - nom de l’utilisateur (par défaut all users)
mode - valeurs possibles :
avg, max, min, sum (défaut)
cmdline - filtrer par ligne de commande line (il s’agit d’une expression régulière4)
memtype - type de mémoire utilisée par processus
Exemples :
=> proc.mem[,root] → mémoire utilisée par tous les processus s'exécutant sous l'utilisateur "root"
=> proc.mem[zabbix_server,zabbix] → mémoire utilisée par tous les processus zabbix_server exécutés sous l'utilisateur zabbix
=> proc.mem[,oracle,max,oracleZABBIX] → mémoire utilisée par le processus le plus gourmand en mémoire sous oracle ayant oracleZABBIX dans sa ligne de commande

Remarque : Lorsque plusieurs processus utilisent la mémoire partagée, la somme de la mémoire utilisée par les processus peut générer des valeurs importantes et irréalistes.

Voir les notes sur la sélection des processus avec les paramètres name et cmdline (spécifiques à Linux).

Le paramètre memtype est supporté sur plusieurs platformes depuis Zabbix 3.0.0.
proc.num[<name>,<user>,<state>,<cmdline>]
Nombre de processus. Entier name - nom du processus (par défaut all processes)
user - nom de l'utilisateur (par défaut all users)
state - valeurs possibles :
all (par défaut),
disk - sommeil ininterrompu,
run - s'exécute,
sleep - sommeil interruptible,
trace - arrêté,
zomb - zombie
cmdline - filtre par ligne de commande (il s'agit d'une expression régulière4)
Exemples :
=> proc.num[,mysql] → nombre de processus s'exécutant sous l'utilisateur mysql
=> proc.num[apache2,www-data] → nombre de processus apache2 s'exécutant sous l'utilisateur www-data
=> proc.num[,oracle,sleep,oracleZABBIX] → nombre de processus en état de veille s'exécutant en tant qu'utilisateur oracle ayant oracleZABBIX dans sa ligne de commande

Voir les notes concernant la sélection des processus avec les paramètres name et cmdline (Spécifique à Linux).

Sur Windows, seuls les paramètres name et user sont supportés.

Les valeurs de disk et trace pour le paramètre state sont supportés depuis Zabbix 3.4.0.
sensor[device,sensor,<mode>]
Lecture d'un capteur matériel. Flottant device - nom du périphérique
sensor - nom du capteur
mode - valeurs possibles :
avg, max, min (si ce paramètre est omis, le périphérique et le capteur sont traités textuellement).
Lit /proc/sys/dev/sensors sur Linux 2.4.

Exemple :
=> sensor[w83781d-i2c-0-2d,temp1]

Dans les versions antérieures à Zabbix 1.8.4, le format sensor[temp1] était utilisé.
Lit /sys/class/hwmon sur Linux 2.6+.

Voir une description plus détaillée de l'élément capteur sur Linux.
lit la MIB hw.sensors sur OpenBSD.

Exemples :
=> sensor[cpu0,temp0] → température d'un CPU
=> sensor["cpu[0-2]$",temp,avg] → température moyenne des trois premiers CPU

Supporté sur OpenBSD depuis Zabbix 1.8.4.
system.boottime
Heure du dernier démarrage. Entier (horodatage Unix)
system.cpu.discovery
Liste des CPU/cœurs de CPU détectés. Utilisé pour la découverte de bas niveau. objet JSON Supporté sur toutes les plateformes depuis Zabbix 2.4.0.
system.cpu.intr
Interruption du périphérique. Entier
system.cpu.load[<cpu>,<mode>]
Charge CPU. Flottant cpu - valeurs possibles :
all (par défaut), percpu (charge totale divisée par le nombre de processeurs en ligne)
mode - valeurs possibles :
avg1 (par défaut moyenne sur une minute), avg5, avg15
Exemple :
=> system.cpu.load[,avg5]

percpu est supporté depuis Zabbix 2.0.0.

Ancien nom : system.cpu.loadX
system.cpu.num[<type>]
Nombre de CPUs. Entier type - valeurs possibles :
online (par défaut), max
Exemple :
=> system.cpu.num
system.cpu.switches
Nombre de commutateurs de contexte. Entier Ancien nom : system[switches]
system.cpu.util[<cpu>,<type>,<mode>]
Pourcentage d'utilisation CPU. Flottant cpu - <numéro du CPU> ou all (par défaut)
type - valeurs possibles :
idle, nice, user (par défaut), system (par défaut pour Windows), iowait, interrupt, softirq, steal, guest (sur les kernels Linux 2.6.24 et supérieur), guest_nice (sur les kernels Linux 2.6.33 et supérieur). Les paramètres temps user et nice n'incluent plus le temps guest et le temps guest_nice depuis Zabbix 3.0.14, 3.4.5 et 4.0.0.
mode - valeurs possibles :
avg1 (moyenne sur une minute, par défaut), avg5, avg15
Exemple :
=> system.cpu.util[0,user,avg5]

Anciens noms : system.cpu.idleX, system.cpu.niceX, system.cpu.systemX, system.cpu.userX
system.hostname[<type>]
Nom d'hôte du système. Chaîne type (Windows uniquement, ne doit pas être utilisé sur les autres systèmes) - valeurs possibles : netbios (par défaut) ou host La valeur est récupérée par les fonctions GetComputerName() (pour netbios) ou gethostname() (pour host) sur Windows et par la commande "hostname" sur les autres systèmes.

Exemples de valeurs de retour :
sur Linux:
=> system.hostname → linux-w7x1
=> system.hostname → www.zabbix.com
sur Windows :
=> system.hostname → WIN-SERV2008-I6
=> system.hostname[host] → Win-Serv2008-I6LonG

Le paramètre type pour cet élément est supporté depuis Zabbix 1.8.6.

Voir aussi une description plus détaillée.
system.hw.chassis[<info>]
Informations sur le châssis. Chaîne info - full (par défaut), model, serial, type ou vendor Exemple : system.hw.chassis[full]
Hewlett-Packard HP Pro 3010 Small Form Factor PC CZXXXXXXXX Desktop]

Cette clé dépend de la disponibilité de la table SMBIOS.
Essayera de lire la table DMI de sysfs, si l'accès sysfs échoue alors il essayera de lire directement en mémoire.

Les autorisations Root sont nécessaires car la valeur est récupérée en lisant sysfs ou en mémoire.

Supporté depuis l'agent Zabbix en version 2.0.
system.hw.cpu[<cpu>,<info>]
Information sur le processeur. Chaîne ou entier cpu - <numéro du CPU> ou all (par défaut)
info - valeurs possibles :
full (par défaut), curfreq, maxfreq, model ou vendor
Exemple :
=> system.hw.cpu[0,vendor] → AuthenticAMD

Récupère les informations dans /proc/cpuinfo et /sys/devices/system/cpu/[cpunum]/cpufreq/cpuinfo_max_freq.

Si le numéro du CPU et curfreq ou maxfreq est spécifié, une valeur numérique est retournée (Hz).

Supporté depuis l'agent Zabbix en version 2.0.
system.hw.devices[<type>]
Liste des périphériques PCI ou USB. Texte type - pci (par défaut) ou usb Exemple :
=> system.hw.devices[pci] → 00:00.0 Host bridge: Advanced Micro Devices [AMD] RS780 Host Bridge
[..]

Renvoie la sortie de l'utilitaire lspci ou lsusb (exécuté sans aucun paramètre)
Pris en charge depuis la version 2.0 de l'agent Zabbix.
system.hw.macaddr[<interface>,<format>]
Liste des adresses MAC. Chaîne interface - all (par défaut) ou une expression régulière4
format - full (par défaut) ou short
Liste les adresses MAC des interfaces dont le nom correspond à l'expression régulière4 de l'interface donnée (all liste toutes les interfaces).

Exemple :
=> system.hw.macaddr["eth0$",full] → [eth0] 00:11:22:33:44:55

Si format est spécifié comme short, les noms d'interfaces et les adresses MAC identiques ne sont pas listées.

Supporté depuis l'agent Zabbix en version 2.0.
system.localtime[<type>]
Heure du sytème. Entier - avec type à utc

Chaîne - avec type à local
type - valeurs possibles :
utc - (par défaut) temps écoulé depuis le 1er Janvier 1970 00:00:00 UTC, mesuré en secondes.
local - l'heure dans le format 'yyyy-mm-dd,hh:mm:ss.nnn,+hh:mm'
Doit être utilisé pour les vérifications passives uniquement.

Les paramètres pour cet élément sont supportés depuis l'agent Zabbix en version 2.0.

Exemple :
=> system.localtime[local] → créé un élément à l'aide de cette clé, puis utilisez-le pour afficher l'heure de l'hôte dans l'élément d'écran Horloge.
system.run[command,<mode>]
Exécute la commande spécifiée sur l'hôte. Résultat de la commande sous forme de texte

1 - avec mode à nowait (peu importe le résultat de la commande)
command - commande à exécuter
mode - valeurs possibles :
wait - attend la fin de l'exécution (par défaut),
nowait - ne pas attendre
Il est possible de renvoyer jusqu'à 512 Ko de données, y compris les espaces de fin tronqués.
Pour être traitée correctement, la sortie de la commande doit être du texte.

Exemple :
=> system.run[ls -l /] → liste détaillée des fichiers du répertoire racine.

Remarque: Pour activer cette fonctionnalité, le fichier de configuration de l'agent doit contenir l'option EnableRemoteCommands=1.

La valeur de retour de l'élément est la sortie standard avec l'erreur standard produite par la commande. Le code de sortie n'est pas vérifié.

Le résultat vide est autorisé à partir de Zabbix 2.4.0.
Voir aussi : Exécution de commandes.
system.stat[resource,<type>]
Statistiques du système. Entier ou flottant ent - nombre d'unités de processeur que cette partition est autorisée à recevoir (flottant)
kthr,<type> - informations sur l'état des threads du noyau :
r - nombre moyen de threads exécutables du noyau (flottant)
b - nombre moyen de threads du noyau placés en file d'attente du gestionnaire de mémoire virtuelle (flottant)
memory,<type> - informations concernant l'utilisation de la mémoire virtuelle et de la mémoire réelle :
avm - pages virtuelles actives (entier)
fre - taille de la liste libre (entier)
page,<type> - informations concernant les erreurs de page et l'activité de pagination :
fi - page-ins fichier par seconde (flottant)
fo - page-outs fichier par seconde (float)
pi - pages entrantes paginées dans l'espace de pagination (flottant)
po - pages sortantes paginées de l'espace de pagination (flottant)
fr - pages libérées (remplacement de la page) (flottant)
sr - pages scannées par l'algorithme de remplacement de page (flottant)
faults,<type> - taux de traps et d'interruptions :
in - interruption de périphériques (flottant)
sy - appels système (flottant)
cs - commutateurs de contexte de threads du noyau (flottant)
cpu,<type> - répartition du pourcentage d'utilisation du temps processeur :
us - temps utilisateur (flottant)
sy - temps système (flottant)
id - temps d'inactivité (flottant)
wa - temps d'inactivité durant lequel le système avait des requêtes d' E/S disque/NFS en attente (flottant)
pc - nombre de processeurs physiques consommés (flottant)
ec - le pourcentage de capacité admissible consommée (flottant)
lbusy - indique le pourcentage d'utilisation des processeurs logiques survenu lors de l'exécution au niveau de l'utilisateur et du système (flottant)
app - indique les processeurs physiques disponibles dans le pool partagé (flottant)
disk,<type> - statistiques du disque :
bps - indique la quantité de données transférées (lues ou écrites) sur le lecteur en octets par seconde (entier)
tps - indique le nombre de transferts par seconde qui ont été émis sur le disque physique/la bande (flottant)
Commentaires
Cet élément est supporté seulement sur AIX, depuis Zabbix 1.8.1.
Les éléments suivants sont supportés seulement sur AIX LPAR de type "Shared" :
=> system.stat[cpu,app]
=> system.stat[cpu,ec] (également sur "Dedicated" depuis Zabbix 4.0.1 ; retourne toujours 100 (pourcentage))
=> system.stat[cpu,lbusy]
=> system.stat[cpu,pc] (également sur "Dedicated" depuis Zabbix 4.0.1)
=> system.stat[ent] (également sur "Dedicated" depuis Zabbix 4.0.1)
system.sw.arch
Informations sur l'architecture logicielle. Chaîne Exemple :
=> system.sw.arch → i686

L'information est récupérée via la fonction uname().

Supporté depuis l'agent Zabbix en version 2.0.
system.sw.os[<info>]
Informations sur le système d'exploitation. Chaîne info - valeurs possibles :
full (par défaut), short ou name
Exemple :
=> system.sw.os[short]→ Ubuntu 2.6.35-28.50-generic 2.6.35.11

L'information est récupérée via (notez que tous les fichiers et les options sont présents sur toutes les distributions) :
/proc/version (full)
/proc/version_signature (short)
le paramètre PRETTY_NAME DE /etc/os-release sur le système le supportant, ou /etc/issue.net (name)

Supporté depuis l'agent Zabbix en version 2.0.
system.sw.packages[<package>,<manager>,<format>]
Liste les packages installés. Texte package - all (par défaut) ou une expression régulière4
manager - all (par défaut) ou un gestionnaire de package
format - full (par défaut) ou short
Liste (par ordre alphabétique) les paquets installés dont le nom correspond à l'expression régulière4 donnée (all : les liste tous).

Exemple :
=> system.sw.packages[mini,dpkg,short] → python-minimal, python2.6-minimal, ubuntu-minimal

Supporte les gestionnaires de packages (exécution de commandes):
dpkg (dpkg --get-selections)
pkgtool (ls /var/log/packages)
rpm (rpm -qa)
pacman (pacman -Q)

Si format est specifié à full, les packages sont regroupés par le gestionnaire de package (chaque gestionnaire sur un ligne séparée commençant par son nom entre crochets).
Si format est specifié à short, les packages ne sont pas regroupés et sont listés sur une seule ligne.

Supporté depuis l'agent Zabbix en version 2.0.
system.swap.in[<device>,<type>]
Statistiques du swap entrant (du périphérique à la mémoire). Entier device - périphérique utilisé pour le swap (all par défaut)
type - valeurs possibles :
count (nombre de swapins), sectors (secteurs swappés), pages (pages swappées). Voir le support par plateforme pour plus de détails sur les valeurs pas défaut.
Exemple :
=> system.swap.in[,pages]

La source de cette information est :
/proc/swaps, /proc/partitions, /proc/stat (Linux 2.4)
/proc/swaps, /proc/diskstats, /proc/vmstat (Linux 2.6)
system.swap.out[<device>,<type>]
Statistiques du swap sortant (de la mémoire vers le périphérique). Entier device - périphérique utilisé pour le swap (all par défaut)
type - valeurs possibles :
count (nombre de swapouts), sectors (secteurs swappés), pages (pages swappées). Voir le support par plateforme pour plus de détails sur les valeurs par défaut.
Exemple :
=> system.swap.out[,pages]

La source de cette information est :
/proc/swaps, /proc/partitions, /proc/stat (Linux 2.4)
/proc/swaps, /proc/diskstats, /proc/vmstat (Linux 2.6)
system.swap.size[<device>,<type>]
Taille de l'espace de swap en octets ou en pourcentage du total Entier - pour les octets

Flottant - pour le pourcentage
device - périphérique utilisé pour le swap (par défaut est all)
type - valeurs possibles :
free (espace libre du swap, par défaut), pfree (espace libre du swap, en pourcentage), pused (espace utilisé du swap, en pourcentage), total (espace totale du swap), used (espace utilisé du swap)
Exemple :
=> system.swap.size[,pfree] → pourcentage d'espace libre du swap

Si device n'est pas spécifié l'agent Zabbix ne prendra pas en compte le périphérique d'échange (fichiers), la mémoire physique sera ignorée. Par exemple, sur les systèmes Solaris la commande swap -s inclut une partie de la mémoire physique et de périphérique d'échange (contrairement à swap -l).

Notez que cette clé peut renvoyer un pourcentage erroné sur les plateforme Windows virtualisées (VMware ESXi, VirtualBox). Dans ce cas, il est préférable d'utiliser la clé perf_counter[\700(_Total)\702] pour obtenir les données d'utilisation correctes du swap.

Ancien nom : system.swap.free, system.swap.total
system.uname
Identification du system. Chaîne Exemple de valeur de retour (Unix) :
FreeBSD localhost 4.2-RELEASE FreeBSD 4.2-RELEASE #0: Mon Nov i386

Exemple de valeur de retour (Windows):
Windows ZABBIX-WIN 6.0.6001 Microsoft® Windows Server® 2008 Standard Service Pack 1 x86

Sur Unix, depuis Zabbix 2.2.0, la valeur de cet élément est obtenue avec l'appel système uname(). Précédemment, elle était obtenue en invoquant "uname -a". ". La valeur de cet élément peut différer de la sortie de "uname -a" et n'inclut pas les informations supplémentaires que "uname -a" affiche en fonction d'autres sources.

Sur Windows, depuis Zabbix 3.0, la valeur pour cet élément est obtenue par les classes WMI Win32_OperatingSystem et Win32_Processor. Précédemment, elle était obtenue depuis les APIs Windows volatiles et des clés de registre non documentées. Le nom de l'OS (édition incluse) peut être traduit dans la langue d'affichage de l'utilisateur. Sur certaines versions de Windows, il contient des symboles de marque et des espaces supplémentaires.

Notez que sous Windows, l'élément renvoie l'architecture du système d'exploitation, tandis que sous Unix, il renvoie l'architecture du processeur.
system.uptime
Temps de fonctionnement du système en secondes. Entier Dans la configuration de l'élément, utilisez les unités s ou uptime pour avoir des valeurs lisibles.
system.users.num
Nombre d'utilisateurs connectés. Entier La commande who est utilisée côté agent pour obtenir la valeur.
vfs.dev.read[<device>,<type>,<mode>]
Statistiques de lecture de disque. Entier - avec type à sectors, operations, bytes

Flottant - avec type à sps, ops, bps

Note : Depuis 4.0.4, si un intervalle de mise à jour de 3h ou plus est utilisé2, retournera toujours '0'
device - périphérique disque (all par défaut)
type - valeurs possibles : sectors, operations, bytes, sps, ops, bps
Ce paramètre doit être spécifié, car les valeurs par défaut diffèrent selon les systèmes d'exploitation.
sps, ops, bps représentent respectivement : secteurs, opérations, octets par secondes.
mode - valeurs possibles : avg1 (moyenne par minutes, par défaut), avg5, avg15.
Ce paramètre est supporté uniquement avec le type à : sps, ops, bps.
Vous pouvez utiliser des noms de périphériques relatifs (par exemple, sda) ainsi que le préfixe optionnel /dev/ (par exemple, /dev/sda).

Les volumes logiques LVM sont supportés.

Les valeurs pas défaut du paramètre 'type' pour différents OS :
AIX - operations
FreeBSD - bps
Linux - sps
OpenBSD - operations
Solaris - bytes

Exemple :
=> vfs.dev.read[,operations]

sps, ops et bps sur les plates-formes prises en charge sont limités à 8 périphériques (7 individuels et un pour all). Depuis Zabbix 2.0.1 cette limite est de 1024 périphériques (1023 individuels et un pour all).

Ancien nom : io[*]
vfs.dev.write[<device>,<type>,<mode>]
Statistiques d'écriture du disque. Entier - avec type à sectors, operations, bytes

Flottant - avec type à sps, ops, bps

Note : Depuis 4.0.4, si un intervalle de 3h ou plus est utilisé 2, retournera toujours '0'
device - périphérique disque (all 3par défaut)
type - valeurs possibles : sectors, operations, bytes, sps, ops, bps
Ce paramètre doit être spécifié, car les valeurs par défaut diffèrent selon les systèmes d'exploitation.
sps, ops, bps représentent respectivement : secteurs, opérations, octets par secondes.
mode - valeurs possibles : avg1 (moyenne par minutes, par défaut), avg5, avg15.
Ce paramètre est supporté uniquement avec le type à : sps, ops, bps.
Vous pouvez utiliser des nom de périphériques relatifs (par exemple, sda) ainsi que le préfixe optionnel /dev/ prefix (par exemple, /dev/sda).

Les volumes logiques sont supportés.

Les valeurs pas défaut du paramètre 'type' pour différents OS :
AIX - operations
FreeBSD - bps
Linux - sps
OpenBSD - operations
Solaris - bytes

Exemple :
=> vfs.dev.write[,operations]

sps, ops et bps sur les plates-formes prises en charge sont limités à 8 périphériques (7 individuels et un pour all). Depuis Zabbix 2.0.1 cette limite est de 1024 périphériques (1023 individuels et un pour all).

Ancien nom : io[*]
vfs.dir.count[dir,<regex_incl>,<regex_excl>,<types_incl>,<types_excl>,<max_depth>,<min_size>,<max_size>,<min_age>,<max_age>]
Compte le nombre d'entrées d'un dossier. Entier dir - chemin absolu du dossier
regex_incl - expression régulière4 décrivant le modèle de nom du fichier, du répertoire et du lien symbolique à inclure (inclus tous les fichiers, dossiers et liens symboliques si vide; la valeur par défaut est une chaîne vide)
regex_excl - expression régulière4 décrivant le modèle de nom du fichier, du répertoire et du lien symbolique à exclure (ne rien exclure si vide ; la valeur par défaut est une chaîne vide)
types_incl - un ensemble de types d'entrées de dossier à compter, valeurs possibles :
file - fichier, dir - sous-dossier, sym - lien symbolique, sock - socket, bdev - périphérique block, cdev - character device, fifo- FIFO, dev- synonyme de "bdev,cdev", all- tous les types mentionnés précédemment, c'est à dire "file,dir,sym,sock,bdev,cdev,fifo". Il s'agit de la valeur par défaut, si le paramètre est laissé vide. Les types multiples doivent être séparés par des virgules et l'ensemble doit être entouré par des doubles guillements "".
types_excl - un ensemble de types d'entrées de dossier à ne pas compter, les mêmes valeurs et syntaxes que pour <types_incl> s'appliquent. Si certaines entrées se trouvent dans <types_incl> et dans <types_excl>, les entrées de ce type ne seront PAS comptées.
max_depth - profondeur maximum de sous-dossier à traverser. -1 (par défaut) - illimté, 0 - ne descend pas dans les sous-dossiers.
min_size - taille minimum des fichiers à compter. Les fichiers plus petits que la taille spécifiée ne seront pas comptés. La valeur est en octets. Les suffixes mémoire peuvent être utilisés.
max_size - taille maximum des fichiers à compter. Les fichiers plus gros que la taille spécifiée ne seront pas comptés. La valeur est en octets. Les suffixes mémoire peuvent être utilisés.
min_age - âge minimum d'entrée du dossier à compter. Les entrées modifiées avant cette valeur ne seront pas comptées. Il s'agit d'un entier représentant des secondes. Les suffixes de temps peuvent être utilisés.
max_age - âge maximum d'entrée du dossier à compter. Les entrées aussi vieilles ou plus vieilles que la valeur spécifiée ne seront pas comptées (basé sur l'heure de modification). Il s'agit d'un entier représentant des secondes. Les suffixes de temps peuvent être utilisés.
Les variables d'environnement comme %APP_HOME%, $HOME et %TEMP% ne sont pas supportées.

Les pseudo-répertoires "." et ".." ne sont jamais comptabilisés.

Les liens symboliques ne sont jamais suivis pour la traversée des répertoires.

Pour les répertoires Windows, les liens symboliques sont ignorés et les liens physiques ne sont comptabilisés qu'une seule fois.

regex_incl et regex_excl sont des expressions régulières compatibles Perl (PCRE). regex_incl et regex_excl sont appliqués au fichiers et aux répertoires lors du calcul de la taille d'une entrée, mais sont ignorés lors de la traversée d'un dossier (si regex_incl est “(?i)^.+\.zip$” et max_depth n'est pas positionné, alors tous les sous-répertoires seront traversés, mais seulement les fichiers de type zip seront comptés). Si un nom de fichier correspond à regex_incl et à regex_excl ce fichier ne sera pas compté.

Le temps d'exécution sera limité par une valeur de délai d'attente par défaut de 3 secondes (paramètre «Timeout» dans le fichier de configuration de l'agent). Étant donné que la traversée de répertoires volumineux peut prendre plus de temps que cela, aucune donnée ne sera renvoyée et l'élément sera marqué comme "non pris en charge". Le décompte partiel ne sera pas retourné.

Lors du filtrage par taille, seuls les fichiers réguliers ont des tailles significatives. Sous Linux et BSD, les répertoires ont également une taille non nulle (quelques Ko généralement). Les périphériques ont une taille nulle, par exemple la taille de /dev/sda1 ne reflète pas la taille de la partition associée. Par conséquent, lors de l'utilisation des paramètres <min_size> et <max_size>, il est conseillé de spécifier <types_incl> à "file", pour éviter les surprises.

Exemples :
⇒ vfs.dir.count[/dev] - surveille le nombre de périphériques dans /dev (Linux)
⇒ vfs.dir.count["C:\Users\ADMINI~1\AppData\Local\Temp"] - surveille le nombre de fichier dans le répertoire temporaire (Windows)

Supporté depuis Zabbix 4.0.0.
vfs.dir.size[dir,<regex_incl>,<regex_excl>,<mode>,<max_depth>]
Taille d'un répertoire (en octets). Entier dir - chemin absolu du répertoire
regex_incl - expression régulière4 décrivant le modèle de nom de fichier, répertoire et lien symbolique à inclure (inclure tous les fichiers, répertoires et liens symboliques si vide, une chaîne vide est la valeur par défaut)
regex_excl - expression régulière4 décrivant le fichier, le répertoire et le lien symbolique à exclure (ne pas exclure si vide, unechaîne vide est la valeur par défaut)
mode - valeurs possibles :
apparent (par défaut) - obtient des tailles de fichiers apparentes plutôt que l'utilisation du disque (agit comme du -sb dir), disk - obtient l'utilisation du disque (agit comme du -s -B1 dir). Contrairement à la commande du, l'élément vfs.dir.size prend en compte les fichiers cachés lors du calcul de la taille du répertoire (agit comme du -sb .[^.]* * dans le répertoire).
max_depth - profondeur maximale des sous-répertoires à parcourir. -1 (par défaut) - illimité, 0 - pas de descente dans les sous-répertoires.
Seuls les répertoires avec au moins l'autorisation de lecture pour l'utilisateur zabbix sont calculés.

Sur Windows, les liens symboliques et les liens durs ne sont pris en compte qu'une seule fois.

Avec des répertoires volumineux ou des lecteurs lents, cet élément peut expirer en raison du paramètre Timeout dans les fichiers de configuration de l'agent et du serveur/proxy. Augmentez les valeurs de délai d'attente si nécessaire.

Exemple :
⇒ vfs.dir.size[/tmp,log] - calcule la taille de tous les fichiers dans /tmp qui contiennent 'log'
⇒ vfs.dir.size[/tmp,log,^.+\.old$] - calcule la taille de tous les fichiers dans /tmp qui contiennent 'log', en excluant ceux contenant '.old'

La taille limite des fichiers dépend de la prise en charge des fichiers volumineux.

Supporté depuis Zabbix 3.4.0.
vfs.file.cksum[file]
Checksum du fichier, calculé par l'algorithme UNIX cksum. Entier file - chemin complet d'accès au fichier Exemple :
=> vfs.file.cksum[/etc/passwd]

Exemple de valeur de retour :
1938292000

Ancien nom : cksum

La taille du fichier dépend de la prise en charge des fichiers volumineux.
vfs.file.contents[file,<encoding>]
Récupère le contenu d'un fichier. Texte file - chemin complet d'accès au fichier
encoding - encodage
Retourne une chaîne vide si le fichier est vide ou contient seulement les caractères LF/CR.

Exemple :
=> vfs.file.contents[/etc/passwd]

Cet élément est limité au fichier dont la taille est inférieur à 64 Ko.

Supporté depuis l'agent Zabbix en version 2.0.
vfs.file.exists[file]
Vérifie si le fichier existe. 0 - non trouvé

1 - le fichier ou le lien (symbolique ou dur) vers le fichier existe
file - chemin complet d'accès au fichier Exemple :
=> vfs.file.exists[/tmp/application.pid]

La valeur de retour dépend de ce que retourne la macro S_ISREG POSIX.

La limite de la taille du fichier dépend de la prise en charge des fichiers volumineux.
vfs.file.md5sum[file]
checksum MD5 du fichier. Chaîne de caractères (table de hachage MD5 du fichier) file - chemin complet d'accès au fichier Exemple :
=> vfs.file.md5sum[/usr/local/etc/zabbix_agentd.conf]

Exemple de valeur de retour :
b5052decb577e0fffd622d6ddc017e82

La taille limite (64 Mo) pour cet élément a été supprimée en version 1.8.6.

La taille limite du fichier dépend de la prise en charge des fichiers volumineux.
vfs.file.regexp[file,regexp,<encoding>,<start line>,<end line>,<output>]
Trouve une chaîne dans un fichier. La ligne contenant la chaîne correspondante, ou comme spécifiée par le paramètre optionnel output file - chemin d'accès complet au fichier
regexp - Expression régulière4 décrivant le modèle requis
encoding - encodage
start line - Le numéro de la première ligne à chercher (première ligne du fichier par défaut).
end line - le numéro de la dernière ligne à chercher (dernière ligne du fichier par défaut).
output - un modèle de mise en forme de sortie en option. La séquence d'échappement \0 est remplacée par la partie du texte correspondant (à partir du premier caractère où la correspondance commence jusqu'au dernier caractère où la correspondance se termine) alors qu'une séquence d'échappement \N (où N=1...9) est remplacée par le Nième groupe correspondant (ou une chaîne vide si N dépasse le nombre de groupes capturés).
Seule la première ligne correspondante est retournée.
Une chaîne vide est renvoyée si aucune ligne ne correspond à l'expression.
L'extraction de contenu à l'aide du paramètre outpout a lieu sur l'agent.
Les paramètres start line, end line et ouput sont supporté depuis la version 2.2.

Exemples :
=> vfs.file.regexp[/etc/passwd,zabbix]
=> vfs.file.regexp[/path/to/some/file,"([0-9]+)$",,3,5,\1]
=> vfs.file.regexp[/etc/passwd,^zabbix:.:([0-9]+),,,,\1] → récupère l'ID de l'utilisateur zabbix
vfs.file.regmatch[file,regexp,<encoding>,<start line>,<end line>]
Trouve une chaîne dans un fichier. 0 - aucune correspondance trouvée

1 - correspondance trouvée
file - chemin d'accès complet au fichier
regexp - Expression régulière4 décrivant le modèle
encoding - encodage
start line - numéro de la première ligne à chercher (première ligne du fichier par défaut).
end line - numéro de la dernière ligne à chercher (dernière ligne du fichier par défaut).
Les paramètres start line et end line sont supporté depuis la version 2.2.

Exemple :
=> vfs.file.regmatch[/var/log/app.log,error]
vfs.file.size[file]
Taille du fichier (en octets). Entier file - chemin d'accès complet au fichier Le fichier doit avoir les permission en lecture pour l'utilisateur zabbix.

Exemple :
=> vfs.file.size[/var/log/syslog]

La taille limite du fichier dépend de la prise en charge des fichiers volumineux.
vfs.file.time[file,<mode>]
Informations temporelles du fichier. Entier (horodatage Unix) file - chemin d'accès complet au fichier
mode - valeurs possibles :
modify (par défaut) - date de modification, access - date du dernier accès, change - date du dernier changement
Exemple :
=> vfs.file.time[/etc/passwd,modify]

La taille limite du fichier dépend de la prise en charge des fichiers volumineux.
vfs.fs.discovery
Liste des systèmes de fichiers montés. Utilisé pour la découverte de bas niveau. Objet JSON Supporté depuis l'agent Zabbix en version 2.0.

La macro {#FSDRIVETYPE} est supportée sur Windows depuis l'agent Zabbix en version 3.0.
vfs.fs.inode[fs,<mode>]
Nombre ou pourcentage d'inodes. Entier - pour les nombres

Flottant - pour les pourcentages
fs - système de fichier
mode - valeurs possibles :
total (par défaut), free, used, //pfree // (libre, pourcentage), pused (utilisé, pourcentage)
Exemple :
=> vfs.fs.inode[/,pfree]

Ancien nom : vfs.fs.inode.free[*], vfs.fs.inode.pfree[*], vfs.fs.inode.total[*]
vfs.fs.size[fs,<mode>]
Espace disque en octets ou en pourcentage du total. Entier - pour les octets

Flottant - pour les pourcentages
fs - Système de fichiers
mode - valeurs possibles :
total (par défaut), free, used, pfree (free, pourcentage), pused (used, pourcentage)
Dans le cas d'un volume monté, l'espace disque du système de fichier local est retourné.

Exemple :
=> vfs.fs.size[/tmp,free]

L’espace réservé d'un système de fichiers est pris en compte et n'est pas inclus lors de l'utilisation du mode free.

Ancien nom : vfs.fs.free[*], vfs.fs.total[*], vfs.fs.used[*], vfs.fs.pfree[*], vfs.fs.pused[*]
vm.memory.size[<mode>]
Taille de la mémoire en octets ou en pourcentage du total. Entier - pour les octets

Flottant - pour les pourcentages
mode - valeurs possibles :
total (par défaut), active, anon, buffers, cached, exec, file, free, inactive, pinned, shared, slab, wired, used, pused (used, pourcentage), available, pavailable (available, pourcentage)
Cet élément accepte 3 catégories de paramètres :

1) total - quantité totale de mémoire ;
2) types de mémoire spécifiques à la plate-forme : active, anon, buffers, cached, exec, file, free, inactive, pinned, shared, slab, wired;
3) les estimations au niveau utilisateur sur la quantité de mémoire utilisée et disponible : used, pused, available, pavailable.

Voir une description plus détaillée des parameters de vm.memory.size.

Ancien nom : vm.memory.buffers, vm.memory.cached, vm.memory.free, vm.memory.shared, vm.memory.total
web.page.get[host,<path>,<port>]
Récupère le contenu d'une page web. Source de la page Web en tant que texte (y compris les en-têtes) host - nom de l'hôte
path - chemin du document HTML (par défaut : /)
port - numéro de port (par défaut 80)
Retourne une chaîne vide en cas d'échec.

Exemple :
=> web.page.get[www.zabbix.com,index.php,80]
web.page.perf[host,<path>,<port>]
Temps de chargement de la page Web complète (en secondes). Flottant host - nom de l'hôte
path - chemin du document HTML (par défaut : /)
port - numéro de port (par défaut 80)
Retourne 0 en cas d'échec.

Exemple :
=> web.page.perf[www.zabbix.com,index.php,80]
web.page.regexp[host,<path>,<port>,<regexp>,<length>,<output>]
Trouve une chaîne sur une page Web. La chaîne correspondante, ou comme spécifiée par le paramètre output optionnel host - nom de l'hôte
path - chemin du document HTML (par défaut : /)
port - numéro de port (par défaut 80)
regexp - Expression régulière4 décrivant le modèle
length - nombre maximum de caractères à retourner
output - un modèle de mise en forme de sortie facultatif. La séquence d'échappement \0 est remplacée par la partie du texte correspondant (à partir du premier caractère où la correspondance commence jusqu'au dernier caractère où la correspondance se termine) alors qu'une séquence d'échappement \N (où N=1...9) est remplacée par le Nième groupe correspondant (ou une chaîne vide si N dépasse le nombre de groupes capturés).
Retourne une chaîne vide si aucune correspondance n'a été trouvée ou en cas d'échec.

L'extraction de contenu à l'aide du paramètre output se fait au niveau de l'agent.

Le paramètre output est supporté depuis la version 2.2.

Exemple :
=> web.page.regexp[www.zabbix.com,index.php,80,OK,2]
zabbix.stats[<ip>,<port>]
Renvoie un ensemble de métriques internes du serveur Zabbix ou du proxy à distance. Objet JSON ip - Liste d'IP/DNS/masques de réseaux des serveurs / proxies à interroger à distance (par défaut : 127.0.0.1)
port - port du serveur / proxy à interroger à distance (par défaut : 10051)
Notez que la demande de statistiques ne sera acceptée qu'à partir des adresses répertoriées dans le paramètre serveur / proxy 'StatsAllowedIP' sur l'instance cible.

Un ensemble sélectionné de métriques internes est renvoyé par cet élément. Pour plus de détails, voir Surveillance à distance des statistiques Zabbix.

Cet élément est supporté depuis Zabbix 4.0.5.
zabbix.stats[<ip>,<port>,queue,<from>,<to>]
Renvoie le nombre d'éléments surveillés dans la file d'attente qui sont retardés sur le serveur Zabbix ou le proxy à distance. Objet JSON ip - Liste d'IP/DNS/masques de réseaux des serveurs / proxies à interroger à distance (par défaut : 127.0.0.1)
port - port du serveur / proxy à interroger à distance (par défaut : 10051)
queue - constante (à utiliser telle quelle)
from - retardé d'au moins (par défaut : 6 secondes)
to - retardé d'au plus (par défaut : infini)
Notez que la demande de statistiques ne sera acceptée qu'à partir des adresses répertoriées dans le paramètre serveur / proxy 'StatsAllowedIP' sur l'instance cible.

Cet élément est supporté depuis Zabbix 4.0.5.
Notes de bas de page

1 Remarque spécifique à Linux : L'agent Zabbix doit avoir un accès en lecture seule au système de fichiers /proc. Les correctifs du noyau de www.grsecurity.org limitent les droits d'accès des utilisateurs non privilégiés.

2 vfs.dev.read[], vfs.dev.write[] : à partir de Zabbix 4.0.4, l'agent Zabbix mettra fin à "stale" connexions de périphérique si les valeurs des éléments ne sont pas consultées pendant plus de 3 heures. Cela peut se produire si un système comporte des périphériques dont les chemins changent de manière dynamique ou si un périphérique est supprimé manuellement. Notez également que ces éléments, si vous utilisez un intervalle de mise à jour de 3 heures ou plus, renverront toujours "0".

3 vfs.dev.read[], vfs.dev.write[] : Si par défaut all est utilisé pour le premier paramètre, alors la clé renverra des statistiques récapitulatives, y compris tous les périphériques de blocs tels que sda, sbd et leurs partitions (sda1, sda2, sdb3...) et plusieurs périphériques (MD RAID) basés sur ces périphériques/partitions de blocs et volumes logiques (LVM) en fonction de ces périphériques/partitions de blocs. Dans ce cas, les valeurs renvoyées doivent être considérées uniquement comme des valeurs relatives (dynamiques dans le temps), mais pas comme des valeurs absolues.

4 Expression Régulière Compatible Perl (PCRE) depuis Zabbix 3.4 ; Expression régulière POSIX étendue avant cela. Voir aussi : Les expressions régulières supportées par emplacement.

Encodages disponibles

Le paramètre encoding est utilisé pour spécifier l’encodage pour le traitement des vérifications d'éléments correspondantes, afin que les données acquises ne soient pas corrompues. Pour obtenir une liste des codages pris en charge (identificateurs de page de codes), consultez la documentation correspondante, telle que la documentation relative à libiconv (GNU Project) ou Microsoft Windows SDK pour les "Identificateurs de page de code".

Si la valeur encoding est vide, alors UTF-8 (paramètres régionaux par défaut pour les nouvelles distributions Unix/Linux, voir les paramètres de votre système) ou ANSI avec une extension spécifique au système (Windows) est utilisé par défaut.

Dépannage des éléments d'agent

  1. Si elle est utilisée avec un agent passif, la valeur du Timeout dans la configuration du serveur peut être supérieure à Timeout dans le fichier de configuration de l'agent. Sinon, l'élément peut ne pas avoir de valeur car la demande du serveur vers l'agent a expiré en premier.