Configurer les data loggers

Les data loggers sont le pont entre les équipements de votre centrale et la plateforme Mirox : une fois un logger configuré, le Mirox-Agent commence à interroger cet équipement selon une planification, en normalisant chaque lecture dans un vocabulaire de métriques unique et en la diffusant vers la plateforme. Ce guide vous accompagne pour ajouter un logger, associer un équipement détecté à un adaptateur, confirmer qu'il répond grâce à une sonde en direct, et appliquer vos changements — ainsi que les limites de ce qui s'intègre automatiquement.

Avant de commencer

Un logger est configuré sur un équipement réseau déjà détecté sur le réseau de la centrale. Si l'équipement souhaité n'y figure pas encore, lancez d'abord un scan de découverte — voir Gérer les équipements réseau. Vous avez également besoin que la connexion sécurisée vers la centrale soit active ; l'Agent atteint les équipements via le tunnel VPN.

Où se trouvent les data loggers

Chaque centrale dispose d'une page Flux de données où vous gérez ses loggers et observez les données arriver.

Ouvrir dans Mirox : Flux de données — ou ouvrez Vos parcs, choisissez un parc, puis passez à l'onglet Flux de données.

L'en-tête de la page affiche des tuiles en direct pour la santé des loggers (sains vs total), la disponibilité de l'Agent et le trafic réseau, afin que vous puissiez voir d'un coup d'œil si la collecte fonctionne. L'onglet Data Loggers est l'endroit où vous ajoutez et gérez les loggers ; le bouton Appliquer les changements en haut à droite pousse votre configuration vers l'Agent.

Comment les data loggers sont intégrés

Ajouter un logger est un flux guidé construit autour d'une véritable conversation avec l'équipement. La plateforme ouvre une connexion temporaire en lecture seule — une sonde — afin que vous puissiez confirmer que l'équipement répond et voir ses lectures en direct avant de valider quoi que ce soit. Il y a deux façons d'entrer dans le flux :

Loggers possibles (détectés automatiquement) — lorsque le fabricant et le type d'un équipement détecté correspondent à un adaptateur connu, il apparaît dans le tableau Loggers possibles avec l'adaptateur correspondant pré-rempli. C'est la voie rapide.
Ajouter un logger (manuel) — lorsque la détection rate ou classe mal un équipement, le bouton Ajouter un logger vous permet de choisir vous-même n'importe quel équipement réseau et un adaptateur.

Dans les deux cas, le même assistant s'exécute et la même sonde en direct confirme l'équipement avant l'enregistrement.

Ajouter un logger détecté automatiquement

Ouvrir dans Mirox : Flux de données (ou choisissez votre parc sous Vos parcs et ouvrez l'onglet Flux de données).
Dans le tableau Loggers possibles, trouvez l'équipement souhaité. Chaque ligne affiche le nom de l'équipement, son IP, son fabricant/type et l'adaptateur auquel la plateforme l'a associé.
Cliquez sur le bouton + de la ligne. L'assistant d'intégration s'ouvre avec cet équipement et cet adaptateur déjà liés.
Suivez les étapes de l'assistant (ci-dessous) et Enregistrez le logger.

Ajouter un logger manuellement

Sur la page Flux de données, cliquez sur Ajouter un logger.
À l'étape Choisir l'équipement, recherchez dans la liste des équipements réseau par nom, IP, fabricant, type, modèle ou description, et sélectionnez l'équipement.
Choisissez l'adaptateur à utiliser, puis cliquez sur Continuer.
Suivez les étapes restantes de l'assistant et Enregistrez le logger.

L'assistant d'intégration, étape par étape

L'assistant est une boîte de dialogue unique avec une barre latérale d'étapes et une bande de journal d'agent en direct en bas, afin que vous puissiez observer l'Agent dialoguer avec l'équipement tout au long du processus. Un badge de connexion à côté du nom de l'équipement indique l'état de la sonde (Connexion, Sondage, Inactif, Erreur, Terminé). Les étapes affichées dépendent de l'adaptateur :

Étape	Quand elle apparaît	Ce que vous faites
Choisir l'équipement	Ajout manuel uniquement	Choisir l'équipement réseau et l'adaptateur
Identité	Équipements nécessitant une configuration	Confirmer que l'équipement et l'adaptateur sont corrects
Identifiants	Adaptateurs nécessitant une connexion	Saisir le nom d'utilisateur et le mot de passe de l'équipement
Sonde	Équipements en zéro configuration	Observer les lectures en direct exposées par l'équipement
Mapper les valeurs	Loggers génériques	Parcourir chaque valeur brute exposée par l'équipement et mapper chacune sur une métrique connue
Essai à blanc	Loggers génériques	Vérifier les métriques exactes que produirait votre mappage
Configuration	Équipements nécessitant un mappage manuel	Choisir les lectures à collecter et l'intervalle d'interrogation
Récapitulatif	Équipements nécessitant une configuration	Vérifier et enregistrer

Identifiants et coffre-fort

Si l'adaptateur doit se connecter à l'équipement, l'étape Identifiants demande un nom d'utilisateur et un mot de passe. Les identifiants que vous avez déjà enregistrés pour cet équipement dans le coffre-fort d'identifiants sont proposés ici pour vous éviter de les ressaisir, et ce que vous saisissez peut être réutilisé ultérieurement pour l'accès proxy.

Janitza n'a besoin d'aucun identifiant

Les compteurs Janitza s'intègrent sans aucun identifiant. Les contrôleurs Huawei SmartLogger et Phoenix Contact nécessitent une connexion à l'équipement, l'étape Identifiants apparaît donc pour eux même s'ils sont par ailleurs en zéro configuration.

Exécuter la sonde en direct

L'étape Sonde lance un essai à blanc de courte durée contre l'équipement. L'Agent lit ce que l'équipement expose et renvoie des échantillons en direct — ils se rafraîchissent chaque seconde, et la bande de journal en bas montre l'échange sous-jacent.

Attendez que les échantillons apparaissent. Le badge de connexion passe à Sondage puis se stabilise une fois que les lectures circulent.
Si rien n'arrive, l'assistant réessaie automatiquement quelques fois. S'il ne parvient toujours pas à joindre l'équipement, vous recevrez un message clair et un bouton Reconnecter pour réessayer.
Une sonde bloquée signifie presque toujours que l'équipement n'est pas joignable depuis l'Agent — vérifiez que la découverte le voit toujours et que le tunnel VPN est actif.

La sonde est en lecture seule

La sonde ne modifie jamais l'équipement et n'enregistre rien d'elle-même. Elle existe pour que vous puissiez confirmer que l'équipement répond et voir ses valeurs réelles avant de valider le logger.

Mapper les valeurs d'un logger générique

Certains loggers sont génériques — ils exposent une longue liste de valeurs brutes que la plateforme ne peut pas interpréter d'elle-même (un compteur de puissance, un pyranomètre et une douzaine d'autres voies derrière un seul équipement, chacune nommée dans le vocabulaire propre de l'équipement). Pour ceux-ci, l'assistant exécute un flux de mappage interactif au lieu d'un aperçu en lecture seule :

À l'étape Mapper les valeurs, l'Agent énumère toutes les valeurs brutes exposées par l'équipement et les renvoie avec leur groupe, leur nom, leur unité et un échantillon en direct. Vous obtenez un tableau consultable.
Pour chaque valeur brute qui vous intéresse, choisissez dans la liste déroulante la métrique connue qu'elle représente. Laissez les autres sans mappage. Vous pouvez inverser un signe par valeur lorsque c'est nécessaire ; les préfixes d'unité (kW, kWh, …) sont automatiquement remis à l'échelle en unités SI de base.
L'étape Essai à blanc rejoue l'équipement à travers votre mappage et affiche les métriques exactes qui seraient produites — votre point de contrôle pour accepter ou refuser.
Le Récapitulatif confirme ce qui sera enregistré.

Seules les valeurs que vous mappez sont collectées, et chaque valeur brute se mappe sur exactement une métrique.

Mapper les lectures (adaptateurs à substitution manuelle)

Pour les adaptateurs non génériques qui exposent tout de même une étape de configuration, l'étape Configuration affiche chaque lecture trouvée par la sonde et vous permet de choisir lesquelles collecter, de définir l'intervalle d'interrogation et d'appliquer des corrections par lecture (par exemple, inverser un signe). Lorsque vous continuez, la plateforme refait une sonde avec votre configuration afin que l'étape Récapitulatif affiche les valeurs exactement telles qu'elles seront stockées.

Enregistrement

À l'étape finale — Récapitulatif pour les adaptateurs manuels, ou l'étape Sonde elle-même pour les équipements en zéro configuration — cliquez sur Enregistrer le logger (ou Ajouter pour le zéro configuration). Le logger est enregistré comme changement en attente. Rien n'atteint encore l'Agent.

Appliquer vos changements

Les nouveaux loggers, les modifications et les suppressions sont mis en attente jusqu'à ce que vous les publiiez sur l'Agent en un seul lot.

Effectuez tous les changements de logger souhaités.
Cliquez sur Appliquer les changements en haut de la page Flux de données (le bouton affiche Appliquer N changement(s) en attente lorsque vous en avez mis en file d'attente durant cette session).
L'Agent se redéploie avec la nouvelle configuration et commence la collecte peu après.

Appliquer est toujours sûr

Vous pouvez appuyer sur Appliquer les changements à tout moment — s'il n'y a rien de nouveau à publier, cela ne fait rien. Après un rafraîchissement de la page, le compteur de changements en attente revient à zéro ; utilisez donc Appliquer les changements pour vous assurer que la configuration la plus récente est active.

Gérer les loggers existants

Le tableau Data Loggers liste tout ce qui est configuré pour la centrale, avec recherche, tri et santé par logger. Le menu d'actions ⋮ sur chaque ligne vous permet de :

Modifier le logger — ajuster la configuration du logger.
Modifier l'équipement réseau — accéder à l'équipement sur la page Réseau pour modifier son IP, ses identifiants, son SNMP ou ses paramètres de proxy (ils se trouvent à un seul endroit, non dupliqués ici).
Mettre en pause / Reprendre — arrêter temporairement la collecte pendant une fenêtre choisie (de 15 minutes jusqu'à 24 heures) et la reprendre. Utile pendant la maintenance pour qu'une panne connue ne génère pas d'événements.
Supprimer le logger — supprimer un logger ajouté via l'assistant.

Supprimer ou mettre en pause un logger est également un changement en attente — pensez à Appliquer les changements ensuite.

Ce qui peut être intégré via l'assistant

Deux types d'équipements s'intègrent via l'assistant :

Familles en zéro configuration — l'adaptateur connaît déjà l'ensemble complet des lectures de l'équipement, vous n'avez donc qu'à confirmer la sonde en direct et enregistrer. Aujourd'hui, il s'agit des compteurs Janitza (aucun identifiant requis), du Huawei SmartLogger et des contrôleurs Phoenix Contact.
Loggers génériques — des équipements qui exposent des valeurs brutes arbitraires que la plateforme ne peut pas interpréter d'elle-même. Ceux-ci s'intègrent via le flux interactif Mapper les valeurs → Essai à blanc décrit ci-dessus, où vous liez chaque valeur brute à une métrique connue. QReader est le premier logger générique pris en charge de cette manière.

Les familles d'équipements en dehors de ces deux groupes fonctionnent également, mais elles ne sont pas intégrables via l'assistant aujourd'hui : elles nécessitent une configuration par équipement que Mirox prépare et livre avec l'Agent. Considérez l'automatisation de l'intégration comme spécifique à l'équipement, non universelle.

Votre équipement n'est pas listé ?

Si votre matériel n'est pas couvert par un adaptateur existant, Mirox en construit un — souvent même pour du matériel ancien ou des interfaces non documentées, dès lors que l'équipement expose ses données d'une manière ou d'une autre. Le sélecteur d'adaptateur dans l'assistant renvoie directement vers une demande de support, ou vous pouvez en démarrer une vous-même.

Comment la demander : Demander une intégration.

Pour comprendre comment les adaptateurs parlent le protocole de chaque équipement, normalisent les unités et découvrent les composants, consultez la page d'architecture Data Scraper — ce guide ne la répète volontairement pas.

Guides associés

Gérer les équipements réseau — découvrir et classer les équipements sur lesquels un logger est configuré
Configurer les composants — mapper les métriques collectées sur les onduleurs, strings et boîtes de jonction
Data Scraper — comment les adaptateurs collectent, normalisent et transmettent vos données
Demander une intégration — demander à Mirox d'ajouter un adaptateur pour un équipement non pris en charge
Utiliser le proxy — ouvrir l'interface web propre à un équipement dans le navigateur à l'aide des identifiants stockés