View Source

Concept

Cette page documente les entrées de log générées par le Synchronizer lors de l'import des éléments d'une source.

Import des éléments en production

Une source peut être configurée pour déployer automatiquement les changements vers la base production via le paramètre put_in. Ce paramètre permet de choisir entre une prise en compte immédiate par l'Arbiter ( production_and_reload_arbiter ) ou différée jusqu'à son prochain redémarrage ( production ).

Les trois premières étapes du processus sont identiques pour les deux modes de déploiement. Toutefois, la prise en compte immédiate par l'Arbiter nécessite une étape supplémentaire.

La documentation ci-dessous détaille les logs correspondant à une mise à jour immédiate. Si la configuration de la source ne l'impose pas ( production ), l'étape 4 doit être ignorée.

Lors de l'import d'une source, un ID unique est généré. Il est utilisé comme chapitre des logs et affiché sur l'Interface. En cas de problème, l'ID permet d'isoler les logs communs cette action.

Demande d'action

[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ PUT_IN_PRODUCTION ][ ACTION_ID ] User [ USER_NAME ] ( id:  user-id ) REQUESTING:  [ ASKED_ACTION ]

ASKED_ACTION peut prendre les valeurs :

Source PUTTING elements in production and RELOADING Arbiter
Source PUTTING elements in production

Dans le reste du chapitre, la valeur ASKED_ACTION est remplacée systématiquement par "Source PUTTING elements in production and RELOADING Arbiter".

Une fois l'action soumise, elle est soit acceptée, soit rejetée. Dans les deux cas, un log est généré.

Rejet de l'action

Une demande peut être refusée si une autre tâche est en cours ( précédente vérification de la configuration, application de la configuration depuis l'interface ).

Si une tâche est en cours :

[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ PUT_IN_PRODUCTION ] [ ASKED_ACTION_ID ] REQUEST [ Source PUTTING elements in production and RELOADING Arbiter ] rejected because: [  RUNNING_ACTION_DESCRIPTION  ] in progress, requested by [ USER_NAME ] at [ RUNNING_ACTION_ASKED_TIME ] with id [ RUNNING_ACTION_ID ]

Validation de l'action

Si la demande est acceptée, le log suivant est généré :

[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ PUT_IN_PRODUCTION ] [ ACTION_ID ] REQUEST [ Source PUTTING elements in production and RELOADING Arbiter ] accepted and started successfully

Exécution de l'action

Lorsque l'action d'import des données commence, le log suivant est généré :

[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ PUT_IN_PRODUCTION ] [ ACTION_ID ] Starting [ Source PUTTING elements in production and RELOADING Arbiter ]

Étape 1/4 - Préparation des données de la source

[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ PUT_IN_PRODUCTION ] [  ACTION_ID ] [ STEP 1/4 ] [ PREPARING DATA ] ----------------------------------------------------------------
[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ PUT_IN_PRODUCTION ] [  ACTION_ID ] [ STEP 1/4 ] [ PREPARING DATA ] 
[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ PUT_IN_PRODUCTION ] [  ACTION_ID ] [ STEP 1/4 ] [ PREPARING DATA ] Starting [ PREPARING data FROM source for production ]

Un log s'affiche en fonction du résultat de l'étape

Étape réussie :

[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ PUT_IN_PRODUCTION ] [  ACTION_ID ] [ STEP 1/4 ] [ PREPARING DATA ] Data preparation completed

Étape échouée :

[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ PUT_IN_PRODUCTION ] [  ACTION_ID ] [ STEP 1/4 ] [ PREPARING DATA ] Data preparation failed with error: __ERROR_MESSAGE__
[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ PUT_IN_PRODUCTION ] [  ACTION_ID ] Stopping [ Source PUTTING elements in production and RELOADING Arbiter ] because step 1 failed

Étape 2/4 - Vérification de la configuration

[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ PUT_IN_PRODUCTION ] [  ACTION_ID ] [ STEP 2/4 ] [ CHECKING CONFIGURATION ] ----------------------------------------------------------------
[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ PUT_IN_PRODUCTION ] [  ACTION_ID ] [ STEP 2/4 ] [ CHECKING CONFIGURATION ] 
[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ PUT_IN_PRODUCTION ] [  ACTION_ID ] [ STEP 2/4 ] [ CHECKING CONFIGURATION ] Starting [ Validation of ELEMENT changes for production ]
[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ PUT_IN_PRODUCTION ] [  ACTION_ID ] [ STEP 2/4 ] [ CHECKING CONFIGURATION ] Requesting Arbiter for : [ Validation of ELEMENT changes for production] 
[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ PUT_IN_PRODUCTION ] [  ACTION_ID ] [ STEP 2/4 ] [ CHECKING CONFIGURATION ]    - command launched :  /usr/bin/env python3-shinken -u /usr/sbin/shinken-arbiter -v -c /etc/shinken/shinken.cfg

Un log s'affiche en fonction du résultat de l'étape

Étape réussie :

[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ PUT_IN_PRODUCTION ] [  ACTION_ID ] [ STEP 2/4 ] [ CHECKING CONFIGURATION ] Configuration successfully validated by Arbiter

Étape échouée :

[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ PUT_IN_PRODUCTION ] [  ACTION_ID ] [ STEP 2/4 ] [ CHECKING CONFIGURATION ] Configuration rejected as invalid by Arbiter
[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ PUT_IN_PRODUCTION ] [  ACTION_ID ] Stopping [ Source PUTTING elements in production and RELOADING Arbiter ] because step 2 failed

Étape 3/4 - Application de la configuration sur la base de production

[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ PUT_IN_PRODUCTION ] [  ACTION_ID ] [ STEP 3/4 ] [ COMMITING DATA ] ----------------------------------------------------------------
[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ PUT_IN_PRODUCTION ] [  ACTION_ID ] [ STEP 3/4 ] [ COMMITING DATA ]
[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ PUT_IN_PRODUCTION ] [  ACTION_ID ] [ STEP 3/4 ] [ COMMITING DATA ] Starting [ APPLYING data from preprod to production ]

Un log s'affiche en fonction du résultat de l'étape

Étape réussie :

[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ PUT_IN_PRODUCTION ] [  ACTION_ID ] [ STEP 3/4 ] [ COMMITING DATA ] Successfully applied source changes to production

Étape échouée :

[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ PUT_IN_PRODUCTION ] [  ACTION_ID ] [ STEP 3/4 ] [ COMMITING DATA ] Failed to apply preprod databases to production with error
[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ PUT_IN_PRODUCTION ] [  ACTION_ID ] Stopping [ Source PUTTING elements in production and RELOADING Arbiter ] because step 3 failed

Étape 4/4 - Redémarrage de l'arbiter ( uniquement dans le cas production_and_reload_arbiter )

[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ PUT_IN_PRODUCTION ] [  ACTION_ID ] [ STEP 4/4 ] [ RELOADING ARBITER ] ----------------------------------------------------------------
[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ PUT_IN_PRODUCTION ] [  ACTION_ID ] [ STEP 4/4 ] [ RELOADING ARBITER ] 
[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ PUT_IN_PRODUCTION ] [  ACTION_ID ] [ STEP 4/4 ] [ RELOADING ARBITER ] Starting [ Arbiter LOADING configuration ]
[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ PUT_IN_PRODUCTION ] [  ACTION_ID ] [ STEP 4/4 ] [ RELOADING ARBITER ] Restarting Arbiter

Un log s'affiche en fonction du résultat de l'étape.

Étape réussie :

[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [  PUT_IN_PRODUCTION ] [  ACTION_ID ] [ STEP 4/4 ] [ RELOADING ARBITER ] Arbiter launched ( currently loading )
[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [  PUT_IN_PRODUCTION ] [  ACTION_ID ] [ STEP 4/4 ] [ RELOADING ARBITER ] Arbiter loading FINISHED

Etape échouée :

[YYYY-MM-DD HH:MM:SS] ERROR  : [ SYNCHRONIZER_NAME ] [  PUT_IN_PRODUCTION ] [  ACTION_ID ] [ STEP 4/4 ] [ RELOADING ARBITER ] Failed to applied new configuration with error :  __ERROR_MESSAGE__
[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ PUT_IN_PRODUCTION ] [  ACTION_ID ] Stopping [ Source PUTTING elements in production and RELOADING Arbiter ] because step 4 failed