| Scroll Ignore | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||
|
Contexte
Quand un conteneur est en fonctionnement, le statut de celui-ci permet de définir son état général. Cependant, dans certains cas, il arrive qu'un conteneur ait besoin d'une ou plusieurs vérifications additionnelles pour attester qu'il fonctionne correctement.
Ces vérifications additionnelles, nommées "healthcheck" dans le jargon Docker, dépendent des utilisateurs pour être ajoutées et ne sont pas configurées par défaut. C'est pourquoi la grande majorité des conteneurs en est dépourvue.
Un healthcheck ne possède pas de structure prédéfinie. Il peut s'agir de n'importe quelle vérification imaginée par l'utilisateur pour attester que le conteneur réponde bien à ses attentes. Il peut prendre la forme :
- D'un ping pour vérifier que le conteneur communique bien
- D'un statut pour vérifier l'état d'un service
- D'une commande complexe pour vérifier un fonctionnement applicatif
- etc ...
Le check Health by SSH permet ainsi de superviser le retour de ces vérifications.
Le changement de statut repose sur une seule règle :
- Si l’état du healthcehck healthcheck n'est pas "healthy" ou "no-healthcheck", le check remontera en warning ou critique ( Basé sur la gravité de l'état remontée remonté ).
| Info |
|---|
Un healthcheck se déclare généralement dans un fichier Docker exécute à intervalles réguliers la commande sélectionnée ( paramétrables paramétrable via
|
Ce check permet donc :
de détecter rapidement un service applicatif non fonctionnel,
de confirmer qu’un conteneur “running” est réellement opérationnel,
de cibler les conteneurs dont l’application interne est partiellement ou totalement indisponible.
Pour résumer, ce check offre un indicateur avancé pour valider le bon fonctionnement interne d'un conteneur,
| Panel |
|---|
|
Paramétrage
Le check utilise la ligne de commande suivante :
| Code Block | ||||
|---|---|---|---|---|
| ||||
$SHINKEN_DOCKER-ON-LINUX-BY-SSH_PLUGINSDIR$/check_docker_SSH.py -H "$HOSTADDRESS$" -u "$_HOSTDOCKER-ON-LINUX-BY-SSH__SSH-USER$" -p "$_HOSTDOCKER-ON-LINUX-BY-SSH__SSH-PORT$" -k "$_HOSTDOCKER-ON-LINUX-BY-SSH__SSH-KEY$" -x "$_HOSTDOCKER-ON-LINUX-BY-SSH__SSH-PASSPHRASE$" -m "health" -e "$_HOSTDOCKER-ON-LINUX-BY-SSH__CONTAINERS-EXCLUDED$" |
Données utilisées provenant du modèle
Données communes pour les checks du modèle
| Excerpt Include | ||||||
|---|---|---|---|---|---|---|
|
Données spécifiques pour ce check
| Nom | Modifiable sur | Unité | Défaut | Valeur par défaut à l'installation du pack | Description | ||
|---|---|---|---|---|---|---|---|
| l'Hôte ( Onglet Données ) | -- | __ | __ | La liste des conteneurs à exclure des vérifications. Cette donnée n'est |
utilisée que pour les checks des modèles "all_containers". | |||||||
| l'Hôte ( Onglet Données ) | -- | __ | __ | La liste des images à exclure des vérifications pour le |
check "Image-age". Cette donnée n'est |
utilisée que pour les checks des modèles "all_containers". |
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
| Excerpt | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Résultat
Exemple
| Panel |
|---|
|
Interprétation des données
Statut
Il peut prendre 3 états OK / CRITIQUE / ATTENTION .
Le statut va dépendre du retour de sonde.
Voici un tableau récapitulatif du statut attendu suivant le retour de sonde :
| Situation | Statut | Exemple |
|---|---|---|
| ATTENTION |
|
| CRITIQUE |  |
Résultat
Le résultat court affiche, en une ligne, un résumé de l'état des healthchecks. Ce retour compact permet de pouvoir visualiser l'information même avec la taille des lignes réduites dans l'interface de visualisatonvisualisation.
Résultat Long
Le résultat long affiche un tableau regroupant l'ensemble des conteneurs détectés et le status de leurs healthchecks.
Métriques
Pas de métriques pour ce check.
Erreurs et pré-requis
| Excerpt Include | ||||||
|---|---|---|---|---|---|---|
|
...