Cree modelos de activos - AWS IoT SiteWise

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.

Cree modelos de activos

AWS IoT SiteWise los modelos de activos impulsan la estandarización de sus datos industriales. Un modelo de activos contiene el nombre, la descripción, las propiedades de activos y las definiciones de jerarquía de activos. Por ejemplo, puede definir un modelo de aerogenerador con propiedades de temperatura, rotaciones por minuto (RPM) y potencia. A continuación, puede definir un modelo de parque eólico con una propiedad de salida de potencia neta y una definición de jerarquía de turbina eólica.

nota
  • Le recomendamos que modele su operación comenzando con los nodos de nivel más bajo. Por ejemplo, cree el modelo de turbina eólica antes de crear el modelo de parque eólico. Las definiciones de jerarquía de activos contienen referencias a modelos de activos existentes. Con este enfoque, puede definir jerarquías de activos a medida que crea sus modelos.

  • Los modelos de activos no pueden contener otros modelos de activos. Si debe definir un modelo al que pueda hacer referencia como subensamblaje dentro de otro modelo, debe crear un modelo de component--> en su lugar. Para obtener más información, consulte Cree modelos de componentes.

En las siguientes secciones se describe cómo utilizar la AWS IoT SiteWise consola o cómo API crear modelos de activos. En las secciones siguientes también se describen los diferentes tipos de propiedades y jerarquías de activos que se pueden utilizar para crear modelos.

Cree un modelo de activos (consola)

Puede utilizar la AWS IoT SiteWise consola para crear un modelo de activos. La AWS IoT SiteWise consola ofrece varias funciones, como el autocompletado de fórmulas, que pueden ayudarle a definir modelos de activos válidos.

Para crear un modelo de activos (consola)
  1. Vaya a la consola de AWS IoT SiteWise.

  2. En el panel de navegación, elija Models (Modelos).

  3. Seleccione Crear modelo.

  4. En la página Crear un modelo, haga lo siguiente:

    1. Escriba un Nombre para el modelo de activos, como Wind Turbine o Wind Turbine Model. Este nombre debe ser único en todos los modelos de su cuenta en esta región.

    2. (Opcional) Añada un identificador externo para el modelo. Se trata de un identificador 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 .

    3. (Opcional) Agregue Definiciones de mediciones para el modelo. Las mediciones representan flujos de datos de su equipo. Para obtener más información, consulte Defina los flujos de datos del equipo (mediciones).

    4. (Opcional) Agregue Definiciones de transformación para el modelo. Las transformaciones son fórmulas que asignan datos de un formulario a otro. Para obtener más información, consulte Transforma los datos (transforma).

    5. (Opcional) Agregue Definiciones de métricas para el modelo. Las métricas son fórmulas que agregan datos a lo largo de intervalos de tiempo. Las métricas pueden agregar datos de entrada de activos asociados, de modo que puede calcular valores que representan la operación o un subconjunto de la operación. Para obtener más información, consulte Agregue datos de propiedades y otros activos (métricas).

    6. (Opcional) Agregue Definiciones de la jerarquía para el modelo. Las jerarquías son relaciones entre activos. Para obtener más información, consulte Defina las jerarquías del modelo de activos.

    7. (Opcional) Agregue etiquetas para el modelo de activos. Para obtener más información, consulte Etiquete sus AWS IoT SiteWise recursos.

    8. Seleccione Crear modelo.

    Al crear un modelo de activos, la AWS IoT SiteWise consola navega hasta la página del nuevo modelo. En esta página, puede ver el estado del modelo, que es inicialmente CREATING. Esta página se actualiza automáticamente, por lo que puede esperar a que se actualice el estado del modelo.

    nota

    El proceso de creación de un modelo de activos puede tardar unos minutos para modelos complejos. Una vez que el estado del modelo de activos sea ACTIVE, puede utilizar el modelo de activos para crear activos. Para obtener más información, consulte Estados de activos y modelos.

  5. (Opcional) Tras crear el modelo de activo, puede configurarlo para la periferia. Para obtener más información sobre SiteWise Edge, consulteActivar el procesamiento de datos periféricos.

    1. En la página del modelo, elija Configurar para Edge.

    2. En la página de configuración del modelo, elija la configuración de periferia para el modelo. Esto controla dónde se AWS IoT SiteWise pueden calcular y almacenar las propiedades asociadas a este modelo de activos. Para obtener más información acerca de la configuración del modelo para la periferia, consulte Configuración de la capacidad de periferia.

    3. Para la configuración perimetral personalizada, elija la ubicación en la que desee AWS IoT SiteWise calcular y almacenar cada una de las propiedades del modelo de activos.

      nota

      Las transformaciones y las métricas asociadas deben configurarse para la misma ubicación. Para obtener más información acerca de la configuración del modelo para la periferia, consulte Configuración de la capacidad de periferia.

    4. Seleccione Guardar. En la página del modelo, su Configuración de periferia ahora debería estar Configurada.

Cree un modelo de activos (AWS CLI)

Puede usar AWS Command Line Interface (AWS CLI) para crear un modelo de activos.

Utilice la CreateAssetModeloperación para crear un modelo de activos con propiedades y jerarquías. Esta operación espera una carga con la siguiente estructura.

{ "assetModelType": "ASSET_MODEL", "assetModelName": "String", "assetModelDescription": "String", "assetModelProperties": Array of AssetModelProperty, "assetModelHierarchies": Array of AssetModelHierarchyDefinition }
Para crear un modelo de activos ()AWS CLI
  1. Cree un archivo llamado asset-model-payload.json y, a continuación, copie el siguiente JSON objeto en el archivo.

    { "assetModelType": "ASSET_MODEL", "assetModelName": "", "assetModelDescription": "", "assetModelProperties": [ ], "assetModelHierarchies": [ ], "assetModelCompositeModels": [ ] }
  2. Utilice el editor de JSON texto que prefiera para editar el asset-model-payload.json archivo para lo siguiente:

    1. Escriba un nombre (assetModelName) para el modelo de activos, como Wind Turbine o Wind Turbine Model. Este nombre debe ser único en todos los modelos de activos y modelos de componentes de su cuenta Región de AWS.

    2. (Opcional) Introduzca un identificador externo (assetModelExternalId) para el modelo de activos. 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 .

    3. (Opcional) Escriba una descripción (assetModelDescription) para el modelo de activos o elimine el par de clave-valor assetModelDescription.

    4. (Opcional) Defina las propiedades del activo (assetModelProperties) para el modelo. Para obtener más información, consulte Defina las propiedades de los datos.

    5. (Opcional) Defina jerarquías de activos (assetModelHierarchies) para el modelo. Para obtener más información, consulte Defina las jerarquías del modelo de activos.

    6. (Opcional) Defina las alarmas para el modelo. Las alarmas monitorean otras propiedades para que pueda identificar cuándo requieren atención los equipos o procesos. Cada definición de alarma es un modelo compuesto (assetModelCompositeModels) que estandariza el conjunto de propiedades que utiliza la alarma. Para obtener más información, consulte Supervise los datos con alarmas y Defina las alarmas en los modelos de activos.

    7. (Opcional) Agregue etiquetas (tags) para el modelo de activos. Para obtener más información, consulte Etiquete sus AWS IoT SiteWise recursos.

  3. Ejecute el siguiente comando para crear un modelo de activos a partir de la definición del JSON archivo.

    aws iotsitewise create-asset-model --cli-input-json file://asset-model-payload.json

    La operación devuelve una respuesta que contiene assetModelId al que hace referencia al crear un activo. La respuesta también contiene el estado del modelo (assetModelStatus.state), que es inicialmente CREATING. El estado del modelo de activos es CREATING hasta que se propagan los cambios.

    nota

    El proceso de creación de un modelo de activos puede tardar unos minutos para modelos complejos. Para comprobar el estado actual de su modelo de activos, utilice la DescribeAssetModeloperación especificando elassetModelId. Una vez que el estado del modelo de activos sea ACTIVE, puede utilizarlo para crear activos. Para obtener más información, consulte Estados de activos y modelos.

  4. (Opcional) Cree modelos compuestos personalizados para su modelo de activos. Con los modelos compuestos personalizados, puede agrupar propiedades dentro del modelo o incluir un subensamblaje haciendo referencia a un modelo de componente. Para obtener más información, consulte Cree modelos compuestos personalizados (componentes).

Modelos de activos de ejemplo

Esta sección contiene ejemplos de definiciones de modelos de activos que puede utilizar para crear modelos de activos con y. AWS CLI AWS IoT SiteWise SDKs Estos modelos de activos representan una turbina eólica y un parque eólico. Los activos de las turbinas eólicas ingieren datos sin procesar de los sensores y calculan valores como la potencia y la velocidad media del viento. Los activos del parque eólico calculan valores como la potencia total de todas las turbinas eólicas del parque eólico.

Modelo de activos de turbina eólica

El siguiente modelo de activos representa una turbina en un parque eólico. La turbina eólica ingiere los datos de los sensores para calcular valores como la potencia y la velocidad media del viento.

nota

Este modelo de ejemplo se parece al modelo de aerogenerador de la AWS IoT SiteWise demostración. Para obtener más información, consulte Usa la AWS IoT SiteWise demo.

{ "assetModelType": "ASSET_MODEL", "assetModelName": "Wind Turbine Asset Model", "assetModelDescription": "Represents a turbine in a wind farm.", "assetModelProperties": [ { "name": "Location", "dataType": "STRING", "type": { "attribute": { "defaultValue": "Renton" } } }, { "name": "Make", "dataType": "STRING", "type": { "attribute": { "defaultValue": "Amazon" } } }, { "name": "Model", "dataType": "INTEGER", "type": { "attribute": { "defaultValue": "500" } } }, { "name": "Torque (KiloNewton Meter)", "dataType": "DOUBLE", "unit": "kNm", "type": { "measurement": {} } }, { "name": "Wind Direction", "dataType": "DOUBLE", "unit": "Degrees", "type": { "measurement": {} } }, { "name": "RotationsPerMinute", "dataType": "DOUBLE", "unit": "RPM", "type": { "measurement": {} } }, { "name": "Wind Speed", "dataType": "DOUBLE", "unit": "m/s", "type": { "measurement": {} } }, { "name": "RotationsPerSecond", "dataType": "DOUBLE", "unit": "RPS", "type": { "transform": { "expression": "rpm / 60", "variables": [ { "name": "rpm", "value": { "propertyId": "RotationsPerMinute" } } ] } } }, { "name": "Overdrive State", "dataType": "DOUBLE", "type": { "transform": { "expression": "gte(torque, 3)", "variables": [ { "name": "torque", "value": { "propertyId": "Torque (KiloNewton Meter)" } } ] } } }, { "name": "Average Power", "dataType": "DOUBLE", "unit": "Watts", "type": { "metric": { "expression": "avg(torque) * avg(rps) * 2 * 3.14", "variables": [ { "name": "torque", "value": { "propertyId": "Torque (Newton Meter)" } }, { "name": "rps", "value": { "propertyId": "RotationsPerSecond" } } ], "window": { "tumbling": { "interval": "5m" } } } } }, { "name": "Average Wind Speed", "dataType": "DOUBLE", "unit": "m/s", "type": { "metric": { "expression": "avg(windspeed)", "variables": [ { "name": "windspeed", "value": { "propertyId": "Wind Speed" } } ], "window": { "tumbling": { "interval": "5m" } } } } }, { "name": "Torque (Newton Meter)", "dataType": "DOUBLE", "unit": "Nm", "type": { "transform": { "expression": "knm * 1000", "variables": [ { "name": "knm", "value": { "propertyId": "Torque (KiloNewton Meter)" } } ] } } }, { "name": "Overdrive State Time", "dataType": "DOUBLE", "unit": "Seconds", "type": { "metric": { "expression": "statetime(overdrive_state)", "variables": [ { "name": "overdrive_state", "value": { "propertyId": "Overdrive State" } } ], "window": { "tumbling": { "interval": "5m" } } } } } ], "assetModelHierarchies": [] }

Modelo de activos de parque eólico

El siguiente modelo de activos representa un parque eólico que comprende varias turbinas eólicas. Este modelo de activos define una jerarquía con respecto al modelo de turbinas eólicas. Esto permite al parque eólico calcular valores (como la potencia media) a partir de los datos de todas las turbinas eólicas del parque eólico.

nota

Este modelo de ejemplo se parece al modelo de parque eólico de la AWS IoT SiteWise demostración. Para obtener más información, consulte Usa la AWS IoT SiteWise demo.

Este modelo de activos depende de Modelo de activos de turbina eólica. Sustituya los valores propertyId y childAssetModelId por los de un modelo de activos de turbina eólica existente.

{ "assetModelName": "Wind Farm Asset Model", "assetModelDescription": "Represents a wind farm.", "assetModelProperties": [ { "name": "Code", "dataType": "INTEGER", "type": { "attribute": { "defaultValue": "300" } } }, { "name": "Location", "dataType": "STRING", "type": { "attribute": { "defaultValue": "Renton" } } }, { "name": "Reliability Manager", "dataType": "STRING", "type": { "attribute": { "defaultValue": "Mary Major" } } }, { "name": "Total Overdrive State Time", "dataType": "DOUBLE", "unit": "seconds", "type": { "metric": { "expression": "sum(overdrive_state_time)", "variables": [ { "name": "overdrive_state_time", "value": { "propertyId": "ID of Overdrive State Time property in Wind Turbine Asset Model", "hierarchyId": "Turbine Asset Model" } } ], "window": { "tumbling": { "interval": "5m" } } } } }, { "name": "Total Average Power", "dataType": "DOUBLE", "unit": "Watts", "type": { "metric": { "expression": "sum(turbine_avg_power)", "variables": [ { "name": "turbine_avg_power", "value": { "propertyId": "ID of Average Power property in Wind Turbine Asset Model", "hierarchyId": "Turbine Asset Model" } } ], "window": { "tumbling": { "interval": "5m" } } } } } ], "assetModelHierarchies": [ { "name": "Turbine Asset Model", "childAssetModelId": "ID of Wind Turbine Asset Model" } ] }