IoT Platform:Créer une métrique

Prérequis

Vous avez importé les métriques de définition d'origine et ajouté des termes atomiques. Pour plus d'informations, consultez les rubriques Importer des métriques prédéfinies et Ajouter des mots atomiques.

Procédure

1. Dans la console IoT Platform, accédez à la page Overview et cliquez sur l'ID ou l'alias de l'instance Enterprise Edition cible.

2. Dans le volet de navigation de gauche, sélectionnez Data Service > Data Metric puis cliquez sur Customize Metric.

3. Accédez à l'onglet All Metrics et cliquez sur Create a Metric.

4. Suivez les instructions à l'écran pour configurer la définition de la métrique.

   1. Sélectionnez le domaine de la nouvelle métrique, puis choisissez l'entité spécifique et l'option Derivation Scope comme indiqué par les invites.

      Paramètre	Remarques
      This Entity	L'entité actuelle.
      Sub-entity	Une sous-entité de l'entité actuelle. Pour les métriques de définition dérivée, vous devez sélectionner une sous-entité. Par exemple, si la sous-entité d'un produit est un dispositif, la métrique de définition dérivée est calculée pour chaque dispositif plutôt que pour le produit dans son ensemble.

   2. Utilisez les directives suivantes pour définir la métrique.

      Paramètre	Remarques
      Modificateur temporel	Sélectionnez un modificateur temporel pour définir la plage de données statistiques de la nouvelle métrique.
      Terme atomique	Sélectionnez les termes atomiques précédemment ajoutés sous le domaine de métrique. Pour ajouter des termes atomiques, cliquez sur le bouton Go to Create Atomic Term situé à droite. Pour plus d'informations, consultez la rubrique Ajouter des mots atomiques.
      Nom de la métrique	Le nom de la métrique est fixe et combine automatiquement le modificateur temporel et le terme atomique. Exemple : Average Temperature of the Last 1 Day.
      Unité de mesure	Sélectionnez le type d'unité et l'unité.
      Type de données	Définissez le type de données, la précision, le nombre de décimales et la plage de valeurs. Cliquez sur l'icône d'aide pour obtenir des descriptions détaillées des types de données.
      Méthode de traitement	Dérivé des actifs de métriques existants. Cette valeur ne peut pas être modifiée.
      Calculable	Pour les métriques numériques cumulables telles que le nombre, le montant ou la fréquence, sélectionnez Yes.
      Fréquence statistique	Les données sont traitées et générées quotidiennement. Cette valeur ne peut pas être modifiée.
      Date d'expiration	Définissez la date d'expiration de la métrique. Important Une fois la métrique expirée, la planification de la production de données s'arrête.
      Description de la métrique	Fournissez une description métier de la métrique, incluant généralement le modificateur temporel et le terme atomique. Exemple : Time Modifier: Last 1 Day, Atomic Term: Average Temperature

   3. Suivez ces instructions pour établir les règles de calcul.

      Méthode de calcul	Remarques	Exemple
      Calcul agrégé	Sélectionnez une fonction d'agrégation, une métrique et un opérateur dans le menu déroulant. Vous pouvez ajouter jusqu'à 10 expressions.	Par exemple, sélectionnez la sous-entité du domaine produit, la fonction COUNT(Count) et la température du produit (od3**), ce qui indique le calcul du nombre d'enregistrements de température sur le produit (od3**) via des métriques de définition dérivée.
      Calcul d'expression	Saisissez l'expression d'opération dans la zone de saisie. Pour connaître les fonctions prises en charge, consultez la section Annexe : Liste des fonctions ci-dessous. Cliquez sur le bouton Function au-dessus de la zone de saisie pour obtenir des instructions et des exemples. La syntaxe de l'expression consiste à saisir la fonction d'agrégation dans la zone de saisie, à insérer le symbole $ ou @ dans le corps de la fonction, à sélectionner le domaine de métrique, à ajouter un point (.), à choisir l'entité sous le domaine de métrique, puis un autre point (.), et enfin à sélectionner la métrique pour la dérivation et le calcul. Les symboles $ et @ répondent à différents types de métriques : $ : Métriques de définition d'origine et de définition dérivée. @ : Métriques d'origine et dérivées. Remarque Les opérateurs de base ne sont pas pris en charge dans les expressions de fonction d'agrégation.	Pour le produit Temperature and Humidity Sensor comportant 100 dispositifs, y compris le TH_sensor, l'expression de métrique dérivée pour Average Temperature of the Last Day basée sur la métrique d'origine et la définition de Temperature est la suivante : avg($Product.Temperature and Humidity Sensor.Temperature) : Calcule la température moyenne de tous les dispositifs du produit à l'aide de métriques de définition dérivée. avg(@Device.TH_sensor.Temperature) : Calcule la température moyenne du dispositif TH_sensor à l'aide de métriques de définition dérivée.

5. Cliquez sur Complete and Publish.

   Consultez les nouvelles métriques finalisées dans la liste All Metrics.

   Remarque

   • Les métriques sélectionnées en cliquant sur le bouton Complete seront marquées comme Unpublished et ne collecteront pas de données.

   • Les métriques incomplètes peuvent être envoyées vers la boîte de brouillons en cliquant sur Enter Draft Box, permettant une édition ultérieure et l'achèvement éventuel du processus de publication.

6. Si nécessaire, dans la liste All Metrics, localisez la métrique souhaitée, cliquez sur le bouton de fonction dans la colonne des opérations, et effectuez les actions suivantes :

   Remarque

   Les métriques de définition d'origine sont limitées aux fonctions de consultation et de suppression.

   Opération	Remarques
   View	Consultez les informations de base, la logique de calcul, l'aperçu des données et d'autres détails de la métrique.
   Edit	Modifiez la configuration de la métrique dérivée.
   Unpublish	Rétablissez la métrique au statut non publié. Les métriques dérivées associées et les services échoueront.
   Publish	Rendez la métrique disponible publiquement.
   Clone	Dupliquez la métrique. Sur la page de clonage de la métrique, modifiez la définition et les paramètres selon vos besoins pour créer une nouvelle métrique. Important Les métriques ayant des configurations identiques à l'original ne peuvent pas être enregistrées.
   Delete	Supprimez la métrique du système. Important La suppression d'une métrique échoue dans les conditions suivantes : La métrique possède des métriques en aval associées. La métrique est utilisée dans des rapports d'analyse de données.

Étapes suivantes

Les métriques dérivées représentent des données statistiques J+1. Pour afficher les données immédiatement après l'ajout de nouvelles métriques, lancez manuellement une tâche d'actualisation.

Pour des instructions détaillées, consultez la rubrique Actualisation des métriques.

Annexe : Liste des fonctions