Le check NtpSyncTimesync SSH va vérifier la date et l'heure de votre système et les comparer à celles du serveur NTP configuré via systemd-timesyncd.

  • Si le serveur NTP est accessible, vous pourrez alors obtenir :
    • le temps d'aller-retour entre votre client et le serveur de temps.
    • le décalage d'horloge entre l'hôte supervisé et le serveur de référence.
  • Sinon, vous serez invité à démarrer le service systemd-timesyncd.

La vérification est basée sur deux informations : OFFSET et DELAY.

  • Pour savoir si le serveur est à l'heure, le service NTP local interroge le serveur de temps de référence configuré dans systemd.
    • Le DELAY correspond au temps d'aller-retour de la requête réseau vers le serveur NTP.

    • L'OFFSET correspond à la différence d'heure mesurée entre le serveur supervisé et le serveur de référence.

  • Ces deux valeurs sont nécessaires, car l’OFFSET peut avoir, dans le pire des cas, une marge d’erreur équivalente au DELAY (temps d’acheminement moyen de la requête vers le serveur de temps).

C’est pourquoi le check NtpSyncTimesync SSH mesure ces deux indicateurs et réagit en fonction des seuils de tolérance que vous définissez.

Note : Pour que le check NtpSyncTimesync SSH apparaisse dans la liste des checks de l'équipement supervisé, il faut que les 2 modèles timesync_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$"
    --systemd-timesyncd
    -w "$_HOSTNTP-TIMESYNC__DELAY-WARNING$,$_HOSTNTP-TIMESYNC__OFFSET-WARNING$"
    -c "$_HOSTNTP-TIMESYNC__DELAY-RITICAL$,$_HOSTNTP-TIMESYNC__OFFSET-CRITICAL$"

Données utilisées provenant du modèle

Données communes pour les checks des modèles

Authentification

Données spécifiques pour ce check

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

l'Hôte

( Onglet Données )

ms

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

l'Hôte

( Onglet Données )

ms

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

l'Hôte

( Onglet Données )

ms

30Définit le décalage en millisecondes à partir duquel le check passe en CRITIQUE.
NTP-TIMESYNC__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

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-TIMESYNC__DELAY-CRITICAL
    • NTP-TIMESYNC__OFFSET-CRITICAL
    • NTP-TIMESYNC__DELAY-WARNING
    • NTP-TIMESYNC__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-TIMESYNC__DELAY-CRITICAL.

CRITIQUE

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

CRITIQUE

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

ATTENTION

  • L'offset dépasse la valeur NTP-TIMESYNC__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-TIMESYNC__DELAY-WARNING

NTP-TIMESYNC__DELAY-CRITICAL

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

NTP-TIMESYNC__OFFSET-WARNING

NTP-TIMESYNC__OFFSET-CRITICAL

Exemple

Les Erreurs

Erreurs spécifiques à ce check

MONITORED HOST - BAD STATE – "systemd-timesyncd" 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 – "systemd-timesyncd" tools and deamon are not installed.


Le service "systemd-timesyncd" n'est pas installé sur le serveur supervisé.



Résolution


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


# Debian 11, 12, 13, 14
apt install systemd-timesyncd

# Ubuntu 18, 20, 22, 24, 25, 26
apt install systemd-timesyncd

MONITORED HOST - BAD STATE – "systemd-timesyncd" seems to be shutdown.


Le service "systemd-timesyncd" n'est pas démarré sur le serveur supervisé.



Résolution


Démarrer le service  "systemd-timesyncd".


systemctl enable systemd-timesyncd
systemctl start systemd-timesyncd