| Scroll Ignore | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||
|
Contexte
Le modèle shinken-broker vous permet de superviser un hôte hébergeant le démon Broker ( voir la page Le Broker ).
- Le modèle shinken-broker pour vérifier le comportement du démon,.
- Le modèle shinken-broker-module-metrology-writer attachera un check additionnel qui permettra de superviser l'écriture des données de métrologie.
- 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 shinken-broker-module-visualisation-ui attachera un check additionnel qui permettra de superviser la lecture des données de métrologie.
- Le modèle shinken-broker-module-visualisation-ui-sla-reader attachera un check additionnel qui permettra de superviser la lecture des données SLA.
- Le modèle shinken-broker-module-visualisation-ui-event-manager-reader attachera un check additionnel qui permettra de superviser la lecture des données du bac à événement.
- Le modèle shinken-broker-module-event-manager-writer attachera un check additionnel qui permettra de superviser l'écriture des données du bac à événement.
- 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.
Le modèle shinken-broker hérite du modèle shinken , shinken-deamon et shinken-broker-db.
Afin de superviser le démon Broker, le modèleshinken-broker appliqué à votre hôte, attachera trois checks qui vérifieront la santé et les performances de ce démon.
Sommaire des checks
Nom | Description |
|---|---|
Broker - $KEY$ - Alive | Vérifie que le démon Broker peut être correctement contacté sur le réseau. ( voir la page Broker - $KEY$ - Alive ) |
Broker - $KEY$ - Performance API Connection | Vérifie les temps de connexion vers le Broker. ( voir la page Broker - $KEY$ - Performance API Connection ) |
Broker - $KEY$ - Performance Modules Queues | Vérifie les performances des modules du Broker. ( voir la page Broker - $KEY$ - Performance Modules Queues ) |
Broker - DB - Connection | Vérifie le temps de connexion à la base de données. ( voir la page Broker - DB - Connection ) |
Broker - DB - Last Flush Time | Vérifie la durée du dernier "Flush" de la base de données. ( voir la page Broker - DB - Last Flush Time ) |
Broker - DB - Open Connections | Vérifie le nombre de connexions en cours sur la base de données. ( voir la page Broker - DB - Open Connections ) |
Les données
Les données communes pour tous les checks
Provenant du modèle shinken
| Excerpt Include | ||||||
|---|---|---|---|---|---|---|
|
Provenant du modèle shinken-daemon
| Excerpt Include | ||||||
|---|---|---|---|---|---|---|
|
Les données spécifiques
| Nom | Modifiable sur | Unités | Défaut | Valeur par défaut à l'installation de Shinken | Description | ||
|---|---|---|---|---|---|---|---|
| Modèle d'hôte ( Onglet Données ) | --- | 7772 | 7772 | Configuration du port de communication avec le Broker. |
Les données DFE ( Duplicate Foreach )
| Excerpt | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Comment appliquer un modèle d'hôte à un hôte
| Excerpt Include | ||||||
|---|---|---|---|---|---|---|
|
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 ).
| Panel |
|---|
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 Stolen ) sera affiché.
Broker - $KEY$ - Performance API Connection
Vérifie les temps de connexion vers le Broker.
| Panel |
|---|
Broker - $KEY$ - Performance Modules Queues
Vérifie les performances des modules du Broker.
| Panel |
|---|
Broker - DB - Connection
Vérifie le temps de connexion à la base de données.
| Panel |
|---|
Broker - DB - Last Flush Time
Vérifie la durée du dernier "Flush" de la base de données.
| Panel |
|---|
| Note | ||
|---|---|---|
La version 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 :
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 |
|---|
| 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 |
|---|
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ée | Description | Valeur par défaut | Hérité du modèle d'hôte ou locale |
|---|---|---|---|
| SHINKEN_PROTOCOL | Protocole utilisé pour établir la connexion avec le Broker | http | shinken |
| CHECK_SHINKEN_TIMEOUT | Timeout utilisé pour l'établissement de la connexion avec Broker | 3 | shinken |
| BROKER_PORT | Port utilisé pour l'établissement de la connexion avec Broker | 7772 | Locale |
| BROKER_LIST | Liste de Broker ( Multi-démon ) | broker-master$($_HOSTBROKER_PORT$)$ | Locale - Dupliquer des checks en fonction d'une liste de valeurs présentes dans la Donnée d'un hôte (duplicate_foreach) |
| DB_CONNECTION_METHOD | Méthode de connexion au serveur MongoDB ( "direct" ou "ssh" ) | ssh | shinken-broker-db |
| DB_CONNECTIONS_CRIT | Seuil critique du nombre de connexions en cours sur la base de données ( en p ourcentage ) | 80 | shinken-broker-db |
| DB_CONNECTIONS_WARN | Seuil d'avertissement du nombre de connexions en cours sur la base de données ( en p ourcentage ) | 70 | shinken-broker-db |
| DB_CONNECT_CRIT | Seuil critique pour le temps de connexion à la base de données ( en secondes ) | 4 | shinken-broker-db |
| DB_CONNECT_WARN | Seuil d'avertissement pour le temps de connexion à la base de données ( en secondes ) | 2 | shinken-broker-db |
| DB_LAST_FLUSH_TIME_CRIT | Seuil critique pour le temps de flush de la base de données ( en millisecondes ) | 10000 | shinken-broker-db |
| DB_LAST_FLUSH_TIME_WARN | Seuil d'avertissement pour le temps de flush de la base de données ( en millisecondes ) | 8000 | shinken-broker-db |
| DB_PORT | Port de la base de données | 27017 | shinken-broker-db |
| DB_SSH_KEY | Clé SSH privée permettant la connexion au serveur hébergeant MongoDB | ~/.ssh/id_rsa | shinken-broker-db |
| DB_SSH_USER | Utilisateur distant avec lequel se connecter au serveur hébergeant MongoDB | shinken | shinken-broker-db |
| THRESHOLD_CPU_STOLEN_WARNING | Seuil de cpu volé ( en p ourcentage ) sur une machine virtuelle supervisée par vmware avant de déclencher un warning | 5 | shinken-deamon |
| THRESHOLD_CPU_STOLEN_CRITICAL | Seuil de cpu volé ( en p ourcentage ) sur une machine virtuelle supervisée par vmware avant de déclencher un critique | 10 | shinken-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 Graphiques ou bien le Widget Graphique.
| Nom du check | Nom de la métrique | Explication |
|---|---|---|
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 Connection | get_lock_time | Temps de connexion et d'obtention d'un appel bloquant dans le démon et ainsi voir si les appels bloquants ne sont pas trop long |
| Broker - $KEY$ - Performance Modules Queues | *.data_queue | Taille 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. |
...