Rechercher des agrégats de propriétés d'actifs - AWS IoT SiteWise
Agrégats pour un actif () APIAgrégats pour un actif ()AWS CLI

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.

Rechercher des agrégats de propriétés d'actifs

AWS IoT SiteWise calcule automatiquement les valeurs agrégées des propriétés des actifs, qui sont un ensemble de mesures de base calculées sur plusieurs intervalles de temps. AWS IoT SiteWise calcule les agrégats suivants chaque minute, heure et jour pour les propriétés de vos actifs :

  • average — La moyenne (moyenne) des valeurs d'une propriété sur un intervalle de temps.

  • count — Le nombre de points de données pour une propriété sur un intervalle de temps.

  • maximum — Le maximum des valeurs d'une propriété sur un intervalle de temps.

  • minimum : valeur minimale d'une propriété sur un intervalle de temps.

  • écart type : écart type des valeurs d'une propriété sur un intervalle de temps.

  • sum — Somme des valeurs d'une propriété sur un intervalle de temps.

Pour les propriétés non numériques, telles que les chaînes et les booléens, AWS IoT SiteWise calcule uniquement le nombre agrégé.

Vous pouvez également calculer des métriques personnalisées pour vos données d'actif. Les propriétés des métriques vous permettent de définir des agrégations spécifiques à votre opération. Les propriétés métriques offrent des fonctions d'agrégation et des intervalles de temps supplémentaires qui ne sont pas précalculés pour le AWS IoT SiteWise API. Pour de plus amples informations, veuillez consulter Données agrégées provenant de propriétés et d'autres actifs (métriques).

Agrégats pour un actif () API

Vous pouvez utiliser le AWS IoT SiteWise API pour obtenir des agrégats pour une propriété d'actif.

Utilisez l'GetAssetPropertyAggregatesopération pour interroger les agrégats d'une propriété d'actif.

Pour identifier une propriété d'actif, spécifiez l'une des options suivantes :

  • La assetId fin propertyId de la propriété de l'actif à laquelle les données sont envoyées.

  • LepropertyAlias, qui est un alias de flux de données (par exemple,/company/windfarm/3/turbine/7/temperature). Pour utiliser cette option, vous devez d'abord définir l'alias de votre propriété de ressource. Pour définir des alias de propriété, consultezMappez les flux de données industriels aux propriétés des actifs.

Vous devez également passer les paramètres obligatoires suivants :

  • aggregateTypes— La liste des agrégats à récupérer. Vous pouvez spécifier n'importe quel élément : AVERAGE, COUNT, MAXIMUM, MINIMUM, STANDARD_DEVIATION et SUM.

  • resolution— Intervalle de temps pendant lequel la métrique doit être 1m récupérée : (1 minute), 1h (1 heure) ou 1d (1 jour).

  • startDate— Le début exclusif de la plage à partir de laquelle interroger les données historiques, exprimé en secondes à l'époque Unix.

  • endDate— La fin de la plage inclusive à partir de laquelle interroger les données historiques, exprimée en secondes à l'époque Unix.

Vous pouvez également passer l'un des paramètres suivants pour affiner vos résultats :

  • maxResults— Le nombre maximum de résultats à renvoyer en une seule demande. Par défaut, ce sont les 20 résultats.

  • nextToken— Un jeton de pagination renvoyé lors d'un précédent appel de cette opération.

  • timeOrdering— La commande à appliquer aux valeurs renvoyées : ASCENDING ouDESCENDING.

  • qualities— La qualité permettant de filtrer les résultats par : GOODBAD, ouUNCERTAIN.

Note

L'GetAssetPropertyAggregatesopération renvoie un TQV avec un format différent de celui des autres opérations décrites dans cette section. La structure value contient un champ pour chacun des éléments aggregateTypes de la demande. Le timestamp contient l'heure à laquelle l'agrégation s'est produite, en secondes (heure UNIX Epoch).

Agrégats pour un actif ()AWS CLI

Pour interroger des agrégats pour une propriété d'actif ()AWS CLI

  1. Exécutez la commande suivante pour obtenir des agrégats pour la propriété de ressource. Cette commande interroge la moyenne et la somme avec une résolution d’1 heure pour un intervalle spécifique d’1 heure. Remplacez asset-id avec l'identifiant de l'actif et property-id avec l'identifiant de la propriété. Remplacez les paramètres par les agrégats et l'intervalle à interroger.

    aws iotsitewise get-asset-property-aggregates \
  --asset-id asset-id \
  --property-id property-id \
  --start-date 1575216000 \
  --end-date 1575219600 \
  --aggregate-types AVERAGE SUM \
  --resolution 1h

    L'opération renvoie une réponse contenant l'historique TQVs de la propriété au format suivant. La réponse inclut uniquement les agrégats demandés.

    {
  "aggregatedValues": [
    {
      "timestamp": Number,
      "quality": "String",
      "value": {
        "average": Number,
        "count": Number,
        "maximum": Number,
        "minimum": Number,
        "standardDeviation": Number,
        "sum": Number
      }
    }
  ],
  "nextToken": "String"
}

  2. S'il existe d'autres entrées de valeur, vous pouvez transmettre le jeton de pagination du nextToken champ à un appel ultérieur à l'GetAssetPropertyAggregatesopération.