Page History

Scroll Ignore

scroll-pdf	true
scroll-office	true
scroll-chm	true
scroll-docbook	true
scroll-eclipsehelp	true
scroll-epub	true
scroll-html	true

Panel

title	Sommaire

Table of Contents

style	none

Contexte

La supervision d'un démon Poller présente un grand nombre de statistiques de performances qui permettent de visualiser le travail effectué par le Poller. Le Poller a pour rôle d'exécuter les checks.

Il est ainsi souvent un des premiers démons que l'on regarde lorsqu'on veut visualiser combien de checks sont exécutés. Aussi, pour dimensionner correctement une installation Shinken Entreprise, il est important de pouvoir visualiser combien de checks un Poller est capable d'exécuter pour pouvoir décider d'ajouter ou retirer des Pollers de la configuration.

Les checks du Poller fournis dans le pack Shinken fournissent donc un grand nombre de données sur les performances du Poller.

Panel
Image Added

Paramétrage

Le check utilise la ligne de commande suivante :

Code Block

language	js
theme	Confluence

$PLUGINSDIR$/check_shinken -H "$HOSTADDRESS$" -p "$ARG2$" --shinkenversion "$SHINKENVERSION$" -t poller -m $ARG1$ --active_poller_latency 
"$_HOSTACTIVE_POLLER_LATENCY$" --check_tolerate "$_HOSTPOLLER_NB_CHECK_IN_TIMEOUT_TOLERATE$" --timeout "$_HOSTCHECK_SHINKEN_TIMEOUT$" -w 
"$_HOSTTHRESHOLD_CPU_STOLEN_WARNING$" -c "$_HOSTTHRESHOLD_CPU_STOLEN_CRITICAL$"

Données utilisées provenant du modèle

Données communes pour les checks du modèle

Excerpt Include

	Modèle shinken-poller
	Modèle shinken-poller
nopanel	true

Données spécifiques pour ce check

Pas de données spécifiqiue pour ce check.

Les données DFE ( Duplicate Foreach )

Scroll Title

anchor	data_for_check_sup_de_sup
title

Nom

Modifiable sur

Unité

Défaut

Valeur par défaut à l'installation de Shinken

Description

No Format
POLLER_LIST

l'Hôte

( Onglet Données )

--

poller-master$($_HOSTPOLLER_PORT$)$

poller-master$($_HOSTPOLLER_PORT$)$

Configuration du port de communication avec l'Arbiter.

Autres check(s) impacté(s) :

Poller - $KEY$ - Running Well

Note : Cette valeur remplacera dans la commande la valeur $ARG2$

Données utilisées provenant du check

Pas de données provenant du check pour ce check.

Données globales

Excerpt Include

	Mise en place du Pack windows
	Mise en place du Pack windows
nopanel	true

Résultat

Exemple

Panel
Image Added

Interprétation

Statut

Il peut prendre quatre 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 :
- THRESHOLD_CPU_STOLEN_CRITICAL
- THRESHOLD_CPU_STOLEN_WARNING
- CHECK_SHINKEN_TIMEOUT
Voici un tableau récapitulatif du statut attendu suivant le retour de sonde :

Les vérifications communes

Excerpt Include

	Liste des événements sur les démons modifiant le résultat des checks
	Liste des événements sur les démons modifiant le résultat des checks
nopanel	true

Les vérifications spécifiques

Situation

Statut

Le temps de connexion à la base de données :

Si c'est supérieur à THRESHOLD_CPU_STOLEN_CRITICAL ( par défaut : 10% )

CRITIQUE

Le temps de connexion à la base de données :

Si c'est supérieur à THRESHOLD_CPU_STOLEN_WARNING ( par défaut : 5% )

ATTENTION

Si la sonde n'a pas eu de réponse avant le temps maximum

Si supérieur à CHECK_SHINKEN_TIMEOUT ( par défaut : 3 sec )

INCONNU

Résultat

Statistiques générales sur l’exécution des checks

La première statistique remontée par le check est le nombre de checks effectués par seconde par le Poller supervisé.

Dans cet exemple, le Poller effectue 1.9 check par seconde en moyenne, tous checks confondus.

Panel
Image Added

Charge du Poller

Le check du Poller fournit aussi la charge du Poller. Il s'agit d'un indicateur général indiquant si le Poller peut encore supporter des checks supplémentaires, ou s’il est chargé au maximum. Cet indicateur n'est pas lié aux autres indicateurs de performances de la machine ( File d'attente CPU, mémoire).

Panel
Image Added

Une pastille orange précédant la mention "Poller load" signifie que le Poller ne peut plus prendre de checks supplémentaires. Cette pastille indique que le Poller fonctionne à la vitesse maximale qui lui est permise par le processeur.

C'est donc un signe indiquant qu'il faudrait ajouter un Poller supplémentaire dans l'architecture Shinken.

Panel
Image Added

Utilisation du CPU

Le Poller se limite intelligemment selon différents critères pour éviter de surcharger inutilement la machine sur laquelle il est exécuté. Le premier critère de limitation est l'utilisation du CPU de la machine par le démon ( et l'exécution des checks ).

Si le Poller se rend compte que le CPU de la machine sur laquelle il est exécuté est surchargé, il se régule pour exécuter moins de checks et éviter de rendre la machine inutilisable.

Dans le check "Poller - Performance", la quantité de CPU utilisée par les checks est affichée dans le Résultat du check.

Panel
Image Added

Si le CPU de la machine hébergeant le Poller est utilisé de manière intensive, le résultat du check "Poller - Performance" avertit de l'utilisation trop élevée du CPU. Dans ce cas, le Poller se limite et n’exécute plus de checks supplémentaires tant que l'utilisation du CPU est trop élevée.

La ligne indiquant la charge du Poller indique alors que le CPU est surchargé.

Panel
Image Added

Utilisation de la mémoire (RAM)

Si le CPU n'est pas le facteur limitant pour le fonctionnement du Poller, l'état de la mémoire du serveur est alors vérifié. Dans le résultat du check "Poller - Performance", l'utilisation de la mémoire sur le serveur est indiquée.

Panel
Image Added

Si l'utilisation de la mémoire (RAM) sur le serveur dépasse le seuil défini dans la configuration du Poller, le résultat du check "Poller - Performance" affiche un avertissement indiquant l'utilisation excessive de la mémoire. Lorsque cet avertissement est affiché, le Poller n'exécute plus de checks supplémentaires tant que l'utilisation de la mémoire est supérieure au seuil défini.

Panel
Image Added

Comme mentionné précédemment, le réglage du seuil est effectué dans le fichier de configuration du Poller concerné.

Code Block

language	js
theme	Confluence
title	/etc/shinken/pollers/mon_poller.cfg

define poller {
...
# Percentage of used physical RAM beyond which the poller will not launch any new check
max_ram_percent           95
...
}

Le nombre de processus dans la file d'attente du processeur

Le Poller possède une dernière mesure de performance qu'il observe et selon laquelle il limite son activité. Après la vérification de l'utilisation du CPU du Poller et de la mémoire du serveur, le Poller vérifie le nombre de processus dans la file d'attente du processeur.

En fonction de la limite de processus dans la file d'attente du processeur, le Poller décide s’il faut exécuter des checks supplémentaires.

Le nombre de processus dans la file d'attente du processeur est affiché dans le résultat du check "Poller - Performance".

Panel
Image Added

Le nombre de processus dans la file d'attente du processeur est aussi accompagné d'une pastille indiquant le statut de cette mesure. Lorsque le nombre de processus est supérieur à la limite définie dans la configuration, cette pastille indique ce dépassement.

Dans ce cas, le Poller n'exécutera plus de checks supplémentaires tant que le nombre de processus dans la file d'attente du processeur sera supérieur au seuil choisi.

Panel
Image Added

Le seuil mentionné précédemment se définit dans le fichier de configuration du Poller concerné. On note que ce seuil se définit par cœur du processeur, et pas globalement pour le processeur.

Ainsi, avec une limite définie à 3, et un processeur possédant 4 cœurs, le Poller ne se limitera que lorsqu'il y a plus de 12 processus dans la file d'attente du processeur.

Code Block

language	js
theme	Confluence
title	/etc/shinken/pollers/mon_poller.cfg

define poller {
...
# Number of maximum runnings processes in the CPU Queue per CPU. Default value is 4.
max_cpu_queue_per_cpu    4
...
}

Résultat Long

Dans le Résultat long du check "Poller - Performance", deux tableaux présentent des statistiques sur les temps d'exécution des checks dans le Poller.

Le premier tableau affiche les 5 checks consommant le plus de temps CPU parmi l'ensemble des checks exécutés sur le Poller. Dans ce tableau, pour chaque check sont affichés le nom du check, l'hôte sur lequel il est accroché, et le temps d'exécution du check.

Panel
Image Added

Un deuxième tableau présente la répartition du temps d'exécution des checks. Dans le tableau en exemple, on voit que les checks exécutés sur ce Poller s'exécutent majoritairement en moins de 50ms.

Panel
Image Added

Si le temps moyen d’exécution des checks est très long, ou très court, il est possible de modifier les réglages des périodes de temps du tableau dans le fichier de configuration du Poller concerné. Dans le fichier de configuration du Poller en question, l'option "exec_stat_range" doit être modifiée.

Code Block

language	js
theme	Confluence
title	/etc/shinken/pollers/mon_poller.cfg

define poller {
...
# Ranges for the check : poller statistics
#exec_stat_range    50, 100, 200, 300, 400, 1000, 5000, 15000
...
}

Description des erreurs

Excerpt Include

	Les vérifications communes à tous les démons
	Les vérifications communes à tous les démons
nopanel	true

Excerpt Include

	Les vérifications de vol de CPU
	Les vérifications de vol de CPU
nopanel	true

Métriques

Scroll Title

anchor	parameter_check_metrics
title

Nom

Unité

Description

No Format

language	text
theme	Emacs

used_ram_percent

--

Pourcentage de mémoire utilisée sur le serveur

No Format

language	text
theme	Emacs

cpu_usage_percent

--

Pourcentage de temps processeur utilisé par le Poller

No Format

language	text
theme	Emacs

poller_load_state

--

Booléen ( 0 ou 100 ) qui indique si le Poller a atteint sa charge maximale :

0 : Le Poller n'a pas atteint sa charge maximale, il peut encore exécuter des checks supplémentaires
100 : Le Poller a atteint sa charge maximale, il ne peut pas exécuter plus de checks.

No Format

language	text
theme	Emacs

nb_action_done_per_sec

--

Nombre moyen de checks exécutés par le Poller ( moyenne glissante calculée sur 1mn )

No Format

language	text
theme	Emacs

cpu_running_queue

--

Queue moyenne de checks exécutés par le Poller ( moyenne glissante calculée sur 1mn )

No Format

language	text
theme	Emacs

checks_per_cpu_running_time_X_Y_ms

--

Ces métriques représentent la répartition du temps d'exécution des checks, le nombre de métriques générées va dépendre de la configuration du Poller, comme expliqué dans l'onglet Résultat Long

Page tree

Versions Compared

Old Version 1

New Version 2

Key

Contexte

Paramétrage

Données utilisées provenant du modèle

Données communes pour les checks du modèle

Données spécifiques pour ce check

Les données DFE ( Duplicate Foreach )

Données utilisées provenant du check

Données globales

Résultat

Exemple

Interprétation

Statut

Les vérifications communes

Les vérifications spécifiques

Résultat

Statistiques générales sur l’exécution des checks

Charge du Poller

Utilisation du CPU

Utilisation de la mémoire (RAM)

Le nombre de processus dans la file d'attente du processeur

Résultat Long

Description des erreurs

Métriques