2 Vérification simple
Vue d'ensemble
Les vérifications simples sont normalement utilisées pour des vérifications à distance des services sans agent.
Notez que l'agent Zabbix 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 surveillance VMware ; ils sont ignorés dans les autres cas.
Vérifications prises en charge
Les clés d'élément sont listées sans paramètres facultatifs ni informations supplémentaires. Cliquez sur la clé d'élément pour voir les détails complets.
Voir aussi Clés d'élément de surveillance VMware.
| Clé d'élément | Description |
|---|---|
| icmpping | L'accessibilité de l'hôte par ping ICMP. |
| icmppingloss | Le pourcentage de paquets perdus. |
| icmppingsec | Le temps de réponse du 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 chevrons sont obligatoires. Les paramètres marqués par des chevrons < > sont facultatifs.
icmpping[<target>,<packets>,<interval>,<size>,<timeout>,<options>]
L'accessibilité de l'hôte par ping ICMP.
Valeur de retour: 0 - l'échec du ping ICMP; 1 - le ping ICMP a 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'attente en millisecondes;
- options - utilisé pour autoriser la redirection: si vide (valeur par défaut), les réponses redirigées sont considérées comme indiquant que l'hôte cible est hors ligne; si défini sur allow_redirect, les réponses redirigées sont considérées comme indiquant que l'hôte cible est en ligne.
Voir aussi le tableau des valeurs par défaut.
Commentaire:
- Si au moins un des paquets définis par le paramètre
packetsest reçu, l'élément renvoie1. Si aucun des paquets n'est reçu, l'élément renvoie0.
Exemple:
icmpping[,4] #Si au moins un des quatre paquets est reçu, l'élément renvoie 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.
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'attente
Zabbix ne traitera pas une vérification simple au-delà du nombre de secondes Timeout défini dans le formulaire de configuration de l'élément.
Pour les éléments VMware,
Zabbix ne traitera pas une vérification simple au-delà du nombre de secondes Timeout défini dans le fichier de configuration du serveur ou du proxy Zabbix. Pour les éléments icmpping*, les valeurs de délai d'attente et de tentatives sont spécifiées directement dans la clé de l'élément et ne sont pas influencées par le paramètre global Timeout. Assurez-vous que ces valeurs sont configurées correctement dans la clé de l'élément. Notez qu'un délai d'attente maximal codé en dur de 600 secondes est appliqué aux éléments icmpping* (depuis Zabbix 7.0.22).
Pings ICMP
Zabbix utilise un utilitaire externe fping pour traiter les pings ICMP (icmpping, icmppingloss, icmppingsec).
Installation
fping n'est pas inclus avec Zabbix et doit être installé séparément :
-
Diverses plateformes basées sur Unix disposent du 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. 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 être exécutable 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 inférieures à 3.10.
Valeurs par défaut
Valeurs par défaut, limites et description des valeurs pour les paramètres de vérification ICMP :
| Parameter | Unit | Description | Fping's flag | Defaults set by | Allowed limits by Zabbix |
||
|---|---|---|---|---|---|---|---|
| fping | Zabbix | min | max | ||||
| packets | number | nombre de paquets de requête envoyés à une cible | -C | 3 | 1 | 10000 | |
| interval | milliseconds | temps d'attente entre des paquets successifs vers une cible individuelle | -p | 1000 | 20 | unlimited | |
| size | bytes | taille du paquet en octets 56 octets sur x86, 68 octets sur x86_64 |
-b | 56 or 68 | 24 | 65507 | |
| timeout | milliseconds | fping v3.x - délai d'attente après l'envoi du dernier paquet, प्रभावित par l'indicateur -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'indicateur -p, mais pas plus de 2000 |
50 | unlimited | |
Les valeurs par défaut peuvent légèrement varier selon la plateforme et la version.
De plus, 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 source IP address (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 tente de détecter la valeur minimale en millisecondes que fping autorise avec -i en essayant 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 trois clés icmpping* dans un fichier temporaire, qui est ensuite transmis à fping. Si les é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 le fichier unique seront vérifiées par fping en parallèle, de sorte que le processus ICMP pinger de Zabbix passera un temps fixe, quel que soit le nombre d'adresses IP dans le fichier.