Crie um modelo de ativo (console)Crie um modelo de ativo (AWS CLI)Exemplos de modelos de ativos

Crie modelos de ativos

AWS IoT SiteWise modelos de ativos impulsionam a padronização de seus dados industriais. Um modelo de ativo contém um nome, uma descrição, propriedades do ativo e definições da hierarquia de ativos. Por exemplo, você pode definir um modelo de turbina eólica com propriedades de temperatura, rotações por minuto (RPM) e potência. Depois, você define um modelo de parque eólico com uma propriedade de saída de energia útil e uma definição de hierarquia de turbinas eólicas.

nota

Recomendamos modelar sua operação começando com os nós de nível mais baixo. Por exemplo, crie seu modelo de turbina eólica antes de criar seu modelo de parque eólico. As definições de hierarquia de ativos contêm referências a modelos de ativos existentes. Com essa abordagem, você pode definir hierarquias de ativos conforme cria seus modelos.
Os modelos de ativos não podem conter outros modelos de ativos. Se você precisar definir um modelo que possa ser referenciado como uma submontagem em outro modelo, crie um modelo de componente -> em vez disso. Para obter mais informações, consulte Crie modelos de componentes.

As seções a seguir descrevem como usar o AWS IoT SiteWise console ou API criar modelos de ativos. As seções a seguir também descrevem os diferentes tipos de propriedades e hierarquias de ativos que você pode usar para criar modelos.

Tópicos

Crie um modelo de ativo (console)
Crie um modelo de ativo (AWS CLI)
Exemplos de modelos de ativos
Definir hierarquias de modelos de ativos

Crie um modelo de ativo (console)

Você pode usar o AWS IoT SiteWise console para criar um modelo de ativo. O AWS IoT SiteWise console fornece vários recursos, como preenchimento automático de fórmulas, que podem ajudá-lo a definir modelos de ativos válidos.

Como criar um modelo de ativo (console)

Navegue até o console do AWS IoT SiteWise.
No painel de navegação, selecione Modelos.
Escolha Criar modelo.
Na página Criar modelo, faça o seguinte:
1. Insira um Nome para o modelo de ativo, como Wind Turbine ou Wind Turbine Model. Esse nome deve ser exclusivo em todos os modelos de sua conta nesta região.
2. (Opcional) Adicione uma ID externa para o modelo. Esse é um ID definido pelo usuário. Para obter mais informações, consulte Objetos de referência com objetos externos IDs no Guia de Usuário AWS IoT SiteWise .
3. (Opcional) Adicione Definições de medição ao modelo. As medições representam fluxos de dados do seu equipamento. Para obter mais informações, consulte Defina fluxos de dados do equipamento (medições).
4. (Opcional) Adicione Definições de transformação ao modelo. As transformações são fórmulas que mapeiam dados de um formulário para outro. Para obter mais informações, consulte Transforme dados (transformações).
5. (Opcional) Adicione Definições de métrica ao modelo. Métricas são fórmulas que agregam dados em intervalos de tempo. As métricas podem inserir dados de entrada de ativos associados, para que você possa calcular valores que representem sua operação ou um subconjunto de sua operação. Para obter mais informações, consulte Dados agregados de propriedades e outros ativos (métricas).
6. (Opcional) Adicione Definições de hierarquia ao modelo. Hierarquias são relacionamentos entre ativos. Para obter mais informações, consulte Definir hierarquias de modelos de ativos.
7. (Opcional) Adicione tags ao modelo de ativo. Para obter mais informações, consulte Marque seus AWS IoT SiteWise recursos.
8. Escolha Criar modelo.
Quando você cria um modelo de ativo, o AWS IoT SiteWise console navega até a página do novo modelo. Nesta página, você pode ver o status do modelo, que é inicialmente CREATING. Essa página é atualizada automaticamente, para que você possa aguardar a atualização do status do modelo.

nota
O processo de criação do modelo de ativo pode levar alguns minutos para modelos complexos. Depois que o status do modelo de ativo for ACTIVE, você poderá usar o modelo de ativo para criar ativos. Para obter mais informações, consulte Estados de ativos e modelos.
(Opcional) Depois de criar seu modelo de ativo, você pode configurá-lo para a borda. Para obter mais informações sobre o SiteWise Edge, consulteAtive o processamento de dados periférico.
1. Na página do modelo, escolha Configurar para Edge.
2. Na página de configuração do modelo, escolha a configuração de borda para seu modelo. Isso controla onde é AWS IoT SiteWise possível calcular e armazenar propriedades associadas a esse modelo de ativo. Para obter mais informações sobre como configurar seu modelo para a borda, consulte Configurar o recurso de borda.
3. Para Configuração de borda personalizada, escolha o local que você deseja AWS IoT SiteWise calcular e armazenar cada uma das propriedades do seu modelo de ativo.
  
  nota
  As transformações e métricas associadas devem ser configuradas para o mesmo local. Para obter mais informações sobre como configurar seu modelo para a borda, consulte Configurar o recurso de borda.
4. Escolha Salvar. Na página do modelo, sua configuração do Edge agora deve estar Configurada.

Crie um modelo de ativo (AWS CLI)

Você pode usar o AWS Command Line Interface (AWS CLI) para criar um modelo de ativo.

Use a CreateAssetModeloperação para criar um modelo de ativo com propriedades e hierarquias. Essa operação espera uma carga útil com a seguinte estrutura.


{
  "assetModelType": "ASSET_MODEL",
  "assetModelName": "String",
  "assetModelDescription": "String",
  "assetModelProperties": Array of AssetModelProperty,
  "assetModelHierarchies": Array of AssetModelHierarchyDefinition
}

Para criar um modelo de ativo (AWS CLI)

Crie um arquivo chamado asset-model-payload.json e, em seguida, copie o JSON objeto a seguir no arquivo.


{
  "assetModelType": "ASSET_MODEL",
  "assetModelName": "",
  "assetModelDescription": "",
  "assetModelProperties": [

  ],
  "assetModelHierarchies": [

  ],
  "assetModelCompositeModels": [

  ]
}

Use seu editor de JSON texto preferido para editar o asset-model-payload.json arquivo para o seguinte:
1. Insira um nome (assetModelName) para o modelo de ativo, como Wind Turbine ou Wind Turbine Model. Nesse caso, esse nome deve ser exclusivo em todos os modelos de ativos e modelos de componentes da sua conta Região da AWS.
2. (Opcional) Insira uma ID externa (assetModelExternalId) para o modelo de ativo. Esse é um ID definido pelo usuário. Para obter mais informações, consulte Objetos de referência com objetos externos IDs no Guia de Usuário AWS IoT SiteWise .
3. (Opcional) Insira uma descrição (assetModelDescription) para o modelo de ativo ou remova o par de chave-valor assetModelDescription.
4. (Opcional) Defina as propriedades do ativo (assetModelProperties) para o modelo. Para obter mais informações, consulte Definir propriedades de dados.
5. (Opcional) Defina hierarquias de ativos (assetModelHierarchies) para o modelo. Para obter mais informações, consulte Definir hierarquias de modelos de ativos.
6. (Opcional) Defina alarmes para o modelo. Os alarmes monitoram outras propriedades para que você possa identificar quando equipamentos ou processos requerem atenção. Cada definição de alarme é um modelo composto (assetModelCompositeModels) que padroniza o conjunto de propriedades usado pelo alarme. Para ter mais informações, consulte Monitore dados com alarmes e Defina alarmes em modelos de ativos.
7. (Opcional) Adicione tags (tags) ao modelo de ativo. Para obter mais informações, consulte Marque seus AWS IoT SiteWise recursos.
Execute o comando a seguir para criar um modelo de ativo a partir da definição no JSON arquivo.
```
aws iotsitewise create-asset-model --cli-input-json file://asset-model-payload.json
```
A operação retorna uma resposta que contém o assetModelId ao qual você faz referência ao criar um ativo. A resposta também contém o estado do modelo (assetModelStatus.state) que, inicialmente, é CREATING. O status do modelo de ativo é CREATING até que as alterações sejam propagadas.

nota
O processo de criação do modelo de ativo pode levar alguns minutos para modelos complexos. Para verificar o status atual do seu modelo de ativo, use a DescribeAssetModeloperação especificando o. assetModelId Depois que o status do modelo de ativo for ACTIVE, você poderá usá-lo para criar ativos. Para obter mais informações, consulte Estados de ativos e modelos.
(Opcional) Crie modelos compostos personalizados para seu modelo de ativo. Com modelos compostos personalizados, você pode agrupar propriedades dentro do modelo ou incluir uma submontagem fazendo referência a um modelo de componente. Para obter mais informações, consulte Crie modelos compostos personalizados (componentes).

Exemplos de modelos de ativos

Esta seção contém exemplos de definições de modelos de ativos que você pode usar para criar modelos de ativos com AWS CLI AWS IoT SiteWise SDKs e. Esses modelos de ativos representam uma turbina eólica e um parque eólico. Os ativos da turbina eólica ingerem dados brutos do sensor e calculam valores como potência e velocidade média do vento. Os ativos do parque eólico calculam valores como a potência total de todas as turbinas eólicas do parque eólico.

Modelo de ativo de turbina eólica

O modelo de ativo a seguir representa uma turbina em um parque eólico. A turbina eólica ingere dados do sensor para calcular valores como potência e velocidade média do vento.

nota

Este modelo de exemplo se assemelha ao modelo de turbina eólica da AWS IoT SiteWise demonstração. Para obter mais informações, consulte Use a AWS IoT SiteWise demonstração.


{
  "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 ativo de parque eólico

O modelo de ativo a seguir representa um parque eólico que é composto por várias turbinas eólicas. Esse modelo de ativos define uma hierarquia para o modelo de turbina eólica. Isso permite que o parque eólico calcule valores (como potência média) a partir dos dados de todas as turbinas eólicas do parque eólico.

nota

Esse modelo de exemplo se assemelha ao modelo de parque eólico da AWS IoT SiteWise demonstração. Para obter mais informações, consulte Use a AWS IoT SiteWise demonstração.

Esse modelo de ativo depende do Modelo de ativo de turbina eólica. Substitua os valores de childAssetModelId e propertyId por aqueles de um modelo de ativo 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"
    }
  ]
}

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Crie modelos

Definir hierarquias de modelos de ativos