View a markdown version of this page

Interrogez les agrégats de propriétés des actifs dans AWS IoT SiteWise - AWS IoT SiteWise
Agrégats pour une propriété d'actif (API)Agrégats pour un actif immobilier ()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.

Interrogez les agrégats de propriétés des actifs dans AWS IoT SiteWise

AWS IoT SiteWise calcule automatiquement les valeurs agrégées des propriétés des actifs, qui constituent un ensemble de mesures de base calculées sur plusieurs intervalles de temps. AWS IoT SiteWise calcule les agrégats suivants toutes les minutes, toutes les heures et tous les jours pour les propriétés de vos actifs :

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

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

  • maximum  : valeur maximale 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 l'agrégat de comptage.

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 activité. Les propriétés métriques offrent des fonctions d'agrégation supplémentaires et des intervalles de temps qui ne sont pas précalculés pour l' 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 (mesures).

Agrégats pour une propriété d'actif (API)

Utilisez l' AWS IoT SiteWise API pour obtenir des agrégats pour une propriété d'actif.

Utilisez cette GetAssetPropertyAggregates opération pour interroger les agrégats d'une propriété d'actif.

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

  • Fin assetId 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é, consultezGérez les flux de données pour AWS IoT SiteWise.

Vous devez transmettre 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 récupérer la métrique : 1m (1 minute), 15m (15 minutes), 1h (1 heure) ou 1d (1 jour).

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

  • endDate— L'extrémité inclusive de la plage à partir de laquelle interroger les données historiques, exprimée en secondes en heure d'é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 dans une seule demande. Par défaut, ce sont les 20 résultats.

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

  • timeOrdering— L'ordre à 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 dans un format différent 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 (propriété)AWS CLI)

Pour interroger les agrégats d'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 par l'ID de la ressource et property-id par l'ID 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 qui contient les données TQV historiques 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.

Note

Si votre plage de requêtes contient une null valeur TQvs, consultez AssetPropertyValue API. Toutes les statistiques, à l'exception du nombre, aboutissent à une null réponse, similaire aux statistiques pour String TQV. Si votre plage de requêtes contient Double.NaN des TQV de type double, tous les calculs, à l'exception du nombre, aboutiront à unDouble.NaN.