Sommaire

À partir de la version 02.04.00 de Shinken, l'Arbiter sauvegarde, dans un fichier de rétention par royaume, les dates de première mise en supervision des éléments.

Pour les éléments créés avant, cette donnée est disponible dans le cache interne des modules SLA

Lors du premier démarrage après la mise en jour, l'Arbiter contacte les modules SLA attachés aux Brokers ( sla_writer ) pour récupérer la date de première mise en supervision des éléments.

L'Arbiter dispose alors de cette information pour tous les éléments de la configuration, permettant ainsi au module SLA de ne plus avoir à maintenir son cache interne.

Construction de la liste des modules SLA à contacter par royaumes

Au démarrage de l'Arbiter, ce dernier établit la liste des modules SLA qui doivent être contactés, pour mettre à jour les données de configuration des éléments d'un royaume. Le log suivant permet de suivre quels royaumes doivent être mis à jour, à partir des données de quels modules SLA

[YYYY-MM-DD HH:MM:SS] INFO: [ ARBITER_NAME] [ MONITORING START TIME COMPONENT ] Will query configuration update of elements of realm 〖 REALM_NAME 〗 from Module 〖 SLA_NAME 〗 of Broker 〖 BROKER_NAME 〗
Exemple
[2022-06-22 11:20:48] INFO   : [ arbiter-master  ] [ MONITORING START TIME COMPONENT ]  Will query configuration update of elements of realm 〖 All 〗 from Module 〖 sla 〗 of Broker 〖 broker-master 〗

Échanges entre l'Arbiter et un Broker

Les logs suivants permettent de voir passer les échanges entre l'Arbiter et un Broker

Côté Arbiter

[YYYY-MM-DD HH:MM:SS] INFO: [ ARBITER_NAME] [ MANAGE INTER DAEMON MESSAGE ] Send 〖X〗 messages to 〖BROKER_NAME〗 in 〖XX.XXms〗
[YYYY-MM-DD HH:MM:SS] INFO: [ ARBITER_NAME ] [ MANAGE INTER DAEMON MESSAGE ] Got 〖X〗 new messages from 〖BROKER_NAME〗 in 〖XX.XXms〗
[YYYY-MM-DD HH:MM:SS] INFO: [ ARBITER_NAME ] [ MANAGE INTER DAEMON MESSAGE ] Message from satellites:〖X〗 processed:〖X〗 remaining:〖X〗
Exemple
[2022-06-22 11:20:47] INFO   : [ arbiter-master  ] [ MANAGE INTER DAEMON MESSAGE ] Send 〖1〗 messages to 〖broker-master〗 in 〖69.38ms〗
Exemple
[2022-06-22 11:20:48] INFO   : [ arbiter-master  ] [ MANAGE INTER DAEMON MESSAGE ] Got 〖1〗 new messages from 〖broker-master〗 in 〖1.48ms〗
Exemple
[2022-06-22 11:20:48] INFO   : [ arbiter-master  ] [ MANAGE INTER DAEMON MESSAGE ] Message from satellites:〖1〗 processed:〖1〗 remaining:〖0〗

Côté Broker (module SLA)

[YYYY-MM-DD HH:MM:SS] INFO: [ BROKER_NAME] [ SLA_NAME ] [ MANAGE INTER DAEMON MESSAGE ] Arbiter asks for our sla monitoring start time. Answer message built in 〖XX.XXms〗 for 〖XXX〗 items.
Exemple
[2022-06-22 11:20:48] INFO   : [ broker-master   ] [ sla              ] [ MANAGE INTER DAEMON MESSAGE ]  Arbiter asks for our sla monitoring start time. Answer message built in 〖3.47ms〗 for 〖29〗 items.

Sauvegarde de rétention des dates de mise en supervision des éléments

Depuis la version 02.06.00 de Shinken, l'Arbiter gère un fichier par royaume pour enregistrer les dates de première mise en supervision des éléments.

Si des données de mise à jour ont pu être reçues de modules SLA, le fichier de sauvegarde de la rétention d'un royaume aura un nom suivant ce motif

  • /var/lib/shinken/arbiter-retention-HASH.json

Sinon, le nom des fichiers suivra ce motif

  • /var/lib/shinken/arbiter-retention-NOM_ROYAUME.json

Entre les version 02.04.00 et 02.06.00 il n'y avait qu'un seul fichier global nommé 

  • /var/lib/shinken/arbiter-retention.json

il sera utilisé si aucun autre fichier de rétention n'est disponible pour un royaume donné

Chargement d'une sauvegarde de rétention sans mise à jour provenant des modules SLA

Si un fichier de sauvegarde de rétention avec les données des éléments créés après la version 02.04.00 de Shinken existe, il est chargé et le message suivant est affiché :

[YYYY-MM-DD HH:MM:SS] INFO: [ ARBITER_NAME] [ MONITORING START TIME COMPONENT ] Old realm retention file 〖 /var/lib/shinken/arbiter-retention-NAME.json 〗 found, loading its data
Exemple
[2022-06-22 11:20:48] INFO   : [ arbiter-master  ] [ MONITORING START TIME COMPONENT ] Old realm retention file 〖 /var/lib/shinken/arbiter-retention-All.json 〗 found, loading its data

Chargement d'une sauvegarde de rétention avec des mises à jour provenant des modules SLA

Si un fichier de sauvegarde de rétention avec des données provenant des modules SLA existe, il est chargé.

  • Si un fichier sans les mises à jour des modules SLA avait été chargé, les données de rétention sont alors mise à jour :
[YYYY-MM-DD HH:MM:SS] INFO: [ ARBITER_NAME] [ MONITORING START TIME COMPONENT ] Realm retention file 〖 /var/lib/shinken/arbiter-retention-HASH.json 〗 found, updating monitoring start times with its data
Exemple
[2022-06-22 11:20:48] INFO   : [ arbiter-master  ] [ MONITORING START TIME COMPONENT ] Realm retention file〖 /var/lib/shinken/arbiter-retention-a52ace420f2175d08b1577a1bea5445e36801229c074ef9ed6c55a73401fd9c2.json 〗 found, updating monitoring start times with its data


  • S'il n'y avait pas eu d'autre fichier de rétention chargé pour ce royaume, ce log est présent
[YYYY-MM-DD HH:MM:SS] INFO: [ ARBITER_NAME] [ MONITORING START TIME COMPONENT ] Realm retention file 〖 /var/lib/shinken/arbiter-retention-HASH.json 〗 found, loading its data
Exemple
[2022-06-22 11:20:48] INFO   : [ arbiter-master  ] [ MONITORING START TIME COMPONENT ] Realm retention file〖 /var/lib/shinken/arbiter-retention-a52ace420f2175d08b1577a1bea5445e36801229c074ef9ed6c55a73401fd9c2.json 〗 found, loading its data

Suppression d'une sauvegarde de rétention ne contenant aucune donnée

Si un fichier de sauvegarde de rétention ne contient aucune donnée, il est supprimé

[YYYY-MM-DD HH:MM:SS] INFO: [ ARBITER_NAME] [ MONITORING START TIME COMPONENT ] Removed empty retention data file 〖 FILE_NAME 〗
Exemple
[2022-06-22 11:20:48] INFO   : [ arbiter-master  ] [ MONITORING START TIME COMPONENT ] Removed empty retention data file 〖 /var/lib/shinken/arbiter-retention-All.json 〗

Une erreur survient lors de la suppression

Si la suppression du fichier sans donnée est impossible, le message suivant sera disponible

[YYYY-MM-DD HH:MM:SS] WARNING: [ ARBITER_NAME] [ MONITORING START TIME COMPONENT ] Remove of empty retention data file 〖 FILE_NAME 〗 returned 〖 ERR 〗
Exemple
[2022-06-22 11:20:48] WARNING: [ arbiter-master  ] [ MONITORING START TIME COMPONENT ] Remove of empty retention data file 〖 /var/lib/shinken/arbiter-retention-All.json 〗 returned 〖 Permission denied 〗

Le royaume ne dispose pas d'une sauvegarde de rétention

S'il n'existe aucun fichier de rétention disponible pour un royaume, ou qu'ils ne contiennent aucune donnée, le log suivant apparaîtra :

[YYYY-MM-DD HH:MM:SS] INFO: [ ARBITER_NAME] [ MONITORING START TIME COMPONENT ] No retention data was available for realm 〖 NAME 〗 tried in 〖 /var/lib/shinken/arbiter-retention-HASH.json 〗, 〖 /var/lib/shinken/arbiter-retention-NAME.json 〗, 〖 /var/lib/shinken/arbiter-retention.json 〗
Exemple
[2022-06-22 11:20:48] INFO   : [ arbiter-master  ] [ MONITORING START TIME COMPONENT ] No retention data was available for realm 〖 All〗 tried in 〖 /var/lib/shinken/arbiter-retention-a52ace420f2175d08b1577a1bea5445e36801229c074ef9ed6c55a73401fd9c2.json 〗, 〖 /var/lib/shinken/arbiter-retention-All.json 〗, 〖 /var/lib/shinken/arbiter-retention.json 〗

Création ou mise à jour d'une sauvegarde de rétention avec des données de modules SLA

Suite à la réception des dates de mise en supervision des modules SLA, le fichier de sauvegarde de rétention est mis à jour :

[YYYY-MM-DD HH:MM:SS] INFO: [ ARBITER_NAME] [ MONITORING START TIME COMPONENT ] Saved retention data file〖 /var/lib/shinken/arbiter-retention-HASH.json 〗 successfully
[YYYY-MM-DD HH:MM:SS] INFO: [ ARBITER_NAME] [ MONITORING START TIME COMPONENT ] Updated retention data of XX elements for realm 〖 REALM_NAME 〗 from Module 〖 SLA_NAME 〗 of Broker 〖 BROKER_NAME 〗
Exemple
[2022-06-22 11:20:48] INFO   : [ arbiter-master  ] [ MONITORING START TIME COMPONENT ] Saved retention data file〖 /var/lib/shinken/arbiter-retention-a52ace420f2175d08b1577a1bea5445e36801229c074ef9ed6c55a73401fd9c2.json 〗 successfully
[2022-06-22 11:20:48] INFO   : [ arbiter-master  ] [ MONITORING START TIME COMPONENT ] Updated retention data of 28 elements for realm 〖 All 〗 from Module 〖 sla 〗 of Broker 〖 broker-master 〗

Suppression des anciens fichiers de sauvegarde de rétenion

Suite à la création du fichier de rétention avec les données de mise en supervision récupérée des modules SLA, le fichier sans les information des modules SLA est supprimé :

[YYYY-MM-DD HH:MM:SS] INFO: [ ARBITER_NAME] [ MONITORING START TIME COMPONENT ] Removed obsolete retention data file 〖 /var/lib/shinken/arbiter-retention-NAME.json 〗
Exemple
[2022-06-22 11:20:48] INFO   : [ arbiter-master  ] [ MONITORING START TIME COMPONENT ] Removed obsolete retention data file 〖 /var/lib/shinken/arbiter-retention-All.json 〗
La suppression est impossible

Si les droits d'accès au fichier à supprimer sont insuffisants, le log suivant sera généré :

[YYYY-MM-DD HH:MM:SS] WARNING: [ ARBITER_NAME] [ MONITORING START TIME COMPONENT ] Remove of obsolete retention data file 〖 /var/lib/shinken/arbiter-retention-NAME.json 〗 canceled due to wrong access rights
Exemple
[2022-06-22 11:20:48] WARNING: [ arbiter-master  ] [ MONITORING START TIME COMPONENT ] Remove of obsolete retention data file 〖 /var/lib/shinken/arbiter-retention-All.json 〗 canceled due to wrong access rights