Contexte

Quand un conteneur Docker rencontre une erreur, il arrive que celui-ci se relance automatiquement pour tenter de résoudre l'erreur rencontrée. Dans certains cas, l'erreur ne se corrige pas et le conteneur va redémarrer continuellement.

Le check  Restarts by SSH  permet de superviser ces redémarrages incontrôlables effectués par les conteneurs sur une instance Docker


Les redémarrages provenant d'une action volontaire de l'utilisateur ne sont pas pris en compte par ce check.


Le changement de statut repose sur une seule règle :

  • Si le nombre de redémarrages d’un conteneur dépasse les seuils définis (warning ou critical), alors le statut du check évolue automatiquement.


Ce check permet :

  • de détecter rSSHdement un comportement instable,

  • d’identifier un conteneur mal configuré,

  • de repérer une anomalie empêchant l’exécution continue du service.


En résumé, ce check vise à assurer la stabilité des conteneurs en signalant les redémarrages anormaux.

Paramétrage

Le check utilise la ligne de commande suivante :

$SHINKEN_DOCKER-BY-SSH_PLUGINSDIR$/check_docker.py 
	--connection "$HOSTADDRESS$":"$_HOSTDOCKER-BY-SSH__PORT$" 
	--restart "$_HOSTDOCKER-BY-SSH__RESTARTS__RESTARTS-WARN$":"$_HOSTDOCKER-BY-SSH__RESTARTS__RESTARTS-CRIT$" 
	--containers "$ARG1$"

Données utilisées provenant du modèle

Données communes pour les checks du modèle

Données spécifiques pour ce check

NomModifiable surUnitéDéfautValeur par défaut à l'installation de ShinkenDescription
DOCKER-BY-SSH__RESTARTS__RESTARTS-CRIT

l'Hôte

( Onglet Données )

--10 10

Définit le nombre de restarts à partir duquel le check passe en CRITIQUE .

  • Il suffit qu'il franchisse ce seuil pour que le check change d'état.
DOCKER-BY-SSH__RESTARTS__RESTARTS-WARN

l'Hôte

( Onglet Données )

--5 5

Définit le nombre de restarts à partir duquel le check passe en ATTENTION .

  • Il suffit qu'il franchisse ce seuil pour que le check change d'état.

Données DFE ( Duplicate Foreach )

NomModifiable sur UnitésDéfautValeur par défaut à l'installation de ShinkenDescription
DOCKER-BY-SSH__CONTAINERS

l'Hôte

( Onglet Données )

---containers1$(containers1)$ containers1$(containers1)$

Nom du ou des conteneurs ( séparés par une virgule ), exemple "prod01$(prod01)$,php$(php)$".

Check(s) impacté(s) :

Données utilisées provenant du check

Pas de données provenant du check pour ce modèle

Données globales

NomModifiable surUnitéDéfautValeur par défaut à l'installationDescription
USERPLUGINSDIR

Non modifiable

( Sauf Admin Shinken )

--/var/lib/shinken-user/libexec /var/lib/shinken-user/libexec

Chemin absolu contenant les sondes installés par Shinken.

SHINKEN_DOCKER-BY-SSH_VENDOR

Non modifiable

( Sauf Admin Shinken )

--shinken-additional-packs shinken-additional-packs

Dossier fournit par shinken.

SHINKEN_DOCKER-BY-SSH_PACKNAME

Non modifiable

( Sauf Admin Shinken )


docker-by-SSH__shinken docker-by-SSH__shinken

Dossier contenant les sondes.

SHINKEN_DOCKER-BY-SSH_PLUGINSDIR

Non modifiable

( Sauf Admin Shinken )

--
$USERPLUGINSDIR$/$SHINKEN_DOCKER-BY-SSH_VENDOR$/$SHINKEN_DOCKER-BY-SSH_PACKNAME$
 /var/lib/shinken-user/libexec/shinken-additional-packs/docker-by-SSH__shinken

Chemin absolu du dossier contenant les sondes du pack docker-by-SSH__shinken  ( non modifiable ).

Propriétés de l'hôte

NomModifiable surUnitéDéfautValeur par défautDescription
HOSTADDRESS

l'Hôte

( Onglet Général )

--

Nom de l'hôte Nom de l'hôte

Adresse de l'hôte

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 :

      • DOCKER-BY-SSH__RESTARTS__RESTARTS-WARN 
      • DOCKER-BY-SSH__RESTARTS__RESTARTS-CRIT

    • Voici un tableau récSSHtulatif 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 nombre de restarts dépasse la valeur de :
    • DOCKER-BY-SSH__RESTARTS__RESTARTS-WARN 
 ATTENTION

  • Le nombre de restarts dépasse la valeur de :
    • DOCKER-BY-SSH__RESTARTS__RESTARTS-CRIT

CRITIQUE

Résultat

Le résultat court affiche le nombre total de redémarrages subis pour le conteneur sélectionné ( valeur entière cumulée ).

Résultat Long

Pas de résultat long pour ce check.

Métriques

Interprétation des métriques

Nom de la métriqueUnitéDescriptionSeuil d'avertissementSeuil critique
(nom-du-container)_restarts nb_restartsRetourne le nombre de restart non intentionnels effectués par un conteneur depuis sa mise en fonctionnement.

DOCKER-BY-SSH__RESTARTS__RESTARTS-WARN 

DOCKER-BY-SSH__RESTARTS__RESTARTS-CRIT

Exemple

Votre essai Premium est terminé