Supervision REFIMEVE

L'outil de supervision REFIMEVE a plusieurs enjeux impliquant des acteurs différents :

• exploitation : administrateurs et utilisateurs
• maintenance et développement : équipe IT (SYRTE, LPL ?) et ingénieurs logiciels REFIMEVE

• Installation: La documentation associée à l'installation des outils de supervision est accessible sur le dépôt gitlab
• Développement: La documentation associée au développement de la supervision est accessible sur le dépôt gitlab

• En test https://refimeve-testsupervision.obspm.fr/admin
  
• En prod (pas installé)
  

L'administration client consiste à gérer la base de données de supervision. Elle est composée d'un ensemble d'objets permettant de décrire le réseau REFIMEVE.

La base de données de Supervision est dite relationnelle. Un objet peut donc être lié à un ou plusieurs objets qui doivent donc, si nécessaire, être créés avec l'objet initial. Mais ces objets liés peuvent eux-mêmes être liés à d'autres… La procédure de mise à jour de la base de données peut donc vite conduire à avoir de nombreux onglets ouverts, ce qui n'est vraiment pas pratique..
Pour cette raison, il est conseillé de créer les nouveaux objets dans l'ordre suivant :

Définition : C'est l'objet le plus global dans la hiérarchie. Une infrastructure peut contenir un ou plusieurs (sous-)réseaux.
Exemples :

• REFIMEVE+ (France) est une infrastructure
• IQB (Italie) est une infrastructure

Liaisons : Aucune

Définition : Un site représente un lieu géographique et structurel. Un site peut contenir un ou plusieurs noeuds.
Exemples :

• Le Datacenter de Strasbourg est un site
• Le SYRTE est un site
• Le Laboratoire 3 du SYRTE n'est pas un site

Liaisons : Aucune

Définition : La notion de réseau désigne un ensemble de noeuds qui dépendent d'un même point d'entrée. Un sous-réseau n'a pas de source de signal propre.
Exemples:

• Réseau REFIMEVE+ : point d'entrée au SYRTE, source venant de la Cavité Ultra-Stable(CUS)
• Sous-Réseau Aquitaine : point d'entrée à Bordeaux, pas de source propre

Liaisons :

• Infrastructure
• Module : source du réseau (optionnel)

Définition : Un noeud est un lieu (une pièce) dans lequel transitent les signaux REFIMEVE. Dans un noeud, on trouve des modules et des instruments de mesure.
Exemples :

• Le Laboratoire 3 du SYRTE est un noeud
• Modane Bureau est un noeud
• Le Datacenter de Strasbourg est un noeud
• Le SYRTE n'est pas un noeud

Liaisons:

• Network
• Site

Définition : Une technique représente une méthode/technologie matérielle/logicielle de transfert Temps/Fréquence.
Exemples :

• transfert de fréquence par liens optiques fibrés REFIMEVE
• transfert de temps par liens optiques fibrés White Rabbit
• protocole NTP

Liaisons : Aucune

Définition : Cet objet contient les métadonnées nécessaires pour accéder à un fichier de mesurandes en lecture (serveur hôte, chemin du répertoire, format du fichier, …). Il permet l'automatisation de la lecture des fichiers.
Liaisons : Aucune

Définition : Un instrument de mesure désigne un appareil permettant l'acquisition de données (mesures/mesurandes). Ces données mesurées sont stockées dans des fichiers dont on connaît la localisation et la manière de les lire grâce aux métadonnées présentes dans les file access.
Exemples :

• Un KKCounter est un instrument de mesure de fréquence
• Un Time Interval Counter (TIC) est un instrument de mesure d'intervalle de temps
• Un serveur NTP est un instrument de mesure, dans le sens où le protocole NTP permet de mesurer la différence de temps entre deux horloges internes de deux ordinateurs appartenant à un réseau NTP.

Liaisons :

• Node: localisation physique du module
• Module : serveur NTP de référence pour l'instrument
• File access : localisation des fichiers de données sur le serveur de calcul

Chaque nouvel instrument newInstrument s'accompagne d'un serveur d'acquisition de données serverAcq avec une synchronisation NTP de son horloge locale localClock. Pour cette raison, on crée d'abord la logique NTP si ce n'est pas déjà fait, avant de créer newInstrument:

• Créer le fichier File access pour accéder aux mesurandes offset et delay NTP de localClock
• Créer l'instrument serverAcq en laissant le champ “Ntp server” vide
• Créer le module “horloge locale du serveur d'acquisition” localClock en laissant les champs “mesurandes” vides
• Mettre à jour l'instrument serverAcq en insérant le module localClock dans le champ “ntp server”
• Créer les mesurandes offset et delay NTP du module localClock
• Remplir les champs “Delay mesurand” et “Offset mesurand” du module localClock

Maintenant que la logique NTP est en place, vous avez tout en main pour créer l'instrument newInstrument

Définition : Une mesurande désigne n'importe quelle donnée acquise - par un instrument de mesure- utile dans le cadre de REFIMEVE.
Exemples :

• les mesures E2E sur les liens fibrés
• les mesures Freelink sur les liens fibrés
• la mesure de synchronisation des compteurs
• le décalage temporel entre deux horloges internes de serveurs NTP
• la température dans le labo3 du SYRTE

Liaisons :

• Measuring Instrument: instrument acquiérant la mesurande

Chaque nouvelle mesurand newMesurand s'accompagne d'un instrument newInstrument. On doit donc créer newInstrument d'abord.
output_value_column : starting from 0 (python-wise)

Définition : Un compteur est un type d'instrument de mesure mesurant des données Temps/Fréquence.
Exemples:

• Un KKCounter est un compteur de fréquence
• Un TIC est un compteur d'intervalle de temps

Liaisons :

• Measuring Instrument : un compteur est associé à un instrument de mesure du même nom
• mesurandes : la fréquence de référence du compteur (optionnel) et son niveau de synchronisation (optionnel).

Définition : Un module est un terme générique pour désigner tout système matériel appartenant à un réseau de transfert Temps-Fréquence en lien avec REFIMEVE : (ré)génération / comparaison / transmission / étalon / …
On peut dire qu'un module est un intermédiaire dans un réseau technique possèdant une sortie mesurée (délai, offset, sortie fréquence, sortie temps, …).
Exemples :

• La fontaine Césium FO1
• Le Maser Hydrogène H-Maser H810S
• Un peigne de fréquence
• La cavité ultra-stable
• La station de régénération du signal REFIMEVE à Grenoble
• Le Switch White-Rabbit M00
• Un serveur NTP

Liaisons :

• Node: localisation physique du module
• Mesurands: Clock Out, PPS Out, Delay, Offset (optionnels)

maintainer_id: ID of the object in the SI of the external contractor if any.
Example : ID of RLS Lyon DC4 in iXBlue SI is 26

Définition :

Définition : Une campagne désigne un intervalle de temps pendant lequel les utilisateurs peuvent s'attendre à avoir un signal reçu des plus performants en stabilité et en précision du fait d'une attention accrue des équipes du SYRTE. Une campagne est souvent synonyme de comparaisons d'horloges atomiques|optiques.
Exemples

• La campagne SYRTE-INRIM en décembre 2021.
• La campagne ROCIT2022 impliquant SYRTE, INRIM, PTB en 2022.

Liaisons :

• File access : localisation des fichiers de données des comparateurs sur le serveur de calcul, conformément au protocole défini à partir de la campagne ROCIT2022.

Définition : Une comparaison d'horloges désigne un couple de modules (horloges atomiques|optiques) dans le cadre d'une campagne. Pour pouvoir réaliser une comparaison entre deux horloges A et B, il faut avoir un jeu de comparateurs qui, mis dans le bon ordre, forment une chaîne allant de A à B.
Cas explicatif : Le seul intérêt de cet objet est de déclarer des comparaisons à effectuer automatiquement. Exemples :

• INRIM_HM-SYRTE-H810: comparaison entre le module Maser Hydrogène Pivot de IQB et le module Maser Hydrogène Pivot de REFIMEVE
• PTB_Sr3_CombKnoten-SYRTE_Sr2: comparaison entre le module horloge Strontium3 du PTB et le module horloge Strontium2 du SYRTE.

Liaisons :

• Campaign

Définition : Un comparateur désigne une mesure entre deux modules successifs. Cette mesure peut être un ratio, une différence, une modulation, … Cela dépend de la nature des modules dans le camparateur.
Exemples:

• SYRTE_CUS-SYRTE_H810 est le ratio de fréquences entre la cavité ultra-stable du SYRTE (SYRTE_CUS) et le Maser Hydrogène pivot du SYRTE (SYRTE_H810)
• SYRTE_CUS-SYRTE_SSSYRTE est la différence entre la cavité ultra-stable du SYRTE (SYRTE_CUS) et la SuperStation du SYRTE (SYRTE_SSSYRTE)
• UNISTRA_RLS5-PTB_NIRP est la différence entre la cavité ultra-stable du PTB (PTB_NIRP) et la Station de Strasbourg (UNISTRA_RLS5)

Liaisons :

• Campaign : on déclare un certain nombre de comparateurs associés à une campagne dont les données sont disponibles.

Le point d'attention est : qui est moduleA et qui est moduleB.
La nomenclature adoptée depuis la publication du formalisme défini par Jérôme Lodewyck et al. (https://hal.science/hal-02997778) est telle que : COMPARATOR_LABEL = ModuleB-ModuleA.
Exemple :

• TH2_RLS-MODANE_RLS : moduleA est MODANE_RLS et moduleB est TH2_RLS
• SYRTE_CUS-SYRTE_H810 : moduleA est SYRTE_H810 et moduleB est SYRTE_CUS

Définition : Un lien désigne une connexion - physique, immatérielle ou conceptuelle - entre deux noeuds. A un lien on associe :

• une technique afin d'identifier le type de lien dont il s'agit
• des link infos

Exemples :

• CUS - Frequency Comb est un lien de comparaison de fréquences
• TH2-Lille est un lien optique fibré de transfert de fréquence entre les noeuds TH2 et Lille
• WR GM-M00 est un lien optique fibré de transfert de temps entre deux Switch White Rabbit
• r530-pc105 est un lien conceptuel entre deux serveurs NTP, car r530 est la référence NTP de pc105

Liaisons :

• noeuds: noeuds de départ et d'arrivée du lien
• Technique: méthode de transfert d'information Temps/Fréquence
• Link : lien parent. Nécessaire pour bien définir l'architecture des liens.

Le point d'attention ici est : qui est from_node et qui est to_node.
Le sens à donner dépend du type d'information transmise :

• signal physique : from_node est le noeud de départ, to_node le noeud d'arrivée
• calibration / synchronisation : from_node est le noeud de référence, to_node le noeud à caler/calibrer/synchroniser

Exemples:

• lien fibré Grenoble - Modane : from_node est Grenoble DSI, to_node est Modane Bureau
• synchro NTP de r530 : from_node est RNT (pour ntp-p1.obspm.fr), to_node est Labo3 (pour r530)
• comparaison par peigne : ???

Définition : Cet objet rassemble les propriétés des liens qui varient dans le temps.
Cas explicatif : à cause d'une défaillance technique, la station RLS-A à Lyon est remplacée par la RLS-B. Pour autant, le lien optique “Lyon-Grenoble” reste le même. Ainsi on ne modifie pas l'objet "lien" mais on ajoute un objet liens info qui va décrire ce changement dans le temps.
Exemples :

• TH2_L3 - RLS Lille : les modules TH2_L3 et RLS1 Lille pour le lien fibré TH2-Lille
• WR GM-M00 : les modules GM et M00 pour le lien WR GM-M00
• ntp-p1.obspm.fr-r530 : pour le lien NTP synchronisant l'horloge du serveur r530 sur ntp-p1.obspm.fr

Liaisons :

• Modules : modules de “début” et de “fin” du lien
• Link : lien associé à ces informations

Le point d'attention ici est : qui est from_module et qui est to_module.
Le sens à donner dépend du type d'information transmise :

• signal physique : from_module est le module de départ, to_module le module d'arrivée
• calibration / synchronisation : from_module est le module de référence, to_module le module à caler/calibrer/synchroniser
• comparaison : “distance” par rapport à la source ???

Exemples:

• lien fibré Grenoble - Modane : from_module est RLS Grenoble, to_module est RLS Modane Bureau
• synchro NTP de r530 : from_module est ntp-p1.obspm.fr, to_module est r530
• comparaison par peigne : ???

Définition : Cet objet représente le système de stabilisation (mesure Freelink) et de vérification (mesure E2E) associé à un ensemble de liens optiques fibrés pour le transfert de fréquence via REFIMEVE.
Exemples :

• SYRTE-TH2: le noeud Labo3 SYRTE et revenant via noeud TH2
• TH2-Modane: le noeud TH2 et revenant via noeud Modane Bureau

Liaisons :

• Mesurands : mesures E2E et/ou Freelink
• Nodes : noeud de début et noeud de retour

Définition : Cet objet représente, comme son nom l'indique, le système de Two Way entre deux Modules.
Exemples :

• Île-de-France loop: battement entre le module Cavité Ultra-Stable (CUS) contre lui-même après transfert dans des noeuds d'Île-de-France
• SYRTE-PTB: battement à Strasbourg entre le module Station côté REFIMEVE et module Station côté PTB

Liaisons :

• Mesurands : beatnope up et beatnote down
• Modules : modules involved in the two-way
• Technique : ??