Agregue datos de propiedades y otros activos (métricas) - AWS IoT SiteWise
Defina las métricas (consola)Defina las métricas ()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.

Agregue datos de propiedades y otros activos (métricas)

Las métricas son expresiones matemáticas que utilizan funciones agregadas para procesar todos los puntos de datos de entrada y generar un único punto de datos por intervalo de tiempo especificado. Por ejemplo, una métrica puede calcular la temperatura media por hora a partir de un flujo de datos de temperatura.

Las métricas pueden agregar datos de métricas de activos asociados, de modo que puede calcular estadísticas que proporcionan información sobre la operación o un subconjunto de la operación. Por ejemplo, una métrica puede calcular la temperatura media por hora en todas las turbinas eólicas de un parque eólico. Para obtener más información acerca de cómo definir asociaciones entre activos, consulte Defina las jerarquías del modelo de activos.

Las métricas también pueden introducir datos de otras propiedades sin agregar datos en cada intervalo de tiempo. Si se especifica un atributo en una fórmula, AWS IoT SiteWise utiliza el valor más reciente de ese atributo al calcular la fórmula. Si especifica una métrica en una fórmula, AWS IoT SiteWise utiliza el último valor del intervalo de tiempo durante el que calcula la fórmula. Esto significa que se pueden definir métricas como OEE = Availability * Quality * Performance, donde Availability, Quality y Performance son todas las demás métricas en el mismo modelo de activos.

AWS IoT SiteWise también calcula automáticamente un conjunto de métricas de agregación básicas para todas las propiedades de los activos. Para reducir los costos de cálculo, puede utilizar estos agregados en lugar de definir métricas personalizadas para cálculos básicos. Para obtener más información, consulte Consulta los agregados de propiedades de los activos.

Defina las métricas (consola)

Al definir una métrica para un modelo de activos en la AWS IoT SiteWise consola, se especifican los siguientes parámetros:

  • Nombre: el nombre de la propiedad.

  • Tipo de datos: el tipo de datos de la transformación, que puede ser Doble o Cadena.

  • ID externo: (opcional) Este es un ID definido por el usuario. Para obtener más información, consulte Haga referencia a objetos con objetos externos IDs en la Guía del usuario de AWS IoT SiteWise .

  • Fórmula: la expresión métrica. Las expresiones métricas pueden utilizar funciones de agregación para introducir datos de una propiedad para todos los activos asociados en una jerarquía. Comience a escribir o presione la tecla de flecha hacia abajo para abrir la característica de autocompletar. Para obtener más información, consulte Usa expresiones de fórmula.

    importante

    Las métricas solo pueden agregar propiedades de tipo entero, doble, booleano o cadena. Los valores booleanos se convierten en 0 (falso) y 1 (verdadero).

    Si define variables de entrada de métrica en la expresión de una métrica, esas entradas deben tener el mismo intervalo de tiempo que la métrica de salida.

    Las expresiones de fórmula solo pueden generar valores dobles o de cadena. Las expresiones anidadas pueden generar otros tipos de datos, como cadenas, pero la fórmula en su conjunto debe evaluarse como un número o una cadena. Puede usar la función jp para convertir una cadena en un número. El valor booleano debe ser 1 (verdadero) o 0 (falso). Para obtener más información, consulte Valores indefinidos, infinitos y de desbordamiento.

  • Intervalo de tiempo – Un intervalo de tiempo de métrica. AWS IoT SiteWise admite los siguientes intervalos de tiempo con periodos de saltos, donde cada intervalo comienza cuando termina el anterior:

    • 1 minuto: 1 minuto, calculado al final de cada minuto (00:00:00 h, 00:01:00 h, 00:02:00 h, etc.).

    • 5 minutos: 5 minutos, calculados al final de cada cinco minutos a partir de la hora en punto (00:00:00 h., 00:05:00 h., 00:10:00 h, etc.).

    • 15 minutos – 15 minutos, calculados al final de cada quince minutos a partir de la hora en punto (00:00:00 h., 00:15:00 h., 00:30:00 h, etc.).

    • 1 hora — 1 hora (60 minutos), calculada al final de cada hora UTC (12:00:00 a. m., 01:00:00 a. m., 02:00:00 a. m., etc.).

    • 1 día — 1 día (24 horas), computado al final de cada día UTC (a las 00:00 a.m. del lunes, a las 12:00 a.m. del martes, etc.).

    • 1 semana — 1 semana (7 días), calculada al final de cada domingo de UTC (todos los lunes a las 12:00:00).

    • Intervalo personalizado: puede escribir cualquier intervalo de tiempo entre un minuto y una semana.

  • Desplazamiento de la fecha: (opcional) la fecha de referencia a partir de la cual se agregan los datos.

  • Desplazamiento de la hora – (Opcional) la hora de referencia a partir de la cual se agregan los datos. El desplazamiento de la hora debe estar comprendido entre las 00:00:00 y las 23:59:59.

  • Desplazamiento de la zona horaria: (opcional) la zona horaria de referencia. Si no se especifica, la zona horaria de desfase predeterminada es la hora coordinada universal ()UTC.

    • (UTC+ 00:00) Hora universal coordinada

    • (UTC+ 01:00) Hora Central Europea

    • (UTC+ 02:00) Europa del Este

    • (UTC03+:00) Hora de África Oriental

    • (UTC+ 04:00) Hora del Cercano Oriente

    • (UTC+ 05:00) Hora de Lahore en Pakistán

    • (UTC+ 05:30) Hora estándar de la India

    • (UTC+ 06:00) Hora estándar de Bangladesh

    • (UTC+ 07:00) Hora estándar de Vietnam

    • (UTC+ 09:00) Hora estándar de Japón

    • (UTC+ 09:30) Hora central de Australia

    • (UTC+ 10:00) Hora del Este de Australia

    • (UTC+ 11:00) Hora estándar de Salomón

    • (UTC+ 12:00) Hora estándar de Nueva Zelanda

    • (UTC- 11:00) Hora de las Islas Midway

    • (UTC- 10:00) Hora estándar de Hawái

    • (UTC- 09:00) Hora estándar de Alaska

    • (UTC- 08:00) Hora estándar del Pacífico

    • (UTC- 07:00) Hora estándar de Phoenix

    • (UTC- 06:00) Hora estándar central

    • (UTC- 05:00) Hora estándar del Este

    • (UTC- 04:00) Hora de Puerto Rico y las Islas Vírgenes de los Estados Unidos

    • (UTC- 03:00) Hora estándar de Argentina

    • (UTC- 02:00) Hora de Georgia del Sur

    • (UTC- 01:00) Hora de África Central

ejemplo intervalo de tiempo personalizado con un desplazamiento (consola)

El siguiente ejemplo muestra cómo definir un intervalo de tiempo de 12 horas con un desfase el 20 de febrero de 2021 a las 18:30:30 (). PST

Para definir un intervalo personalizado con un desplazamiento

  1. En Intervalo de tiempo, elija Intervalo personalizado.

  2. Para Intervalo de tiempo, realice una de las siguientes acciones:

    • Escriba 12 y, a continuación, elija horas.

    • Escriba 720 y, a continuación, elija minutos.

    • Escriba 43200 y, a continuación, elija segundos.

    importante

    El Intervalo de tiempo debe ser un número entero, independientemente de cuál sea la unidad.

  3. En Desplazamiento de la fecha, elija 20/02/2021.

  4. En Desplazamiento de la hora, escriba 18:30:30.

  5. En Offset, zona horaria, elija (UTC- 08:00), hora estándar del Pacífico.

Si crea la métrica el 1 de julio de 2021, antes o a las 18:30:30 (PST), obtendrá el primer resultado de agregación el 1 de julio de 2021 a las 18:30:30 (). PST El segundo resultado de la agregación es el 2 de julio de 2021, a las 06:30:30 a.m. ()PST, y así sucesivamente.

Defina las métricas ()AWS CLI

Al definir una métrica para un modelo de activos con AWS IoT SiteWise API, se especifican los siguientes parámetros:

  • name: el nombre de la propiedad.

  • dataType: el tipo de datos de la métrica, que puede ser DOUBLE o STRING.

  • externalId— (Opcional) Se trata de un ID definido por el usuario. Para obtener más información, consulte Haga referencia a objetos con objetos externos IDs en la Guía del usuario de AWS IoT SiteWise .

  • expression: la expresión métrica. Las expresiones métricas pueden utilizar funciones de agregación para introducir datos de una propiedad para todos los activos asociados en una jerarquía. Para obtener más información, consulte Usa expresiones de fórmula.

  • window: el intervalo de tiempo y el desplazamiento de la ventana de saltos de la métrica, donde cada intervalo comienza cuando termina el anterior:

    • interval: el intervalo de tiempo para la ventana de caída. El intervalo de tiempo debe estar comprendido entre un minuto y una semana.

    • offsets: el desvío de la ventana de caída.

    Para obtener más información, consulte TumblingWindowla AWS IoT SiteWise APIReferencia.

    ejemplo intervalo de tiempo personalizado con un desplazamiento (AWS CLI)

    El siguiente ejemplo muestra cómo definir un intervalo de tiempo de 12 horas con un desfase el 20 de febrero de 2021 a las 18:30:30 (). PST

    
{
    "window": {
        "tumbling": {
            "interval": "12h",
            "offset": " 2021-07-23T18:30:30-08"
        }
    }
}

    Si crea la métrica el 1 de julio de 2021, antes o a las 18:30:30 (PST), obtendrá el primer resultado de agregación el 1 de julio de 2021 a las 18:30:30 (). PST El segundo resultado de la agregación es el 2 de julio de 2021, a las 06:30:30 a.m. ()PST, y así sucesivamente.

  • variables: una lista de variables que define las otras propiedades del activo o los activos secundarios que se van a utilizar en la expresión. Cada estructura de variable contiene un nombre sencillo para su uso en la expresión y una estructura value que identifica qué propiedad vincular a esa variable. La estructura value contiene la siguiente información:

    • propertyId: el ID de la propiedad desde la cual se extraen los valores. Puede utilizar el nombre de la propiedad en lugar de su identificador si la propiedad está definida en el modelo actual (en lugar de definirse en un modelo de una jerarquía).

    • hierarchyId: (opcional) el ID de la jerarquía desde la que se consultan las entidades secundarias de la propiedad. Puede utilizar el nombre de la definición de jerarquía en lugar de su ID. Si omite este valor, AWS IoT SiteWise busca la propiedad en el modelo actual.

    importante

    Las métricas solo pueden agregar propiedades de tipo entero, doble, booleano o cadena. Los valores booleanos se convierten en 0 (falso) y 1 (verdadero).

    Si define variables de entrada de métrica en la expresión de una métrica, esas entradas deben tener el mismo intervalo de tiempo que la métrica de salida.

    Las expresiones de fórmula solo pueden generar valores dobles o de cadena. Las expresiones anidadas pueden generar otros tipos de datos, como cadenas, pero la fórmula en su conjunto debe evaluarse como un número o una cadena. Puede usar la función jp para convertir una cadena en un número. El valor booleano debe ser 1 (verdadero) o 0 (falso). Para obtener más información, consulte Valores indefinidos, infinitos y de desbordamiento.

  • unit: (opcional) la unidad científica de la propiedad, como mm o Celsius.

ejemplo Definición de métrica de ejemplo

En el ejemplo siguiente se muestra una propiedad de métrica que agrega los datos de medición de temperatura de un activo para calcular la temperatura máxima por hora en Fahrenheit. Este objeto es un ejemplo de un objeto AssetModelPropertyque contiene una métrica. Puede especificar este objeto como parte de la carga útil de la CreateAssetModelsolicitud para crear una propiedad métrica. Para obtener más información, consulte Cree un modelo de activos (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"
      }
    ],
    ...
}
ejemplo Ejemplo de definición de métrica que introduce datos procedentes de los activos asociados

El siguiente ejemplo muestra una propiedad métrica que agrega los datos de potencia media de varias turbinas eólicas para calcular la potencia media total de un parque eólico. Este objeto es un ejemplo de un objeto AssetModelPropertyque contiene una métrica. Puede especificar este objeto como parte de la carga útil de la CreateAssetModelsolicitud para crear una propiedad métrica. 

{
      ...
      "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"
      }
    ],
    ...
}