Sommaire



Contexte

Le check NtpSyncChrony SSH va vérifier la date et l'heure de votre système et le comparer à celles du serveur Chrony.

  • Si le serveur Chrony 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 NtpChronySync SSH mesure ces 2 valeurs et réagi en fonction des seuils de tolérance que vous définissez.

Note : Pour que le check NtpSyncChrony SSH apparaisse dans la liste des checks de l'équipement supervisé, il faut que les 2 modèles chrony_by_ssh, et linux_by_ssh soient accrochés sur l'équipement.



Paramétrage

Le check utilise la ligne de commande suivante :

$LINUXBYSSH_SHINKEN_PLUGINSDIR$/check_linux_health_by_ssh_rust --check check_ntp_sync
    -H "$HOSTADDRESS$" 
    -u "$_HOSTSSH_USER$"
    -p "$_HOSTSSH_PORT$"
    -i "$_HOSTSSH_KEY$" 
    -P "$_HOSTSSH_KEY_PASSPHRASE$"
    --chrony
    -w "$_HOSTNTP-CHRONY__DELAY-WARNING$,$_HOSTNTP-CHRONY__OFFSET-WARNING$"
    -c "$_HOSTNTP-CHRONY__DELAY-CRITICAL$,$_HOSTNTP-CHRONY__OFFSET-CRITICAL$"

Données utilisées provenant du modèle

Données communes pour les checks des modèles

Authentification

NomModifiable surUnitéDéfautValeur par défaut à l'installation de ShinkenDescription
SSH_KEY

l'Hôte

( Onglet Données )

--$SSH_KEY_KEY$    ~/.ssh/id_rsa

Chemin vers la clé SSH privé de l'utilisateur shinken, sur le serveur hébergeant le Poller qui exécutera le check. 

  • Cette clé doit être présente dans les clefs autorisées du compte utilisateur utilisé pour se connecter sur le serveur linux supervisé ( voir la donnée SSH_USER si dessous ).
SSH_KEY_PASSPHRASE

l'Hôte

( Onglet Données )

--$SSH_KEY_PASSPHRASE$''

Phrase secrète utilisée pour déchiffrer la clé privée de l'utilisateur ( si celle-ci est protégée par une passphrase ). La clé privée déchiffré est ensuite utilisée pour authentifier l'utilisateur.

SSH_PORT

l'Hôte

( Onglet Données )

--$SSH_PORT$22

Port de connexion SSH.

SSH_USER

l'Hôte

( Onglet Données )

--$SSH_USER$shinken

Nom de l'utilisateur pour se connecter sur le serveur supervisé.

Données spécifiques pour ce check

DonnéeModifiable surUnitéValeur par défautDescription
NTP-CHRONY__DELAY-CRITICAL

l'Hôte

( Onglet Données )

ms

200Définit le délai en millisecondes à partir duquel le check passe en CRITIQUE.
NTP-CHRONY__DELAY-WARNING

l'Hôte

( Onglet Données )

ms

100Définit le délai en millisecondes à partir duquel le check passe en ATTENTION.
NTP-CHRONY__OFFSET-CRITICAL

l'Hôte

( Onglet Données )

ms

30Définit le décalage en millisecondes à partir duquel le check passe en CRITIQUE.
NTP-CHRONY__OFFSET-WARNING

l'Hôte

( Onglet Données )

ms

10Définit le décalage 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 spécifiques pour ce check

Résultat

Exemple

Interprétation des données

Statut

Il peut prendre 4 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 :

    • NTP-CHRONY__DELAY-CRITICAL
    • NTP-CHRONY__OFFSET-CRITICAL
    • NTP-CHRONY__DELAY-WARNING
    • NTP-CHRONY__OFFSET_WARNING
  • 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

  • Le délai dépasse la valeur de NTP-CHRONY__DELAY-CRITICAL.

CRITIQUE

  • L'offset dépasse la valeur NTP-CHRONY__OFFSET_CRITICAL.

CRITIQUE

  • Le délai dépasse la valeur de NTP-CHRONY__DELAY-WARNING.

ATTENTION

  • L'offset dépasse la valeur NTP-CHRONY__OFFSET-WARNING.

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étriqueUnitéDescriptionSeuil d'avertissementSeuil critique
delaymsTemps aller-retour entre le client et le serveur 

NTP-CHRONY__DELAY-WARNING

NTP-CHRONY__DELAY-CRITICAL

offsetmsDécalage d'heure entre le système et le serveur

NTP-CHRONY__OFFSET-WARNING

NTP-CHRONY__OFFSET-CRITICAL

Exemple

Les Erreurs

Erreurs spécifiques à ce check

MONITORED HOST - BAD STATE – Chrony daemon is not synchronized.



Le système est en cours de synchronisation avec un serveur NTP.



Il suffit généralement de patienter quelques secondes. Si le problème persiste la configuration NTP doit avoir un problème.

MONITORED HOST - BAD STATE – Chrony daemon seems to be shutdown.

Le serveur de temps chronyd n'est pas démarré sur le serveur supervisé.


Résolution

Démarrer le démon chrony.


systemctl start chronyd
systemctl enable chronyd

MONITORED HOST - BAD STATE – Chrony tools and daemon are not installed.

Le serveur de temps chronyd n'est pas installé sur le serveur supervisé.


Résolution

Installer le packet chrony pour les serveurs plus récents. D'autres serveurs NTP peuvent également être installé, comme ntpd.


# Centos 6, 7, 8, 9, 10
yum install chrony

# Debian 11, 12, 13, 14
dnf install chrony

# Ubuntu 14, 16, 18, 20, 22, 24, 25, 26
apt install chrony

# Fedora 37, 38, 39, 40, 41, 42, 43
apt install chrony

# Opensuse 15.4, 15.5, 15.6
zypper install chrony