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

Ouvrez la page Rapports de n'importe quelle centrale et passez au troisième onglet, Indicateurs. La liste qui s'affiche appartient à votre organisation ; la centrale n'est que l'endroit où vous la consultez et où vous effectuez vos tests.

  • Les administrateurs de l'organisation créent, modifient et suppriment les métriques.
  • Tous les membres voient les métriques et peuvent les utiliser dans des rapports.

Définir une métrique

Une métrique se compose de quelques champs descriptifs et d'une à trois 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 reste un Brouillon : la table la signale par la mention Brouillon, et un brouillon n'est jamais proposé 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.

  • 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.
  • 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 la condensation. 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.
  • Condensation — comment les valeurs 15 minutes deviennent un seul nombre :
    • moyenne — la moyenne des valeurs d'intervalle
    • somme — le total des valeurs d'intervalle
    • proportion — la part des intervalles attendus pour lesquels l'expression valait 1
    • dernière valeur — la valeur à la fin de la période
  • Attendu (facultatif, pour la condensation « proportion ») — 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 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.

Vous choisissez également la résolution de restitution de la métrique : 15 minutes, horaire, journalière, mensuelle, ou une valeur unique pour toute la période.

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 la condensation choisie, et la taille. Une exécution de test évalue ensuite la métrique sur la centrale courante, 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.

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.
  • Données 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 powerplant_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(powerplant_park_eeg_value - market_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é.

Exemples fournis

La table Indicateurs contient déjà cinq métriques que Mirox livre à chaque organisation : Connectivité, Disponibilité de l'enregistreur, Disponibilité des onduleurs en journée, Heures de soleil 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 la condensation « proportion », l'identification par composant et une mise à l'échelle de l'unité.
  • Lancer 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.

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 un brouillon 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 la condensation proportion.

Expression :

max by (inverter_id) (max_over_time(powerplant_inverter_power_ac[900s])) > bool on(inverter_id) 0.02 * powerplant_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) :

powerplant_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 sur laquelle vous êtes, ce que vous avez saisi jusque-là (nom, expression, condensation…), 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 le chat y transporte l'échange.

Utiliser une métrique dans un rapport

Dans l'éditeur de rapports, ouvrez le sélecteur de données d'un bloc et choisissez le niveau Métriques de l'organisation. Vos métriques y figurent aux côtés des éléments de la plateforme 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 n'importe quelle centrale.

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