MODULE-CODE-LOADING - Import du code des modules depuis /var/lib/shinken/modules
Les démons vont lister les répertoires dans /var/lib/shinken/modules et vont tenter de charger chaque module.
Log INFO:
Une fois les modules chargé il y a un résumé qui est affiché avec les modules éligibles à ce démon/module:
| Code Block | ||
|---|---|---|
| ||
[2020-07-08 16:31:38] INFO : [broker-master ] [ modules-manager ] [MODULE-CODE-LOADING] A total of 9 Shinken Enterprise modules are available for this daemon/module (broker): broker-module-livedata, event-container, graphite-perfdata, livestatus, simple-log, sla, trending, webui, MODULE-CODE-NAME (on a total of 40, loaded in 1.844s) |
Log WARNING:
Ce log indique qu'il n'est pas possible d'importer des fichiers dans module.py.
| Code Block | ||
|---|---|---|
| ||
[2020-07-08 16:31:38] WARNING : [ broker-master ] [ modules-manager ] [MODULE-CODE-LOADING] [directory=architecture-export] - 'import architecture-export.my_file' will not work in your module.py file. |
Log ERROR:
Il y a un problème de code dans le module.py.
| Code Block | ||
|---|---|---|
| ||
[2020-07-08 16:31:38] ERROR : [broker-master ] [ modules-manager ] [MODULE-CODE-LOADING] [directory=architecture-export] Failed to load the directory [architecture-export] as a python module. |
Il n'y a pas de fichier module.py.
| Code Block | ||
|---|---|---|
| ||
[2020-07-08 16:31:38] ERROR : [broker-master ] [ modules-manager ] [MODULE-CODE-LOADING] [directory=architecture-export] - because of missing file :[PATH_DU_FICHIER]. |
Il manque un dictionnaire Python dans module.py listant les propriétés du module.
| Code Block | ||
|---|---|---|
| ||
[2020-07-08 16:31:38] ERROR : [broker-master ] [ modules-manager ] [MODULE-CODE-LOADING] [directory=architecture-export] Bad module file for FILE_NAME : missing properties dict. |
L'import du module.py n'a pas fonctionné une exception Python a été trouvée.
| Code Block | ||
|---|---|---|
| ||
[2020-07-08 16:31:38] ERROR : [broker-master ] [ modules-manager ] [MODULE-CODE-LOADING] [directory=architecture-export] Importing module architecture-export: EXCEPTION. |
Log DEBUG:
Le log annonce qu'il commence à charger le code du module.
| Code Block | ||
|---|---|---|
| ||
[2020-07-08 16:31:36] DEBUG : [broker-master ] [ modules-manager ] [MODULE-CODE-LOADING] [directory=architecture-export ] Starting to load the module code directory /var/lib/shinken/modules/architecture-export. |
Le log donne le temps de chargement, mais également les nouvelles librairies importées.
| Code Block | ||
|---|---|---|
| ||
[2020-07-08 16:31:36] DEBUG : [broker-master ] [ modules-manager ] [MODULE-CODE-LOADING] [directory=architecture-export ] [0.021s] Module code was loaded. Did import 10 python new librairies (PIL,PIL.Image,PIL.ImageMode,PIL._binary,_imaging,architecture-export,architecture-export.mapper,shinken.webui.bottlewebui,shinken.webui.bottlewebui.ext,shinken.webui.cherrypybackend). |
MODULE-INSTANCE-CREATION - Création des instances de modules
Une fois le code python chargé, on demande au démon de créer des instances pour les modules ( les vrais objets ) et de les démarrer.
Log INFO:
L'instance du module a été créée. Le temps de création de l'instance est affiché.
| Code Block | ||
|---|---|---|
| ||
[2020-07-08 16:31:38] INFO : [broker-master ] [ modules-manager ] [MODULE-INSTANCE-CREATION] [module type=webui ] [name=WebUI ] [0.046s] SUCCESS The module instance is created. |
L'instance va essayé de se démarrer.
| Code Block | ||
|---|---|---|
| ||
[2020-07-08 16:31:38] INFO : [broker-master ] [ modules-manager ] [MODULE-INSTANCE-CREATION] [module type=webui ] [name=WebUI ] Trying to init module. |
L'instance a réussi à se démarrer.
| Code Block | ||
|---|---|---|
| ||
[2020-07-08 16:31:38] INFO : [broker-master ] [ modules-manager ] [MODULE-INSTANCE-CREATION] [module type=webui ] [name=WebUI ] SUCCESS The module is started. |
L'instance démarre son ou ses Worker(s).
| Code Block | ||
|---|---|---|
| ||
[2020-07-08 16:31:38] INFO : [broker-master ] [ modules-manager ] [MODULE-INSTANCE-CREATION] [module type=webui ] [name=WebUI ] Starting a worker(s). |
L'instance a réussi à démarrer son ou ses Worker(s).
| Code Block | ||
|---|---|---|
| ||
[2020-07-08 16:31:38] INFO : [broker-master ] [ modules-manager ] [MODULE-INSTANCE-CREATION] [module type=webui ] [name=WebUI ] SUCCESS The worker(s) is created. |
Log WARNING:
Indication du nombre de fois ou le module à essayer de se démarrer sans succès. Le conteur est remis à zéro une fois le module démarrer.
| Code Block | ||
|---|---|---|
| ||
[2020-07-08 16:31:38] WARNING : [broker-master ] [ modules-manager ] [MODULE-INSTANCE-CREATION] [module type=webui ] [name=WebUI ] The module tried to start: 5 times. |
Indication de la date prévu du redémarrage du module.
| Code Block | ||
|---|---|---|
| ||
[2020-07-08 16:31:38] WARNING : [broker-master ] [ modules-manager ] [MODULE-INSTANCE-CREATION] [module type=webui ] [name=WebUI ] The module will try to restart at 16:32:18. |
Log ERROR:
Le module n'a pas réussi à se démarrer . Une exception Python à été trouvé pendant le démarrage du module.
| Code Block | ||
|---|---|---|
| ||
[2020-07-08 16:31:38] ERROR : [broker-master ] [ modules-manager ] [MODULE-INSTANCE-CREATION] [module type=webui ] [name=WebUI ] The module failed to init and he raised an exception: EXCEPTION. |
Le module n'a pas réussi à démarrer son ou ses Worker(s).
| Code Block | ||
|---|---|---|
| ||
[2020-07-08 16:31:38] ERROR : [broker-master ] [ modules-manager ] [MODULE-INSTANCE-CREATION] [module type=webui ] [name=WebUI ] The worker(s) failed to init. |
Le module n'a pas réussi à démarrer son ou ses Worker(s) et une exception Python à été trouvé pendant le démarrage du ou des Worker(s).
| Code Block | ||
|---|---|---|
| ||
[2020-07-08 16:31:38] ERROR : [broker-master ] [ modules-manager ] [MODULE-INSTANCE-CREATION] [module type=webui ] [name=WebUI ] The worker(s) failed to init and he raised an exception: EXCEPTION. |
La création de l'instance du module à échoué. Une exception Python à été trouvé pendant la création de l'instance. Le module sera re-créée dans le futur (Max: 1 minute).
| Code Block | ||
|---|---|---|
| ||
[2020-07-08 16:31:38] ERROR : [broker-master ] [ modules-manager ] [MODULE-INSTANCE-CREATION] [module type=webui ] [name=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. |
La création de l'instance du module à échoué. La fonction get_instance() du module n'a rien retourné.
| Code Block | ||
|---|---|---|
| ||
[2020-07-08 16:31:38] ERROR : [broker-master ] [ modules-manager ] [MODULE-INSTANCE-CREATION] [module type=webui ] [name=WebUI ] FAIL The module get_instance() call did not return any instance. |
Log DEBUG:
| Code Block | ||
|---|---|---|
| ||
[2020-07-08 16:31:38] DEBUG : [broker-master ] [ modules-manager ] [MODULE-INSTANCE-CREATION] [module type=webui ] [name=WebUI ] Start to create the module instance |
| Code Block | ||
|---|---|---|
| ||
[2020-07-08 16:31:38] DEBUG : [broker-master ] [ modules-manager ] [MODULE-INSTANCE-CREATION] [module type=webui ] [name=WebUI ] [0.046s] The module is not ready to start. |
| Code Block | ||
|---|---|---|
| ||
[2020-07-08 16:31:38] DEBUG : [broker-master ] [ modules-manager ] [MODULE-INSTANCE-CREATION] [module type=webui ] [name=WebUI ] Creation module instance was skipped. |
Initialisation des instances de modules
Log INFO:
Une fois les instances créées, on leur demande de se préparer ( ouvrir leurs connexions, lancer les processus pour les modules externes ou avec des workers, etc ).
Ceci sera de l'ordre de la seconde pour le cas des modules avec workers ( il faut créer les queues de connexions, lancer les processus et le manager de queue, etc ).
Quand l'initialisation est finie, un log INFO est affiché.
| Code Block | ||
|---|---|---|
| ||
[2020-07-08 16:31:39] INFO : [broker-master ] [ modules-manager ] [ MODULE-CHANGE ] [name=WebUI] Configuration of the module did change so we restart it. |
| Code Block | ||
|---|---|---|
| ||
[2020-07-08 16:31:39] INFO : [broker-master ] [ modules-manager ] [MODULE-CHANGE ] [name=WebUI] Removing the module because it is remove from the configuration. |
| Code Block | ||
|---|---|---|
| ||
[2020-07-08 16:31:39] INFO : [broker-master ] [ modules-manager ] [ MODULE-CHANGE ] [name=WebUI] Launching a new module as it was added in the daemon configuration. |
Log WARNING:
| Code Block | ||
|---|---|---|
| ||
[2020-07-08 16:31:39] WARNING : [broker-master ] [ modules-manager ] [ MODULE-CHANGE ] [name=WebUI] Trying to remove the module %s but it is not found in the current instances: INSTANCES |
Log ERROR:
| Code Block | ||
|---|---|---|
| ||
[2020-07-08 16:31:39] ERROR : [broker-master ] [ modules-manager ] [ MODULE-CHANGE ] [name=WebUI] Cannot find previous or new module definition for the module name WebUI, so cannot update it. |
Log DEBUG:
| Code Block | ||
|---|---|---|
| ||
[2020-07-08 16:31:39] DEBUG : [ broker-master ] [ modules-manager ] [MODULE-INSTANCE-CREATION] [name=WebUI] The module did change its configuration. We restart it to take the new configuration. |
| Code Block | ||
|---|---|---|
| ||
[2020-07-08 16:31:39] DEBUG : [ broker-master ] [ modules-manager ] [MODULE-INSTANCE-CREATION] [module type=webui ] [name=WebUI] Ask stop process. |
| Code Block | ||
|---|---|---|
| ||
[2020-07-08 16:31:39] DEBUG : [ broker-master ] [ modules-manager ] [MODULE-INSTANCE-CREATION] [module type=webui ] [name=WebUI] Stop process done. |
Rajout d'un nouveau module dans un démon
Suppression d'un module dans un démon
Quand un module est enlevé de la configuration d'un démon, celui-ci l'affichera avec une entrée MODULES-CHANGE en INFO comme quoi le module est stopped:
Changement de configuration d'un module (et sa relance)
Quand la configuration d'un module change (ou la configuration d'un de ses sous-modules) alors le module est redémarré (et ses processus redémarrés si besoin). Ceci est loggué avec une entrée MODULES-CHANGE en INFO comme quoi le module est restarted: