5 Vérifications simples

Aperçu

Les vérifications simples sont normalement utilisées pour des vérifications distantes sans agent de services.

Notez que Zabbix agent n'est pas nécessaire pour les vérifications simples. Le serveur/proxy Zabbix est responsable du traitement des vérifications simples (établissement de connexions externes, etc.).

Exemples d'utilisation des vérifications simples :

net.tcp.service[ftp,,155]
net.tcp.service[http]
net.tcp.service.perf[http,,8080]
net.udp.service.perf[ntp]

Les champs Nom d'utilisateur et Mot de passe (limités à 255 caractères) dans la configuration d'un élément de vérification simple sont utilisés pour les éléments de supervision VMware ; ils sont ignorés dans les autres cas.

Vérifications prises en charge

Les clés d'élément sont répertoriées sans les paramètres optionnels ni les informations supplémentaires. Cliquez sur la clé d'élément pour voir tous les détails.

Voir aussi les clés d'élément de supervision VMware.

Clé d'élément Description
icmpping L'accessibilité de l'hôte par ping ICMP.
icmppingloss Le pourcentage de paquets perdus.
icmppingretry L'accessibilité de l'hôte par ping ICMP avec nouvelles tentatives.
icmppingsec Le temps de réponse au ping ICMP.
net.tcp.service Vérifie si un service est en cours d'exécution et accepte les connexions TCP.
net.tcp.service.perf Vérifie les performances d'un service TCP.
net.udp.service Vérifie si un service est en cours d'exécution et répond aux requêtes UDP.
net.udp.service.perf Vérifie les performances d'un service UDP.

Détails de la clé d’élément

Les paramètres sans crochets angulaires sont obligatoires. Les paramètres marqués par des crochets angulaires < > sont facultatifs.

icmpping[<target>,<packets>,<interval>,<size>,<timeout>,<options>]


L’accessibilité de l’hôte par ping ICMP.
Valeur de retour : 0 - échec du ping ICMP ; 1 - ping ICMP réussi.

Paramètres :

  • target - l’adresse IP ou le nom DNS de l’hôte ;
  • packets - le nombre de paquets ;
  • interval - le temps entre les paquets successifs, en millisecondes ;
  • size - la taille du paquet en octets ;
  • timeout - le délai d’expiration en millisecondes ;
  • options - utilisé pour autoriser la redirection : si vide (valeur par défaut), les réponses redirigées sont traitées comme si l’hôte cible était indisponible ; si défini sur allow_redirect, les réponses redirigées sont traitées comme si l’hôte cible était disponible.

Voir aussi le tableau des valeurs par défaut.

Exemple :

icmpping[,4] #Si au moins un paquet sur les quatre est renvoyé, l’élément retournera 1.
icmppingloss[<target>,<packets>,<interval>,<size>,<timeout>,<options>]


Le pourcentage de paquets perdus.
Valeur de retour : Float.

Paramètres :

  • target - l’adresse IP ou le nom DNS de l’hôte ;
  • packets - le nombre de paquets ;
  • interval - le temps entre les paquets successifs, en millisecondes ;
  • size - la taille du paquet en octets ;
  • timeout - le délai d’expiration en millisecondes ;
  • options - utilisé pour autoriser la redirection : si vide (valeur par défaut), les réponses redirigées sont traitées comme si l’hôte cible était indisponible ; si défini sur allow_redirect, les réponses redirigées sont traitées comme si l’hôte cible était disponible.

Voir aussi le tableau des valeurs par défaut.

icmppingretry[<target>,<retries>,<backoff>,<size>,<timeout>,<options>]


L’accessibilité de l’hôte par ping ICMP avec nouvelles tentatives. Si le premier paquet réussit, l’opération s’arrête ; si le paquet échoue, une nouvelle tentative est effectuée jusqu’à ce que le nombre maximal de tentatives défini dans le paramètre retries soit atteint. Cet élément est utile pour réduire le nombre de paquets envoyés sur le réseau.
Valeur de retour : 0 - échec du ping ICMP ; 1 - ping ICMP réussi.

Paramètres :

  • target - l’adresse IP ou le nom DNS de l’hôte ;
  • retries - le nombre de tentatives d’envoi d’un ping vers une cible, sans compter le premier essai (0 ou plus ; valeur par défaut : 1) ;
  • backoff - le nombre par lequel le temps d’attente est multiplié à chaque requête successive (plage de 1.0 à 5.0 ; valeur par défaut : 1.0) ;
  • size - la taille du paquet en octets ;
  • timeout - le délai d’expiration en millisecondes ;
  • options - utilisé pour autoriser la redirection : si vide (valeur par défaut), les réponses redirigées sont traitées comme si l’hôte cible était indisponible ; si défini sur allow_redirect, les réponses redirigées sont traitées comme si l’hôte cible était disponible.

Voir aussi le tableau des valeurs par défaut.

icmppingsec[<target>,<packets>,<interval>,<size>,<timeout>,<mode>,<options>]


Le temps de réponse du ping ICMP (en secondes).
Valeur de retour : Float.

Paramètres :

  • target - l’adresse IP ou le nom DNS de l’hôte ;
  • packets - le nombre de paquets ;
  • interval - le temps entre les paquets successifs, en millisecondes ;
  • size - la taille du paquet en octets ;
  • timeout - le délai d’expiration en millisecondes ;
  • mode - valeurs possibles : min, max ou avg (par défaut) ;
  • options - utilisé pour autoriser la redirection : si vide (valeur par défaut), les réponses redirigées sont traitées comme si l’hôte cible était indisponible ; si défini sur allow_redirect, les réponses redirigées sont traitées comme si l’hôte cible était disponible.

Commentaires :

  • Les paquets perdus ou expirés ne sont pas utilisés dans le calcul ;
  • Si l’hôte n’est pas disponible (délai d’expiration atteint), l’élément renverra 0 ;
  • Si la valeur de retour est inférieure à 0.0001 seconde, la valeur sera définie sur 0.0001 seconde ;
  • Voir également le tableau des valeurs par défaut.
net.tcp.service[service,<ip>,<port>]


Vérifie si un service est en cours d’exécution et accepte les connexions TCP.
Valeur de retour : 0 - le service est indisponible ; 1 - le service est en cours d’exécution.

Paramètres :

  • service - valeurs possibles : ssh, ldap, smtp, ftp, http, pop, nntp, imap, tcp, https, telnet (voir les détails) ;
  • ip - l’adresse IP ou le nom DNS (par défaut, l’IP/DNS de l’hôte est utilisé) ;
  • port - le numéro de port (par défaut, le numéro de port standard du service est utilisé).

Commentaires :

  • Notez qu’avec le service tcp, l’indication du port est obligatoire ;
  • Ces vérifications peuvent entraîner des messages supplémentaires dans les fichiers journaux des démons système (les sessions SMTP et SSH étant généralement journalisées) ;
  • La vérification des protocoles chiffrés (comme IMAP sur le port 993 ou POP sur le port 995) n’est actuellement pas prise en charge. Comme solution de contournement, veuillez utiliser net.tcp.service[tcp,<ip>,port] pour ce type de vérifications.

Exemple :

net.tcp.service[ftp,,45] #Cet élément peut être utilisé pour tester la disponibilité du serveur FTP sur le port TCP 45.

Si SELinux s’exécute en mode enforced, les contrôles simples TCP/UDP personnalisés peuvent être bloqués par la politique. Pour vérifier et autoriser la nouvelle connexion sortante, examinez les refus d’audit : avec grep denied /var/log/audit/audit.log

net.tcp.service.perf[service,<ip>,<port>]


Vérifie les performances d’un service TCP.
Valeur de retour : Float : 0.000000 - le service est indisponible ; secondes - le nombre de secondes passées lors de la connexion au service.

Paramètres :

  • service - valeurs possibles : ssh, ldap, smtp, ftp, http, pop, nntp, imap, tcp, https, telnet (voir les détails) ;
  • ip - l’adresse IP ou le nom DNS (par défaut, l’IP/DNS de l’hôte est utilisé) ;
  • port - le numéro de port (par défaut, le numéro de port standard du service est utilisé).

Commentaires :

  • Notez qu’avec le service tcp, l’indication du port est obligatoire ;
  • La vérification des protocoles chiffrés (comme IMAP sur le port 993 ou POP sur le port 995) n’est actuellement pas prise en charge. Comme solution de contournement, veuillez utiliser net.tcp.service[tcp,<ip>,port] pour ce type de vérifications.

Exemple :

net.tcp.service.perf[ssh] #Cet élément peut être utilisé pour tester la vitesse de la réponse initiale du serveur SSH.
net.udp.service[service,<ip>,<port>]


Vérifie si un service est en cours d’exécution et répond aux requêtes UDP.
Valeur de retour : 0 - le service est indisponible ; 1 - le service est en cours d’exécution.

Paramètres :

  • service - valeurs possibles : ntp (voir détails) ;
  • ip - l’adresse IP ou le nom DNS (par défaut, l’IP/DNS de l’hôte est utilisé) ;
  • port - le numéro de port (par défaut, le numéro de port standard du service est utilisé).

Exemple :

net.udp.service[ntp,,45] #Cet élément peut être utilisé pour tester la disponibilité du service NTP sur le port UDP 45.
net.udp.service.perf[service,<ip>,<port>]


Vérifie les performances d’un service UDP.
Valeur de retour : Float : 0.000000 - le service est indisponible ; seconds - le nombre de secondes passées à attendre une réponse du service.

Paramètres :

  • service - valeurs possibles : ntp (voir les détails) ;
  • ip - l’adresse IP ou le nom DNS (par défaut, l’IP/DNS de l’hôte est utilisé) ;
  • port - le numéro de port (par défaut, le numéro de port standard du service est utilisé).

Exemple :

net.udp.service.perf[ntp] #Cet élément peut être utilisé pour tester le temps de réponse du service NTP.

Pour la prise en charge de SourceIP dans les vérifications simples LDAP (par ex. net.tcp.service[ldap]), OpenLDAP version 2.6.1 ou supérieure est requise.

Traitement du délai d'expiration

Les délais d'expiration flexibles des éléments, bien qu'ils soient pris en charge pour les vérifications simples, ne s'appliquent pas aux éléments icmpping* et VMware. Voir Prise en charge des délais d'expiration flexibles.

Pings ICMP

Zabbix utilise un utilitaire externe fping pour traiter les pings ICMP (icmpping, icmppingloss, icmppingretry, icmppingsec).

Installation

fping n’est pas inclus avec Zabbix et doit être installé séparément :

  • Diverses plateformes basées sur Unix proposent le paquet fping dans leurs dépôts par défaut, mais il n’est pas préinstallé. Dans ce cas, vous pouvez utiliser le gestionnaire de paquets pour installer fping.

  • Zabbix fournit des paquets fping pour RHEL et ses dérivés. Veuillez noter que ces paquets sont fournis sans support officiel.

  • fping peut également être compilé à partir des sources.

Configuration

Spécifiez l’emplacement de fping dans le paramètre FpingLocation du fichier de configuration du serveur/proxy Zabbix (ou le paramètre Fping6Location pour utiliser des adresses IPv6).

fping doit pouvoir être exécuté par l’utilisateur sous lequel le serveur/proxy Zabbix s’exécute, et cet utilisateur doit disposer de droits suffisants.

Voir aussi : Problèmes connus pour le traitement des vérifications simples avec des versions de fping antérieures à 3.10.

Valeurs par défaut

Valeurs par défaut, limites et description des valeurs pour les paramètres de vérification ICMP :

Paramètre Unité Description Option fping Valeurs par défaut définies par < Limites autorisées
par Zabbix		 <
fping Zabbix min max
packets nombre Nombre de paquets de requête envoyés à une cible -C 3 1 10000
interval millisecondes Temps d’attente entre des paquets successifs vers une cible individuelle -p 1000 20 illimité
size octets Taille du paquet en octets
56 octets sur x86, 68 octets sur x86_64		 -b 56 ou 68 24 65507
timeout millisecondes fping v3.x - délai d’attente après l’envoi du dernier paquet, affecté par l’option -C
fping v4.x - délai d’attente individuel pour chaque paquet		 -t fping v3.x - 500
fping v4.x et versions plus récentes - hérité de l’option -p, mais pas supérieur à 2000		 50 illimité
retries nombre Nombre de tentatives de ping d’une cible, sans compter le premier essai -r 3 1 0 illimité
backoff factor nombre Facteur par lequel le temps d’attente est multiplié à chaque requête successive -B 1.5 1.0 1.0 5.0

Les valeurs par défaut peuvent varier légèrement selon la plateforme et la version.

En outre, Zabbix utilise les options fping -i interval ms (à ne pas confondre avec le paramètre d’élément interval mentionné dans le tableau ci-dessus, qui correspond à l’option fping -p) et -S adresse IP source (ou -I dans les anciennes versions de fping). Ces options sont détectées automatiquement en exécutant des vérifications avec différentes combinaisons d’options. Zabbix essaie de détecter la valeur minimale en millisecondes que fping autorise avec -i en testant 3 valeurs : 0, 1 et 10. La première valeur qui réussit est ensuite utilisée pour les vérifications ICMP suivantes. Ce processus est effectué individuellement par chaque processus ICMP pinger.

Les options fping détectées automatiquement sont invalidées toutes les heures et détectées à nouveau lors de la prochaine tentative d’exécution d’une vérification ICMP. Définissez DebugLevel>=4 afin d’afficher les détails de ce processus dans le fichier journal du serveur ou du proxy.

Zabbix écrit les adresses IP à vérifier par l’une des clés icmpping* dans un fichier temporaire, qui est ensuite transmis à fping. Si des éléments ont des paramètres de clé différents, seuls ceux ayant des paramètres de clé identiques sont écrits dans un même fichier. Toutes les adresses IP écrites dans un même fichier seront vérifiées par fping en parallèle, ainsi le processus ICMP pinger de Zabbix passera un temps fixe, indépendamment du nombre d’adresses IP dans le fichier.