Contexte
Le modèle shinken-synchronizer vous permet de superviser un hôte hébergeant le démon Synchronizer ( voir la page Le Synchronizer ) .
Description du modèle
Modèle d'hôte correspondant: shinken-synchronizer ( notez que ce modèle hérite du modèle shinken, shinken-deamon et shinken-synchronizer-db )
Afin de superviser le démon Synchronizer, le modèle shinken-synchronizer appliqué à votre hôte, attachera plusieurs checks qui vérifieront la santé et la performance de ce démon.
Checks
- Synchronizer - $KEY$ - Alive :
Vérifie que le démon Synchronizer peut être correctement contacté sur le réseau. Son numéro de version est affiché.
Si jamais le démon Arbiter est en exécution sur une machine virtuelle supervisé par VMware, alors le pourcentage de temps de vol de CPU ( CPU Stolen ) sera affiché.
|
- Synchronizer - $KEY$ - Performance API Connection :
Vérifie la latence de connexion au Synchronizer et ses performances
|
- Synchronizer - DB - Connection
Vérifie le temps de connexion à la base de données
|
- Synchronizer - DB - Last Flush Time
Vérifie la durée du dernier "Flush" de la base de données
|
La 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 "Synchronizer - 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 "Synchronizer - DB - Last Flush Time" a le même comportement que précédemment. |
- Synchronizer - DB - Open Connections
Vérifie le nombre de connexions en cours sur la base de données
|
Lors de la mise à jour de Shinken une montée de version de MongoDB est effectuée. Le check " Synchronizer - 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. |
Données du modèle
Les checks du Synchronizer peuvent être configurés via des données fournies par le modèle.
Les données suivantes sont disponibles pour le Synchronizer:
| 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 Synchronizer | http | shinken |
| CHECK_SHINKEN_TIMEOUT | Timeout utilisé pour établir la connexion avec le Synchronizer | 3 | shinken |
| SYNCHRONIZER_PORT | Port utilisé pour l'établissement de la connexion avec Synchronizer | 7772 | Locale |
| SYNCHRONIZER_LIST | Liste de Synchronizer (Multi-démon) | synchronizer-master$($_HOSTSYNCHRONIZER_PORT$)$ | Locale - Duplicate For Each ( voir la page 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-synchronizer-db |
| DB_CONNECTIONS_CRIT | Seuil critique du nombre de connexions en cours sur la base de données (en pourcentage) | 80 | shinken-synchronizer-db |
| DB_CONNECTIONS_WARN | Seuil avertissement du nombre de connexions en cours sur la base de données (en pourcentage) | 70 | shinken-synchronizer-db |
| DB_CONNECT_CRIT | Seuil critique pour le temps de connexion à la base de données (en secondes) | 4 | shinken-synchronizer-db |
| DB_CONNECT_WARN | Seuil avertissement pour le temps de connexion à la base de données (en secondes) | 2 | shinken-synchronizer-db |
| DB_LAST_FLUSH_TIME_CRIT | Seuil critique pour le temps de flush de la base de données (en millisecondes) | 10000 | shinken-synchronizer-db |
| DB_LAST_FLUSH_TIME_WARN | Seuil avertissement pour le temps de flush de la base de données (en millisecondes) | 8000 | shinken-synchronizer-db |
| DB_PORT | Port de la base de données | 27017 | shinken-synchronizer-db |
| DB_SSH_KEY | Clé SSH privée permettant la connexion au serveur hébergeant MongoDB | ~/.ssh/id_rsa | shinken-synchronizer-db |
| DB_SSH_USER | Utilisateur distant avec lequel se connecter au serveur hébergeant MongoDB | shinken | shinken-synchronizer-db |
| THRESHOLD_CPU_STOLEN_WARNING | Seuil de CPU volé ( en pourcentage ) 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 pourcentage ) 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 Graphes ou bien le Widget Graphique.
| Nom du check | Nom de la métrique | Explication |
|---|---|---|
Synchronizer - $KEY$ - Alive | connexion_time | Temps de connexion en secondes pour contacter le démon |
Synchronizer - $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) |
| Synchronizer - $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 |
Commandes
Nom du check | Commande du check | Ligne de commande |
|---|---|---|
| Synchronizer - $KEY$ - Alive | check_shinken_synchronizer! alive ! $VALUE1$ | $PLUGINSDIR$/check_shinken -H "$HOSTADDRESS$" -p "$ARG2$" --shinkenversion "$SHINKENVERSION$" -t synchronizer -m $ARG1$ --timeout $_HOSTCHECK_SHINKEN_TIMEOUT$ |
| Synchronizer - $KEY$ - Performance API Connection | check_shinken_synchronizer!api_connection ! $VALUE1$ | $PLUGINSDIR$/check_shinken -H "$HOSTADDRESS$" -p "$ARG2$" --shinkenversion "$SHINKENVERSION$" -t synchronizer -m $ARG1$ --timeout $_HOSTCHECK_SHINKEN_TIMEOUT$ |
| Synchronizer - DB - Connection | check_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$ |
| Synchronizer - 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$ -w $_HOSTTHRESHOLD_CPU_STOLEN_WARNING$ -c $_HOSTTHRESHOLD_CPU_STOLEN_CRITICAL$ |
| Synchronizer - 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$ -w $_HOSTTHRESHOLD_CPU_STOLEN_WARNING$ -c $_HOSTTHRESHOLD_CPU_STOLEN_CRITICAL$ |
Lors de la mise à jour de Shinken une montée de version de MongoDB est effectuée. Le check "Synchronizer - 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. |
Check : Synchronizer - $KEY$ - Alive
Description des erreurs
Erreur de surcharge des disques de logs
- Disque des logs trop lent :
En cas de disques trop lent sur le volume des logs, le check sera mis en WARNING avec l'erreur suivante.
|
Erreur de vol de CPU
Seulement si votre machine virtuelle est hébergé sur un hyperviseur VMWare
- Votre machine à du vol de CPU :
- Si la VM se fait voler trop de temps de calcul ( CPU Stolen ), le check sera mis en WARNING ou en CRITIQUE ( en fonction du taux de vol fixé par défaut ou indiqué par l'utilisateur ).
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) |
|
|
Erreur d'un démon bloqué, qui doit être redémarré
- Si un démon est dans un état bloqué, il doit être redémarré. Si c'est le cas:
- les checks seront en ERROR avec le message suivant,
- il faut ouvrir un ticket à votre support pour analyser le blocage
|
Le démon a bloqué une tentative de chargement d'objet malveillant
Il est possible qu'un démon puisse détecter et bloquer une tentative d'injection d'objet malveillant par le biais de l'une de ses routes.
Un message est remonté :
- le nombre total de ces tentatives que le démon a bloqué ce jour ( compte commence à minuit ) ;
- pour chacune des tentatives ( maximum 3 ) :
- descriptif de l'objet que l'attaquant essaye de charger,
- sa provenance de l'attaque, par exemple le nom de la route utilisée, et l'IP à la source de l'attaque,
- sa date.
|
Le démon est en cours d'arrêt
Lorsque le démon est en cours d'arrêt, le check le signale, et les informations relatives aux modules ne sont plus disponibles
|
