Page History

Import des modules depuis /

opt/

shinken/modules - chapitre [ CODE-LOADING ]

Anchor
importDesModules importDesModules

Chaque démon ( ou module qui possèdes d'autres modules ) va démarrer son gestionnaire de module "modules-manager" qui va charger chaque module présent dans /var/libopt/shinken/modules. Pour qu'un module soit chargé, il faut qu'il soit présent dans un répertoire.

Chargement du code

Le "modules-manager" va regarder si le fichier "module_info.json" placé dans le répertoire du module existe. S'il n'existe pas un log en WARNING sera affiché.

[YYYY-MM-DD HH:MM:SS] WARNING : [ daemonDAEMON_orOR_moduleMODULE_nameNAME  ] [ MODULES-MANAGER ] [ CODE-LOADING ] [ directory=directoryMY_MODULE_nameDIRECTORY ] Missing 'module_info.json' file at the pathin directory /varopt/lib/shinken/modules/myMY_moduleMODULE_directoryDIRECTORY/module_info.json. TheModule code of the module will be loaded anyway.

Après que le "modules-manager" ait regardé si le fichier "module_info.json" existe, il va regarder si la clé "daemons" est bien présente dans le fichier. Si elle n'existe pas un log en WARNING sera affiché.

[YYYY-MM-DD HH:MM:SS] WARNING : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ CODE-LOADING ] [ directory=directoryMY_MODULE_nameDIRECTORY ] Missing 'daemons' key in the 'module_info.json' filein atdirectory the path /var/lib/opt/shinken/modules/myMY_moduleMODULE_directoryDIRECTORY/module_info.json. TheModule code of the module will be loaded anyway.

Si le "modules-manager" n'a pas réussi à lire le fichier à cause d'un problème de formatage, un log en WARNING sera affiché.

[YYYY-MM-DD HH:MM:SS] WARNING : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ CODE-LOADING ] [ directory=directoryMY_MODULE_nameDIRECTORY ] The 'module_info.json' file atin the pathdirectory /varopt/lib/shinken/modules/myMY_moduleMODULE_directoryDIRECTORY/module_info.json is malformed. TheModule code of the module will be loaded anyway.

Si le "modules-manager" n'a pas réussi à lire le fichier à cause d'un problème de permissions, un log en WARNING sera affiché.

[YYYY-MM-DD HH:MM:SS] WARNING : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ CODE-LOADING ] [ directory=directoryMY_MODULE_nameDIRECTORY ] PermissionRead permission denied to read file 'module_info.json' file at the pathin directory /varopt/lib/shinken/modules/myMY_moduleMODULE_directoryDIRECTORY/module_info.json. TheModule code of the module will be loaded anyway.

Le "modules-manager" annonce qu'il va commencer à charger le code de son module. Un log en INFO apparaîtra.

[YYYY-MM-DD HH:MM:SS] INFO : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ CODE-LOADING ] [ directory=directoryMY_MODULE_nameDIRECTORY  ] Starting to load the module code from directory /varopt/lib/shinken/modules/myMY_moduleMODULE_directoryDIRECTORY.

Si le "modules-manager" 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 : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ CODE-LOADING ] [ directory=directoryMY_MODULE_nameDIRECTORY ] Import module moduleMODULE_nameNAME failed: EXCEPTION.

À la fin la fin de l'import du code le "modules-manager" affiche un résumé de l'import dans un log en INFO.

[YYYY-MM-DD HH:MM:SS] INFO : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ CODE-LOADING ] A total of 9 Shinken Enterprise modules are available for this daemon/module ( daemonDAEMON_orOR_moduleMODULE_nameNAME ): MODULES_LIST_NAME (on a total of 40, loaded in 1.844s)

Chargement du module en tant que module Python

Lors du chargement du code, le "modules-manager" va vérifier si un module peut être importé en tant que package Python. En cas d'échec un log en INFO sera affiché.

[YYYY-MM-DD HH:MM:SS] INFO : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ CODE-LOADING ] [ directory=directoryMY_MODULE_nameDIRECTORY ] Try to import a module code infrom /var/libopt/shinken/modules/moduleMY_MODULE_nameDIRECTORY as python module.

En cas d'échec, 2 situations sont possibles:

• Si vous le module n'utilisez utilise pas les fonctionnalités propre à un module python ( import d'un fichier local, ...  ), un log en INFO sera affiché.
  
  

[YYYY-MM-DD HH:MM:SS] INFO : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ CODE-LOADING ] [ directory=moduleMODULE_nameNAME ] Failed to import the directory /varopt/lib/shinken/modules/moduleMY_MODULE_nameDIRECTORY as a python module. If it doesn't usethis is not a python module feature, itthis won'tis encounternot loadinga problemsproblem..

• Dans le cas contraire, il se peut que l'échec de chargement du module soit lié à un problème d'import de fichier en Python. Les 3 logs en ERROR seront affichés  :
  
  

  • Le premier log indique que l'import a échoué et que le module ne sera pas chargé.
    
    

    Code Block
    language text theme Emacs
    [YYYY-MM-DD HH:MM:SS] ERROR : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ CODE-LOADING ] [ directory=directoryMY_MODULE_nameDIRECTORY] Failed to import the directory /var/libopt/shinken/modules/directoryMY_MODULE_nameDIRECTORY as a python module. ThePython modulecode won't be loaded.

  • Le second log indique que le fichier '__init__.py' dans le dossier du module est manquant ( sans ce fichier, il est impossible d'importer le module en tant que module Python ).
    
    

    Code Block
    language text theme Emacs
    [YYYY-MM-DD HH:MM:SS] ERROR : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ CODE-LOADING ] [ directory=directoryMY_MODULE_nameDIRECTORY] - because of missing file : /varopt/lib/shinken/modules/moduleMY_MODULE_nameDIRECTORY/__init__.py.

  • Le troisième log précise quel fichier n'a pas réussi à être importé dans le code du module. Dans notre exemple, c'est le fichier module_namefichier MY_MODULE_DIRECTORY.my_file qui n'a pas été importé.
    
    

    Code Block
    language text theme Emacs
    [YYYY-MM-DD HH:MM:SS] ERROR : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ CODE-LOADING ] [ directory=directoryMY_MODULE_nameDIRECTORY] - The line 'import moduleMY_MODULE_nameDIRECTORY.my_file' The module won't work in your module.py file.

modules-managerINFO 

[YYYY-MM-DD HH:MM:SS] INFO : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ CODE-LOADING ] [ directory=directoryMY_MODULE_nameDIRECTORY ] SuccessSuccessfully toimported import the directory /varopt/lib/shinken/modules/architecture-exportMY_MODULE_DIRECTORY/ as a python module.

Vérification de l'existense du dictionnaire Python "properties" du module

Une fois que le "modules-manager" a chargé un module en tant que package Python, il va vérifier si le dictionnaire "properties" est existant dans le module.

Dans le cas contraire, le module ne sera pas importé et le log en ERROR suivant sera affiché :

[YYYY-MM-DD HH:MM:SS] ERROR : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ CODE-LOADING ] [ directory=nameMY_directoryMODULE_DIRECTORY ] Missing properties dict in your module file /varopt/lib/shinken/modules/moduleMY_MODULE_nameDIRECTORY/module.py. The module won't be loaded.

Création du module - chapitre [ CREATION ]

Une fois, le code python chargé, on demande au "modules-manager" 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 "modules-manager" va essayer de créer le 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é:

  Code Block
  language text theme Emacs
  [YYYY-MM-DD HH:MM:SS] ERROR : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ CREATION ] [ moduleMODULE_nameNAME] [ module-type=moduleMODULE_typeTYPE ] The module get_instance() call did not return any instance or does not exist.

• Si le "get_instance()" du module rencontre une erreur, le log en ERROR sera affiché avec l'exception Python concernée:

  Code Block
  language text theme Emacs
  [YYYY-MM-DD HH:MM:SS] ERROR : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ CREATION ] [ moduleMODULE_nameNAME ] [ module-type=moduleMODULE_typeTYPE ] [0.046s] The module creation didhas failfailed withraising an exception: EXCEPTION. Will try to recreate it in the future.retry later

• Si le module type ne correspond pas au démon ou au module qui le lance:

  Code Block
  language text theme Emacs
  [YYYY-MM-DD HH:MM:SS] INFO : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ CREATION ] [ moduleMODULE_nameNAME ] [ module-type=moduleMODULE_typeTYPE ] The module moduleMODULE_nameNAME of type moduleMODULE_typeTYPE is not available for the daemon/module daemonDAEMON_orOR_moduleMODULE_nameNAME.

• Si le module a bien été créé alors un log en INFO indiquera son temps de création:

  Code Block
  language text theme Emacs
  [YYYY-MM-DD HH:MM:SS] INFO : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ CREATION ] [ moduleMODULE_nameNAME ] [ module-type=moduleMODULE_typeTYPE ] [0.046s] The module is created.

Démarrage du module

Une fois le module créé, le "modules-manager" va essayer de le démarrer.

Ce log sera en INFO.

[YYYY-MM-DD HH:MM:SS] INFO : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ CREATION ] [ moduleMODULE_nameNAME ] [ module-type=moduleMODULE_typeTYPE ]  Trying to init module.

Si le "modules-manager" a réussi à créer son module, mais n'a pas réussi à le démarrer alors 3 logs apparaîtront :

1. Un log en ERROR avec l'exception Python rencontrée :

   Code Block
   language text theme Emacs
   [YYYY-MM-DD HH:MM:SS] ERROR : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ CREATION ] [ moduleMODULE_nameNAME ] [ module-type=moduleMODULE_typeTYPE ] The module has failed to init and he raised anraising exception: EXCEPTION.

2. Un log en WARNING indiquant le nombre de fois que le "modules-manager" à essayé de démarrer son module sans succès. Le compteur se remet à zéro dès lors que le démon a réussi à démarrer son module.

   Code Block
   language text theme Emacs
   [YYYY-MM-DD HH:MM:SS] WARNING : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ CREATION ] [ moduleMODULE_nameNAME ] [ module-type=moduleMODULE_typeTYPE ] Tried Theto modulestart tried to start:the module 5 times.

3. Un log en WARNING indiquant quand le "modules-manager" va essayer de redémarrer son module ( maximum une minute ).

   Code Block
   language text theme Emacs
   [YYYY-MM-DD HH:MM:SS] WARNING : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ CREATION ] [ moduleMODULE_nameNAME ] [ module-type=moduleMODULE_typeTYPE ] Will Theretry moduleto willstart trythe to restartmodule at 16:32:18.

Un log en INFO  apparaîtra si le "modules-manager a réussi à démarrer son module.

[YYYY-MM-DD HH:MM:SS] INFO : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ CREATION ] [ moduleMODULE_nameNAME ] [ module-type=moduleMODULE_typeTYPE ] The module is started.

Démarrage des modules avec des workers

Une fois le module créé, le "modules-manager" va essayer de le démarrer.

• S'il n'arrive pas à les démarrer, le module redémarrera dans le futur ( max 1 minute ) afin de redémarrer le module et ces Workers.
• Ce log sera en INFO.
  
  

[YYYY-MM-DD HH:MM:SS] INFO : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ CREATION ] [ moduleMODULE_nameNAME ] [ module-type=moduleMODULE_typeTYPE ]  Starting a worker basebased module.

Si le "modules-manager" n'a pas réussi à démarrer le module :

1. Et qu'il a levé une exception lors du démarrage, alors un log en ERROR sera affiché disant que le "modules-manager" n'a pas réussi à démarrer le module avec le message de l'exception. Le module redémarrera dans le futur ( max 1 minute ).

   Code Block
   language text theme Emacs
   [YYYY-MM-DD HH:MM:SS] ERROR : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ CREATION ] [ moduleMODULE_nameNAME ] [ module-type=moduleMODULE_typeTYPE ] The worker basebased module has failed to init and raised anraising exception: EXCEPTION. TheWill module will be restarted in the futureretry later.

2. Un log en ERROR sera affiché disant que le "modules-manager" n'a pas réussi à démarrer le module et ces Workers, et que le module redémarrera dans le futur ( max 1 minute ).

   Code Block
   language text theme Emacs
   [YYYY-MM-DD HH:MM:SS] ERROR : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ CREATION ] [ moduleMODULE_nameNAME ] [ module-type=moduleMODULE_typeTYPE ] The worker basebased module failed to init. TheWill module will be restarted in the futureretry later.

Si le module et ces Workers se sont bien démarrés alors ce log en  INFO apparaîtra.

[YYYY-MM-DD HH:MM:SS] INFO : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ CREATION ] [ moduleMODULE_nameNAME ] [ module-type=moduleMODULE_typeTYPE ]  The worker basebased module has started.

Création d'

un nouveau processus [ FORK_CLEANUP ] / [ HTTP_CLIENT ]

La création d'un nouveau processus ( fork ) nécessite l'arrêt des requêtes faites via le module Python  PyCurl ( utilisé par HTTP_CLIENT de Shinken ), pour éviter tout risque de blocage ( deadlock ) dans le processus créé ( sur les fonctions de résolution de nom de la libc, ou la gestion des contexte SSL de la bibliothèque OpenSSL par exemple ). 

Les logs suivants indiquent

• le temps nécessaire à l'interruption des requêtes faites via PyCurl. 
• quelles requêtes ont été interrompues pour être rejouées plus tard.
  
  

Rajout d'un nouveau module

Lorsqu'un démon ou un module reçoit un nouveau module, le "modules-manager" affiche un log en INFO expliquant qu'il va lancer le nouveau module.

[YYYY-MM-DD HH:MM:SS] INFO   : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ UPDATEFORK_CLEANUP     ] [ module_nameBEFORE ] Launched as a NEW module as it was added in the configuration.

[ PID ] [ HTTP_CLIENT ] interrupting current PyCurl transfers to allow process creation
[YYYY-MM-DD HH:MM:SS] INFO WARNING: [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGERHTTP_CLIENT ] PyCurl query [ UPDATEURL ] Modules did changed:has been interrupted and paused to allow process creation
[YYYY-MM-DD HH:MM:SS] INFO   : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGERFORK_CLEANUP     ] [ UPDATEBEFORE ] -[ WebUIPID ->] started[ (HTTP_CLIENT new )
[YYYY-MM-] PyCurl is now idle, after X.XXXs
[YYYY-MM-DD HH:MM:SS] INFO   : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGERHTTP_CLIENT ] PyCurl query [ UPDATEURL ] -has slabeen ->replayed startedsuccessfully ( newstatus:XXX )

Suppression d'un module dans un démon

Lorsqu'un module est enlevé de la configuration du démon ou de son module, le "modules-manager" affichera un log en INFO informant que l'on supprime le module.

Changement de configuration ou d'état du module - chapitre [ UPDATE ]

Rajout d'un nouveau module

Lorsqu'un démon ou un module reçoit un nouveau module, le "modules-manager" affiche un log en INFO expliquant qu'il va lancer le nouveau module.

[YYYY-MM-DD HH:MM:SS] INFO : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ UPDATE ] [ moduleMODULE_nameNAME ] Removing theLaunched as a NEW module becauseas it iswas removedadded into the configuration.

Si Quand le "module possède des Workers, le "modules-manager" va arrêter tous ses Workers. Un log en INFO sera affiché.-manager" a fini de créer le ou les module(s) ajouté(s) dans la configuration du module ou du démon, alors un récapitulatif des actions faites sera affiché en log INFO.

[YYYY-MM-DD HH:MM:SS] INFO : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ UPDATE ] Module modifications:
[ module_name ] Stopping all workers.

Le module "modules-manager" indique avec un log en INFO qu'il va essayer d’arrêter le module.

[YYYY-MM-DD HH:MM:YYYY-MM-DD HH:MM:SS] INFO : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ UPDATE ] [- module_name ] Trying to stop module.

Si l’arrêt du module a échoué en appelant la fonction quit() du module, un log en ERROR sera affiché. 

WebUI -> started ( new )
[YYYY-MM-DD HH:MM:SS] 

INFO : [ 

DAEMON_

OR_

MODULE_

NAME ] [ MODULES-MANAGER ] [ UPDATE ] 

- 

Si l’arrêt du module a échoué avec une exception Python, un log en ERROR sera affiché. 

sla -> started ( new )

Suppression d'un module dans un démon

Lorsqu'un module est enlevé de la configuration du démon ou de son module, le "modules-manager" affichera un log en INFO  informant que l'on supprime le module.

[YYYY-MM-DD HH:MM:SS] 

INFO : [ 

DAEMON_

OR_

MODULE_

NAME ] [ MODULES-MANAGER ] [ UPDATE ] [ 

MODULE_

NAME ] 

Removing module because 

it 

has 

been 

removed 

from 

configuration.

Si le

module possède des Workers, le "modules-manager" va arrêter tous ses Workers. Un log en INFO sera affiché.

[YYYY-MM-DD HH:MM:SS] INFO : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ UPDATE ] [ moduleMODULE_nameNAME ] Stopping the module was a success.all workers.

Le module Si le "modules-manager" a essayé de supprimer le module, mais qu'il n'a pas été trouvé dans sa liste de modules en cours d’exécution alors un log en WARNING sera affichéindique avec un log en INFO qu'il va essayer d’arrêter le module.

[YYYY-MM-DD HH:MM:SS] WARNINGINFO : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ UPDATE ] [ moduleMODULE_nameNAME ] Trying to remove the module WebUI but it is not found in the current running modules: LIST_CURRENT_RUNNING_MODULES

Où LIST_CURRENT_RUNNING_MODULES est la liste des modules en cours d'exécution.

stop module.

• Si l’arrêt du module a échoué en appelant la fonction quit() du module, un log en ERROR sera affiché. 

  Code Block
  language text

• theme Emacs

  [YYYY-MM-DD HH:MM:SS] ERROR : [

• DAEMON_

• OR_

• MODULE_

• NAME ] [ MODULES-MANAGER ] [ UPDATE ] [

• MODULE_

• NAME ]

• Stopping module

• failed.

• The

• quit()

• function

• has

• failed

• with error: EXCEPTION

Quand le "module-manager" a fini d’éteindre le ou les module(s) supprimé(s) dans la configuration d'un module ou d'un démon, alors un récapitulatif des actions faites sera affiché en log INFO.

• .

• Si l’arrêt du module a échoué avec une exception Python, un log en  ERROR sera affiché. 

  Code Block
  language text theme Emacs
  [YYYY-MM-DD HH:MM:SS]

• ERROR : [

• DAEMON_

• OR_

• MODULE_

• NAME ] [ MODULES-MANAGER ] [ UPDATE ] [ MODULE_NAME ] Stopping module has failed raising exception: EXCEPTION.

Lorsque que le "module-manager" a réussi à arrêter son module, il l'indique avec un log en INFO. 

Modules did changed:
[YYYY-MM-DD HH:MM:SS] INFO : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ UPDATE ] -[ Livestatus -> stopped ( removed )

Changement de configuration d'un module ( et sa relance )

Le démon ou le module a détecté que la configuration de son module en cours d'exécution a changé. Le "modules-manager" indique avec un log INFO qu'il va redémarrer le module afin de prendre en compte la nouvelle configuration.

MODULE_NAME ] Stopped module successfully.

Si le "modules-manager" a essayé de supprimer le module, mais qu'il n'a pas été trouvé dans sa liste de modules en cours d’exécution alors un log en WARNING sera affiché.

[YYYY-MM-DD HH:MM:SS] INFOWARNING : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ UPDATE ] [ moduleMODULE_nameNAME ] ConfigurationTrying to ofremove the module did change so we restart itMODULE_NAME but it was not in running modules list: LIST_CURRENT_RUNNING_MODULES

Où LIST_CURRENT_RUNNING_MODULES est la liste des modules en cours d'exécution.

Quand le "modulemodules-manager" a fini de redémarrer le ou les module(s) supprimé(s) dans la configuration du module ou du démon, alors un récapitulatif des actions faites sera affiché en log INFO.éteint les modules, si un module ne réussit pas à s'éteindre alors un log en ERROR sera affiché, suivi de la traceback de l'exception.

[YYYY-MM-DD HH:MM:SS] INFOERROR : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ UPDATE ] Modules[ did changed:
[YYYY-MM-DD HH:MM:SS] INFO : [ daemon_or_module_name ] [ MODULES-MANAGER ] [ UPDATE ] - Livestatus -> restarted ( configuration change )

Le module n'a pas réussi à se mettre à jour

Le démon ou le module n'arrive pas à mettre à jour son module. Le "modules-manager" informe qu'il faut contacter le support avec un log en ERROR.

MODULE_NAME ] The module MODULE_NAME has failed to stop raising exception: EXCEPTION

Quand le "module-manager" a fini d’éteindre le ou les module(s) supprimé(s) dans la configuration d'un module ou d'un démon, alors un récapitulatif des actions faites sera affiché en log INFO.

[YYYY-MM-DD HH:MM:SS] ERRORINFO : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ UPDATE ] Module modifications:
[ module_name ] We cannot update 'module_name' module. Please contact your Support.

Arrêt du module - chapitre [ SHUTDOWN ]

Lorsqu'un démon s'éteint, il va d'abord demander au "modules-manager" d'éteindre ses modules.

Le démon éteint ses modules

Ce log en INFO indique que le "modules-manager" va commencer à éteindre tous ses modules.

YYYY-MM-DD HH:MM:SS] INFO : [ DAEMON_OR_MODULE_NAME ] [ MODULES-MANAGER ] [ UPDATE ] - Livestatus -> stopped ( removed )

Changement de configuration d'un module ( et sa relance )

Le démon ou le module a détecté que la configuration de son module en cours d'exécution a changé. Le "modules-manager" indique avec un log  INFO qu'il va redémarrer le module afin de prendre en compte la nouvelle configuration.

[YYYY-MM-DD HH:MM:SS] INFO : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ SHUTDOWNUPDATE ] [ MODULE_NAME ] Start to shutdown all modules.

Le module s'éteint

Ce log en INFO indique que le "modules-manager est en train d’arrêter le module.

Restarting module because its configuration has changed.

Quand le "module-manager" a fini de redémarrer le ou les module(s) supprimé(s) dans la configuration du module ou du démon, alors un récapitulatif des actions faites sera affiché en log INFO.

[YYYY-MM-DD HH:MM:SS] INFO : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ SHUTDOWN ] Stopping module module_name.

Si une exception Python a été remontée par le "modules-manager" lors de l’arrêt du module, un log apparaîtra en ERROR avec le nom du module et le message de l’exception Python.

[YYYY-MM-DD HH:MM:SS] ERROR : [ daemon_or_module_name UPDATE ] Module modifications:
[YYYY-MM-DD HH:MM:SS] INFO : [ DAEMON_OR_MODULE_NAME ] [ MODULES-MANAGER ] [ SHUTDOWNUPDATE ] Stopping- moduleLivestatus FAILED.-> Callrestarted quit() functionconfiguration on module: [ module_name ] fail with error: [ EXCEPTION ].change )

Le module n'a pas réussi à se mettre à jour

Le démon ou le module n'arrive pas à mettre à jour son module. Le Si le "modules-manager" a essayé de supprimer un module, mais informe qu'il ne l'a pas trouvé dans sa liste de modules en cours d’exécution alors un log en ERROR sera affichéfaut contacter le support avec un log en ERROR.

[YYYY-MM-DD HH:MM:SS] ERROR : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ SHUTDOWNUPDATE ] Trying[ toMODULE_NAME remove] theCannot module WebUI but it is not found in the current running modules: LIST_CURRENT_RUNNING_MODULES

Le démon a fini d'éteindre ses modules

Le "modules-manager" informe avec un log INFO qu'il a terminé d’arrêter tous les modules.

update 'MODULE_NAME' module. Please contact your Support.

Arrêt du module - chapitre [ SHUTDOWN ]

Lorsqu'un démon s'éteint, il va d'abord demander au "modules-manager" d'éteindre ses modules.

Le démon éteint ses modules

Ce log en INFO indique que le "modules-manager" va commencer à éteindre tous ses modules.

[YYYY-MM-DD HH:MM:SS] INFO : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ SHUTDOWN ] Start Stoppingto shutdown all modules ended.

Arrêt inopiné du module - chapitre [ CRASH ]

Le module s'

éteint

Ce log en INFO indique que le "modules-manager est en train d’arrêter le module.

[YYYY-MM-DD HH:MM:SS] ERRORINFO : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ CRASHSHUTDOWN ] [Stopping module_name ] [ module-type=module_type ] The module module_name goes down unexpectedly! MODULE_NAME.

Si une exception Python a été remontée par Lorsqu'un ou plusieurs Worker(s) d'un module ne sont plus en cours d’exécution et qu'ils se sont éteint(s) de manière inattendue, le "modules-manager" affichera lors de l’arrêt du module, un log en ERRORapparaîtra en ERROR avec le nom du module et le message de l’exception Python.

[YYYY-MM-DD HH:MM:SS] ERROR : [ daemonDAEMON_orOR_moduleMODULE_nameNAME ] [ MODULES-MANAGER ] [ CRASHSHUTDOWN ] [Stopping module_name ]failed. [ module-type=module_type ] The module module_name worker(s) goes down unexpectedly!

Le module a un comportement anormal

Lorsqu'un module externe a une taille de liste d'attente ( de commande interne ou de retour de commande interne ) plus élevée 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(s) 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 ).

The quit() function has failed with error: EXCEPTION.

Si le "modules-manager" a essayé de supprimer un module, mais qu'il ne l'a pas trouvé dans sa liste de modules en cours d’exécution alors un log en WARNING sera affiché.

[YYYY-MM-DD HH:MM:SS] WARNING : [ DAEMON_OR_MODULE_NAME

[YYYY-MM-DD HH:MM:SS] ERROR : [ daemon_or_module_name ] [ MODULES-MANAGER ] [ CRASHSHUTDOWN ] Trying [to module_name ] [ module-type=module_type ] The external module module_name got a too high brok queue size ( QUEUE_SIZE > QUEUE_MAX_SIZE )!

Décalage d'heure entre le démon et le système détecté

remove the module MODULE_NAME but it was not in running modules list: LIST_CURRENT_RUNNING_MODULES

Le démon a fini d'éteindre ses modules

Le "modules-manager" informe avec un log INFO qu'il a terminé d’arrêter tous les modules.

[YYYY-MM-DD HH:MM:SS] INFO : [ DAEMON_OR_MODULE_NAME ] [ MODULES-MANAGER ] [ SHUTDOWN ] Stopping all modules ended.

Arrêt inopiné du module - chapitre [ CRASH ]

Le module s'est arrêté de façon inattendu

Lorsqu'un module n'est plus en cours d’exécution et qu'il s'est éteint de façon inattendue, le "modules-manager" affichera un log en ERROR.

[YYYY-MM-DD HH:MM:SS] ERROR : [ DAEMON_OR_MODULE_NAME ] [ MODULES-MANAGER ] [ CRASH ] [ MODULE_NAME ] [ module-type=MODULE_TYPE ] The module MODULE_NAME has gone down unexpectedly!

Lorsqu'un ou plusieurs Worker(s) d'un module ne sont plus en cours d’exécution et qu'ils se sont éteint(s) de manière inattendue, le "modules-manager" affichera un log en ERROR.

[YYYY-MM-DD HH:MM:SS] ERROR : [ DAEMON_OR_MODULE_NAME ] [ MODULES-MANAGER ] [ CRASH ] [ MODULE_NAME ] [ module-type=MODULE_TYPE ] The module MODULE_NAME worker(s) has gone down unexpectedly!

Le module a un comportement anormal

Lorsqu'un module externe a une taille de liste d'attente ( de commande interne ou de retour de commande interne ) plus élevée 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(s) 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 ).

Les démons effectuent régulièrement des vérifications sur le système sur lequel il est lancé tant qu'il est en vie ( environ toutes les deux secondes ).

Une de ces vérifications est le changement d'heure du serveur. Si un démon est décalé par rapport à la date que garde le démon en mémoire, alors celui-ci nous informe qu'il détecte un changement d'heure de la machine, et va se mettre à jour automatiquement à la nouvelle heure connue :

[YYYY-MM-DD HH:MM:SS] WARNING: [ DAEMONERROR : [ DAEMON_OR_MODULE_NAME ] [ MODULES-MANAGER ] [ CRASH ] [ MODULE_NAME ] [ module-type=MODULE_TYPE ] SystemThe timeexternal change detected. The last daemon time was [ YYYY-MM-DD HH:YY:YY ], but the system time is [ YYYY-MM-DD HH:XX:XX ] which makes a difference of X seconds. Compensating...module MODULE_NAME queue size is too high ( QUEUE_SIZE > QUEUE_MAX_SIZE )!