Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Contexte

Le Pack Shinken est inclus dans votre installation de Shinken Entreprise afin d'avoir une bonne visibilité de la santé de votre architecture de supervision.

Afin de pouvoir superviser les démons de l'architecture, la source cfg-file-shinken comprend un certain nombre de modèles d'hôte qu'il faudra importer et appliquer sur vos serveurs hébergeant vos démons Shinken.

Les différents modèles mis à votre disposition sont les suivants :

  • shinken-arbiter
  • shinken-broker
  • shinken-broker-module-sla
  • shinken-poller
  • shinken-reactionner
  • shinken-receiver
  • shinken-scheduler
  • shinken-synchronizer

  


Panel
titleSommaire

Table of Contents
maxLevel23


Une fois les modèles appliqués, les checks apparaitront dans l'onglet "Checks" de votre hôte.

Voici un exemple des différents checks du pack Shinken sur un hôte.



Panel

Arbiter

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

 

Checks

Check nameDescriptionExample OutputArbiter - AliveChecks that the Arbiter daemon can be reached over the network

Image Removed

Arbiter - PerformanceReturns connection time with the Arbiter daemon and the connection status of the Arbiter with the other daemons

Image Removed

Checks settings

Arbiter checks can be configured via datas provided by the template.

The following datas are available for the Arbiter:

Data nameDescriptionDefault ValueARBITER_PORTPort used to establish the connection with the Arbiter7770SHINKEN_PROTOCOLProtocol used to establish the connection with the Arbiterhttp

Broker

Corresponding host template: shinken-broker

Checks

Check nameDescriptionExample OutputBroker - AliveChecks that the Broker daemon can be reached over the network

Image Removed

Broker - Performance API ConnectionChecks to connection time to the Broker and its performances

Image Removed

Broker - Performance Modules QueuesChecks Broker module's performance

Image Removed

Mongo ChecksMultiple Mongo checks to assure Mongo is running well 

Check settings

Broker checks can be configured via datas provided by the template.

The following datas are available for the Broker:

Data nameDescriptionDefault ValueBROKER_PORTPort used to establish the connection with the Broker7772   

Poller

Corresponding host template: shinken-poller

Checks

Check nameDescriptionExample OutputPoller - Running WellChecks that the Poller daemon can be reached over the network, displays its tags an the connection status with the schedulers

Image Removed

Poller - PerformanceDisplay performance statistics of checks execution in the Poller.

Image Removed

Check settings

Poller checks can be configured via datas provided by the template.

The following datas are available for the Poller:

Data nameDescriptionDefault ValuePOLLER_PORTPort used to establish the connection with the Poller7771NB_CHECK_IN_TIMEOUT_TOLERATENumber of checks in timeout threshold. Over this limit, the check will exit with an error status0ACTIVE_POLLER_LATENCYConnection latency above which the check will issue an error. (in seconds)0.5

Reactionner

Corresponding host template: shinken-reactionner

Checks

Check nameDescriptionExample OutputReactionner - Running WellChecks that the Reactionner daemon can be reached over the network, displays its tags and the connection status with the schedulers

Image Removed

Reactionner - PerformanceDisplay performance statistics of notifications execution in the Reactionner.

Image Removed

Checks settings

Reactionner checks can be configured via datas provided by the template.

The following datas are available for the Reactionner.

Data nameDescriptionDefault ValueREACTIONNER_PORTPort used to establish the connection with the Reactionner7769ACTIVE_REACTIONNER_LATENCYConnection latency above which the check will issue an error. (in seconds)0.5

Receiver

Corresponding host template: shinken-receiver

Checks

Check nameDescriptionExample OutputReceiver - AliveChecks that the Receiver can be reached over the network

Image Removed

Receiver - Performance API ConnectionChecks connection time to the Receiver and its performances

Image Removed

Check settings

 

Receiver checks can be configured via datas provided by the template.

The following datas are available for the Receiver:

Data nameDescriptionDefault ValueRECEIVER_PORTPort used to establish the connection with the Receiver7769

Scheduler

Corresponding host template: shinken-scheduler

Checks

Check nameDescriptionExample OutputScheduler - Running WellChecks that the Scheduler daemon can be reached over the network, displays how many elements it is managing

Image Removed

Scheduler - PerformanceDisplays CPU usage as well as poller and reactionners statistics.

Image Removed


Cas particuliers

Détection de la haute disponibilité

Les modèles d'hôte du pack Shinken permettent de détecter les environnements distribués avec des démons configurés en Spare.

Dans le cas ou un démon est spare, une pastille bleue "SPARE" est affichée a coté du statut de la vérification:

Panel

Image Added

Lorsqu'un Spare prend le relais, une pastille "RUNNING" est rajoutée à la mention "SPARE" :

Panel

Image Added


Détection d'erreurs de communication entre démons

Les checks du pack Shinken ont la capacité de détecter les problèmes de communication entre les démons. 

En effet, si le démon supervisé lance un appel (API) et qu'il échoue, alors l'erreur sera écrite dans les logs de ce démon (Les fichiers Logs) et un Warning sera remonté :

Panel

Image Added

La vérification se base sur les dernières 24h. Si toutes les communications aboutissent correctement durant les dernières 24h, le message disparaîtra et vous retrouverez un état OK.

Info

Les erreurs de communication peuvent ne pas être graves et ne pas avoir d'incidence sur votre architecture Shinken. Cependant, si vous recevez des erreurs et que vous avez des doutes sur l'origine de ces problèmes de communication, par prévention, envoyez nous votre log pour analyse.


Détection des différences de versions

Les checks du pack Shinken sont également capables de détecter des différences de version entres les démons, et d'afficher l'information dans le retour du check.

Par exemple ici le retour du check "Arbiter - Performance" :


Panel

Image Added


Par exemple ici le retour du check "Scheduler - Performance", indiquant une différence de version avec un Poller :


Panel

Image Added


Détection du mode Passif des démons Poller et Reactionner

Les checks "Poller - Running Well" et "Reactionner - Running Well" du pack Shinken permettent de détecter et donc afficher si un démon est en mode passif.

Voici un exemple avec le check du Reactionner :

Panel

Image Added

Check settings

Scheduler checks can be configured via datas provided by the template. SSH parameters are fully described in Rétention Mongodb

The following datas are available for the Scheduler:

Data nameDescriptionDefault ValueSCHEDULER_PORTPort used to establish the connection with the Scheduler7768PASSIVE_POLLER_LATENCYConnection latency above which the check will issue an error. (in seconds)0.5MONGO_CONNECTION_METHODConnection method to the MongoDB server ("direct" or "ssh")sshMONGO_SSH_USERUser with whom to connect to the distant servershinkenMONGO_SSH_KEYFILESSH private key file to use to connect to the distant server~/.ssh/id_rsa

Synchronizer

Corresponding host template: shinken-synchronizer

Checks

Check nameDescriptionExample OutputSynchronizer - AliveChecks that the Scheduler daemon can be reached over the network

Image Removed

Synchronizer - Performance API ConnectionChecks connection time to the Synchronizer and its performances

Image Removed

Check settings

Synchronizer checks can be configured via datas provided by the template. SSH parameters are fully described in Rétention Mongodb

The following datas are available for the Synchronizer:

Data nameDescriptionDefault ValueSYNCHRONIZER_PORTPort used to establish the connection with the Synchronizer

7765

MONGO_CONNECTION_METHODConnection method to the MongoDB server ("direct" or "ssh")sshMONGO_SSH_USERUser with whom to connect to the distant servershinkenMONGO_SSH_KEYFILESSH private key file to use to connect to the distant server~/.ssh/id_rsa