Une table de métriques prédéfinie est une collection de métriques par défaut que la plateforme IoT Data Service utilise pour décrire l'état des appareils. La collecte de données pour ces métriques est désactivée par défaut. Activez une table de métriques prédéfinie pour collecter les données et générer une API de données afin de récupérer les résultats agrégés.
Prérequis
Vous avez sauvegardé les données de votre produit. Pour plus d'informations, consultez la rubrique sauvegarde des données.
Facturation
L'activation d'une table de métriques prédéfinie pour la collecte de données consomme des unités de calcul (CU). Pour en savoir plus, consultez la description de la facturation des services de données.
Consulter les tables de métriques prédéfinies
Dans la console IoT Platform, accédez à la page Overview et cliquez sur l'ID ou l'alias de l'instance Enterprise Edition cible.
Dans le volet de navigation de gauche, choisissez Data Service > Data Metrics.
-
Sous l'onglet Predefined Metrics , consultez toutes les tables de métriques prédéfinies.
La liste des tables de métriques prédéfinies comprend les colonnes suivantes : Metric Name, Description, CU Consumption, Scheduling Type, Metric Type et Actions. Dans la colonne Actions, cliquez sur View pour afficher les détails de la métrique, ou sur Enable Metric pour l'activer. Utilisez la zone de recherche en haut de la page pour rechercher par nom de métrique.
-
(Facultatif) Dans la colonne Actions d'une table de métriques prédéfinie, cliquez sur View.
La page Metric Table Details affiche les informations de base concernant la table de métriques et ses métriques, telles que le nom de la métrique (par exemple,
connectionSuccessRate), le nom d'affichage (par exemple, Taux de réussite des connexions réseau par minute), le nombre de champs et le type (appareil). La section du schéma de table répertorie le nom de chaque champ, son alias (nom chinois) et son type de données. Par exemple, le champmetricValuea pour alias « Taux de réussite des connexions réseau » et un type de donnéesdouble.
Activer et désactiver la collecte de données
Activer la collecte de données
Sous l'onglet Predefined Metrics , dans la colonne Actions , cliquez sur Enable Metric pour la table de métriques prédéfinie cible.
-
Dans la boîte de dialogue qui s'affiche, cliquez sur Confirm.
ImportantSi votre instance ne dispose pas d'assez d'unités CU, une boîte de dialogue vous invite à mettre à niveau les spécifications de votre instance. Suivez les instructions affichées à l'écran pour augmenter le nombre d'unités CU. Pour obtenir des informations sur les spécifications, consultez la rubrique Achat d'une instance Enterprise Edition.
Une fois la mise à niveau terminée, suivez les étapes ci-dessus pour activer la collecte de données pour la métrique.
La boîte de dialogue indique les unités CU disponibles et celles requises pour activer la métrique. La consommation mensuelle d'unités CU varie en fonction du nombre d'appareils. Les métriques hors ligne utilisent un modèle d'agrégation T+1, de sorte que les résultats agrégés sont disponibles le lendemain de l'activation de la métrique.
Désactiver la collecte de données
Sous l'onglet Predefined Metrics , dans la colonne Actions , cliquez sur Disable Metric pour la table de métriques prédéfinie cible.
-
Dans la boîte de dialogue qui s'affiche, cliquez sur Confirm.
Une fois la métrique désactivée, la collecte de données s'arrête. Vous pouvez la réactiver à tout moment.
Générer des API de données
Après avoir activé la collecte de données pour une table de métriques prédéfinie, le système génère automatiquement une API de données pour récupérer les données de métriques agrégées.
Sous l'onglet Predefined Metrics , dans la colonne Actions de la table de métriques prédéfinie cible, cliquez sur Data Preview pour afficher les 20 enregistrements les plus récents. Par exemple, pour la table Daily Device Online Duration Statistics , l'aperçu inclut des champs tels que Statistics Date , Max Online Duration , Min Online Duration , Average Online Duration , Device with Max Online Duration et Device with Min Online Duration .
-
Revenez à l'onglet Predefined Metrics . Dans la colonne Actions de la même table de métriques prédéfinie, cliquez sur Data API Details pour afficher ses informations de base et ses détails d'utilisation.
Pour plus d'informations sur les détails et l'utilisation de l'API, consultez la rubrique Gérer et utiliser les API. Les informations de base comprennent API Name , API Path , Status , Creation Time , API Type , Number of Calls , Timeout Error Condition et Last Invocation . Dans la zone API Monitoring , vous pouvez basculer entre les onglets API O&M et API Test .