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.

Fronius peut remplacer un compteur d'injection

Les petits parcs Fronius n'ont souvent pas de compteur d'injection réseau dédié. Lors de l'intégration d'un logger Fronius, activez l'option « Utiliser comme compteur d'injection » pour publier la puissance combinée de l'ensemble de l'appareil et l'énergie totale comme série principale d'injection réseau du parc — aucun compteur séparé n'est nécessaire.

SMA Power Manager liste lui-même ses équipements

SMA Power Manager (le contrôleur de centrale SMA Data Manager / ennexOS) s'intègre en zéro configuration : connectez-vous avec un compte utilisateur ennexOS et le gestionnaire signale automatiquement tous les équipements qu'il connaît — identifiant de composant, nom, produit, numéro de série, adresse IP et firmware — de sorte qu'il n'y a aucune liste de composants à saisir. Trois interrupteurs contrôlent ce qui est collecté : collecter les totaux de centrale (désactivez-le lorsqu'un compteur réseau dédié les mesure déjà), collecter les séries d'onduleurs et exclure les voies de limitation. Un onduleur déjà lu directement par un autre logger est automatiquement écarté — le Power Manager continue de signaler son motif de déclassement, mais pas sa télémétrie, afin que rien ne soit publié en double.

SMA Sunny Central conserve son identité

SMA Sunny Central (l'interface web classique par onduleur) s'intègre lui aussi en zéro configuration. Lorsque la même centrale dispose également d'un SMA Power Manager configuré, l'assistant résout automatiquement l'identité du Sunny Central à partir de la liste d'équipements du Power Manager, de sorte que l'unité conserve le même composant et le même historique qu'elle avait déjà.

La surveillance de strings du blue'Log est un champ de l'assistant

Un blue'Log desservant du matériel de surveillance de strings reçoit une étape surveillance des strings : activez ou désactivez le suivi, choisissez à quel onduleur appartiennent les strings, et définissez la fréquence de lecture de la couche de strings (tous les n-ièmes cycles). Si le logger connaît déjà son onduleur, celui-ci est pré-rempli automatiquement ; sinon, vous le choisissez parmi les onduleurs de la centrale.

Sungrow Logger s'intègre en zéro configuration

Sungrow Logger se connecte avec le même nom d'utilisateur et le même mot de passe que l'interface web du logger lui-même (le comportement SSL et ping sont des paramètres avancés optionnels). Outre les lectures de ses onduleurs, il collecte également la liste des défauts actifs du logger sous forme d'alarmes et signale automatiquement le numéro de série, le modèle, le firmware et la puissance nominale de chaque onduleur.

Batteries INTILION : choisir le type d'appareil et apparier l'identifiant

Une centrale INTILION place deux contrôleurs différents sur le même protocole : un contrôleur de centrale pour tout le site et un contrôleur d'unité de batterie par unité de stockage. Choisissez celui que vous intégrez sous Type d'appareil — aucun des deux ne porte de numéro de série, c'est donc la seule indication qui dit à la plateforme ce qu'elle lit, et un mauvais choix est refusé plutôt que publié.

Pour un contrôleur d'unité de batterie, donnez à l'unité un identifiant d'unité de batterie et utilisez exactement le même identifiant sur le relais de protection du départ moyenne tension de cette unité. Le relais mesure le côté réseau et le contrôleur le côté batterie ; des identifiants identiques en font une seule unité de stockage au lieu de deux à demi mesurées.

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é.

Paramètres avancés par valeur

Chaque valeur mappée dispose d'un panneau Paramètres avancés, replié par défaut — la plupart des valeurs n'en ont pas besoin. Ouvrez-le lorsque l'équipement renvoie une valeur qui doit être retravaillée avant publication :

Facteur — multiplie la mesure (p. ex. un compteur à impulsions dont chaque impulsion vaut 200 Wh). Appliqué par-dessus la remise à l'échelle automatique des unités.
Limite haute / Limite basse — rejette les mesures hors de cette plage au lieu de les publier. Utile pour un équipement qui émet un pic hors plage quand son entrée n'est pas lue.
Valeurs à ignorer — écarte entièrement certaines mesures brutes, séparées par des virgules (p. ex. 0 pour un compteur qui renvoie zéro tant que son entrée est déconnectée).
Inverser le signe — échange le sens soutirage/injection.

Un champ laissé vide n'est pas appliqué du tout. Tout ce que vous définissez apparaît sous forme d'un court badge (×200 · ≥-10000) sur la ligne de la valeur puis à l'étape Récapitulatif, ce qui vous permet de vérifier l'ensemble du mappage avant d'enregistrer.

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

Trois 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, cela inclut les compteurs Janitza (aucun identifiant requis), le Huawei SmartLogger, les contrôleurs Phoenix Contact, SMA Sunny Central, SMA Power Manager et Sungrow Logger.
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 et blue'Log sont pris en charge de cette manière.
Adaptateurs à ajout manuel — une famille que la plateforme lit intégralement mais qu'elle ne doit jamais deviner. Aujourd'hui, c'est l'automate d'alarme WAGO PFC200 : il lit les contacts du système d'alarme d'un site en Modbus TCP en lecture seule et sans identifiants, mais une WAGO est un automate vierge que chaque intégrateur programme différemment et rien sur le fil n'indique quel programme tourne. Il n'est donc jamais proposé dans Loggers possibles : utilisez Ajouter un logger, choisissez l'adaptateur et définissez le profil d'intégrateur (abo_uegs aujourd'hui), éventuellement un identifiant de système d'alarme et les contacts non câblés. La sonde en direct affiche ensuite l'état de chaque contact avant l'enregistrement.

Les familles d'équipements en dehors de ces trois 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. Cliquez sur Demander de l'aide pour un enregistreur sous le tableau Loggers possibles (le sélecteur d'adaptateur de l'assistant renvoie vers la même demande) ; les détails de la centrale et de l'équipement sont joints automatiquement, et la prise en charge d'un nouvel équipement est généralement prête en un jour.

Pas à pas : 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.

Migrer une configuration écrite à la main

Un petit nombre de centrales intégrées avant l'existence de l'assistant fonctionnent encore avec une configuration écrite à la main (une surcouche héritée) au lieu de la configuration que la plateforme générerait aujourd'hui à partir de leurs lignes de logger. Pour celles-ci, les administrateurs système Mirox disposent d'une vue de migration sur l'onglet Flux de données → Configuration de l'agent de la centrale, qui montre à quoi ressemblerait la sortie de la surcouche avant que quoi que ce soit ne change :

la configuration que la plateforme générerait sans la surcouche héritée,
une comparaison (diff) par rapport à la surcouche actuellement active sur la centrale, et
pour chaque logger, si le générateur peut déjà produire une entrée pour celui-ci et ce qu'il manque encore (une identité d'onduleur non résolue, une association de surveillance de strings manquante, un inventaire pas encore capturé, et ainsi de suite).

À partir de là, un administrateur peut re-sonder un logger individuel pour compléter ce qui manque, effacer la surcouche et déployer la configuration générée — sans renommer aucun composant ni perdre son historique. Il s'agit d'un outil de migration interne, pas d'un réglage destiné au client : il existe pour que les dernières centrales écrites à la main puissent basculer vers la même configuration générée que toutes les autres centrales utilisent déjà.

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