Consulta los agregados de propiedades de los activos - AWS IoT SiteWise
Agregados de una propiedad de activo () APIAgregados de una propiedad de activo ()AWS CLI

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Consulta los agregados de propiedades de los activos

AWS IoT SiteWise calcula automáticamente los valores agregados de las propiedades de los activos, que son un conjunto de métricas básicas calculadas en varios intervalos de tiempo. AWS IoT SiteWise calcula los siguientes agregados cada minuto, hora y día para las propiedades de sus activos:

  • promedio: el promedio (media) de los valores de una propiedad en un intervalo de tiempo.

  • recuento: el número de puntos de datos de una propiedad a lo largo de un intervalo de tiempo.

  • máximo: el máximo de los valores de una propiedad en un intervalo de tiempo.

  • mínimo: el mínimo de los valores de una propiedad en un intervalo de tiempo.

  • desviación estándar: la desviación estándar de los valores de una propiedad en un intervalo de tiempo.

  • suma: la suma de los valores de una propiedad en un intervalo de tiempo.

Para las propiedades no numéricas, como cadenas y valores booleanos, AWS IoT SiteWise calcula solo el recuento agregado.

También puede calcular métricas personalizadas para los datos de activos. Con las propiedades métricas, usted define las agregaciones que son específicas de su operación. Las propiedades métricas ofrecen funciones de agregación e intervalos de tiempo adicionales que no están precalculados para el. AWS IoT SiteWise API Para obtener más información, consulte Agregue datos de propiedades y otros activos (métricas).

Agregados de una propiedad de activo () API

Puede utilizar el AWS IoT SiteWise API para obtener los agregados de una propiedad de activo.

Utilice la GetAssetPropertyAggregatesoperación para consultar los agregados de una propiedad de activo.

Para identificar una propiedad de activo, especifique una de las siguientes opciones:

  • El assetId extremo propertyId de la propiedad del activo a la que se envían los datos.

  • El propertyAlias, que es un alias de flujo de datos (por ejemplo, /company/windfarm/3/turbine/7/temperature). Para utilizar esta opción, primero debe establecer el alias de la propiedad del activo. Para establecer los alias de las propiedades, consulteAsigne flujos de datos industriales a propiedades de activos.

También debe pasar los siguientes parámetros obligatorios:

  • aggregateTypes: la lista de agregados que se va a recuperar. Puede especificar uno de estos: AVERAGE, COUNT, MAXIMUM, MINIMUM, STANDARD_DEVIATION y SUM.

  • resolution: el intervalo de tiempo para el cual se recupera la métrica: 1m (1 minuto), 1h (1 hora) o 1d (1 día).

  • startDate: el inicio inclusivo del rango del cual se consultan los datos históricos, expresado en segundos en tiempo epoch de Unix.

  • endDate: el final inclusivo del rango del cual se consultan los datos históricos, expresado en segundos en tiempo epoch de Unix.

También puede pasar cualquiera de los siguientes parámetros para refinar los resultados:

  • maxResults: el número máximo de resultados por devolver en una petición. Predeterminado a 20 resultados.

  • nextToken: un token de paginación devuelto por una llamada anterior de esta operación.

  • timeOrdering: el orden por aplicar a los valores devueltos: ASCENDING o DESCENDING.

  • qualities: calidad para filtrar los resultados: GOOD, BAD, o UNCERTAIN.

nota

La GetAssetPropertyAggregatesoperación devuelve un TQV con un formato diferente al de las demás operaciones descritas en esta sección. La estructura del value contiene un campo para cada uno de los aggregateTypes de la solicitud. En timestamp se incluye el tiempo en que se produjo la agregación, en segundos en formato Unix.

Agregados de una propiedad de activo ()AWS CLI

Para consultar los agregados de una propiedad de activo ()AWS CLI

  1. Ejecute el siguiente comando para obtener agregados para la propiedad del activo. Este comando consulta la media y la suma con una resolución de 1 hora para un intervalo de 1 hora específico. Reemplazar asset-id con el ID del activo y property-id con el identificador de la propiedad. Reemplace los parámetros por los agregados y el intervalo a consultar.

    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

    La operación devuelve una respuesta que contiene el historial TQVs de la propiedad en el siguiente formato. La respuesta incluye solo los agregados solicitados.

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

  2. Si existen más entradas de valores, puede pasar el token de paginación del nextToken campo a una llamada posterior a la GetAssetPropertyAggregatesoperación.