Contexte
Le check Memory by SSH permet de superviser l’utilisation mémoire des conteneurs.
Il remonte, pour chacun d'entre eux, le pourcentage de mémoire utilisé au moment de la vérification.
Par défaut, un conteneur n'est pas limité en consommation mémoire. Cela veut dire qu'il peut théoriquement consommer autant de mémoire que l'hôte ( le serveur ou le docker est installé ) en possède. Dans ce cas, le pourcentage d'utilisation mémoire représente également un bon indicateur de la charge globale du serveur.
Exemple pour un serveur avec 8GB de mémoire :
- conteneur non limité
- 500 Mo consommés = 6.25% d'utilisation
- Conteneur limité à 1 GB
- 500 Mo consommés = 50% d'utilisation
Le changement de statut repose sur une seule règle :
Si l’utilisation mémoire d'un des conteneurs dépasse les seuils définis ( warning ou critical ), alors le statut du check change automatiquement.
Ce check permet :
de repérer rapidement une surcharge mémoire et d'identifier le conteneur responsable,
de détecter une activité anormale,
de prévenir une saturation système.
Pour résumer, ce check est un indicateur clé pour vérifier le fonctionnement normal d'un groupe de conteneurs.
Paramétrage
Le check utilise la ligne de commande suivante :
$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 "memory" -w "$_HOSTDOCKER-ON-LINUX-BY-SSH__MEMORY__MEMORY-WARN$" -c "$_HOSTDOCKER-ON-LINUX-BY-SSH__MEMORY__MEMORY-CRIT$" -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
| Nom | Modifiable sur | Unité | Défaut | Valeur par défaut à l'installation du pack | Description |
|---|---|---|---|---|---|
DOCKER-ON-LINUX-BY-SSH__SSH-PORT | l'Hôte ( Onglet Données ) | -- | 22 | 22 | Port de connexion SSH. |
_DOCKER-ON-LINUX-BY-SSH__SSH-USER | l'Hôte ( Onglet Données ) | -- | user-service-shinken | user-service-shinken | Nom de l'utilisateur pour se connecter sur le serveur supervisé. |
_DOCKER-ON-LINUX-BY-SSH__SSH-KEY | l'Hôte ( Onglet Données ) | -- | /var/lib/shinken/.ssh/id_rsa | /var/lib/shinken/.ssh/id_rsa | Chemin vers la clé SSH privée de l'utilisateur shinken, sur le serveur hébergeant le Poller qui exécutera le check.
|
_DOCKER-ON-LINUX-BY-SSH__SSH-PASSPHRASE | l'Hôte ( Onglet Données ) | -- | $SSH_KEY_PASSPHRASE$ | $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ée est ensuite utilisée pour authentifier l'utilisateur. |
Données spécifiques pour ce check
| Nom | Modifiable sur | Unité | Défaut | Valeur par défaut à l'installation de Shinken | Description |
|---|---|---|---|---|---|
_DOCKER-ON-LINUX-BY-SSH__CONTAINERS-EXCLUDED | 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" |
_DOCKER-ON-LINUX-BY-SSH__IMAGES-EXCLUDED | 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" |
DOCKER-ON-LINUX-BY-SSH__MEMORY__MEMORY-CRIT | l'Hôte ( Onglet Données ) | % | 90 | 90 | Définit le pourcentage d'utilisation mémoire à partir duquel le check passe en CRITIQUE.
|
DOCKER-ON-LINUX-BY-SSH__MEMORY__MEMORY-WARN | l'Hôte ( Onglet Données ) | % | 80 | 80 | Définit le pourcentage d'utilisation mémoire à 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 provenant du check pour ce modèle
Non modifiable ( Sauf Admin Shinken ) Chemin absolu contenant les sondes installées par Shinken. Non modifiable ( Sauf Admin Shinken ) Dossier fourni par Shinken. Non modifiable ( Sauf Admin Shinken ) Dossier contenant les sondes. Non modifiable ( Sauf Admin Shinken ) Chemin absolu du dossier contenant les sondes du pack docker-on-linux-by-SSH__shinken ( non modifiable ). l'Hôte ( Onglet Général ) -- Adresse de l'hôteDonnées globales
Nom Modifiable sur Unité Défaut Valeur par défaut à l'installation Description USERPLUGINSDIR
-- /var/lib/shinken-user/libexec /var/lib/shinken-user/libexec SHINKEN_DOCKER-ON-LINUX-BY-SSH_VENDOR
-- shinken-additional-packs shinken-additional-packs SHINKEN_DOCKER-ON-LINUX-BY-SSH_PACKNAME
docker-on-linux-by-SSH__shinken docker-on-linux-by-SSH__shinken SHINKEN_DOCKER-ON-LINUX-BY-SSH_PLUGINSDIR
-- USERPLUGINSDIR$/$SHINKEN_DOCKER-ON-LINUX-BY-SSH_VENDOR$/$SHINKEN_DOCKER-ON-LINUX-BY-SSH_PACKNAME
/var/lib/shinken-user/libexec/shinken-additional-packs/docker-on-linux-by-SSH__shinken Propriétés de l'hôte
Nom Modifiable sur Unité Défaut Valeur par défaut Description HOSTADDRESS
Nom de l'hôte Nom de l'hôte
Résultat
Exemple
Interprétation des données
Statut
Il peut prendre 3 états OK / CRITIQUE / ATTENTION .
Le statut va dépendre du retour de sonde et de la configuration spécifique du check pour les données suivantes :
- DOCKER-ON-LINUX-BY-SSH__MEMORY__MEMORY-WARN
- DOCKER-ON-LINUX-BY-SSH__MEMORY__MEMORY-CRIT
- 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 |
|---|---|---|
| ATTENTION |
|
| CRITIQUE |  |
Résultat
Le résultat court affiche, en une ligne, un résumé de l'état des conteneurs. Ce retour compact permet de pouvoir visualiser l'information même avec la taille des lignes réduites dans l'interface de visualisation.
Résultat Long
Le résultat long affiche un tableau regroupant l'ensemble des conteneurs détectés et leurs consommations mémoire.
Métriques
Interprétation des métriques
| Nom de la métrique | Unité | Description | Seuil d'avertissement | Seuil critique |
|---|---|---|---|---|
| (nom-du-container)_mem | % | Retourne le pourcentage de mémoire utilisé au cours par le conteneur ( Correspond au % affiché dans le résultat du check ). | DOCKER-ON-LINUX-BY-SSH__MEMORY__MEMORY-WARN | DOCKER-ON-LINUX-BY-SSH__MEMORY__MEMORY-CRIT |
Exemple
