DOCKER-BY-API
| Scroll Ignore | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||
|
Contexte
Le check CPU by API [$KEY$] Cpu by SSH permet de superviser vérifier l’utilisation CPU du CPU alloué à un conteneur spécifique de l'instance Dockerconteneur sélectionné.
Il interroge remonte, pour celui-ci, le pourcentage d’utilisation CPU à un instant donné ( valeur instantanée )de CPU utilisé au moment de la vérification.
Par défaut, un conteneur Docker n'est pas limité en consommation CPU. Il peut Cela veut dire qu'il peut théoriquement consommer autant de mémoire que la machine virtuelle a à disposition. CPU que l'hôte ( le serveur ou le docker est installé ) en possède. 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 consommerreprésente également un bon indicateur de la charge globale du serveur.
| Info |
|---|
Exemple pour un serveur avec 4 CPU :
|
Le changement de statut repose sur une seule règle :
Si l’utilisation CPU du conteneur dépasse les seuils définis ( warning ou critical ), alors le statut du check change automatiquement.
Ce check permet donc :
de repérer rapidement une surcharge CPU sur l’instance Docker,
de détecter un trafic anormalune activité anormale,
d’identifier un processus excessivement consommateur,
ou de prévenir une saturation système.
En résuméPour résumer, ce check est un indicateur clé pour anticiper des dérives de performance au niveau vérifier le fonctionnement normal d'un conteneurgroupe de conteneurs.
| Panel |
|---|
|
Paramétrage
Le check utilise la ligne de commande suivante :
| Code Block | ||||
|---|---|---|---|---|
| ||||
$SHINKEN_DOCKER-ON-LINUX-BY-APISSH_PLUGINSDIR$/check_docker_SSH.py --connection "$HOSTADDRESS$":H "$HOSTADDRESS$" -u "$_HOSTDOCKER-ON-LINUX-BY-SSH__SSH-USER$" -p "$_HOSTDOCKER-ON-LINUX-BY-APISSH__SSH-PORT$" -k "$_HOSTDOCKER-ON-LINUX-BY-SSH__SSH-KEY$" -x "$_HOSTDOCKER-ON-LINUX-BY-SSH__SSH-PASSPHRASE$" -m "cpu" -w "$_HOSTDOCKER-ON-LINUX-BY-APISSH__CPU__CPU-WARN$": -c "$_HOSTDOCKER-ON-LINUX-BY-APISSH__CPU__CPU-CRIT$" --containerss "$ARG1$" |
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 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
| Excerpt | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Résultat
Exemple
| Panel |
|---|
|
Interprétation des données
Statut
Il peut prendre 4 valeursétats 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-ON-LINUX-BY-APISSH__CPU__CPU-WARN
- DOCKER-ON-LINUX-BY-APISSH__CPU__CPU-CRIT
Voici Ci-dessous, un tableau récapitulatif du statut attendu suivant le retour de sonde des différents retours possibles :
| Info | ||
|---|---|---|
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  |  | |
| INCONNU |
|
Résultat
Le résultat court affiche l’utilisation CPU en cours sur le conteneur sélectionné ( valeur instantanée ), 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
Pas de Le résultat long pour ce checkaffiche un tableau affichant la consommation CPU.
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 affiché dans le résultat du check ). | DOCKER-ON-LINUX-BY-APISSH__CPU__CPU-WARN | DOCKER-ON-LINUX-BY-APISSH__CPU__CPU-CRIT |
Exemple
| Panel |
|---|
|
...
|
Erreurs et pré-requis
| Excerpt Include | ||||||
|---|---|---|---|---|---|---|
|