Les agrégats

L’écran des agrégats permet de paramètrer le fonctionnement du service enezKenstroll. Ce service va automatiquement calculer des valeurs agrégées temporellement. Une donnée agrégée est une donnée représentant un état durant un interval de temps fixé. Cette donnée résulte donc d’une opération faite sur les données enregistrées.
Ensuite, selon la nature de la donnée, l’opération demandée est différente. En général, l’agrégation des données conciste à calculer des sommes, des moyennes, des minima ou des maxima sur des intervalles de temps fixés. Par exemple, la température maximale journalière, la consommmation électrique horaire.
On arrive d’abord sur un écran qui liste les agrégats actuels connus. Il est possible d’en ajouter grâce au bouton “Nouveau”, ou de modifier un agrégat existant en le sélectionnant.

Les champs suivants sont utilisés :

Titre :

Titre attribué à l’agrégat afin de l’identifié facilment.

Code :

Code de cet agrégat de données.
Il est obligatoire et doit être unique car c’est ce code qui permet à la base de données d’enregistrer et de récupérer les données de cet agrégat.

Description :

Description et complèments d’information sur cet agrégat de données. C’est juste à titre informatif pour l’utilisateur.

Flux d’origine :

Pour savoir d’où vient la données à tracer, il faut indiquer le flux d’origine de cette donnée. La liste des flux disponibles est proposée.

Elément :

C’est l’élément du flux à utiliser pour tracer la courbe.
Un flux peut-être composé de plusieurs données. Les données d’un flux sont nommés. Il faut donc utiliser le nom de la données au sein du flux.
Dans le cas de documents json imbriqués, comme ceux générés par les capteurs Tasmota, l’élément de détail doit être indiqué en concaténant l’élément secondaire à l’élément principal et en les séparant avec les 2 lettres -).
Par exemple, pour le cas d’un compteur d’énergie électrique, l’ensemble des informations est indiqué dans la balise “ENERGY”. Si c’est l’élément “Power” qui nous intéresse, ce sera noté ENERGY-)Power.
Si des données existent déjà, l’icône live_help permet d’afficher les éléments disponibles et de les choisir.
Il se peut que cette icône ne soit pas immédiatement active. En effet, la liste des éléments disponibles peut parfois demander un certain temps à être complètement constituée.

Portée :

Dans le cas des moyennes mobiles, indique le laps de temps sur lequel agréger les données. Le choix se fait dans une liste.

Timing :

Indique la récurence de l’agrégat, c’est à dire le laps de temps entre chaque donnée calculée, ou vu autrement, l’intervalle de temps sur lequel va se faire l’agrégation. Le choix se fait dans une liste.

Update :

Dans le cas d’une récurence assez longue, la journée par exemple, il peut être intéressant que des calculs intermédiaires se fassent lors de la journée.
C’est ici que l’on peut spécifier selon quel intervalle effectuer ces calculs.

Type d’agrégat :

Les calculs effectués seront différents en fonction du type d’agrégat.
Il y a actuellement 3 types de données qui vont indiquer la méthode de calcul et les nouvelles données qui seront disponibles :

Compteur
Il s’agit d’une valeur qui s’incrémente, comme par exemple un compteur d’électricité.
Il faut donc calculer une différence entre le début de l’intervalle de temps et la fin de cet intervalle. Le nouveau flux proposera donc la donnée delta.
Valeur
Il s’agit d’une valeur qui fluctue comme par exemple une température.
Il est ici possible de calculer une moyenne, un maximum et un minimum. Le nouveau flux proposera donc les données avg, min et max.
Moyenne mobile
Une moyenne mobile peut se calculer sur une valeur qui fluctues, comme par exemple une température.
Il faut alors préciser sur quel laps de temps (ou ‘portée’) doit se faire la moyenne. Le nouveau flux proposera donc les données MovAvg.

Topic utilisé :

A titre indicatif, affiche le topic sur lequel seront publiées les données calculées. Ce topic n’est pas modifiable.