Utiliser Grafana comme plateforme de lecture externe

Mirox provisionne un Grafana prêt à l'emploi pour vos données et le connecte pour vous, afin que vous puissiez ouvrir un espace de travail de traçage complet pour n'importe quelle centrale en un clic — sans connexion Grafana séparée, sans installation ni configuration de source de données. Ce guide vous accompagne pour accéder à Grafana et lire vos données ; pour ce que l'intégration fait en coulisses, consultez Visualisation graphique.

Quand utiliser Grafana

Utilisez Grafana lorsque vous souhaitez explorer les mesures brutes derrière les chiffres clés — courbes de puissance, compteurs d'énergie, entrées météo et signaux au niveau des composants — sur la plage de temps et la résolution de votre choix.

Pour les synthèses de performance calculées (production, pertes, disponibilité, productible spécifique), utilisez plutôt les vues KPI intégrées à la plateforme — Grafana trace les séries brutes, pas les KPI pré-agrégés.
Pour extraire des données en CSV ou JSON destinées aux tableurs et rapports, utilisez le Metric Export.
Pour définir votre propre grandeur calculée, créez un indicateur de votre organisation. Il s'écrit dans le langage de requête avec lequel sont lues les séries brutes dans Grafana.

Lit les métriques brutes

Le Grafana provisionné fonctionne sur les mêmes métriques brutes collectées que la plateforme enregistre depuis vos centrales — des séries à haute fréquence et multidimensionnelles — et non sur les indicateurs de la collection, que les rapports et le Metric Export lisent selon une lecture définie. C'est précisément pour cela qu'il est l'outil idéal pour inspecter un signal en détail.

Les noms ne sont pas des labels

Les séries portent les identifiants des composants (inverter_id, gak_id, string_number), jamais les noms attribués dans Mirox — renommer un composant dans Mirox ne change donc rien dans Grafana, ni rétroactivement ni pour les nouvelles données. Les noms actuels arrivent dans une légende via les séries d'information (powerplant_inverter_info …) ; le modèle est décrit dans Afficher les noms actuels des composants.

Où Grafana est provisionné

Grafana est provisionné par portefeuille. Lorsque vous créez un portefeuille, ses tableaux de bord sont configurés automatiquement et deviennent accessibles immédiatement — vous n'attendez aucune synchronisation en arrière-plan, et vous ne configurez aucune source de données.

Chaque centrale à laquelle vous avez accès est joignable via le tableau de bord de son portefeuille, restreint à cette centrale. Vous ne voyez jamais que les graphiques des centrales que votre rôle vous autorise ; la visibilité suit les mêmes règles de permission que le reste de la plateforme.

Cela inclut l'exigence de deux facteurs d'une organisation. Si l'organisation propriétaire d'une centrale exige l'authentification à deux facteurs (2FA) et que votre compte n'a pas de second facteur, ses tableaux de bord ne vous sont pas accessibles. Une fois la 2FA activée, Grafana suit dans un délai d'environ une heure. Voir Politique de sécurité de l'organisation.

Disponible en production

Le lien Grafana est actif dans l'environnement de production. Si vous travaillez dans un environnement hors production, le lien est affiché mais désactivé.

Ouvrir Grafana pour une centrale

Grafana s'ouvre depuis la navigation de la centrale, restreint à la centrale que vous avez sélectionnée.

Ouvrez la centrale que vous souhaitez tracer.
Ouvrir dans Mirox : service.mirox.io/#/monitor/solar/0/production
Dans la section Site de la barre latérale, cliquez sur Grafana.
Grafana s'ouvre dans un nouvel onglet de navigateur, déjà connecté via votre session Mirox et affichant déjà le tableau de bord d'aperçu de la centrale.

Pas de seconde connexion

Votre session Mirox est transmise à Grafana — il n'y a aucun nom d'utilisateur, mot de passe, URL de serveur ou jeton distinct à saisir avant de pouvoir tracer une centrale.

Grafana n'a pas de connexion propre. Il reste ouvert aussi longtemps que votre connexion Mirox, et se ferme avec elle :

Lorsque vous vous déconnectez de Mirox, ou que votre connexion prend fin, un tableau de bord ouvert cesse de charger des données. Ses panneaux affichent des erreurs jusqu'à ce que vous vous reconnectiez à Mirox et rouvriez le tableau de bord.
La durée d'une connexion est fixée par votre organisation. Si votre organisation a fixé un intervalle de revérification 2FA, un compte avec 2FA (application d'authentification ou passkey) doit en plus se reconnecter à cet intervalle. Voir Politique de sécurité de l'organisation.

Écrans muraux

Un tableau de bord affiché sur un écran mural qui tourne sous un compte personnel est déconnecté lorsque la connexion de ce compte prend fin. Quelqu'un doit alors se reconnecter sur l'écran. Le Grafana fourni par Mirox n'a ni compte d'affichage ni jeton distinct : tenez-en compte lorsque vous installez un écran censé fonctionner sans surveillance.

Lire vos données

Le tableau de bord s'ouvre sur la vue d'aperçu de la centrale et vous offre la boîte à outils Grafana standard appliquée aux métriques de votre centrale :

Choisissez une plage de temps — sélectionnez n'importe quelle fenêtre, puis zoomez et déplacez-vous jusqu'au moment qui vous intéresse.
Ajustez la résolution — affichez des échantillons bruts à grain fin pour une courbe de puissance ou des agrégats plus grossiers pour les tendances à long terme.
Lisez les valeurs exactes — survolez ou cliquez une série pour lire la valeur à un instant donné.
Comparez les signaux — tracez ensemble des métriques d'unités différentes (par exemple la puissance par rapport à l'irradiance).

Le tableau de bord arrive déjà restreint à la centrale pour laquelle vous l'avez ouvert, de sorte que la production et les signaux clés de cette installation sont déjà à l'écran.

Créez vos propres tableaux de bord — ne modifiez jamais celui qui est fourni

Portfolio Overview - <portefeuille> est géré par Mirox et remplacé à chaque déploiement d'une nouvelle version du modèle — tout panneau ajouté ou toute requête modifiée y est perdu. Pour personnaliser, enregistrez une copie (Edit → Save as copy) ou créez un nouveau tableau de bord dans l'organisation Grafana du portefeuille ; les copies et vos propres tableaux de bord ne sont jamais touchés. La structure de Grafana par portefeuille, qui peut modifier et comment lire les séries de la plateforme pour obtenir des chiffres corrects sont décrits dans Créer ses propres tableaux de bord Grafana. Les tableaux de bord fournis eux-mêmes sont décrits dans Visualisation graphique.

Distinction avec les surfaces connexes

Il est facile de confondre les endroits où les données de métriques apparaissent dans Mirox. Chacun répond à un besoin différent :

Surface	Ce qu'elle affiche	Quand l'utiliser
Grafana provisionné	Séries temporelles brutes et agrégées dans des graphiques interactifs, pré-connectées à vos centrales	Examiner un signal en détail dans Mirox, sans rien à configurer
Indicateurs	Les grandeurs que votre organisation définit sur les séries 15 minutes	Vos propres chiffres clés, dans les rapports et les exports
Metric Export	Les indicateurs de la collection en CSV ou JSON, à des pas de 1 minute à une année	Extraire des données pour des tableurs, des rapports ou des outils externes

Documentation associée

Créer ses propres tableaux de bord Grafana — structure par portefeuille, droits d'édition, la règle « copier, ne pas modifier » et la lecture correcte des séries
Visualisation graphique — comment fonctionne la surface Grafana intégrée et quels tableaux de bord sont fournis
Metric Export — exportez n'importe quel indicateur sous forme de série temporelle
Indicateurs — définissez vos propres grandeurs calculées
Politique de sécurité de l'organisation — combien de temps dure une connexion et quand la 2FA est exigée
FAQ Sécurité du compte — pourquoi vous avez été déconnecté et pourquoi des centrales peuvent manquer