Metric Export

La page Export de données exporte n'importe quel indicateur de vos centrales sous forme de série temporelle : de l'injection d'un portefeuille entier jusqu'à un seul capteur d'irradiance, une seule éolienne ou une seule cellule de batterie. Vous choisissez les centrales, les indicateurs, la période et le pas, vous vérifiez l'aperçu, puis vous téléchargez un fichier CSV. Chaque export est aussi un lien que vous pouvez confier à Excel ou à un script.

Ce guide couvre la page elle-même. Les paramètres derrière chaque lien d'export sont décrits dans l'API Metric Export.

Une seule collection d'indicateurs

L'export et les rapports lisent la même collection d'indicateurs. Un indicateur a un seul nom, une seule unité et une seule définition, où que vous le rencontriez : dans le sélecteur de données du rapport, dans un rapport terminé et dans un fichier exporté.

La collection contient :

• les indicateurs fournis par Mirox, classés par niveau — centrale, onduleur, boîte de jonction, string, batterie, éolienne, capteur, compteur, météo, marché et d'autres encore. Les niveaux sont listés sous Indicateurs disponibles ;
• les indicateurs que votre organisation a définis elle-même sous Indicateurs. Dans le sélecteur, ils sont regroupés sous Mes indicateurs.

Un indicateur marqué Non validé sous Mes indicateurs ne peut pas être exporté tant que son expression n'est pas validée.

Les trois onglets

Exporter des indicateurs

1. Choisir les centrales

Sous Centrales, ouvrez la liste des centrales et cochez une ou plusieurs centrales ; la liste des portefeuilles à côté ajoute des portefeuilles entiers. Ce sont les mêmes listes que dans la navigation de gauche : chaque ligne porte le type de la centrale — solaire, éolien ou batterie — et votre choix apparaît sous forme de puces dans le champ. Centrales et portefeuilles se combinent ; une centrale qui figure aussi dans un portefeuille choisi n'est exportée qu'une fois. Un fichier peut contenir au plus 50 centrales. Avec plus d'une centrale, vous choisissez aussi si les centrales sont regroupées en une colonne par indicateur ou affichées côte à côte — voir Plusieurs centrales. Des centrales dans des fuseaux horaires différents mettent le fichier en UTC — voir Heure locale de la centrale et UTC.

2. Ajouter des indicateurs

Sous Indicateurs, tapez dans le champ de recherche ce que vous cherchez — un nom, un mot de la description, un composant ou une unité, par exemple onduleur dc. Chaque mot tapé doit se trouver quelque part dans un indicateur : dans son nom, son identifiant, les identifiants de l'export précédent, son unité, son niveau ou sa description. Les meilleures correspondances viennent en premier : un indicateur dont le nom commence par vos mots avant un autre qui ne les mentionne que dans sa description. Entrée ajoute la première correspondance, les flèches déplacent le choix, et Parcourir toutes les métriques ouvre toute la collection par niveau, avec la même recherche. energy_grid_daily trouve Injection réseau : un identifiant tiré d'un ancien lien fonctionne donc aussi.

Chaque ligne indique ce que l'indicateur mesure et à quels pas il peut être lu. Une ligne que vous ne pouvez pas choisir en donne la raison :

Un export contient au plus 20 indicateurs. Les indicateurs choisis sont listés sous la recherche, dans l'ordre des colonnes ; faites glisser une ligne pour le changer. Explications, au-dessus de la liste, ouvre une description de chaque indicateur choisi : unité, fréquence de mesure, pas et valeurs proposés, et façon dont plusieurs centrales sont regroupées. Télécharger le glossaire (CSV) vous y fournit toute la collection sous forme de fichier.

Si la collection n'a pas d'indicateur pour ce dont vous avez besoin, Créer un indicateur ouvre l'éditeur d'indicateurs de la page Rapports ; Retour à l'export de données, en haut de l'éditeur, vous ramène avec les centrales, les indicateurs et la période que vous aviez. Pour une lecture ponctuelle de la base de séries temporelles, ajoutez plutôt une requête MetricsQL.

3. Choisir des composants

Un indicateur d'un niveau de composant — onduleur, boîte de jonction, string, éolienne, capteur, compteur, conteneur de batterie, rack, module, cellule ou convertisseur — exporte une colonne par composant. Sans sélection, vous obtenez tous les composants de la centrale, 50 par page. Pour restreindre l'export, ouvrez le bouton des composants sur l'indicateur et choisissez ceux dont vous avez besoin, jusqu'à 100.

C'est ainsi que vous exportez chaque capteur d'irradiance séparément, sans moyenne : ajoutez Éclairement par capteur et laissez la sélection de composants vide.

Les composants masqués sont laissés de côté. Afficher les masqués, dans la boîte de dialogue des composants, les liste pour que vous puissiez en choisir un délibérément.

4. Définir la période

Sous Période et pas, choisissez une période prédéfinie ou fixez vous-même le début et la fin. Les périodes prédéfinies sont Aujourd’hui, Hier, 7 derniers jours, 30 derniers jours, Cette semaine, Semaine précédente, Ce mois-ci, Mois précédent, Ce trimestre, Trimestre précédent, Cette année et Année précédente. Sans choix, l'export couvre le mois précédent.

Une période peut commencer au plus tôt en 2020 et couvrir au plus cinq ans. Une période qui s'étend dans le futur se termine maintenant.

5. Choisir le pas

Le pas est la durée d'une ligne : 1 min, 5 min, 15 min, 1 h, jour, semaine, mois, trimestre ou année. Laissé sur automatique, Mirox choisit un pas que chaque indicateur choisi propose et qui convient à la période : 15 minutes jusqu'à deux jours, une heure jusqu'à deux mois, un jour jusqu'à trois ans, un mois au-delà.

Tous les indicateurs ne peuvent pas être lus à tous les pas — voir Les pas et leurs limites. Un indicateur qui ne propose pas le pas choisi est tout de même exporté, à son propre pas — voir Indicateurs à pas différents. Seul un pas auquel un indicateur ne pourrait avoir aucune ligne est grisé et nomme cet indicateur.

6. Choisir les valeurs

Pour une énergie ou une autre grandeur comptée, choisissez sous Valeurs si chaque ligne affiche la quantité Par intervalle ou le Cumul depuis le début de la période. Tous les autres indicateurs sont exportés Tel que mesuré, et la liste indique comment chaque ligne est formée — voir Valeurs.

7. Choisir le fuseau horaire

Heure locale de la centrale est la valeur par défaut ; UTC est l'alternative. Voir Heure locale de la centrale et UTC.

8. Vérifier l'aperçu et télécharger

L'Aperçu montre l'export sous forme de graphique ou de tableau. Sous la période, une ligne en indique la taille : lignes, colonnes, taille approximative du fichier et durée. Les remarques sous l'aperçu vous disent ce que Mirox a fait de lui-même, par exemple qu'une période a été élargie à des jours entiers.

Dans le graphique :

• L'œil au début de chaque ligne d'indicateur ou de requête masque sa série dans le graphique et le tableau, et l'affiche de nouveau. Une série masquée reste dans le téléchargement et dans le lien ; le réglage fait partie de l'adresse de la page, un lien partagé montre donc la même vue.
• Un clic sur un nom dans la légende fait la même chose ; Maj+clic n'affiche que cette série. Légende et œils sont toujours d'accord.
• Faites glisser sur le graphique pour zoomer sur une plage ; un double-clic dézoome. Le zoom ne change que la vue.
• L'infobulle liste jusqu'à dix séries, la plus grande valeur d'abord, et dit combien d'autres il y a.
• Une longue période à un pas fin a plus de points qu'un navigateur ne peut en dessiner. Le graphique affiche alors une résolution plus grossière et le dit dans une remarque orange — Le graphique affiche la résolution 1 h pour rester lisible ; le tableau et l'export gardent 1 min — ou, quand aucun pas plus grossier n'est proposé, regroupe plusieurs lignes en un point. Le tableau, le téléchargement et le lien gardent toujours le pas que vous avez choisi.

Sous Options d'export, choisissez le séparateur CSV, le séparateur décimal, le format d'horodatage, la langue des noms de colonne et les En-têtes de colonne : Noms (pour les personnes) ou Identifiants (pour les scripts). Le format d'horodatage change aussi les dates du tableau, l'aperçu montre donc ce que le fichier contiendra. Ensuite :

• Télécharger le CSV enregistre le fichier.
• Copier l'URL de l'API copie le même export sous forme de lien. Essayer prépare un jeton d'API et fournit des commandes prêtes à l'emploi pour le terminal et pour Python.
• Enregistrer comme modèle conserve la sélection comme modèle.

Requêtes MetricsQL

À côté des indicateurs de la collection, l'onglet Métriques accepte des requêtes brutes en MetricsQL, le langage de requête de la base de séries temporelles de la plateforme — le langage qu'utilisent les indicateurs de votre organisation et Grafana. Une requête sert à ce pour quoi la collection n'a pas d'indicateur : une série que la base contient, une combinaison de séries, une fonction sur celles-ci.

1. Cliquez sur MetricsQL sous les indicateurs pour ouvrir le champ de requête.
2. Tapez la requête, par exemple sum by (inverter_id) (powerplant_inverter_power_ac). Pendant la saisie, le champ propose des noms de séries, des labels et des fonctions ; Tab accepte la proposition. Entrée exécute la requête et l'ajoute comme ligne ; Maj+Entrée commence une nouvelle ligne dans la requête.
3. La ligne montre le texte de la requête sur un fond de code et la puce MetricsQL là où un indicateur montre son unité. Les colonnes de la ligne sont une par série que la requête renvoie, telle que mesurée. Le crayon transforme le texte en éditeur sur place : Entrée enregistre, Échap annule. Rien d'autre ne change dans la ligne.

Ce qu'une requête fait et ne fait pas :

• Mirox ajoute la centrale choisie à chaque sélecteur de la requête, la requête ne nomme donc jamais une centrale, un parc ou une organisation. Une requête qui porte un tel label est refusée, et le label est nommé.
• Une requête est lue au pas que vous avez choisi — n'importe quel pas, de 1 min à l'année — comme un tableau de bord la lirait : des échantillons bruts à ce pas, sans mode de valeur ni regroupement. Par intervalle et Cumul ne s'y appliquent pas.
• Avec plusieurs centrales, chaque centrale reçoit ses propres colonnes. Les requêtes ne sont jamais regroupées entre centrales.
• Une requête peut renvoyer au plus 500 séries sur une centrale ; agrégez-la, avec sum by (…) par exemple, si elle en renvoie davantage. Un export contient au plus 5 requêtes de 4 000 caractères chacune au maximum, et les séries qu'elles renvoient comptent dans les limites de taille comme toute autre colonne.
• Dans le fichier, la colonne a pour en-tête MetricsQL suivi de la requête et, quand la requête renvoie plusieurs séries, des labels de chaque série : MetricsQL sum by (inverter_id) (powerplant_inverter_power_ac) {inverter_id="INV1"}. Avec Identifiants (pour les scripts), l'en-tête est expr1, expr2, … avec les mêmes labels. Un fichier avec des requêtes se distingue donc d'un export ordinaire dès sa première ligne.
• Une requête n'est pas enregistrée dans un modèle. Retirez les requêtes pour enregistrer les indicateurs comme modèle, ou définissez la grandeur une fois pour toutes comme indicateur de votre organisation : elle est alors validée, a un nom et une unité, et est aussi proposée aux rapports.

Les pas et leurs limites

Les pas qu'un indicateur propose dépendent de ce qu'il est et de sa fréquence de mesure :

Un indicateur n'est jamais proposé plus finement qu'il n'est mesuré : une éolienne qui remonte ses données toutes les 10 minutes n'a pas de valeurs à 1 minute.

Le pas limite aussi la période, car une colonne contient au plus 180 000 valeurs :

Les pas d'un jour ou plus couvrent toujours des jours, semaines, mois, trimestres ou années entiers. Une période qui commence ou se termine à l'intérieur de l'un d'eux est élargie à l'intervalle entier, et une remarque le signale. Les semaines commencent le lundi.

Indicateurs à pas différents

Tous les indicateurs ne proposent pas tous les pas, et certains n'en proposent que de grossiers : le ratio de performance commence au jour, une valeur de marché existe une fois par mois. L'onglet Métriques les réunit tout de même dans un seul fichier :

• Un indicateur au pas plus grossier que le fichier garde son propre pas. Sa valeur se trouve sur la première ligne de chacun de ses intervalles — la valeur d'un jour sur la ligne de son minuit, celle d'un mois sur la ligne de son premier jour — et les lignes intermédiaires restent vides. Le graphique dessine un tel indicateur sous forme de points. Une remarque orange au-dessus de l'aperçu nomme ces indicateurs avec leurs pas et propose Exporter séparément : un lien par pas, chaque indicateur à sa propre résolution.
• Un indicateur qui ne propose que des pas plus fins est lu au plus grossier d'entre eux et regroupé au pas du fichier selon la règle de sa grandeur : une énergie s'additionne, une mesure se moyenne, un ratio se recalcule à partir de ses deux moitiés, un état garde son dernier code. Une remarque sous l'aperçu le signale.
• Deux cas restent refusés : une valeur par mois, trimestre ou année n'a pas de ligne dans un fichier par semaine, et une valeur mensuelle comme le Marktwert n'est jamais additionnée ni moyennée en un trimestre ou une année, car ce ne serait pas cette valeur. Un tel pas reste grisé et nomme l'indicateur.

Un modèle en décide lui-même avec Métriques d'un autre pas : Souple se comporte comme l'onglet Métriques, Strict refuse un lien qui nomme un pas que l'une de ses colonnes ne propose pas. Un modèle enregistré depuis l'onglet Métriques ou créé à neuf est souple ; les modèles antérieurs à ce réglage sont stricts. Un lien d'export écrit à la main est strict sauf indication contraire — voir le paramètre mismatch.

Valeurs : par intervalle, cumul, tel que mesuré

Par intervalle n'est proposé que pour l'énergie. Une puissance, une température ou un ratio n'ont pas de « quantité par intervalle » ; ils sont donc toujours exportés tels que mesurés.

L'avertissement en dessous de 15 minutes

Un compteur compte l'énergie par paliers entiers, souvent 1 kWh. En une minute, une centrale produit rarement un palier entier : une énergie par intervalle à 1 ou 5 minutes saute donc entre zéro et un palier au lieu de dessiner une courbe. Mirox vous avertit lorsque vous combinez les deux et propose trois issues :

• Passer à l'indicateur de puissance correspondant, lorsque la collection en a un. La puissance est la bonne grandeur pour une courbe fine.
• Utiliser 15 min, le pas le plus fin auquel une énergie par intervalle se lit bien.
• Conserver, si ce sont les paliers du compteur que vous voulez voir.

Heure locale de la centrale et UTC

Les lignes suivent l'heure locale de la centrale, heure d'été comprise. Un jour est un jour local : il compte donc 23 ou 25 heures lors du changement d'heure, et un mois est un mois local.

• Aux pas inférieurs à un jour, une colonne Décalage UTC se trouve à côté de l'heure. Le jour du passage à l'heure d'hiver, l'heure entre 02:00 et 03:00 apparaît deux fois ; le décalage permet de les distinguer.
• UTC comme fuseau horaire place toutes les lignes sur le calendrier UTC. Utilisez-le lorsque le fichier est destiné à un système qui attend de l'UTC.
• Des centrales situées dans des fuseaux horaires différents partagent une seule colonne de temps ; un tel export est donc toujours en UTC. Le choix du fuseau horaire est alors verrouillé et en indique la raison.

Plusieurs centrales : regroupées ou par centrale

Avec plus d'une centrale, vous choisissez entre une colonne par indicateur pour toutes les centrales ensemble et une colonne par centrale.

Regroupé, chaque indicateur suit sa propre règle :

Les indicateurs par composant sont toujours affichés par centrale. Une remarque sous l'aperçu nomme chaque indicateur affiché par centrale au lieu d'être regroupé.

Modèles

Un modèle est une liste d'indicateurs enregistrée, avec ses propres valeurs par défaut : pas, période, valeurs, fuseau horaire, regroupé ou par centrale, et en-têtes de colonne. Chaque colonne peut porter son propre texte d'en-tête : le fichier conserve ainsi ses en-têtes même lorsqu'un indicateur est renommé plus tard.

Modèles système

Mirox fournit huit modèles, marqués Système. Ils ne peuvent être ni modifiés ni supprimés.

Les cinq premiers succèdent aux modèles de l'export précédent. Leurs identifiants et leurs colonnes sont listés dans le guide de migration.

Vos propres modèles

Enregistrer comme modèle dans l'onglet Métriques, ou Créer le modèle dans l'onglet Modèles, enregistre votre sélection pour toute l'organisation. Un modèle contient jusqu'à 40 indicateurs et aucune requête MetricsQL. Ouvrir dans Métriques charge un modèle dans l'onglet Métriques. Métriques d'un autre pas décide ce qu'un lien du modèle fait d'une colonne qui ne propose pas le pas demandé — voir Indicateurs à pas différents.

Les modèles sont créés, modifiés, convertis et supprimés par le rôle d'organisation Admin. Tous les membres de l'organisation peuvent les utiliser.

Un indicateur de votre organisation utilisé par un modèle ne peut être ni supprimé ni doté d'un nouvel identifiant. Si un indicateur d'un modèle n'est plus disponible — parce qu'il est retombé à Non validé, par exemple — sa colonne reste dans le fichier, vide, de sorte que la position des autres colonnes ne change pas.

Anciens modèles et conversion

Un modèle créé avant le Metric Export est marqué Ancien. Il repose sur l'ancien jeu d'indicateurs, et son lien continue de fonctionner sans changement. Les nouveaux modèles reposent toujours sur la collection d'indicateurs.

Convertir en nouveau modèle crée un nouveau modèle à partir d'un ancien. L'ancien modèle n'est jamais modifié : les fichiers et les liens qui l'utilisent restent donc tels quels.

1. Mirox montre quelles colonnes ont un équivalent, si les chiffres sont les mêmes (Exact) ou s'il s'agit de la même grandeur lue d'une meilleure façon (Approché), et quelles colonnes n'ont pas d'équivalent.
2. Vous donnez un nom au nouveau modèle et confirmez.
3. Les deux liens sont affichés. Excel continue d'utiliser l'ancien lien jusqu'à ce que vous le remplaciez.

Un modèle converti exporte des jours, comme sa source. Une colonne dont l'indicateur n'a pas de valeur journalière — la fréquence ou le facteur de puissance, par exemple — n'est pas reprise ; la boîte de dialogue nomme l'indicateur pour que vous puissiez l'exporter dans l'onglet Métriques.

Constructeur API

Choisissez un modèle et les centrales, puis ajustez la période, le pas et le format de fichier si les valeurs par défaut du modèle ne conviennent pas. La page affiche le lien et un aperçu des données. Essayer prépare un jeton d'API et des commandes prêtes à l'emploi pour ce lien. Pour un ancien modèle, le constructeur affiche le lien précédent et propose la conversion.

Un lien avec une période prédéfinie telle que Mois précédent fournit toujours la période complète la plus récente : c'est ce dont a besoin un classeur qui s'actualise de lui-même. Voir Excel avec Power Query.

Quand un export est trop volumineux

Mirox vérifie la taille d'un export avant de lire la moindre donnée. Si l'export est trop volumineux, rien n'est exporté, et le message propose ce qui conviendrait : un pas plus grossier, ou une période plus courte dont le nombre de jours est indiqué.

Pour exporter davantage, scindez l'export :

• par période — un fichier par mois ou par trimestre au lieu d'un fichier par an ;
• par centrale — un fichier par centrale ou par portefeuille ;
• par indicateur — les indicateurs par composant dans un fichier à part, séparés des indicateurs de centrale ;
• par page — pour une centrale comptant de nombreux composants, exportez les composants page par page.

Les indicateurs que Mirox doit déterminer à partir de plusieurs sources, comme Production (résolue), coûtent plus qu'un simple relevé de compteur. Un modèle qui porte un tel indicateur couvre moins de centrales et de mois par fichier. La ligne de taille sous la période vous en informe avant le téléchargement.

Qui peut exporter quoi

• Vous exportez les centrales dont vous pouvez lire les mesures : les rôles de fonction Exploitant, Technical Manager, Asset Manager et Spectateur. Une centrale que vous ne pouvez pas lire est laissée de côté, et une remarque la nomme.
• Les indicateurs de montant exigent en plus l'accès à la comptabilité, dont disposent les rôles de fonction Exploitant et Asset Manager. Sans lui, la colonne reste vide pour cette centrale.
• Les indicateurs de votre organisation sont exportés sur chaque centrale que vous pouvez lire, y compris les centrales partagées avec vous dans le cadre d'une coopération. Ils sont proposés à chaque rôle d'organisation sauf Externe.
• En dehors du navigateur, un jeton d'API du groupe Metric Export lit chaque export. Il ne peut rien modifier.

Anciens liens et favoris

Les liens vers l'ancien onglet Données brutes et vers l'ancien onglet Métriques continuent de fonctionner : ils ouvrent l'onglet Métriques avec les mêmes centrales, indicateurs, période et pas. Lorsqu'un indicateur n'a pas d'équivalent, un bandeau le signale et propose Copier l’URL d’API d’origine, qui le fournit toujours. Un lien vers l'un des cinq modèles système antérieurs ouvre son successeur.

Les formules ne se modifient plus dans l'application. Voir Formules MiroxQL.

Fonctionnalités associées

• API Metric Export — chaque paramètre, erreur et limite des liens d'export
• Migrer vers le Metric Export — les anciens identifiants et leurs nouveaux indicateurs, et ce qui change
• API de l'ancien export — les liens d'export précédents, qui continuent de fonctionner
• Metric Export pour Excel — recettes et Power Query
• FAQ sur l'export de données — des réponses courtes aux questions courantes
• Indicateurs — les indicateurs propres à votre organisation
• Jetons d'API — le jeton Metric Export