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.
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
| Nom | Modifiable sur | Unité | Défaut | Valeur par défaut à l'installation de Shinken | Description |
|---|---|---|---|---|---|
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.
|
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ée | Modifiable sur | Unité | Valeur par défaut | Description |
|---|---|---|---|---|
NTP-TIMESYNC__DELAY-CRITICAL | l'Hôte ( Onglet Données ) | ms | 200 | Définit le délai en millisecondes à partir duquel le check passe en CRITIQUE. |
NTP-TIMESYNC__DELAY-WARNING | l'Hôte ( Onglet Données ) | ms | 100 | Définit le délai en millisecondes à partir duquel le check passe en ATTENTION. |
NTP-TIMESYNC__OFFSET-CRITICAL | l'Hôte ( Onglet Données ) | ms | 30 | Définit le décalage en millisecondes à partir duquel le check passe en CRITIQUE. |
NTP-TIMESYNC__OFFSET-WARNING | l'Hôte ( Onglet Données ) | ms | 10 | Dé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 |
|---|---|---|
| CRITIQUE |
|
| CRITIQUE |
|
| ATTENTION |
|
| 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 | NTP-TIMESYNC__DELAY-WARNING | NTP-TIMESYNC__DELAY-CRITICAL |
| offset | ms | Dé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
Il suffit généralement de patienter quelques secondes. Si le problème persiste la configuration NTP doit avoir un problème. 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. Le service "systemd-timesyncd" n'est pas démarré sur le serveur supervisé. Résolution Démarrer le service "systemd-timesyncd".MONITORED HOST - BAD STATE – "systemd-timesyncd" daemon is not synchronized. [...]
MONITORED HOST - BAD STATE – "systemd-timesyncd" tools and deamon are not installed.
# 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.
systemctl enable systemd-timesyncd
systemctl start systemd-timesyncd