Import des modules depuis /var/lib/shinken/modules - chapitre [ CODE-LOADING ]
Les démons vont lister les répertoires dans /var/lib/shinken/modules et vont tenter de charger chaque module.
Les logs en DEBUG seront changé en INFO quand le démon chargera le code de ses propres modules et non pas de tous les modules.
Chargement du code du module
Le démon annonce qu'il va commencer à charger son module. Un log en DEBUG apparaîtra.
[YYYY-MM-DD HH:MM:SS] DEBUG : [ broker-master ] [ MODULES-MANAGER ] [ CODE-LOADING ] [ directory=architecture-export ] Starting to load the module code directory /var/lib/shinken/modules/architecture-export. |
Si le démon trouve une exception Python durant le procédé d'import du module, un log en ERROR avec l’exception sera affiché et le module ne sera pas importé.
[YYYY-MM-DD HH:MM:SS] ERROR : [ broker-master ] [ MODULES-MANAGER ] [ CODE-LOADING ] [ directory=architecture-export ] Import module [architecture-export] failed: EXCEPTION. |
Chargement du module en tant que module Python
Une fois que le démon à charger le code du module il va vérifier si le module peut être importé en tant qu'un module python. Un log en DEBUG apparaîtra.
[YYYY-MM-DD HH:MM:SS] DEBUG : [ broker-master ] [ MODULES-MANAGER ] [ CODE-LOADING ] [ directory=architecture-export ] Try to import a module code in /var/lib/shinken/modules/architecture-export as python module. |
Si le démon ne peut pas importer le code du module en tant que module python alors des logs en WARNING formant un bloc apparaîtrons.
Un premier log expliquant que le démon n'a pas réussi à importer le module en tant que python module.
[YYYY-MM-DD HH:MM:SS] WARNING : [ broker-master ] [ MODULES-MANAGER ] [ CODE-LOADING ] [ directory=architecture-export ] Failed to import the directory /var/lib/shinken/modules/architecture-export as a python module.
Un second log s'affichera seulement s'il manque le fichier '__init__.py' dans le dossier du module. Sans se fichier il n'est pas possible d'importer le module en tant que module Python.
[YYYY-MM-DD HH:MM:SS] WARNING : [ broker-master ] [ MODULES-MANAGER ] [ CODE-LOADING ] [ directory=architecture-export ] - because of missing file : /var/lib/shinken/modules/architecture-export/__init__.py.
Un troisième log informant qu'il n'est pas possible de faire un import : 'import architecture-export.my_file '. Car le module n'a pas été importé en tant que module python.
[YYYY-MM-DD HH:MM:SS] WARNING : [ broker-master ] [ MODULES-MANAGER ] [ CODE-LOADING ] [ directory=architecture-export ] - 'import architecture-export.my_file' will not work in your module.py file.
Si le démon à réussi à importer le module en tant que python module alors un log en DEBUG apparaîtra.
[YYYY-MM-DD HH:MM:SS] DEBUG : [ broker-master ] [ MODULES-MANAGER ] [ CODE-LOADING ] [ directory=architecture-export ] Success to import the directory /var/lib/shinken/modules/architecture-export/ as a python module. |
Vérification des propriétés du module
Une fois que le démon à importer (ou non) son module en tant que python module, il va vérifier si le dictionnaire "properties " existe.
S'il n'existe pas alors un log en ERROR sera affiché expliquant que le dictionnaire est manquant et que le module ne sera par conséquent pas importé.
[YYYY-MM-DD HH:MM:SS] ERROR : [ broker-master ] [ MODULES-MANAGER ] [ CODE-LOADING ] [ directory=architecture-export ] Missing properties dict in your module file /var/lib/shinken/modules/architecture-export/module.py. The module will not be imported. |
Création du module - chapitre [ CREATION ]
Une fois le code python chargé, on demande au démon de créer les modules, de les démarrer et de démarrer son ou ces Worker(s).
Création de l'instance du module
Le démon va essayer de créer l'instance du module :
Si le code du module ne contient pas la fonction "get_instance()" ou qu'elle ne retourne rien un log en ERROR sera affiché.
[YYYY-MM-DD HH:MM:SS] ERROR : [ broker-master ] [ MODULES-MANAGER ] [ CREATION ] [ WebUI ] [ module-type=webui ] FAIL The module get_instance() call did not return any instance.
Si le démon a réussi à charger le code du module mais n'a pas réussi à créer l'instance alors un log en ERROR sera affiché avec l'exception Python concerné.
[YYYY-MM-DD HH:MM:SS] ERROR : [ broker-master ] [ MODULES-MANAGER ] [ CREATION ] [ WebUI ] [ module-type=webui ] [0.046s] FAIL The module creation did fail with an exception: EXCEPTION. Remove this module currently, will try to recreate it in the future.
Si l'instance a bien été créée alors un log en INFO sera affiché son temps de création.
[YYYY-MM-DD HH:MM:SS] INFO : [ broker-master ] [ MODULES-MANAGER ] [ CREATION ] [ WebUI ] [ module-type=webui ] [0.046s] SUCCESS The module instance is created. |
Démarrage du module
Une fois le module créé le démon va essayer de la démarrer. Ce log sera en INFO.
[YYYY-MM-DD HH:MM:SS] INFO : [ broker-master ] [ MODULES-MANAGER ] [ CREATION ] [ WebUI ] [ module-type=webui ] Trying to init module. |
Si le démon a réussi à créer son module mais n'a pas réussi à le démarrer alors 3 logs apparaîtrons :
Un log en ERROR expliquant que le module n'a pas réussi à se démarrer suivie du message de l'exception Python puis de l'exception en question.
[YYYY-MM-DD HH:MM:SS] ERROR : [ broker-master ] [ MODULES-MANAGER ] [ CREATION ] [ WebUI ] [ module-type=webui ] The module failed to init and he raised an exception: EXCEPTION.
Un log en WARNING indiquant le nombre de fois que le démon à essayer de démarrer son module sans succès. Le compteur se remet à zéro des lors que le démon à réussi à démarrer son module.
[YYYY-MM-DD HH:MM:SS] WARNING : [ broker-master ] [ MODULES-MANAGER ] [ CREATION ] [ WebUI ] [ module-type=webui ] The module tried to start: 5 times.
Un log en WARNING indiquant quand est-ce que le démon va essayer de redémarrer son module (Maximum une minute).
[YYYY-MM-DD HH:MM:SS] WARNING : [ broker-master ] [ MODULES-MANAGER ] [ CREATION ] [ WebUI ] [ module-type=webui ] The module will try to restart at 16:32:18.
Un log en INFO apparaîtra si le démon a réussi à démarrer son module.
[YYYY-MM-DD HH:MM:SS] INFO : [ broker-master ] [ MODULES-MANAGER ] [ CREATION ] [ WebUI ] [ module-type=webui ] SUCCESS The module is started. |
Démarrage du/des Worker(s) du module
Une fois le module démarré le démon va essayer de démarrer son/ses Worker(s). Ce log sera en INFO.
[YYYY-MM-DD HH:MM:SS] INFO : [ broker-master ] [ MODULES-MANAGER ] [ CREATION ] [ WebUI ] [ module-type=webui ] Starting a worker(s). |
Si le démon n'a pas réussi à démarrer le/les Wroker(s) du module :
Et qu'il a levé une exception lors du démarrage alors un log en ERROR sera affiché disant que le démon n'a pas réussi à démarrer le/les Worker(s) du module avec le message de l'exception.
[YYYY-MM-DD HH:MM:SS] ERROR : [ broker-master ] [ MODULES-MANAGER ] [ CREATION ] [ WebUI ] [ module-type=webui ] The worker(s) failed to init and he raised an exception: EXCEPTION.
Alors un log en ERROR sera affiché disant que le démon n'a pas réussi à démarrer le/les Worker(s) du module.
[YYYY-MM-DD HH:MM:SS] ERROR : [ broker-master ] [ MODULES-MANAGER ] [ CREATION ] [ WebUI ] [ module-type=webui ] The worker(s) failed to init.
Si le/les Worker(s) du module ce sont bien démarrer alors ce log en INFO apparaîtra.
[YYYY-MM-DD HH:MM:SS] INFO : [ broker-master ] [ MODULES-MANAGER ] [ CREATION ] [ WebUI ] [ module-type=webui ] SUCCESS The worker(s) is created. |
Changement de configuration ou d'état du module - chapitre [ UPDATE ]
Rajout d'un nouveau module dans un démon
Lorsqu'un démon reçoit un nouveau module, on va avoir un log en INFO comme quoi le module à été ajouter à la configuration du démon.
[YYYY-MM-DD HH:MM:SS] INFO : [ broker-master ] [ MODULES-MANAGER ] [ UPDATE ] [ WebUI ] Launching a new module as it was added in the daemon configuration. |
Suppression d'un module dans un démon
Lorsqu'un utilisateur enlève un module de la configuration du démon, on va avoir un log en INFO informant que l'on supprime le module car il n'est plus dans la configuration du démon.
[YYYY-MM-DD HH:MM:SS] INFO : [ broker-master ] [ MODULES-MANAGER ] [UPDATE ] [ WebUI ] Removing the module because it is removed from the configuration. |
Si le démon a essayé de supprimer un module mais qu'il ne la pas trouver dans ses instances alors un log en WARNING sera affiché.
[YYYY-MM-DD HH:MM:SS] WARNING : [ broker-master ] [ MODULES-MANAGER ] [ UPDATE ] [ WebUI ] Trying to remove the module WebUI but it is not found in the current running modules: LIST_CURRENT_RUNNING_MODULES |
Changement de configuration d'un module (et sa relance)
Le démon a détecté que la configuration de son module n'est plus la même qu'avant il annonce avec un log INFO qu'il va redémarrer son module afin de prendre la nouvelle configuration en compte.
[YYYY-MM-DD HH:MM:SS] INFO : [ broker-master ] [ MODULES-MANAGER ] [ UPDATE ] [ WebUI ] Configuration of the module did change so we restart it. |
Le module n'a pas réussi à se mettre à jour
Le démon à trouver une nouvelle configuration venant d'un ancien ou d'un nouveau module mais il n'arrive pas à le mettre à jour. Le démon vous l'informe avec un log en ERROR.
[YYYY-MM-DD HH:MM:SS] ERROR : [ broker-master ] [ MODULES-MANAGER ] [ UPDATE ] [ WebUI ] Cannot find previous or new module definition for the module name WebUI, so cannot update it. |
Arrêt du module en cours d’exécution - chapitre [ CRASH ]
Le module s'est arrêté de façon inattendu
Lorsqu'un module externe n'est plus en cours d’exécution et qu'il s'est éteint de façon inattendue le démon affichera un log en ERROR.
[YYYY-MM-DD HH:MM:SS] ERROR : [ broker-master ] [ MODULES-MANAGER ] [ CRASH] [ synchronizer-module-database-backup ] [ module-type=synchronizer_module_database_backup ] The external module synchronizer-module-database-backup goes down unexpectedly! |
Lorsqu'un ou plusieurs Worker(s) d'un module externe n'est ou ne sont plus en cours d’exécution et qu'il s'est ou qu'ils se sont éteint(s) de façon inattendue le démon affichera un log en ERROR.
[YYYY-MM-DD HH:MM:SS] ERROR : [ broker-master ] [ MODULES-MANAGER ] [ CRASH] [ synchronizer-module-database-backup ] [ module-type=synchronizer_module_database_backup ] The module synchronizer-module-database-backup worker(s) goes down unexpectedly! |
Si un module a pu prévenir lors de son arrêt (par exemple la WebUI détecte qu'elle a un problème avec ses fichiers .html ou .js, elle peutprévenir le démon avant de s’arrêter), on aura le log explicatif en ERROR issu du module.
[YYYY-MM-DD HH:MM:SS] ERROR : [ broker-master ] [ MODULES-MANAGER ] [ CRASH ] [ WebUI ] [ module_type=webui ] The __shinken_lang__ variable was not found in the index.html file: there is a critical error with your installation. Please open a ticket to your support. |
Le module à un comportement anormal
Lorsqu'un module externe à une taille de liste d'attente d'internal commande ou de retour d'internal commande plus élevé que la taille maximale définie dans le fichier de configuration ini du démon ( max_queue_size) un log sera affiché en ERROR.
QUEUE_SIZE = Taille ( en nombre d'éléments ) de la liste d'attente. Éléments possibles : Commande(s) ou retour de commande(s).
QUEUE_MAX_SIZE = Taille ( en nombre d'éléments ) maximale de la Queue définie dans le fichier ini du démon. ( paramètre max queue size).
[YYYY-MM-DD HH:MM:SS] ERROR : [ broker-master ] [ MODULES-MANAGER ] [ CRASH] [ synchronizer-module-database-backup ] [ module-type=synchronizer_module_database_backup ] The external module synchronizer-module-database-backup got a too high brok queue size (QUEUE_SIZE > QUEUE_MAX_SIZE)! |