Définition des métriques (console)Définition des métriques (AWS CLI)

Agrégation de donné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éfinition de hiérarchies de 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 plus d’informations, consultez Interrogation des agrégats de propriétés d'actif.

Définition 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 Référencement d'objets avec des identifiants externes 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 plus d’informations, consultez Utilisation d'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) et 1 (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 plus d’informations, consultez 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 en UTC (00:00 AM, 01:00:00 AM, 02:00:00 AM, etc.).
- 1 jour — 1 jour (24 heures), calculé à la fin de chaque journée en UTC (00h00 le lundi, 00h00 le mardi, etc.).
- 1 semaine — 1 semaine (7 jours), calculée à la fin de chaque dimanche en UTC (tous les lundis à 00h00).
- 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 décalé par défaut est le temps universel coordonné (UTC).
- (UTC+ 00:00) Heure universelle coordonnée
- (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+ 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 d'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 :
- Entrez12, puis choisissez les heures.
- Entrez720, puis choisissez minutes.
- Entrez43200, 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, entrez18: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 à 06h30 (PST), et ainsi de suite.

Définition des métriques (AWS CLI)

Lorsque vous définissez une métrique pour un modèle d'actif avec l' 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 être DOUBLE ouSTRING.
externalId— (Facultatif) Il s'agit d'un identifiant défini par l'utilisateur. Pour plus d’informations, consultez Référencement d'objets avec des identifiants externes 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 plus d’informations, consultez Utilisation d'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, consultez TumblingWindowla référence de AWS IoT SiteWise l'API.
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 à 18h30 (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 à 06h30 (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 structure value qui identifie la propriété à lier à cette variable. La structure value contient 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) et 1 (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 plus d’informations, consultez 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 de AssetModelpropriété contenant une métrique. Vous pouvez spécifier cet objet dans le cadre de la charge utile de la demande de CreateAssetmodèle pour créer une propriété métrique. Pour plus d’informations, consultez 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 de AssetModelpropriété contenant une métrique. Vous pouvez spécifier cet objet dans le cadre de la charge utile de la demande de CreateAssetmodèle 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"
      }
    ],
    ...
}

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Transformation des données (transformations)

Utilisation d'expressions de formule

Agrégation de données provenant de propriétés et d'autres actifs (métriques)

Rubriques

Définition des métriques (console)

Important

Exemple intervalle de temps personnalisé avec décalage (console)

Pour définir un intervalle personnalisé avec un décalage

Important

Définition des métriques (AWS CLI)

Exemple intervalle de temps personnalisé avec un décalage (AWS CLI)

Important

Exemple de définition de métrique

Exemple de définition de métrique qui saisit les données des actifs associés