IoT Platform:Métriques

Métrique

Une métrique, également appelée mesure, est une norme permettant d'évaluer un changement ou une évolution. Parmi les exemples figurent la température, la population, le PIB, le chiffre d'affaires, le nombre d'utilisateurs, la marge bénéficiaire, le taux de rétention et le taux de couverture.

Domaine de métrique

Un domaine de métrique désigne l'objet associé à une métrique ; il sert à catégoriser et à gérer les métriques. IoT Data Service propose deux domaines de métriques : produit et appareil.

Type de métrique

• Définition d'origine

  Les métriques de définition d'origine sont dérivées du modèle de thing d'un produit dans IoT Platform.

  Dans la console IoT Platform, accédez à Device Management > Product, sélectionnez un produit pour ouvrir sa page Product Details, puis cliquez sur Function Definition afin de consulter le modèle de thing défini.

• Métrique brute

  Les métriques brutes proviennent des propriétés que les appareils signalent à IoT Platform ou des propriétés extraites des topics personnalisés.

  Dans la console IoT Platform, accédez à Device Management > Device pour ouvrir la page Device Details. Cliquez sur TSL Data pour afficher les propriétés. Par exemple, sur la page Device Details, choisissez TSL Data > Running Status pour visualiser les propriétés signalées par un appareil, telles que les métriques d'un instrument de mesure des paramètres électriques : puissance de charge (28 kW), courant de fonctionnement (15 A) et tension (20 V).

• Définition dérivée

  Une définition dérivée repose sur une définition d'origine et s'applique aux entités subordonnées d'un produit.

  À l'instar d'une définition d'origine, une définition dérivée constitue une définition de propriété et ne possède pas de valeur de données spécifique.

  Les données agrégées deviennent la valeur de la métrique dérivée pour chaque appareil.

  La définition dérivée d'un produit et la métrique dérivée de chaque appareil appartenant à ce produit partagent le même code de métrique.

• Métrique dérivée

  Une métrique dérivée est calculée à partir de métriques brutes, de définitions d'origine ou de définitions dérivées en utilisant des méthodes d'agrégation telles que la somme et la moyenne.

  Pour une métrique dérivée, un modificateur temporel définit la plage de temps d'agrégation (la contrainte temporelle), tandis que les modificateurs métier définissent d'autres contraintes.

  Par conséquent, une métrique dérivée se compose de trois éléments : modificateur temporel (obligatoire) + modificateur métier (facultatif) + métrique atomique (obligatoire).

  Pour savoir comment ajouter une métrique, consultez la section Ajouter une métrique.

Applicabilité des types de métriques

Le tableau suivant indique les types de métriques pris en charge dans chaque domaine de métriques.

Un appareil rattaché à un produit peut inclure des métriques des types définition dérivée et métrique dérivée.

Prenons l'exemple d'une définition dérivée pour le produit PK1 nommée Average Temperature in the Last 24 Hours. Ce produit comporte 100 appareils, nommés DNn (où n=1 à 100). Créer une métrique dérivée Average Temperature in the Last 24 Hours distincte pour chaque appareil nécessiterait de répéter la configuration 100 fois. En revanche, la création d'une seule définition dérivée pour le produit PK1 génère automatiquement la métrique dérivée Average Temperature in the Last 24 Hours pour l'ensemble des 100 appareils.