Contexte

Le modèle shinken-receiver vous permet de superviser un hôte hébergeant le démon Receiver.

Receiver

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

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

Checks

  • Receiver - $KEY$ - Alive

    Vérifie que le démon Receiver peut être correctement contacté sur le réseau ( Résultat court ) et que les modules sont opérationnels ( Résultat long ).

    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 Ready ) sera affiché.



  • Receiver - $KEY$ - Performance API Connection

    Vérifie la latence de connexion au Receiver et ses performances



Données du modèles

Les checks du Receiver peuvent être configurés via des données fournies par le modèle.

Les données suivantes sont disponibles pour le Receiver:

Nom de la donnéeDescriptionValeur par défautHérité du modèle d'hôte ou locale
SHINKEN_PROTOCOL

Protocole utilisé pour établir la connexion avec le Receiver

httpshinken
CHECK_SHINKEN_TIMEOUTTimeout utilisé pour établir la connexion avec le Receiver3shinken
RECEIVER_PORT

Port utilisé pour établir la connexion avec le Receiver

7773Locale
RECEIVER_LIST

Liste de Receiver (Multi-démon)

receiver-master$($_HOSTRECEIVER_PORT$)$Locale - Duplicate For Each
THRESHOLD_CPU_STOLEN_WARNINGSeuil de CPU volé (en pourcentage) sur une machine virtuelle supervisée par VMware avant de déclencher un warning5shinken-deamon
THRESHOLD_CPU_STOLEN_CRITICALSeuil de CPU volé (en pourcentage) sur une machine virtuelle supervisée par VMware avant de déclencher un critique10shinken-deamon


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 checkNom de la métriqueExplication

Receiver - $KEY$ - Alive

connexion_time

Temps de connexion en secondes pour contacter le démon

Receiver - $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)

Receiver - $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 long


Commandes


Nom du check

Commande du check

Ligne de commande

Receiver - $KEY$ - Alivecheck_shinken_receiver!alive!$VALUE1$ $PLUGINSDIR$/check_shinken -H "$HOSTADDRESS$" -p "$ARG2$" --shinkenversion "$SHINKENVERSION$" -t receiver -m $ARG1$ --timeout $_HOSTCHECK_SHINKEN_TIMEOUT$ -w $_HOSTTHRESHOLD_CPU_STOLEN_WARNING$ -c $_HOSTTHRESHOLD_CPU_STOLEN_CRITICAL$
Receiver - $KEY$ - Performance API Connectioncheck_shinken_receiver!api_connection!$VALUE1$ $PLUGINSDIR$/check_shinken -H "$HOSTADDRESS$" -p "$ARG2$" --shinkenversion "$SHINKENVERSION$" -t receiver -m $ARG1$ --timeout $_HOSTCHECK_SHINKEN_TIMEOUT$ -w $_HOSTTHRESHOLD_CPU_STOLEN_WARNING$ -c $_HOSTTHRESHOLD_CPU_STOLEN_CRITICAL$


Description des erreurs de Receiver - $KEY$ - Alive

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.



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 .



  • 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.



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érences des données de supervision.



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 Arbiter 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.




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.


Description des erreurs de Receiver - $KEY$ - Performance

Erreur de vol de CPU

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

  • 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 ).