DOCKER-BY-SSH
Contexte
Le check CPU by SSH permet de superviser l’utilisation du CPU alloué à un conteneur spécifique de l'instance Docker.
Il interroge le pourcentage d’utilisation CPU à un instant donné ( valeur instantanée ).
Par défaut, un conteneur Docker n'est pas limité en consommation CPU. Il peut consommer autant de mémoire que la machine virtuelle a à disposition. Dans ce cas, le pourcentage d'utilisation CPU reflète la disponibilité CPU sur le serveur entier.
Si le conteneur Docker a été limité, le pourcentage d'utilisation reflétera la disponibilité CPU dans la limite de ce que le conteneur peut consommer.
Exemple pour un serveur avec 4 CPU :
|
Le changement de statut repose sur une seule règle :
Si l’utilisation CPU dépasse les seuils définis ( warning ou critical ), alors le statut du check change automatiquement.
Ce check permet :
de repérer rSSHdement une surcharge CPU sur l’instance Docker,
de détecter un trafic anormal,
d’identifier un processus excessivement consommateur,
ou de prévenir une saturation système.
En résumé, ce check est un indicateur clé pour anticiper des dérives de performance au niveau d'un conteneur.
|
Paramétrage
Le check utilise la ligne de commande suivante :
$SHINKEN_DOCKER-BY-SSH_PLUGINSDIR$/check_docker_SSH.py -H "$HOSTADDRESS$" -u "$_HOSTDOCKER-BY-SSH__SSH-USER$" -p "$_HOSTDOCKER-BY-SSH__SSH-PORT$" -k "$_HOSTDOCKER-BY-SSH__SSH-KEY$" -x "$_HOSTDOCKER-BY-SSH__SSH-PASSPHRASE$" -m "cpu" -w "$_HOSTDOCKER-BY-SSH__CPU__CPU-WARN$" -c "$_HOSTDOCKER-BY-SSH__CPU__CPU-CRIT$" -s "$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
| Nom | Modifiable sur | Unité | Défaut | Valeur par défaut à l'installation de Shinken | Description | |
|---|---|---|---|---|---|---|
| l'Hôte ( Onglet Données ) | % | 90 | 90 | Définit le pourcentage d'utilisation CPU à partir duquel le check passe en CRITIQUE .
| |
| l'Hôte ( Onglet Données ) | % | 80 | 80 | Définit le pourcentage d'utilisation CPU à partir duquel le check passe en ATTENTION .
|
Données DFE ( Duplicate Foreach )
| Nom | Modifiable sur | Unités | Défaut | Valeur par défaut à l'installation de Shinken | Description | |
|---|---|---|---|---|---|---|
| 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)$".
|
Données utilisées provenant du check
Pas de données provenant du check pour ce modèle
|
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__CPU__CPU-WARN
- DOCKER-BY-SSH__CPU__CPU-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 |
|---|---|---|
| ATTENTION |
|
| CRITIQUE |  |
Résultat
Le résultat court affiche l’utilisation CPU en cours sur le conteneur sélectionné ( valeur instantanée ).
Résultat Long
Pas de résultat long pour ce check.
Métriques
Interprétation des métriques
| Nom de la métrique | Unité | Description | Seuil d'avertissement | Seuil critique |
|---|---|---|---|---|
| (nom-du-container)_cpu__all_usage | % | Retourne le pourcentage de temps CPU actif au cours de la dernière seconde ( Correspond au % afficher dans le résultat du check ). | DOCKER-BY-SSH__CPU__CPU-WARN | DOCKER-BY-SSH__CPU__CPU-CRIT |
Example
|
