MiroxMirox
  • Plateforme

    • Philosophie
    • Vue d'ensemble de la plateforme
    • Ressources de la plateforme
    • Disponibilité et fenêtres de maintenance
    • Versions et numéros de version
  • Mirox-Cloud

    • Vue d'ensemble du cloud
    • Microservices connectés
  • Mirox-Agent

    • Vue d'ensemble de l'agent
    • Options de déploiement
    • Data Scraper
    • Jumeau numérique
  • Détails techniques

    • Collecte de métriques
  • Informations

    • Centrales prises en charge
  • Types de centrale

    • Centrales solaires
    • Trackers solaires et contrôleurs de parc
    • Postes de transformation
    • Parcs éoliens
    • Stockage par batteries
    • Système d'alarme
  • Monitoring et visualisation

    • Monitoring en temps réel
    • Jumeau numérique
    • États des composants
    • Codes d'état des onduleurs
    • Événements des onduleurs
    • Détection des pertes
    • Limites de puissance et écrêtement
    • Détection d'efficacité
    • Tableau de bord KPI
  • Gestion des données

    • Événements
    • Niveaux d'alarme
    • Tickets
    • Prévisions
    • Rapports
    • Indicateurs
  • Alert Manager

    • Vue d'ensemble
    • Règles d'alerte
    • Alertes et notifications
    • Exemples
  • Intégration et partage

    • Coopérations
    • Jetons API
    • VPN
    • Conflits d’adresses VPN
    • Proxy
  • IA

    • Assistant IA et assistants
    • Accès agentique (MCP)
  • Facturation

    • Marché et tarifs
    • Comment les revenus sont calculés
    • Comptabilité et facturation
    • Contrats
    • Certificats de prestation et factures
  • Collaboration

    • Invitations
  • Sécurité

    • Authentification
    • Verrouillage de compte
    • Politique de sécurité de l'organisation
    • Système de permissions
    • Segmentation réseau
    • Restrictions de coopération
    • Journalisation d'audit d'accès
    • Activité et journal d'audit
    • Isolation des données
  • Premiers pas

    • Onboarding
    • Configuration initiale
  • Personnel

    • Utiliser le VPN
    • Utiliser le proxy
    • Authentification à deux facteurs
    • Sessions
    • Jetons API
    • Notifications
    • Connecter Microsoft Teams
  • Par centrale

    • Contacts
    • Périphériques réseau
    • Enregistreurs de données
    • Lecteur Modbus générique
    • Composants
    • VPN direct (par agent)
    • Volume de données
    • Importer l'historique
  • Organisation

    • Permissions des membres
    • Politique de sécurité
    • Coopérations
    • Stockage de fichiers
    • Services VPN
    • Travailler avec les rapports
  • Export de données

    • Metric Export
    • API Metric Export
    • Migrer vers le Metric Export
    • API de l'ancien export
    • Génération externe de rapports
    • Grafana
    • Tableaux de bord Grafana
    • Vue d'ensemble de l'API
    • Formules MiroxQL (API)
  • Assistance

    • Demander une intégration
  • Reporting

    • Générateur de rapports externe
    • Metric Export pour Excel
  • Accès distant
  • Sécurité du compte
  • L'IA dans Mirox
  • Import de l'historique
  • Rapports
  • Export de données
  • English
  • Deutsch
  • Español
  • Français
  • Português
  • Italiano
  • English
  • Plateforme

    • Philosophie
    • Vue d'ensemble de la plateforme
    • Ressources de la plateforme
    • Disponibilité et fenêtres de maintenance
    • Versions et numéros de version
  • Mirox-Cloud

    • Vue d'ensemble du cloud
    • Microservices connectés
  • Mirox-Agent

    • Vue d'ensemble de l'agent
    • Options de déploiement
    • Data Scraper
    • Jumeau numérique
  • Détails techniques

    • Collecte de métriques
  • Informations

    • Centrales prises en charge
  • Types de centrale

    • Centrales solaires
    • Trackers solaires et contrôleurs de parc
    • Postes de transformation
    • Parcs éoliens
    • Stockage par batteries
    • Système d'alarme
  • Monitoring et visualisation

    • Monitoring en temps réel
    • Jumeau numérique
    • États des composants
    • Codes d'état des onduleurs
    • Événements des onduleurs
    • Détection des pertes
    • Limites de puissance et écrêtement
    • Détection d'efficacité
    • Tableau de bord KPI
  • Gestion des données

    • Événements
    • Niveaux d'alarme
    • Tickets
    • Prévisions
    • Rapports
    • Indicateurs
  • Alert Manager

    • Vue d'ensemble
    • Règles d'alerte
    • Alertes et notifications
    • Exemples
  • Intégration et partage

    • Coopérations
    • Jetons API
    • VPN
    • Conflits d’adresses VPN
    • Proxy
  • IA

    • Assistant IA et assistants
    • Accès agentique (MCP)
  • Facturation

    • Marché et tarifs
    • Comment les revenus sont calculés
    • Comptabilité et facturation
    • Contrats
    • Certificats de prestation et factures
  • Collaboration

    • Invitations
  • Sécurité

    • Authentification
    • Verrouillage de compte
    • Politique de sécurité de l'organisation
    • Système de permissions
    • Segmentation réseau
    • Restrictions de coopération
    • Journalisation d'audit d'accès
    • Activité et journal d'audit
    • Isolation des données
  • Premiers pas

    • Onboarding
    • Configuration initiale
  • Personnel

    • Utiliser le VPN
    • Utiliser le proxy
    • Authentification à deux facteurs
    • Sessions
    • Jetons API
    • Notifications
    • Connecter Microsoft Teams
  • Par centrale

    • Contacts
    • Périphériques réseau
    • Enregistreurs de données
    • Lecteur Modbus générique
    • Composants
    • VPN direct (par agent)
    • Volume de données
    • Importer l'historique
  • Organisation

    • Permissions des membres
    • Politique de sécurité
    • Coopérations
    • Stockage de fichiers
    • Services VPN
    • Travailler avec les rapports
  • Export de données

    • Metric Export
    • API Metric Export
    • Migrer vers le Metric Export
    • API de l'ancien export
    • Génération externe de rapports
    • Grafana
    • Tableaux de bord Grafana
    • Vue d'ensemble de l'API
    • Formules MiroxQL (API)
  • Assistance

    • Demander une intégration
  • Reporting

    • Générateur de rapports externe
    • Metric Export pour Excel
  • Accès distant
  • Sécurité du compte
  • L'IA dans Mirox
  • Import de l'historique
  • Rapports
  • Export de données
  • English
  • Deutsch
  • Español
  • Français
  • Português
  • Italiano
  • English
  • Monitoring et visualisation

    • Supervision en temps réel
    • Jumeau numérique
    • États des composants
    • Codes d'état des onduleurs
    • Événements des onduleurs
    • Détection de pertes
    • Limites de puissance et écrêtement
    • Détection d'efficacité (PRRC)
    • Inspecteur de réseau local
    • Surveillance des accès
    • Tableau de bord KPI
    • Visualisation graphique
  • Gestion des données

    • Événements
    • Niveaux d'alarme et événements notifiables
    • Tickets
    • Prévisions
    • Rapports
    • Indicateurs
  • Alert Manager

    • Gestionnaire d'alertes
    • Règles d'alerte
    • Alertes et notifications
    • Exemples
  • Intégration et partage

    • Coopérations
    • Jetons API
    • VPN
    • VPN : conflits d'adresses
    • Proxy (accès web aux appareils de la centrale)
  • IA

    • Assistant IA et assistants guidés
    • Accès agentique (MCP)
  • Facturation

    • Marché et tarifs
    • Comment les revenus sont calculés
    • Comptabilité et facturation
    • Contrats
    • Certificats de prestation et factures
  • Collaboration

    • Invitations
  • Sécurité

    • Authentification
    • Compte temporairement verrouillé
    • Politique de sécurité de l'organisation
    • Système d'autorisations
    • Segmentation réseau
    • Restrictions des autorisations de coopération
    • Journalisation d'audit des accès
    • Activité et piste d'audit
    • Isolation des données

Indicateurs

Sous Indicateurs, votre organisation définit ses propres grandeurs clés. Vous décrivez, dans une courte expression, ce qui doit être mesuré sur un seul intervalle de 15 minutes. La plateforme fait le reste : elle applique votre expression à chaque centrale, sur la période couverte par un rapport, et condense les valeurs 15 minutes en la valeur que vous voulez voir.

Une métrique se définit une seule fois pour toute l'organisation et devient alors disponible sur chaque centrale — vous n'écrivez jamais une métrique « pour une centrale ».

Où les trouver

Les métriques appartiennent à l'organisation ; elles se trouvent donc dans son glossaire, sur la page Export de données : ouvrez Export de données dans la navigation principale et passez à l'onglet Glossaire. Ouvrir dans Mirox — Export de données ▸ Glossaire. Un lien vers une seule métrique ouvre directement son éditeur : https://service.mirox.io/#/export?tab=glossary&metric=<uid>.

La page Rapports n'a plus d'onglet d'indicateurs propre ; les chapitres continuent d'utiliser vos métriques via le sélecteur de données. Les anciens liens vers les indicateurs de la page Rapports fonctionnent toujours et mènent au glossaire.

  • Les rôles d'organisation Admin, Modérateur, Gestionnaire d’actifs (technique) et Gestionnaire d’actifs (commercial) créent, dupliquent, modifient et suppriment les métriques.
  • Tous les membres voient les métriques et peuvent les utiliser dans des rapports.
  • Une métrique marquée Privé n'est modifiée et supprimée que par son créateur, un Admin ou un Modérateur. Tous la voient toujours et l'utilisent dans les rapports et les règles d'alerte, et toute personne autorisée à créer des métriques peut la dupliquer. Voir Privé.

Le tableau indique pour chaque métrique ses types de centrale et où elle est utilisée ; un clic sur une ligne ouvre l'éditeur. Les instructions pas à pas se trouvent dans Travailler avec les rapports.

Définir une métrique

Une métrique se compose de quelques champs descriptifs et d'une à quatre expressions.

Nouvel indicateur crée la métrique immédiatement, et à partir de là chaque modification est enregistrée au fil de la saisie — un indicateur d'état affiche Enregistrement puis Enregistré, sans étape de confirmation séparée. Tant que son expression n'est pas valide, la métrique est marquée Non validé et n'est jamais proposée comme source de données dans un rapport. Dès que l'expression est valide, la mention disparaît et la métrique s'utilise partout — voir Validation.

  • Nom, description, unité — la façon dont la métrique apparaît dans le sélecteur de données du rapport et dans le rapport final.
  • Id — le nom par lequel les modèles et les chapitres désignent la métrique ; voir Id d'un indicateur.
  • Expression — ce qui est mesuré sur un intervalle de 15 minutes. Elle s'écrit en MetricsQL, le langage de requête du magasin de séries temporelles de la plateforme. Vous n'écrivez que la partie relative à l'intervalle : la plateforme ajoute la centrale, la fenêtre temporelle et l'agrégation. Ne nommez jamais une centrale ni une organisation dans l'expression — cela est refusé, car la même métrique doit fonctionner sur toutes les centrales.
  • Agrégation — comment les valeurs 15 minutes deviennent un seul nombre :
    • Moyenne — la moyenne des valeurs d'intervalle
    • Moyenne pondérée — la moyenne dans laquelle chaque intervalle compte avec la valeur d'une autre expression, Pondération par intervalle : Σ(valeur × pondération) ÷ Σ(pondération). La pondération répond pour toute la centrale ou pour le même composant que l'expression.
    • Somme — le total des valeurs d'intervalle
    • Rapport — la part des intervalles attendus pour lesquels l'expression valait 1
    • Dernière valeur — la valeur à la fin de la période
  • Attendu (dénominateur) (facultatif, pour l'agrégation « Rapport ») — une deuxième expression qui détermine quels intervalles comptent, par exemple « il fait jour ». Un intervalle sans attente ne compte pas ; un intervalle attendu sans mesure compte comme non disponible ; une période sans aucun intervalle attendu s'affiche sous forme de tiret.
  • Pondération (facultatif) — une valeur fixe par composant, par exemple sa puissance crête, utilisée pour combiner les valeurs des composants en une valeur de centrale. Sans pondération, tous les composants comptent à parts égales.
  • Restituer comme — la forme sous laquelle la métrique répond. Valeur de la centrale donne un seul nombre par centrale ; si l'expression travaille par composant, ce nombre est la valeur de centrale pondérée décrite ci-dessus. Par composant donne une colonne par onduleur, coffret de raccordement générateur, string ou enregistreur, en plus de la valeur de centrale. Dupliquez une métrique pour disposer de la même grandeur sous les deux formes.
  • Résolution la plus fine — le pas le plus fin auquel un rapport peut restituer la métrique : 15 minutes, horaire ou journalière. Les pas plus larges restent toujours disponibles ; choisissez Jour pour une grandeur qui n'a de sens qu'à la journée.

Un rapport imprime la métrique à la résolution que demande son bloc — 15 minutes, horaire, journalière, mensuelle, ou une valeur unique pour toute la période — et un export au pas que vous choisissez, mais jamais plus fin que la Résolution la plus fine.

Pendant que vous saisissez, l'éditeur valide en direct : syntaxe, séries inconnues (avec des suggestions de ce que vous vouliez probablement écrire), la règle de non-ciblage, la compatibilité des expressions avec l'agrégation choisie, et la taille. Une exécution de test évalue ensuite la métrique sur la centrale choisie sous Évaluer sur, et un aperçu affiche un tableau et un graphique avec chaque onduleur ou composant et la valeur de centrale obtenue pour un mois, un trimestre ou une année de votre choix — une métrique restituée comme valeur de centrale n'affiche que cette seule valeur. Les messages de validation et de test nomment la centrale sur laquelle la vérification a eu lieu.

Validation

Pendant que vous saisissez, l'éditeur vérifie la métrique sur la centrale choisie sous Évaluer sur, en haut de l'éditeur : syntaxe, séries inconnues (avec suggestions), la règle de non-ciblage, la compatibilité des expressions avec l'agrégation, et la taille. Le verdict liste ce qui ne va pas encore et affiche la valeur d'hier sur cette centrale, telle qu'un rapport l'imprimerait.

Tant qu'un problème subsiste, la métrique est marquée Non validé. Elle est tout de même enregistrée, mais aucun rapport, chapitre ou export ne peut la lire, et le sélecteur de données ne la propose pas. Corrigez ce que l'éditeur liste et la mention disparaît d'elle-même. Non validé n'est pas la même chose qu'un Brouillon de rapport — un brouillon de rapport est un rapport terminé qui attend d'être vérifié et publié.

Les avertissements — une série que cette centrale n'a pas livrée, une valeur qui semble invraisemblable — ne bloquent pas la métrique ; ils vous indiquent quoi vérifier.

Une métrique déjà utilisée par des modèles et que vous rendez invalide en la modifiant disparaît de leurs rapports jusqu'à ce qu'elle soit de nouveau valide — gardez un œil sur le compteur Utilisé dans avant des changements importants.

Évaluer sur ne détermine que l'endroit où s'exécutent la vérification, l'échantillon d'hier, l'aperçu, les éléments disponibles et l'assistant. La métrique elle-même n'appartient à aucune centrale : chaque rapport l'évalue sur la centrale pour laquelle il est établi.

Id d'un indicateur

Chaque métrique a un id : lettres minuscules, chiffres et tirets bas, au moins trois caractères, ne commençant pas par un chiffre, et unique au sein de votre organisation. Les modèles et les chapitres désignent une métrique par cet id.

Vous pouvez modifier l'id tant que rien n'utilise la métrique — validée ou non. Dès qu'un modèle ou un chapitre la lit, l'id est figé : le champ est verrouillé, et la ligne en dessous indique où la métrique est utilisée. Si vous avez vraiment besoin d'un nouvel id, retirez d'abord la métrique de ces modèles et chapitres. Si l'id saisi est déjà pris, l'éditeur le signale et propose de remettre l'id enregistré.

Les briques de base

Le panneau latéral de l'éditeur liste tout ce à partir de quoi vous pouvez construire, ce qui vous évite de mémoriser des noms :

  • Séries — les mêmes données que la sélection de données des rapports : injection et production de la centrale, production attendue et séries de référence, rémunération et écrêtement, onduleurs, coffrets, strings, batterie, météo et infrastructure, chacune avec les libellés et les pas qu'elle porte. Vous pouvez chercher par nom et filtrer par niveau ; une marque indique les séries que la centrale courante n'a pas encore livrées — l'indicateur fonctionne malgré tout pour toute l'organisation. Ce qu'un rapport calcule au lieu de lire (performance ratio, nombre d'événements, montants de règlement) figure en bas comme non exprimable, pour que vous le sachiez avant de l'écrire.
  • Valeurs configurées — valeurs issues de la configuration de la centrale, et non des mesures : puissance crête CC d'onduleur, de coffret et de string, puissance crête de la centrale, capacité onduleur de la centrale et nombre de composants. Elles sont insérées dans la requête de chaque centrale à l'exécution, un indicateur utilise donc le nom comme une série constante — par exemple park.inverter.peak_power pour pondérer ou fixer un seuil par onduleur. Sur une centrale où aucun composant n'a la valeur configurée, l'aperçu reste vide ; l'indicateur lui-même fonctionne sur chaque centrale qui en dispose. Deux d'entre elles sont valables par période et non constantes : la valeur applicable effective de la centrale — l'anzulegender Wert pondéré par la capacité des paliers en vigueur à cet instant — et le Marktwert sur lequel la centrale est réglée, mensuel ou annuel selon sa configuration marché, tous deux en EUR/MWh. Elles changent dans le temps et la plateforme insère la valeur en vigueur à chaque pas de 15 minutes, elles n'ont donc pas besoin d'une fenêtre propre. Une prime de marché construite à partir des deux — clamp_min(park.eeg_value - park.marktwert, 0) — est une approximation moyennée pour lire une évolution : le règlement calcule chaque palier au prorata séparément, ce n'est donc jamais le montant réglé.

Valeurs configurées

Les valeurs configurées sont des grandeurs issues de la configuration de la centrale — puissances crête, limite onduleur, nombres de composants et deux valeurs monétaires — que vous pouvez utiliser dans un indicateur. Leurs noms commencent par park. : le nom montre à lui seul que la valeur provient de la configuration de la centrale et non de données mesurées.

NomSignificationUnitéAncien nom
park.inverter.peak_powerPuissance crête CC par onduleurWpowerplant_inverter_peak_power
park.gak.peak_powerPuissance crête CC par coffretWpowerplant_gak_peak_power
park.string.peak_powerPuissance crête CC par stringWpowerplant_string_peak_power
park.peak_powerPuissance crête de la centraleWpowerplant_park_peak_power
park.inverter_limitLimite onduleur de la centraleWpowerplant_park_limit_inverter
park.inverter_countNombre d'onduleursnombrepowerplant_park_inverter_count
park.string_countNombre de stringsnombrepowerplant_park_string_count
park.eeg_valueValeur applicable EEG effective (anzulegender Wert), valable par périodeEUR/MWhpowerplant_park_eeg_value
park.marktwertMarktwert sur lequel la centrale est réglée, valable par périodeEUR/MWhmarket_marktwert
  • Lues dans la configuration, pas stockées. Les valeurs configurées ne sont pas conservées sous forme de séries temporelles. À chaque calcul d'un indicateur, Mirox les lit dans la configuration de la centrale et les insère dans la requête de cette centrale. La valeur est donc toujours celle configurée à l'instant : corrigez une puissance crête, et chaque période calculée ensuite — périodes passées comprises — utilise la valeur corrigée.
  • Calculées par Mirox. Un indicateur qui utilise une valeur configurée est disponible dans les rapports, dans l'export de données (onglet Métriques, CSV et JSON) et via l'API d'export. Il n'est pas disponible par un accès direct à la base de séries temporelles — par exemple dans vos propres tableaux de bord Grafana ou tout autre outil qui interroge la base elle-même : les noms park. n'y existent pas. Il en va de même pour la valeur de centrale d'un indicateur par composant pondéré par une valeur configurée — par exemple des onduleurs pondérés par leur puissance crête —, car Mirox calcule cette agrégation après avoir lu les valeurs des composants. Dans l'export de données, ces indicateurs portent un petit badge config ; survolez-le pour une courte explication.
  • Pondération par la puissance crête. Avec une puissance crête comme Pondération (par exemple park.inverter.peak_power), chaque composant compte en proportion de sa puissance crête configurée. Un composant sans puissance crête saisie ne compte presque pas ; si aucun composant n'en a, tous comptent à parts égales. Les composants masqués n'ont pas de valeur configurée et ne comptent pas.
  • Les anciens noms restent valables. Les indicateurs enregistrés avec les anciens noms fonctionnent sans changement. Les nouveaux indicateurs, les briques de l'éditeur et l'assistant utilisent les noms park..
  • Série choisie par un paramètre de la centrale. Certains indicateurs lisent une série présente dans la base de séries temporelles, mais laquelle dépend des paramètres de la centrale : les indicateurs d'écrêtement réglé marqués (méthode du parc) lisent la série de la méthode de règlement configurée pour chaque centrale (Spitz, Spitz light ou Pauschal ; pour un parc éolien, les méthodes éoliennes). Leur requête dans l'export de données affiche powerplant_<method>_… avec la méthode laissée ouverte et, après un aperçu, l'infobulle indique la méthode de chaque centrale. Avec plusieurs centrales, chacune compte avec sa propre méthode. En accès direct à la base de séries temporelles, vous choisissez vous-même la méthode de chaque centrale ; pour lire une méthode précise indépendamment des paramètres, choisissez l'indicateur propre à cette méthode. Dans l'export de données, ces indicateurs portent aussi le badge config.

Exemples fournis

La table Indicateurs contient déjà cinq métriques que Mirox livre à chaque organisation : Connectivité, Disponibilité de l'enregistreur, Disponibilité de l'onduleur en journée, Heures d'ensoleillement et Disponibilité des données d'injection. Elles portent un cadenas et la mention Exemple : elles n'appartiennent à aucune organisation et ne peuvent donc être ni modifiées ni supprimées.

Ce que vous pouvez en faire :

  • Ouvrir un exemple et lire ses expressions. Ce sont des cas résolus de tout ce qui précède : le filtre de lumière du jour, les deux formes de l'agrégation « Rapport », l'identification par composant et une mise à l'échelle de l'unité.
  • Cliquer sur Calculer l'aperçu sur la centrale où vous vous trouvez, pour voir les différentes séries et la valeur de centrale qui en résulte.
  • Dupliquer un exemple. La copie appartient à votre organisation, se modifie librement et constitue le point de départ habituel d'une métrique à vous.

Les exemples sont volontairement la version simple et lisible de chaque question, et chaque description précise ce qu'elle ne prend pas en compte. Les valeurs de disponibilité propres au rapport — qui s'appuient sur le parc d'enregistreurs configuré de la centrale et sur ses méthodes de règlement — restent là où elles étaient, sous Disponibilité dans le sélecteur de données du rapport. C'est pourquoi les exemples eux-mêmes n'y sont pas proposés ; une copie, si.

Écrire des expressions (MetricsQL)

Une expression s'écrit en MetricsQL, le langage de requête du magasin de séries temporelles de la plateforme — le même langage avec lequel sont lues les métriques brutes derrière Grafana. Elle est évaluée sur des créneaux de 15 minutes pour une centrale à la fois : la plateforme limite chaque série à la centrale elle-même, une expression ne nomme donc jamais une centrale, un portefeuille ou une organisation. Partez des briques que l'éditeur propose (les séries avec leurs labels, les valeurs configurées de la centrale, les modèles), laissez la validation en direct vous dire ce qui manque et prévisualisez contre une centrale avant d'enregistrer. MetricsQL est la plus puissante des deux façons de définir un indicateur : voies par composant, filtrage sur la lumière du jour, ratios et agrégations s'expriment ici — les métriques succèdent aux formules MiroxQL, les colonnes calculées de l'ancien export, qui ne se modifient plus dans l'application. La référence du langage est la documentation MetricsQL publique de l'éditeur du magasin ; les fonctions et limites acceptées par l'éditeur figurent dans ses briques. Pendant la saisie, l'éditeur propose des noms de séries, des labels et des fonctions ; Tab accepte la proposition.

S'appuyer sur d'autres métriques

Une expression peut utiliser une autre métrique au lieu de la répéter :

  • metric("<metric id>") — une autre métrique de votre organisation, par son id ;
  • series("<series id>") — une série de la plateforme sous la forme de sa valeur 15 minutes pour la centrale, ou series("<series id>", "inverter") pour une valeur par onduleur (de même gak, string, …).

Une référence représente la valeur 15 minutes de l'autre métrique, avant l'agrégation : metric("yield") / metric("expected_yield") divise les deux valeurs de chaque intervalle, puis l'agrégation de cette métrique s'applique. Une métrique référencée peut elle-même utiliser des références, jusqu'à huit niveaux de profondeur ; une métrique qui finit par se référencer elle-même est refusée. Lorsqu'une métrique référencée change, toutes les métriques construites dessus suivent.

Limites

  • Une expression peut compter jusqu'à 4 000 caractères ; une fois la centrale ajoutée par la plateforme, le magasin refuse toute requête dépassant 16 Ko.
  • Une métrique peut renvoyer au maximum 500 séries sur une même centrale.
  • L'exécution de test sur une journée doit se terminer en 5 secondes.
  • Rien ne peut être mesuré plus finement que 15 minutes.

Si une métrique atteint l'une de ces limites, l'éditeur vous le signale pendant la saisie, et la métrique reste Non validé tant que ce n'est pas corrigé.

Un exemple complet

Disponibilité des onduleurs (2 % de la crête CC) — la part des intervalles de jour pendant lesquels un onduleur a produit au moins 2 % de sa puissance crête CC, pondérée par la puissance crête, exprimée en pourcentage avec l'agrégation Rapport.

Expression :

max by (inverter_id) (max_over_time(powerplant_inverter_power_ac[900s])) > bool on(inverter_id) 0.02 * park.inverter.peak_power

Attendu (quels intervalles comptent — la lumière est suffisante) :

(avg(avg_over_time(powerplant_pyranometer_radiation_power{segment_id!~".+"}[900s])) or avg(avg_over_time(powerplant_weather_radiation_power{segment_id!~".+"}[900s]))) > bool 100

Pondération (pour que les gros onduleurs pèsent davantage dans la valeur de centrale) :

park.inverter.peak_power

Créer une métrique avec l'assistant

Vous n'êtes pas obligé d'écrire vous-même du MetricsQL. L'assistant se trouve dans l'éditeur de métriques : ouvrez Nouvel indicateur — ou n'importe quelle métrique que vous avez le droit de modifier — et il apparaît comme volet de conversation en haut à droite. Il reste muet tant que vous ne lui écrivez pas ; rien n'est envoyé avant.

Décrivez la grandeur voulue avec vos propres mots. L'assistant connaît déjà la centrale choisie sous Évaluer sur, ce que vous avez saisi jusque-là (nom, expression, agrégation…), le résultat de la dernière validation et les séries que cette centrale écrit réellement : il n'a donc presque jamais besoin de poser les questions de base. Il propose l'expression, un nom et une description, les valide et en affiche un aperçu sur la centrale, et vous avertit lorsque la plateforme ne dispose pas des données demandées ou lorsque la requête serait trop lourde.

La proposition est reportée dans les champs dès qu'elle arrive : l'assistant édite avec vous et chaque modification est enregistrée au passage. Si vous préférez garder ce que vous aviez, Annuler sur la proposition dans le chat remet les champs dans l'état précédent ; la proposition reste dans le chat et peut être appliquée à nouveau. L'assistant va au bout tout seul : la proposition est enregistrée sur la métrique au moment où elle est faite, vous pouvez donc envoyer votre demande, fermer la page et retrouver la métrique terminée dans la liste à votre retour. Ensuite, tout se passe comme une saisie ordinaire : vous modifiez un champ, relancez l'aperçu ou demandez autre chose.

La conversation appartient à la métrique, pas à l'onglet du navigateur. Fermez l'éditeur et rouvrez la métrique, ou rechargez la page : le même échange est toujours là, à côté des champs qu'il a écrits.

La conversation de l'éditeur n'accepte que du texte. Les photos et les documents — la page de formule d'un contrat, par exemple — restent une fonctionnalité de la page de chat complète ; Ouvrir dans la discussion y transporte l'échange.

Utiliser une métrique dans un rapport

Dans l'éditeur de rapport ou l'éditeur de chapitre, choisissez les données d'un bloc : vos métriques figurent dans le sélecteur de données aux côtés des éléments de la plateforme, marquées indicateur propre, et se comportent exactement comme eux : mêmes résolutions, mêmes tableaux et graphiques. Comme une métrique vaut pour toute l'organisation, le même bloc fonctionne tel quel dans un rapport de toute centrale qui possède les types de centrale de la métrique. Une métrique marquée Non validé n'est pas proposée.

Utiliser une métrique dans une règle d'alerte

Une métrique validée peut être surveillée par une règle d'alerte du Gestionnaire d'alertes : la règle juge sa valeur toutes les cinq minutes sur chaque centrale et déclenche une alerte lorsqu'elle franchit votre seuil. Vos métriques apparaissent dans l'éditeur de règles sous Vos métriques.

Exporter un indicateur

Une métrique validée fait partie de la collection d'indicateurs. Elle s'exporte sous forme de série temporelle comme chaque indicateur fourni par Mirox, pour toute centrale que vous pouvez lire et sur n'importe quelle période.

Ouvrir dans Mirox

Export de données ▸ Métriques — cliquez sur Ajouter des indicateurs. Les métriques de votre organisation sont regroupées sous Mes indicateurs.

Ce que vous réglez sur la métrique décide de la façon dont elle est exportée :

Réglage de la métriqueDans l'export
Résolution la plus fineLe pas le plus fin. Une métrique réglée sur 15 minutes propose 15 min, 1 h, jour, semaine, mois, trimestre et année ; une métrique réglée sur Jour commence au jour. Une métrique n'est jamais exportée plus finement que 15 minutes.
Restituer comme ▸ Valeur de la centraleUne colonne par centrale.
Restituer comme ▸ Par composantUne colonne par composant — onduleur, boîte de jonction, string, éolienne, conteneur de batterie, etc. — comme les indicateurs par composant fournis par Mirox.
Agrégation ▸ Somme avec une unité d'énergie (Wh, kWh, MWh)Une énergie : exportée Par intervalle ou en Cumul.
Agrégation ▸ Somme avec une autre unitéUne grandeur comptée : exportée Tel que mesuré ou en Cumul.
Agrégation ▸ Moyenne, Rapport, Moyenne pondérée, Dernière valeurExportée Tel que mesuré.

Lorsque plusieurs centrales sont regroupées en une colonne, une Somme est additionnée sur les centrales, une Moyenne est moyennée (une puissance en W, var ou VA est additionnée), et un Rapport ou une Moyenne pondérée est recalculé à partir des totaux des centrales. Une Dernière valeur ne peut pas être regroupée et est affichée par centrale.

Trois points à connaître :

  • Non validé signifie non exportable. Le sélecteur affiche la métrique avec la mention Brouillon — validez-le d’abord dans Mes indicateurs, et un lien d'export qui la nomme est refusé.
  • Les montants exigent l'accès à la comptabilité. Une métrique qui lit la valeur applicable EEG ou la Marktwert est un indicateur de montant. Sa colonne reste vide pour les centrales sur lesquelles vous n'avez pas l'accès à la comptabilité.
  • L'identifiant dans un lien est organization. suivi de l'id de l'indicateur, par exemple organization.inverter_availability_2pct.

Le chemin inverse fonctionne aussi : Créer un indicateur, dans l'onglet Métriques de la page Export de données, ouvre cet éditeur sans quitter l'Export de données, et Retour à l'export de données, en haut de l'éditeur, vous ramène à l'export avec les centrales, les indicateurs et la période que vous aviez. Ouvert depuis le glossaire, le bouton s'intitule Retour au glossaire. Pour une grandeur dont vous avez besoin une seule fois, sans nom ni unité, la page d'export accepte aussi une requête MetricsQL brute ; un indicateur est le bon choix dès qu'une grandeur est réutilisée ou employée dans un rapport.

Les instructions pas à pas se trouvent dans Metric Export ; les paramètres des liens sont décrits dans l'API Metric Export.

Où un indicateur est utilisé

La colonne Utilisé dans du tableau des indicateurs compte les modèles et les chapitres qui lisent une métrique — par exemple « 2 modèles · 1 chapitre ». Un clic sur le nombre les affiche par leur nom, chacun avec un lien Ouvrir : un modèle s'ouvre dans l'éditeur de rapport, un chapitre dans l'éditeur de chapitre. Un modèle compte qu'il lise la métrique dans un chapitre qui lui est propre ou au travers d'un chapitre de bibliothèque. Les modèles d'export qui portent la métrique comme colonne comptent eux aussi comme une utilisation.

Tant qu'une métrique est utilisée :

  • elle ne peut pas être supprimée — la boîte de dialogue de suppression liste les modèles et chapitres au lieu de proposer Supprimer ; retirez d'abord la métrique de chacun d'eux, ainsi que des modèles d'export qui la portent ;
  • son id ne peut pas changer — voir Id d'un indicateur ;
  • une modification de son expression apparaît dans chaque rapport généré ensuite à partir de ces modèles. Les rapports générés auparavant conservent leurs chiffres.

Une métrique sur laquelle une autre métrique s'appuie ou qu'une règle d'alerte surveille ne peut pas non plus être supprimée ; le message les nomme.

Une métrique que personne n'utilise peut être supprimée depuis le tableau ou depuis l'éditeur ; les rapports générés auparavant conservent leurs chiffres. Les exemples fournis ne peuvent pas être supprimés.

Types de centrale

Une métrique s'applique aux types de centrale des séries qu'elle lit. Mirox le déduit — vous ne le définissez jamais :

  • séries d'éoliennes et autres séries éoliennes → Éolien
  • séries de batterie → Batterie
  • séries d'onduleurs, de strings, de coffrets et autres séries PV → Solaire
  • séries dont dispose toute centrale, comme le compteur d'injection, la météo ou les prix de marché → Tous les types de centrale

Une métrique qui lit des séries de plusieurs types s'applique à chacun d'eux. L'éditeur affiche le résultat à côté du verdict (S’applique à), et le tableau des indicateurs comporte une colonne Types de centrale. Un chapitre qui utilise la métrique en reprend les types de centrale ; il n'apparaît donc que dans les rapports des centrales qui en possèdent au moins un — voir Types de centrale. Si la centrale choisie sous Évaluer sur ne possède aucun des types de la métrique, l'éditeur le signale : la métrique n'y répond rien, choisissez donc une autre centrale pour la vérifier.

Ce qui ne peut pas être défini

Certaines grandeurs sont calculées par la plateforme elle-même et doivent être reprises des éléments existants plutôt que reconstruites :

  • Performance ratio et production attendue — utilisez les éléments calculés par la plateforme, également disponibles comme briques de base.
  • Règlement des écrêtements — il découle de votre configuration marché et tarifs.
  • Puissance nominale CA par onduleur — elle n'est pas stockée par onduleur et ne peut donc pas être référencée.

Pages associées

  • Rapports — là où les indicateurs sont utilisés
  • Gestionnaire d'alertes — des règles d'alerte sur vos métriques
  • Travailler avec les rapports — guide pas à pas, y compris la création d'un indicateur
  • FAQ sur les rapports — pourquoi un indicateur ne peut pas être supprimé ou renommé, et plus encore
  • Metric Export — exporter les indicateurs sous forme de séries temporelles
  • API Metric Export — les paramètres des liens d'export
  • Formules MiroxQL — les colonnes calculées de l'ancien export
  • Assistant IA et assistants — l'assistant qui travaille aussi dans l'éditeur de métriques
  • Permissions des membres — qui peut créer des métriques d'organisation
Prev
Rapports
© 2026 Mirox Verwaltungs GmbH. Tous droits réservés. | Politique de confidentialité