Criar modelos de ativo - AWS IoT SiteWise

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Criar modelos de ativo

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 temperatura, rotações por minuto (RPM) e propriedades de energia. 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 ter mais informações, consulte Criação de modelos de componentes.

As seções a seguir descrevem como usar o AWS IoT SiteWise console ou a API para 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.

Criar 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)
  1. Navegue até o console do AWS IoT SiteWise.

  2. No painel de navegação, selecione Modelos.

  3. Escolha Criar modelo.

  4. 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 Referenciando objetos com IDs externos 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 ter mais informações, consulte Definindo 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 ter mais informações, consulte Transformando 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 ter mais informações, consulte Agregando dados de propriedades e outros ativos (métricas).

    6. (Opcional) Adicione Definições de hierarquia ao modelo. Hierarquias são relacionamentos entre ativos. Para ter mais informações, consulte Definindo hierarquias de modelos de ativos.

    7. (Opcional) Adicione tags ao modelo de ativo. Para ter mais informações, consulte Marcando seus recursos AWS IoT SiteWise.

    8. Escolha Criar modelo.

    Quando você cria um modelo de ativo, o AWS IoT SiteWise console navega até a página do novo modelo. Nessa página, você pode ver o Status do modelo que, inicialmente, é CRIANDO. 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 ATIVADO, você poderá usá-lo para criar ativos. Para ter mais informações, consulte Estados de ativos e modelos.

  5. (Opcional) Depois de criar seu modelo de ativo, você pode configurá-lo para a borda. Para obter mais informações sobre o SiteWise Edge, consulteHabilitar o processamento de dados de borda.

    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.

Criação de 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)
  1. Crie um arquivo chamado asset-model-payload.json e copie o objeto JSON a seguir no arquivo.

    { "assetModelType": "ASSET_MODEL", "assetModelName": "", "assetModelDescription": "", "assetModelProperties": [ ], "assetModelHierarchies": [ ], "assetModelCompositeModels": [ ] }
  2. Use seu editor de texto JSON preferido para editar o arquivo asset-model-payload.json 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 Referenciando objetos com IDs externos 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 ter mais informações, consulte Definir propriedades de dados.

    5. (Opcional) Defina hierarquias de ativos (assetModelHierarchies) para o modelo. Para ter mais informações, consulte Definindo 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 obter mais informações, consulte Monitorar dados com alarmes e Definir alarmes em modelos de ativos.

    7. (Opcional) Adicione tags (tags) ao modelo de ativo. Para ter mais informações, consulte Marcando seus recursos AWS IoT SiteWise.

  3. Execute o seguinte comando para criar um modelo de ativo usando a definição no arquivo JSON.

    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 ter mais informações, consulte Estados de ativos e modelos.

  4. (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 ter mais informações, consulte Criação de 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 os AWS IoT SiteWise SDKs AWS CLI 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 ter mais informações, consulte Usando 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 ter mais informações, consulte Usando 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" } ] }