Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Données agrégées provenant de propriétés et d'autres actifs (métriques)
Les métriques sont des expressions mathématiques qui utilisent des fonctions d'agrégation pour traiter tous les points de données en entrée et en sortie un seul point de données par intervalle de temps spécifié. Par exemple, une métrique peut calculer la température horaire moyenne à partir d'un flux de données de température.
Les métriques peuvent entrer des données à partir des métriques des ressources associées, de sorte que vous pouvez calculer des statistiques qui fournissent un aperçu de votre opération ou d'un sous-ensemble de votre opération. Par exemple, une métrique peut calculer la température horaire moyenne pour toutes les éoliennes d'un parc éolien. Pour de plus amples informations sur la définition des associations entre les ressources, veuillez consulter Définir les hiérarchies des modèles d'actifs.
Les métriques peuvent également saisir des données provenant d'autres propriétés sans agréger les données sur chaque intervalle de temps. Si vous spécifiez un attribut dans une formule, AWS IoT SiteWise utilise la dernière valeur de cet attribut lors du calcul de la formule. Si vous spécifiez une métrique dans une formule, AWS IoT SiteWise utilise la dernière valeur de l'intervalle de temps pendant lequel la formule est calculée. Cela signifie que vous pouvez définir des indicateurs tels que OEE = Availability * Quality *
Performance AvailabilityQuality, où et quels Performance sont tous les autres indicateurs du même modèle d'actif.
AWS IoT SiteWise calcule également automatiquement un ensemble de mesures d'agrégation de base pour toutes les propriétés des actifs. Pour réduire les coûts de calcul, vous pouvez utiliser ces agrégats au lieu de définir des métriques personnalisées pour les calculs de base. Pour de plus amples informations, veuillez consulter Rechercher des agrégats de propriétés d'actifs.
Définir des métriques (console)
Lorsque vous définissez une métrique pour un modèle d'actif dans la AWS IoT SiteWise console, vous spécifiez les paramètres suivants :
-
Nom : nom de la propriété.
-
Type de données : type de données de la transformation, qui peut être double ou chaîne.
-
ID externe — (Facultatif) Il s'agit d'un identifiant défini par l'utilisateur. Pour plus d’informations, consultez Objets de référence avec interface externe IDs dans le Guide de l’utilisateur AWS IoT SiteWise .
-
Formule — L'expression métrique. Les expressions métriques peuvent utiliser des fonctions d'agrégation pour saisir des données à partir d'une propriété pour tous les actifs associés dans une hiérarchie. Commencez à taper ou appuyez sur la flèche vers le bas pour ouvrir la fonction de saisie automatique. Pour de plus amples informations, veuillez consulter Utiliser des expressions de formule.
Important
Les métriques ne peuvent être que des propriétés de type entier, double, booléen ou chaîne. Les booléens sont convertis en
0(faux) et1(vrai).Si vous définissez des variables d'entrée de métrique dans l'expression d'une métrique, ces entrées doivent avoir le même intervalle de temps que la métrique de sortie.
Les expressions de formule ne peuvent générer que des valeurs doubles ou des valeurs de chaîne. Les expressions imbriquées peuvent générer d'autres types de données, tels que des chaînes, mais la formule dans son ensemble doit être évaluée à un nombre ou à une chaîne. Vous pouvez utiliser la fonction jp pour convertir une chaîne en nombre. La valeur booléenne doit être 1 (vrai) ou 0 (faux). Pour de plus amples informations, veuillez consulter Valeurs non définies, infinies et en dépassement.
-
Intervalle de temps : intervalle de temps métrique. AWS IoT SiteWise prend en charge les intervalles temporels suivants, où chaque intervalle commence à la fin du précédent :
-
1 minute à 1 minute, calculée à la fin de chaque minute (00h00, 00h01, 00h02, etc.).
-
5 minutes — 5 minutes, calculées à la fin de toutes les cinq minutes à partir de l'heure (00h00, 00h05, 00h10, etc.).
-
15 minutes — 15 minutes, calculées à la fin de toutes les quinze minutes à partir de l'heure (00h00, 00h15, 00h30, etc.).
-
1 heure à 1 heure (60 minutes), calculée à la fin de chaque heure UTC (0 h 00, 1 h 00, 2 h 00, etc.).
-
1 jour — 1 jour (24 heures), calculé à la fin de chaque journée UTC (00 h 00 le lundi, 00 h 00 le mardi, etc.).
-
1 semaine — 1 semaine (7 jours), calculée à la fin de chaque dimanche UTC (tous les lundis à minuit).
-
Intervalle personnalisé : vous pouvez saisir n'importe quel intervalle de temps compris entre une minute et une semaine.
-
-
Date de décalage — (Facultatif) Date de référence à partir de laquelle agréger les données.
-
Temps de décalage — (Facultatif) Heure de référence à partir de laquelle agréger les données. L'heure de décalage doit être comprise entre 00:00:00 et 23:59:59.
-
Fuseau horaire du décalage — (Facultatif) Fuseau horaire du décalage. S'il n'est pas spécifié, le fuseau horaire de décalage par défaut est le temps universel coordonné (UTC).
-
(UTC+ 00:00) Temps universel coordonné
-
(UTC+ 01:00) Heure centrale européenne
-
(UTC+ 02:00) Europe de l'Est
-
(UTC03+:00) Heure de l'Afrique de l'Est
-
(UTC+ 04:00) Heure du Proche-Orient
-
(UTC+ 05:00) Heure de Lahore au Pakistan
-
(UTC+ 05:30) Heure normale de l'Inde
-
(UTC+ 06:00) Heure normale du Bangladesh
-
(UTC+ 07:00) Heure normale du Vietnam
-
(UTC+ 08:00) Chine, heure de Taiwan
-
(UTC+ 09:00) Heure normale du Japon
-
(UTC+ 09:30) Heure centrale de l'Australie
-
(UTC+ 10:00) Heure de l'Est de l'Australie
-
(UTC+ 11:00) Heure normale de Salomon
-
(UTC+ 12:00) Heure normale de Nouvelle-Zélande
-
(UTC- 11:00) Heure des îles Midway
-
(UTC- 10:00) Heure normale d'Hawaï
-
(UTC- 09:00) Heure normale de l'Alaska
-
(UTC- 08:00) Heure normale du Pacifique
-
(UTC- 07:00) Heure normale de Phoenix
-
(UTC- 06:00) Heure normale du Centre
-
(UTC- 05:00) Heure normale de l'Est
-
(UTC- 04:00) Heure de Porto Rico et des îles Vierges américaines
-
(UTC- 03:00) Heure normale de l'Argentine
-
(UTC- 02:00) Heure de Géorgie du Sud
-
(UTC- 01:00) Heure d'Afrique centrale
-
Exemple intervalle de temps personnalisé avec décalage (console)
L'exemple suivant vous montre comment définir un intervalle de 12 heures avec un décalage le 20 février 2021 à 18 h 30 30 (). PST
Pour définir un intervalle personnalisé avec un décalage
-
Pour Intervalle de temps, choisissez Intervalle personnalisé.
-
Pour Intervalle de temps, effectuez l'une des opérations suivantes :
-
Entrez
12, puis choisissez les heures. -
Entrez
720, puis choisissez minutes. -
Entrez
43200, puis choisissez secondes.
Important
L'intervalle de temps doit être un entier, quelle que soit l'unité.
-
-
Pour Date de décalage, choisissez 2021/02/20.
-
Pour Heure de décalage, entrez
18:30:30. -
Pour le fuseau horaire décalé, choisissez (UTC- 08:00) Heure normale du Pacifique.
Si vous créez la métrique le 1er juillet 2021, avant ou à 18 h 30 30 (PST), vous obtenez le premier résultat d'agrégation le 1er juillet 2021 à 18 h 30 30 (). PST Le deuxième résultat d'agrégation est le 2 juillet 2021 à 6 h 30 (PST), et ainsi de suite.
Définir les métriques (AWS CLI)
Lorsque vous définissez une métrique pour un modèle d'actifs avec le AWS IoT SiteWise API, vous spécifiez les paramètres suivants :
-
name— Le nom de la propriété. -
dataType— Le type de données de la métrique, qui peut êtreDOUBLEouSTRING. -
externalId— (Facultatif) Il s'agit d'un identifiant défini par l'utilisateur. Pour plus d’informations, consultez Objets de référence avec interface externe IDs dans le Guide de l’utilisateur AWS IoT SiteWise . -
expression— L'expression métrique. Les expressions métriques peuvent utiliser des fonctions d'agrégation pour saisir des données à partir d'une propriété pour tous les actifs associés dans une hiérarchie. Pour de plus amples informations, veuillez consulter Utiliser des expressions de formule. -
window— L'intervalle de temps et le décalage correspondant à la fenêtre de fluctuation de la métrique, où chaque intervalle commence à la fin du précédent :-
interval— L'intervalle de temps pendant lequel la fenêtre clignote. L'intervalle de temps doit être compris entre une minute et une semaine. -
offsets— Le décalage dû à la fenêtre qui piétine.
Pour plus d'informations, reportez-vous TumblingWindowà la section AWS IoT SiteWise APIRéférence.
Exemple intervalle de temps personnalisé avec un décalage (AWS CLI)
L'exemple suivant vous montre comment définir un intervalle de 12 heures avec un décalage le 20 février 2021 à 18 h 30 30 (). PST
{ "window": { "tumbling": { "interval": "12h", "offset": " 2021-07-23T18:30:30-08" } } }Si vous créez la métrique le 1er juillet 2021, avant ou à 18 h 30 30 (PST), vous obtenez le premier résultat d'agrégation le 1er juillet 2021 à 18 h 30 30 (). PST Le deuxième résultat d'agrégation est le 2 juillet 2021 à 6 h 30 (PST), et ainsi de suite.
-
-
variables— La liste des variables qui définit les autres propriétés de votre actif ou de vos actifs enfants à utiliser dans l'expression. Chaque structure de variable contient un nom simple à utiliser dans l'expression et une structurevaluequi identifie la propriété à lier à cette variable. La structurevaluecontient les informations suivantes :-
propertyId— L'ID de la propriété à partir de laquelle les valeurs doivent être extraites. Vous pouvez utiliser le nom de la propriété au lieu de son ID si la propriété est définie dans le modèle actuel (plutôt que définie dans un modèle à partir d'une hiérarchie). -
hierarchyId— (Facultatif) L'ID de la hiérarchie à partir de laquelle interroger les actifs enfants de la propriété. Vous pouvez utiliser le nom de la définition de hiérarchie au lieu de son ID. Si vous omettez cette valeur, AWS IoT SiteWise recherche la propriété dans le modèle actuel.
Important
Les métriques ne peuvent être que des propriétés de type entier, double, booléen ou chaîne. Les booléens sont convertis en
0(faux) et1(vrai).Si vous définissez des variables d'entrée de métrique dans l'expression d'une métrique, ces entrées doivent avoir le même intervalle de temps que la métrique de sortie.
Les expressions de formule ne peuvent générer que des valeurs doubles ou des valeurs de chaîne. Les expressions imbriquées peuvent générer d'autres types de données, tels que des chaînes, mais la formule dans son ensemble doit être évaluée à un nombre ou à une chaîne. Vous pouvez utiliser la fonction jp pour convertir une chaîne en nombre. La valeur booléenne doit être 1 (vrai) ou 0 (faux). Pour de plus amples informations, veuillez consulter Valeurs non définies, infinies et en dépassement.
-
-
unit— (Facultatif) L'unité scientifique de la propriété, telle que mm ou Celsius.
Exemple de définition de métrique
L'exemple suivant illustre une propriété de métrique qui agrège les données de mesure de la température d'une ressource pour calculer la température horaire maximale en Fahrenheit. Cet objet est un exemple d'objet AssetModelPropertycontenant une métrique. Vous pouvez spécifier cet objet dans le cadre de la charge utile de la CreateAssetModeldemande pour créer une propriété métrique. Pour de plus amples informations, veuillez consulter Création d'un modèle d'actifs (AWS CLI).
{..."assetModelProperties": [...{ "name": "Max temperature", "dataType": "DOUBLE", "type": { "metric": { "expression": "max(temp_f)", "variables": [ { "name": "temp_f", "value": { "propertyId": "Temperature F" } } ], "window": { "tumbling": { "interval": "1h" } } } }, "unit": "Fahrenheit" } ],...}
Exemple de définition de métrique qui saisit les données des actifs associés
L'exemple suivant illustre une propriété métrique qui agrège les données de puissance moyenne de plusieurs éoliennes pour calculer la puissance moyenne totale d'un parc éolien. Cet objet est un exemple d'objet AssetModelPropertycontenant une métrique. Vous pouvez spécifier cet objet dans le cadre de la charge utile de la CreateAssetModeldemande pour créer une propriété métrique.
{..."assetModelProperties": [...{ "name": "Total Average Power", "dataType": "DOUBLE", "type": { "metric": { "expression": "avg(power)", "variables": [ { "name": "power", "value": { "propertyId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "hierarchyId": "Turbine Asset Model" } } ], "window": { "tumbling": { "interval": "5m" } } } }, "unit": "kWh" } ],...}
