Creación de 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 turbina eólica 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 Creación de modelos de componentes.

En las siguientes secciones se describe cómo utilizar la AWS IoT SiteWise consola o la API para 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.

Temas

• Creación de un modelo de activos (consola)
• Crear un modelo de activos (AWS CLI)
• Modelos de activos de ejemplo
• Definición de jerarquías de modelos de activos

Creación de un modelo de activos (consola)

Puede usar 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 Hacer referencia a objetos con identificadores externos 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 Definición de flujos de datos procedentes 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 Transformación de datos (transformaciones).

   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 Agregación de 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 Definición de jerarquías de modelos de activos.

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

   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 consultar el Estado del modelo, que inicialmente es CREANDO. 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 ACTIVO, 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, consulteHabilitación del procesamiento de datos de la periferia.

   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.

Crear un modelo de activos (AWS CLI)

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

Utilice la operación CreateAssetModelo 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 objeto JSON en el archivo.

   {
     "assetModelType": "ASSET_MODEL",
     "assetModelName": "",
     "assetModelDescription": "",
     "assetModelProperties": [
   
     ],
     "assetModelHierarchies": [
   
     ],
     "assetModelCompositeModels": [
   
     ]
   }

2. Use su editor de texto JSON preferido para editar el archivo asset-model-payload.json para lo que se muestra a continuación:

   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 Hacer referencia a objetos con identificadores externos 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 Definición de las propiedades de datos.

   5. (Opcional) Defina jerarquías de activos (assetModelHierarchies) para el modelo. Para obtener más información, consulte Definición de jerarquías de modelos 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 Monitoreo de datos con alarmas y Definición de alarmas en los modelos de activos.

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

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

   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 operación DescribeAssetModelo 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 Creación de 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 los SDK AWS CLI y AWS IoT SiteWise . 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 Uso de la AWS IoT SiteWise demostración.

{
  "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 Uso de la AWS IoT SiteWise demostración.

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"
    }
  ]
}