View Source

Concept

L'API "item-api" expose des opérations de suppression d'éléments dans les différents espaces de donnée ( voir la page Supprimer des éléments ).

Cette page documente les entrées de log générées par le Synchronizer lors des appels de l'API.

Suppression des éléments en production

Lors d'une suppression d'éléments en production, 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 ] [ DELETE_IN_PRODUCTION ][ ACTION_ID ] User [ USER_NAME ] ( id:  user-id ) REQUESTING:  [ API DELETING hosts from 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 ) ou si l'Arbiter n'est pas joignable.

Si un tâche est en cours :

[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ DELETE_IN_PRODUCTION ] [ ASKED_ACTION_ID ] REQUEST [ API DELETING hosts from 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 ]

Si l'Arbiter n'est pas joignable :

[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ DELETE_IN_PRODUCTION ] [ ACTION_ID ] REQUEST [ API DELETING hosts from production and RELOADING Arbiter ] rejected because: no reachable Arbiter found

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 ] [ DELETE_IN_PRODUCTION  ] [ ACTION_ID ] REQUEST [ API DELETING hosts from production and RELOADING Arbiter ] accepted and started successfully

Exécution de l'action

Lorsque l'action de suppression commence, le log suivant est généré :

[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ DELETE_IN_PRODUCTION ] [ ACTION_ID ] Starting [ API DELETING hosts from production and RELOADING Arbiter ]

Étape 1/4 - Préparation des données de l'API

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

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

Si l'étape a réussi :

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

Si l'étape a échoué :

car il n'y a aucun élément à supprimer

[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ DELETE_IN_PRODUCTION ] [ ACTION_ID ] [ STEP 1/4 ] [ PREPARING DATA ] No items to delete. Following message will appear on the interface: "Le ou les éléments que l'api a tenté de supprimer sont introuvables. Aucune action réalisée."
[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ DELETE_IN_PRODUCTION ] [ ACTION_ID ] Stopping [ API DELETING hosts from production and RELOADING Arbiter ] because step 1 failed

pour une autre erreur

[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ DELETE_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 ] [ DELETE_IN_PRODUCTION ] [ ACTION_ID ] Stopping [ API DELETING hosts from 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 ] [ DELETE_IN_PRODUCTION ] [ ACTION_ID ] [ STEP 2/4 ] [ CHECKING CONFIGURATION ] ----------------------------------------------------------------
[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ DELETE_IN_PRODUCTION ] [ ACTION_ID ] [ STEP 2/4 ] [ CHECKING CONFIGURATION ] 
[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ DELETE_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 ] [ DELETE_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 ] [ DELETE_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.

Si l'étape a réussi :

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

Si l'étape a échoué :

[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ DELETE_IN_PRODUCTION ] [ ACTION_ID ] [ STEP 2/4 ] [ CHECKING CONFIGURATION ] Configuration rejected as invalid by Arbiter
[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ DELETE_IN_PRODUCTION ] [ ACTION_ID ] Stopping [ API DELETING hosts from 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 ] [ DELETE_IN_PRODUCTION ] [ ACTION_ID ] [ STEP 3/4 ] [ COMMITING DATA ] ----------------------------------------------------------------
[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ DELETE_IN_PRODUCTION ] [ ACTION_ID ] [ STEP 3/4 ] [ COMMITING DATA ]   
[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ DELETE_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.

Si l'étape a réussi :

[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [  DELETE_IN_PRODUCTION ] [ ACTION_ID ] [ STEP 3/4 ] [ COMMITING DATA ] Successfully applied api deletions to production

Si l'étape a échoué :

[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ DELETE_IN_PRODUCTION ] [ ACTION_ID ] [ STEP 3/4 ] [ CHECKING CONFIGURATION ] Failed to apply api deletions to production with error: __ERROR_MESSAGE__
[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ DELETE_IN_PRODUCTION ] [ ACTION_ID ] Stopping [ API DELETING hosts from production and RELOADING Arbiter ] because step 3 failed

Étape 4/4 - Redémarrage de l'arbiter

[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ DELETE_IN_PRODUCTION ] [ ACTION_ID ] [ STEP 4/4 ] [ RELOADING ARBITER ] ----------------------------------------------------------------
[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ DELETE_IN_PRODUCTION ] [ ACTION_ID ] [ STEP 4/4 ] [ RELOADING ARBITER ] 
[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ DELETE_IN_PRODUCTION ] [ ACTION_ID ] [ STEP 4/4 ] [ RELOADING ARBITER ] Starting [ Arbiter LOADING configuration ]
[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ DELETE_IN_PRODUCTION ] [ ACTION_ID ] [ STEP 4/4 ] [ RELOADING ARBITER ] Restarting Arbiter
[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ DELETE_IN_PRODUCTION ] [ ACTION_ID ] [ STEP 4/4 ] [ RELOADING ARBITER ] Arbiter launched ( currently loading )

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

Si l'étape a réussi :

[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ DELETE_IN_PRODUCTION ] [ ACTION_ID ] [ STEP 4/4 ] [ RELOADING ARBITER ] Arbiter loading FINISHED

Si l'étape a échoué :

[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ DELETE_IN_PRODUCTION ] [ ACTION_ID ] [ STEP 4/4 ] [ RELOADING ARBITER ] Failed to applied new configuration with error 
[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ DELETE_IN_PRODUCTION ] [ ACTION_ID ] Stopping [ API DELETING hosts from production and RELOADING Arbiter ] because step 4 failed

A la fin, un log validant le succès de l'action est générée :

[YYYY-MM-DD HH:MM:SS] INFO   : [ SYNCHRONIZER_NAME ] [ DELETE_IN_PRODUCTION ] [ ACTION_ID ] Action [ API DELETING hosts from production and RELOADING Arbiter ] completed successfully