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

maxLevel	5
style	none

Contexte

Plusieurs modèles vous permettent Le modèle shinken-broker permet de superviser un hôte hébergeant le démon Brokerdémon Broker ( voir la page Le Broker ).

Le modèle shinken-broker pour vérifier le comportement du démon,.
Le modèle Modèle shinken-broker-module-metrology-writer attachera attachera un check additionnel qui permettra de superviser l'écriture des données de métrologie.
Le modèle Modèle shinken-broker-module-sla-writer attachera un check additionnel qui permettra de superviser l'écriture des données de SLA.
Le modèle Modèle shinken-broker-module-visualisation-ui attachera un check additionnel qui permettra de superviser la lecture des données de métrologie.
- Le modèle Modèle shinken-broker-module-visualisation-ui-sla-reader readerattachera un check additionnel qui permettra de superviser la lecture des données SLA.
- Le modèle Modèle shinken-broker-module-visualisation-ui-event-manager-reader reader attachera un check additionnel qui permettra de superviser la lecture des données du données du bac à événement.
Le modèle Modèle shinken-broker-module-event-manager-writer writerattachera un check additionnel qui permettra de superviser l'écriture des données du bac à événement.
Le modèle Modèle shinken-broker-db attachera quant à lui, les checks qui permettront de superviser la base utilisée par Shinken pour le démon Broker.

Description du modèle

Modèle d'hôte correspondant: shinken-broker (notez que ce modèle hérite du modèle shinken, shinken-deamon et shinken-broker-db)

Afin de superviser le démon Broker, le modèle shinken-broker appliqué à votre hôte, attachera plusieurs checks qui vérifieront la santé et la performance de ce démon.

module-livedata attachera un check qui permettra de superviser le module SLA en vérifiant l'état du module livedata, le nombre de requêtes effectué sur le module et le temps de réponse moyenne des requêtes.

Le modèle shinken-broker hérite des modèles suivants :

Le Modèle shinken qui fournira des données globales de fonctionnement des checks de shinken ;
Le Modèle shinken-daemon qui fournira des données globales de fonctionnement des checks de démon de shinken ;
Le Modèle shinken-broker-db qui fournira 3 checks pour la supervision de la base de donnée et les données associées à leur fonctionnement ;

Sommaire des checks

Nom	Description

Checks


Broker - $KEY$ - Alive	Vérifie que le démon Broker peut être correctement contacté sur le réseau

, que la version du démon est affichée dans le ( Résultat court ) et aussi que les modules sont opérationnels ( Résultat long ).Si jamais le démon Arbiter est en exécution sur une machine virtuelle supervisée par VMware, alors le pourcentage de temps de vol de CPU ( CPU %Ready ) sera affiché

.

panel

Image Removed

Broker - $KEY$ - Performance API Connection

Vérifie les temps de connexion vers le Broker.

panel

Image Removed

Broker - $KEY$ - Performance Modules Queues

Vérifie les performances des modules du Broker.

Panel
Image Removed

Broker - DB - Connection

Vérifie le temps de connexion à la base de données.

Panel

Image Removed


Broker - DB - Last Flush Time	Vérifie la durée du dernier "Flush" de la base

de données.

Panel
Image Removed

NoteLa version V02.07.00 de Shinken est accompagnée d'une mise à jour de MongoDB. Cette nouvelle version comporte notamment un changement de la méthode

de

sauvegarde des objets au sein de Mongo.

Sur une installation neuve de Shinken, le nouveau format (WiredTiger) est utilisé, ce qui rend le "Broker - DB - Last Flush Time" non pertinent. Dans ce cas, ce check aura le résultat suivant :

Panel
Image Removed

Dans le cas d'une mise à jour de Shinken, la méthode de stockage des

données

dans Mongo n'est pas modifiée et le check "Broker - DB - Last Flush Time" a le même comportement que précédemment

.
Broker - DB - Open Connections	Vérifie le nombre de connexions en cours sur la base de données.

panel

Image Removed

Note
Lors de la mise à jour de Shinken une montée de version de MongoDB est effectuée. Le check "Broker - DB - Lock Time Percentage" devient obsolète et peut être désactivé. La source "cfg-file-shinken" propose la désactivation du check, mais ne peut pas le supprimer automatiquement.

Un démon spare n'a pas à avoir la même liste de module que son master

Quand le master est configuré pour avoir un spare qui n'a pas la même liste de modules que lui, le check ajoute un message d'information le précisant :

Panel
Image Removed

Consulter l'option suivante dans la configuration du master ( voir la page Le Broker ).

Code Block
broker__manage_spare__spare_must_have_the_same_list_of_module_type

Données du modèle

Les

checks du Broker peuvent être configurés via des

données

fournies par le modèle.

Les données

suivantes sont disponibles :Nom de la donnéeDescriptionValeur par défautHérité du modèle d'hôte ou localeSHINKEN_PROTOCOLProtocole utilisé pour établir la connexion avec le BrokerhttpshinkenCHECK_SHINKEN_TIMEOUTTimeout utilisé pour l'établissement de la connexion avec Broker3shinkenBROKER_PORTPort utilisé pour l'établissement de la connexion avec Broker7772LocaleBROKER_LISTListe de Broker (Multi-démon)broker-master$($_HOSTBROKER_PORT$)$Locale - Duplicate For EachDB_CONNECTION_METHODMéthode de connexion au serveur MongoDB ("direct" ou "ssh")sshshinken-broker-dbDB_CONNECTIONS_CRITSeuil critique du nombre de connexions en cours sur la base de données (en pourcentage)80shinken-broker-dbDB_CONNECTIONS_WARNSeuil d'avertissement du nombre de connexions en cours sur la base de données (en pourcentage)70shinken-broker-dbDB_CONNECT_CRITSeuil critique pour le temps de connexion à la base de données (en secondes)4shinken-broker-dbDB_CONNECT_WARNSeuil d'avertissement pour le temps de connexion à la base de données (en secondes)2shinken-broker-dbDB_LAST_FLUSH_TIME_CRITSeuil critique pour le temps de flush de la base de données (en millisecondes)10000shinken-broker-dbDB_LAST_FLUSH_TIME_WARNSeuil d'avertissement pour le temps de flush de la base de données (en millisecondes)8000shinken-broker-dbDB_PORTPort de la base de données27017shinken-broker-dbDB_SSH_KEYClé SSH privée permettant la connexion au serveur hébergeant MongoDB~/.ssh/id_rsashinken-broker-dbDB_SSH_USERUtilisateur distant avec lequel se connecter au serveur hébergeant MongoDBshinkenshinken-broker-dbTHRESHOLD_CPU_STOLEN_WARNINGSeuil de cpu volé (en pourcentage) sur une machine virtuelle supervisée par vmware avant de déclencher un warning5shinken-deamonTHRESHOLD_CPU_STOLEN_CRITICALSeuil de cpu volé (en pourcentage) sur une machine virtuelle supervisée par vmware avant de déclencher un critique10shinken-deamon

Voir la page de Sécurisation des connexions aux bases MongoDB pour plus d'information sur un paramétrage sécurisé.

Métriques enregistrées

Les checks du modèle enregistrent des données de performance, qui peuvent ensuite être affichées dans l'interface de Visualisation sur l'Onglet Graphes ou bien le Widget Graphique.

communes pour tous les checks

Provenant du modèle shinken

Excerpt Include

	Modèle shinken
	Modèle shinken
nopanel	true

Provenant du modèle shinken-daemon

Excerpt Include

	Modèle shinken-daemon
	Modèle shinken-daemon
nopanel	true

Provenant du modèle shinken-broker-db

Excerpt Include

	Modèle shinken-broker-db
	Modèle shinken-broker-db
nopanel	true

Provenant du modèle shinken-broker

Excerpt Include

	Le Broker
	Le Broker
nopanel	true

Les données spécifiques

Pour le check "Broker - DB - Connection"

Excerpt Include

	Broker - DB - Connection
	Broker - DB - Connection
nopanel	true

Pour le check "Broker - DB - Last Flush Time"

Excerpt Include

	Broker - DB - Last Flush Time

Nom du checkNom de la métriqueExplication

Broker - $KEY$ - Alive

connexion_time

Temps de connexion en secondes pour contacter le démon

Broker - $KEY$ - Alive

cpu_stolen__vmware__percent_ready

(Seulement si le démon est situé sur une VM VMWare) Valeur de l'indicateur VMWare %ready (temps de blocage de la VM avant d'avoir accès à ses VCpu, donc temps perdu du point de vue de la VM)

Broker - $KEY$ - Performance API Connectionget_lock_timeTemps de connexion et d'obtention d'un appel bloquant dans le démon et ainsi voir si les appels bloquants ne sont pas trop longBroker - $KEY$ - Performance Modules Queues*.data_queueTaille de la file d'attente des envois de Broks vers les modules externes. Un élément étant rajouté par seconde, ceci représente le nombre de secondes de Brok reçus qui n'ont pas encore été récupérés par le module.

Commandes

Nom du check

Commande du check

Ligne de commande

Broker - $KEY$ - Alivecheck_shinken_broker!alive!$VALUE1$$PLUGINSDIR$/check_shinken -H "$HOSTADDRESS$" -p "$ARG2$" --shinkenversion "$SHINKENVERSION$" -t broker -m $ARG1$ --timeout $_HOSTCHECK_SHINKEN_TIMEOUT$ -w $_HOSTTHRESHOLD_CPU_STOLEN_WARNING$ -c $_HOSTTHRESHOLD_CPU_STOLEN_CRITICAL$
Broker - $KEY$ - Performance API Connectioncheck_shinken_broker!api_connection!$VALUE1$$PLUGINSDIR$/check_shinken -H "$HOSTADDRESS$" -p "$ARG2$" --shinkenversion "$SHINKENVERSION$" -t broker -m $ARG1$ --timeout $_HOSTCHECK_SHINKEN_TIMEOUT$ -w $_HOSTTHRESHOLD_CPU_STOLEN_WARNING$ -c $_HOSTTHRESHOLD_CPU_STOLEN_CRITICAL$
Broker - $KEY$ - Performance Modules Queuescheck_shinken_broker!modules_queue!$VALUE1$

$PLUGINSDIR$/check_shinken -H "$HOSTADDRESS$" -p "$ARG2$" --shinkenversion "$SHINKENVERSION$" -t broker -m $ARG1$ --timeout $_HOSTCHECK_SHINKEN_TIMEOUT$ -w $_HOSTTHRESHOLD_CPU_STOLEN_WARNING$ -c $_HOSTTHRESHOLD_CPU_STOLEN_CRITICAL$

Broker - DB - Connectioncheck_shinkendb_connection$PLUGINSDIR$/check_shinkendb.py -D -H "$HOSTADDRESS$" -P "$_HOSTDB_PORT$" --connection-method "$_HOSTDB_CONNECTION_METHOD$" --ssh-user "$_HOSTDB_SSH_USER$" --ssh-keyfile "$_HOSTDB_SSH_KEY$" -A connect -W "$_HOSTDB_CONNECT_WARN$" -C "$_HOSTDB_CONNECT_CRIT$" --timeout $_HOSTCHECK_SHINKEN_TIMEOUT$


	Broker - DB - Last Flush Time

check_shinkendb_last_flush$PLUGINSDIR$/check_shinkendb.py -D -H "$HOSTADDRESS$" -P "$_HOSTDB_PORT$" --connection-method "$_HOSTDB_CONNECTION_METHOD$" --ssh-user "$_HOSTDB_SSH_USER$" --ssh-keyfile "$_HOSTDB_SSH_KEY$" -A last_flush_time -W "$_HOSTDB_LAST_FLUSH_TIME_WARN$" -C "$_HOSTDB_LAST_FLUSH_TIME_CRIT$" --timeout $_HOSTCHECK_SHINKEN_TIMEOUT$

nopanel	true

Pour le check "Broker - DB - Connection"

Excerpt Include

	Broker - DB - Open Connections
	Broker - DB - Open Connections

check_shinkendb_open_connections$PLUGINSDIR$/check_shinkendb.py -D -H "$HOSTADDRESS$" -P "$_HOSTDB_PORT$" --connection-method "$_HOSTDB_CONNECTION_METHOD$" --ssh-user "$_HOSTDB_SSH_USER$" --ssh-keyfile "$_HOSTDB_SSH_KEY$" -A connections -W "$_HOSTDB_CONNECTIONS_WARN$" -C "$_HOSTDB_CONNECTIONS_CRIT$" --timeout $_HOSTCHECK_SHINKEN_TIMEOUT$

Description des erreurs de Broker - $KEY$ - Alive

Erreur de surcharge des disques de logs

En cas de disques trop lent sur le volume des logs, le check sera mis en WARNING avec l'erreur suivante.

Panel
Image Removed

Erreur de vol de CPU

Seulement si votre machine virtuelle est hébergé sur un hyperviseur VMWare

Votre machine à du vol de CPU :
Lorsque le CPU se fait voler trop de temps de calcul, le check sera mis en WARNING ou en CRITIQUE
( en fonction du taux de vol ) avec l'erreur suivante.
- Vous pouvez avoir plus d'information sur cet indicateur et comment réduire la parte de temps de la VM sur la page Machine VMWare avec un fort taux de CPU Stolen (%ready + %costop)

Panel
Image Removed

Panel
Image Removed

Un démon spare n'est assigné sur aucun démon master

Un spare n'est pas assigné à un démon master:
Lorsqu’un démon Broker spare n'est assigné par aucun démon master, il est inutile, et remonte en erreur dans le check, tout comme dans la commande shinken-healtcheck, afin qu'il soit rapidement identifié et corrigé.

Panel
Image Removed

Problème de conflits d'Arbiters

Conflit d'Arbiters :
Si le démon est contacté par des Arbiters qui ne sont pas sur la même architecture ( par exemple un Arbiter de Production, et un autre de l'environnement de Testing ), le check sera mis en CRITICAL.

Panel
Image Removed

Conflit d'Arbiters qui ont le même nom d'Architecture :
Comme dans le cas précédent, le démon est contacté par des Arbiters d'architectures différents, mais qui ont le même nom. On sort également en CRITICAL mais en avertissant que les noms sont identiques, et en indiquant comment retrouver les serveurs en question, en trouvant leur valeur dans le fichier /var/lib/shinken/server.uuid.

nopanel	true

Les données DFE ( Duplicate Foreach )

Excerpt

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
BROKER_LIST

l'Hôte

( Onglet Données )

---

broker-master$($_HOSTBROKER_PORT$)$

broker-master$($_HOSTBROKER_PORT$)$

Liste de Brokers ( Multi-démon )

Check(s) impacté(s) :

Comment appliquer un modèle d'hôte à un hôte

Excerpt Include

	Comment appliquer un modèle d'hôte à un hôte - Pack shinken
	Comment appliquer un modèle d'hôte à un hôte - Pack shinken
nopanel	true

Panel
Image Removed

Les serveurs ne sont pas à la même heure

Si le serveur n'est pas à la même heure que le serveur Arbiter ( qui fait office de référence ), une erreur CRITICAL sera levée, car des temps différents sur les différents serveurs va avoir des effets désastreux sur la cohérence des données de supervision.

Panel
Image Removed

La dernière connexion de l'Arbiter remonte à trop longtemps

Si la dernière connexion de l'Arbiter remonte à trop de temps, le démon va lever un WARNING. Ceci peux être dû:

Les Arbiters MASTER et SPARE sont réellement éteints
Les Arbiters MASTER et SPARE sont en train d'envoyer des configurations à d'autres démons, et ne peuvent donc pas contacter ce démon pour l'instant.

Panel
Image Removed

Info

Le temps pris en compte comme limite de dernière connexion est de check_interval * max_check_attempts du démon ( définis dans sa configuration ).

Les valeurs par défauts sont de 60s * 3, soit 3 minutes.

Page tree

Versions Compared

Old Version 39

New Version Current

Key

Contexte

Description du modèle

Sommaire des checks

Un démon spare n'a pas à avoir la même liste de module que son master

Données du modèle

Les

données

Les données

Métriques enregistrées

communes pour tous les checks

Provenant du modèle shinken

Provenant du modèle shinken-daemon

Provenant du modèle shinken-broker-db

Provenant du modèle shinken-broker

Les données spécifiques

Pour le check "Broker - DB - Connection"

Pour le check "Broker - DB - Last Flush Time"

Commandes

Pour le check "Broker - DB - Connection"

Description des erreurs de Broker - $KEY$ - Alive

Erreur de surcharge des disques de logs

Erreur de vol de CPU

Un démon spare n'est assigné sur aucun démon master

Problème de conflits d'Arbiters

Les données DFE ( Duplicate Foreach )

Comment appliquer un modèle d'hôte à un hôte

Les serveurs ne sont pas à la même heure

La dernière connexion de l'Arbiter remonte à trop longtemps