Contexte
Le check Ntp Sync by SNMPv1v2 va vérifier la date et l'heure de votre système et le comparer à celles du serveur ntpd.
- Si le serveur ntpd est accessible, vous pourrez alors obtenir:
- le temps d'aller-retour entre votre client et le serveur
- le décalage d'horloge entre l'hôte supervisé et le serveur de temps de référence.
- Sinon, vous serez invité à démarrer le service adéquat.
La vérification est basée sur 2 informations : l' OFFSET et le DELAY
- Pour savoir si le serveur est à l'heure, le serveur ntp local fait une requête au serveur ntp de référence.
- Le temps d'aller-retour de la requête correspond au DELAY mesuré.
- L'OFFSET correspond à la différence d'heure entre le serveur supervisé et le serveur ntp de référence.
- Les 2 valeurs sont nécessaires, car l'OFFSET peut avoir au pire la valeur de DELAY comme marge d'erreur ( le temps d'acheminement moyen de la requête au serveur de temps ).
- C'est pour cela que le check Ntp Sync by SNMPv1v2 mesure ces 2 valeurs et réagi en fonction des seuils de tolérance que vous définissez.
REMARQUE
Paramétrage
Le check utilise la ligne de commande suivante :
$LINUX-BY-SNMP__SHINKEN__PLUGINSDIR$/check_linux_health_by_snmp_rust --check check_ntp_sync
-H "$HOSTADDRESS$"
-p "$_HOSTLINUX-BY-SNMP__PORT$"
-t "$_HOSTLINUX-BY-SNMP__TIMEOUT$"
-c "$_HOSTLINUX-BY-SNMP__NTP-SYNC__DELAY-CRIT$,$_HOSTLINUX-BY-SNMP__NTP-SYNC__OFFSET-CRIT$"
-w "$_HOSTLINUX-BY-SNMP__NTP-SYNC__DELAY-WARN$,$_HOSTLINUX-BY-SNMP__NTP-SYNC__OFFSET-WARN$"
--snmp_version "2"
--community "$_HOSTLINUX-BY-SNMP__V1V2-COMMUNITY$"
Données utilisées provenant des modèles
Données communes pour les checks des modèles
l'Hôte ( Onglet Données ) l'Hôte ( Onglet Données ) --- l'Hôte ( Onglet Données ) La Communauté SNMP v1/v2 défini sur votre linux : l'Hôte ( Onglet Données ) Sélectionne la version SNMP 1 ou 2 à utiliser.Nom Modifiable sur Unité Défaut Valeur par défaut à l'installation de Shinken Description LINUX-BY-SNMP__TIMEOUT
seconde 5 5 Temps maximal en seconde pour réussir une connexion SNMP avant que le check ne renvoi une erreur INCONNU ( La valeur doit être comprise entre 2 et 60 ). LINUX-BY-SNMP__PORT
161 161 Port pour la connexion SNMP. LINUX-BY-SNMP__V1V2-COMMUNITY
--- public public LINUX-BY-SNMP__V1V2-VERSION
--- 2 2
Données spécifiques pour ce check
| Nom | Modifiable sur | Unité | Valeur par défaut à l'installation de Shinken | Description |
|---|---|---|---|---|
LINUX-BY-SNMP__NTP-SYNC__OFFSET-CRIT | l'Hôte ( Onglet Données ) | ms | 30 | Définit le décalage en millisecondes à partir duquel le check passe en CRITIQUE. |
LINUX-BY-SNMP__NTP-SYNC__OFFSET-WARN | l'Hôte ( Onglet Données ) | ms | 10 | Définit le décalage en millisecondes à partir duquel le check passe en ATTENTION. |
LINUX-BY-SNMP__NTP-SYNC__DELAY-CRIT | l'Hôte ( Onglet Données ) | ms | 200 | Définit le délai en millisecondes à partir duquel le check passe en CRITIQUE. |
LINUX-BY-SNMP__NTP-SYNC__DELAY-WARN | l'Hôte ( Onglet Données ) | ms | 100 | Définit le délai en millisecondes à partir duquel le check passe en ATTENTION. |
Données DFE ( Duplicate Foreach )
Pas de données DFE pour ce check
Données utilisées provenant du check
Pas de données provenant du check pour ce modèle
Non modifiable ( Sauf Admin Shinken ) Chemin absolu contenant les sondes installés par Shinken Non modifiable ( Sauf Admin Shinken ) Dossier fournit par shinken Non modifiable ( Sauf Admin Shinken ) Dossier contenant les sondes Non modifiable ( Sauf Admin Shinken ) Chemin absolu du dossier contenant les sondes du pack linux-by-SNMP__shinken ( non modifiable )Données globales
Nom Modifiable sur Unité Défaut Valeur par défaut à l'installation Description USERPLUGINSDIR
-- /var/lib/shinken/libexec /var/lib/shinken/libexec LINUX-BY-SNMP__SHINKEN__VENDOR
-- shinken-additional-packs shinken-additional-packs LINUX-BY-SNMP__SHINKEN__PACKNAME
linux-by-SNMP__shinken linux-by-SNMP__shinken LINUX-BY-SNMP__SHINKEN__PLUGINSDIR
-- USERPLUGINSDIR/LINUX-BY-SNMP__SHINKEN__VENDOR/
LINUX-BY-SNMP__SHINKEN__PACKNAME
/var/lib/shinken-user/libexec/shinken-additional-packs/linux-by-SNMP__shinken
l'Hôte ( Onglet Général ) -- Adresse de l'hôtePropriétés de l'hôte
Nom Modifiable sur Unité Défaut Valeur par défaut Description HOSTADDRESS
Nom de l'hôte Nom de l'hôte
Résultat
Exemple
Interprétation
Statut
- Il peut prendre quatre valeurs OK / CRITIQUE / ATTENTION / INCONNU .
- Le statut va dépendre du retour de sonde et de la configuration spécifique du check pour les données suivantes :
LINUX-BY-SNMP__NTP-SYNC__OFFSET-CRIT
LINUX-BY-SNMP__NTP-SYNC__OFFSET-WARN
LINUX-BY-SNMP__NTP-SYNC__DELAY-CRIT
LINUX-BY-SNMP__NTP-SYNC__DELAY-WARN
- Le statut va dépendre du retour de sonde et de la configuration spécifique du check pour les données suivantes :
- Voici un tableau récapitulatif du statut attendu suivant le retour de sonde :
Le texte de la colonne "Affichage des seuils" montre les paramètres utilisés et leur valeur définie sur l'équipement supervisé.
Situation | Statut | Exemple |
|---|---|---|
| CRITIQUE |
|
| ATTENTION |
|
| CRITIQUE |
|
| ATTENTION |
|
Résultat
Le résultat contient un message indiquant le statut du check.
Lors d'un passage en CRITIQUE ou ATTENTION, un message indique quel en est la cause.
Résultat Long
Le résultat long contient un tableau affichant la valeur de l'OFFSET et du DELAY en millisecondes.
Métriques
Définition
| Nom de la métrique | Unité | Description | Seuil d'avertissement | Seuil critique |
|---|---|---|---|---|
| delay | ms | Temps aller-retour entre le client et le serveur | LINUX-BY-SNMP__NTP-SYNC__DELAY-WARN | LINUX-BY-SNMP__NTP-SYNC__DELAY-CRIT |
| offset | ms | Décalage de temps entre le système et le serveur | LINUX-BY-SNMP__NTP-SYNC__OFFSET-WARN | LINUX-BY-SNMP__NTP-SYNC__OFFSET-CRIT |
Exemple
Erreurs et pré-requis
Erreurs de configuration de l'hôte à superviser ( spécifique à ce check )
MONITORED HOST - BAD STATE – NTP tools and daemon are not installed
Il est nécessaire que le service ntpd soit installé pour le bon fonctionnement du check. Sans cela, l'erreur suivante sera générée :
Les instructions suivantes sont à exécuter sur l'hôte supervisée.
Installez et activez le service ntpd.
# Debian, Ubuntu sudo apt install ntp # Fedora, OpenSUSE sudo yum install ntp # Arch sudo pacman -S ntp sudo service ntpd restart
MONITORED HOST - BAD STATE – NTP daemon seems to be shutdown.
Il est possible que le service ntpd ne soit pas allumé. L'erreur suivante sera générée :
RESOLUTION :
Les instructions suivantes sont à exécuter sur l'hôte supervisée.
Le service ntpd doit être activé et démarré :
sudo service ntpd restart
MONITORED HOST - BAD STATE – No NTP source server found.
Une fois lancé, le service ntpd va choisir le serveur NTP, parmi un ou plusieurs configurés, qui sera utilisé pour la synchronisation NTP. Cette opération prend quelques secondes une fois le service démarré. Sans cela, l'erreur suivante sera générée :
Il suffit d'attendre quelques secondes.
Si le problème persiste, vérifiez le bon fonctionnement du service ntpd et de sa configuration. Cliquez ici pour un guide de configuration ntpd.
La connexion SNMP est configuré par défaut pour se couper si aucune réponse n'est perçu après cinq secondes ( paramétrable avec LINUX-BY-SNMP__TIMEOUT ).
Cette erreur peut intervenir lorsque : La résolution DNS de l'hôte a échoué.
La tentative de connexion à l'hôte a échoué à atteindre l'hôte.
Cette erreur peut être générée à cause d'une mauvaise configuration de pare-feu. La tentative de connexion à l'hôte a été refusé.
Cette erreur peut intervenir lorsque : L'authentification SNMP v3 a échoué.
Cette erreur peut intervenir lorsque : L'utilisateur SNMP v3 utilisé n'existe pas.
L'authentification SNMP v3 a échoué. La méthode d'authentification n'est pas authorisé.
Cette erreur peut intervenir lorsque : Les erreurs suivantes peuvent arriver sur la version SNMPv2 et SNMPv3. Deux erreurs sont possibles :
RESOLUTION : Il faut vérifier les deux étapes suivantes de la configuration :Erreurs de connexion ( communes à tous les checks )
UNKNOWN – Session error: timeout
UNKNOWN – Failed to create SNMP session. Got error: failed to lookup address information: Name or service not known
UNKNOWN – Session error: Socket receive error: host unreachable
UNKNOWN – Session error: Socket receive error: connection refused
UNKNOWN – Session error: Unexpected report: authentication failure
UNKNOWN – Session error: Unexpected report: unknown user name
UNKNOWN – Session error: Unexpected report: unsupported security level.
Erreurs de configuration de l'hôte à superviser ( communes à tous les checks )
MONITORED HOST - BAD STATE – No [ ... ] data found. This might be due to :


















