Creazione di un modello di asset (console)Creazione di un modello di asset (AWS CLI)Modelli di asset di esempio

Creazione dei modelli di asset

AWS IoT SiteWise i modelli di asset favoriscono la standardizzazione dei dati industriali. Un modello include un nome e una descrizione, oltre a proprietà e definizioni gerarchiche di asset. Ad esempio, è possibile definire un modello di turbina eolica con proprietà di temperatura, rotazioni al minuto (RPM) e potenza. Quindi, è possibile definire un modello di parco eolico con una proprietà di potenza netta e una definizione di gerarchia di turbine eoliche.

Nota

Si consiglia di modellare l'operazione partendo dai nodi di livello inferiore. Ad esempio, crea il modello di turbina eolica prima di creare il modello di centrale eolica. Le definizioni della gerarchia delle risorse contengono riferimenti a modelli di asset esistenti. Con questo approccio, puoi definire le gerarchie di asset durante la creazione dei modelli.
I modelli di asset non possono contenere altri modelli di asset. Se dovete definire un modello a cui potete fare riferimento come sottoassieme all'interno di un altro modello, dovreste invece creare un modello componente-->. Per ulteriori informazioni, consulta Creazione di modelli di componenti.

Le sezioni seguenti descrivono come utilizzare la AWS IoT SiteWise console o l'API per creare modelli di asset. Nelle sezioni seguenti vengono inoltre descritti i diversi tipi di proprietà e gerarchie degli asset che puoi utilizzare per creare modelli.

Argomenti

Creazione di un modello di asset (console)
Creazione di un modello di asset (AWS CLI)
Modelli di asset di esempio
Definizione delle gerarchie dei modelli di asset

Creazione di un modello di asset (console)

È possibile utilizzare la AWS IoT SiteWise console per creare un modello di asset. La AWS IoT SiteWise console offre varie funzionalità, come il completamento automatico delle formule, che possono aiutarti a definire modelli di asset validi.

Per creare un modello di asset (console)

Passare alla console AWS IoT SiteWise.
Nel riquadro di navigazione selezionare Models (Modelli).
Scegli Crea modello.
Nella pagina Crea modello, esegui le operazioni seguenti:
1. Immetti un nome per il modello di asset, ad esempio Wind Turbine o Wind Turbine Model. Questo nome deve essere univoco rispetto a tutti i modelli del tuo account in questa regione.
2. (Facoltativo) Aggiungete un ID esterno per il modello. Si tratta di un ID definito dall'utente. Per ulteriori informazioni, consulta Riferimento a oggetti con ID esterni nella Guida per l'utente di AWS IoT SiteWise .
3. (Facoltativo) Aggiungi le definizioni misurazione per il modello. Le misurazioni rappresentano flussi di dati provenienti dall'apparecchiatura. Per ulteriori informazioni, consulta Definizione dei flussi di dati provenienti dalle apparecchiature (misurazioni).
4. (Facoltativo) Aggiungi le definizioni di trasformazione per il modello. Le trasformazioni sono formule che mappano i dati da un modulo all'altro. Per ulteriori informazioni, consulta Trasformazione dei dati (trasformazioni).
5. (Facoltativo) Aggiungi le definizioni parametro per il modello. Le metriche sono formule che aggregano i dati su intervalli di tempo. Le metriche possono inserire dati dalle risorse associate, in modo da poter calcolare valori che rappresentano l'operazione o un sottoinsieme dell'operazione. Per ulteriori informazioni, consulta Aggregazione di dati da proprietà e altre risorse (metriche).
6. (Facoltativo) Aggiungi le definizioni gerarchiche per il modello. Le gerarchie sono relazioni tra risorse. Per ulteriori informazioni, consulta Definizione delle gerarchie dei modelli di asset.
7. (Facoltativo) Aggiungi i tag per il modello di asset. Per ulteriori informazioni, consulta Taggare le tue risorse AWS IoT SiteWise.
8. Scegli Crea modello.
Quando si crea un modello di asset, la AWS IoT SiteWise console accede alla pagina del nuovo modello. In questa pagina puoi vedere lo stato del modello che inizialmente è CREAZIONE IN CORSO. Questa pagina si aggiorna automaticamente, quindi attendi l'aggiornamento dello stato del modello.

Nota
Il processo di creazione del modello di asset può richiedere fino a qualche minuto, nei casi di maggiore complessità. Dopo che lo stato del modello di asset è ATTIVO, potete utilizzare il modello di asset per creare risorse. Per ulteriori informazioni, consulta Stati di asset e modelli.
(Facoltativo) Dopo aver creato il modello di asset, potete configurare il modello di asset per l'edge. Per ulteriori informazioni su SiteWise Edge, consultaAbilitare l'elaborazione dei dati edge.
1. Nella pagina del modello, scegli Configure for Edge.
2. Nella pagina di configurazione del modello, scegli la configurazione del bordo per il tuo modello. Questo controlla dove AWS IoT SiteWise è possibile calcolare e archiviare le proprietà associate a questo modello di asset. Per ulteriori informazioni sulla configurazione del modello per l'edge, consulta. Configurazione della funzionalità edge
3. Per la configurazione edge personalizzata, scegliete la posizione in cui desiderate AWS IoT SiteWise calcolare e archiviare ciascuna delle proprietà del modello di asset.
  
  Nota
  Le trasformazioni e le metriche associate devono essere configurate per la stessa posizione. Per ulteriori informazioni sulla configurazione del modello per l'edge, consulta. Configurazione della funzionalità edge
4. Selezionare Salva. Nella pagina del modello, la configurazione di Edge dovrebbe ora essere configurata.

Creazione di un modello di asset (AWS CLI)

È possibile utilizzare AWS Command Line Interface (AWS CLI) per creare un modello di asset.

Utilizzate l'operazione CreateAssetModel per creare un modello di asset con proprietà e gerarchie. Questa operazione prevede un payload con la seguente struttura.


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

Per creare un modello di asset ()AWS CLI

Crea un file denominato asset-model-payload.json e copia il seguente oggetto JSON nel file.


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

  ],
  "assetModelHierarchies": [

  ],
  "assetModelCompositeModels": [

  ]
}

Utilizza l'editor di testo JSON preferito per modificare il file asset-model-payload.json come segue:
1. Immetti un nome (assetModelName) per il modello di asset, ad esempio Wind Turbine o Wind Turbine Model. In questo caso, questo nome deve essere univoco per tutti i modelli di asset e i modelli di componenti del tuo account Regione AWS.
2. (Facoltativo) Inserite un ID esterno (assetModelExternalId) per il modello di asset. Si tratta di un ID definito dall'utente. Per ulteriori informazioni, consulta Riferimento a oggetti con ID esterni nella Guida per l'utente di AWS IoT SiteWise .
3. (Facoltativo) Immetti una descrizione (assetModelDescription) per il modello di asset o rimuovi la coppia chiave-valore assetModelDescription.
4. (Facoltativo) Definisci le proprietà dell'asset (assetModelProperties) per il modello. Per ulteriori informazioni, consulta Definizione delle proprietà dei dati.
5. (Facoltativo) Definisci le gerarchie dell'asset (assetModelHierarchies) per il modello. Per ulteriori informazioni, consulta Definizione delle gerarchie dei modelli di asset.
6. (Facoltativo) Definite gli allarmi per il modello. Gli allarmi monitorano altre proprietà in modo da poter identificare quando le apparecchiature o i processi richiedono attenzione. Ogni definizione di allarme è un modello composito (assetModelCompositeModels) che standardizza l'insieme di proprietà utilizzate dall'allarme. Per ulteriori informazioni, consulta Monitoraggio dei dati con allarmi e Definizione degli allarmi sui modelli di asset.
7. (Facoltativo) Aggiungi i tag (tags) per il modello di asset. Per ulteriori informazioni, consulta Taggare le tue risorse AWS IoT SiteWise.
Esegui il comando seguente per creare un modello di asset dalla definizione nel file JSON.
```
aws iotsitewise create-asset-model --cli-input-json file://asset-model-payload.json
```
L'operazione restituisce una risposta contenente l'assetModelId univoco al quale fai riferimento quando crei un asset. La risposta contiene anche lo stato del modello (assetModelStatus.state) che inizialmente è CREATING. Lo stato del modello di asset è CREATING fino a quando le modifiche non si propagano.

Nota
Il processo di creazione del modello di asset può richiedere fino a qualche minuto, nei casi di maggiore complessità. Per verificare lo stato attuale del modello di asset, utilizzate l'operazione DescribeAssetModello specificando il. assetModelId Una volta contrassegnato dallo stato ACTIVE, il modello potrà essere utilizzato per creare asset. Per ulteriori informazioni, consulta Stati di asset e modelli.
(Facoltativo) Crea modelli compositi personalizzati per il tuo modello di asset. Con i modelli compositi personalizzati, è possibile raggruppare le proprietà all'interno del modello o includere un sottoassieme facendo riferimento a un modello di componente. Per ulteriori informazioni, consulta Creazione di modelli compositi personalizzati (Componenti).

Modelli di asset di esempio

Questa sezione contiene esempi di definizioni di modelli di asset che è possibile utilizzare per creare modelli di asset con gli SDK e. AWS CLI AWS IoT SiteWise Questi modelli di asset rappresentano una turbina eolica e un parco eolico. Gli asset delle turbine eoliche acquisiscono i dati grezzi dei sensori e calcolano valori come la potenza e la velocità media del vento. Gli asset del parco eolico calcolano valori come la potenza totale per tutte le turbine eoliche del parco eolico.

Modello di asset turbina eolica

Il seguente modello di asset rappresenta una turbina in una centrale eolica. La turbina eolica acquisisce i dati dei sensori per calcolare valori come la potenza e la velocità media del vento.

Nota

Questo modello di esempio è simile al modello di turbina eolica mostrato nella demo. AWS IoT SiteWise Per ulteriori informazioni, consulta Utilizzo della 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": []
}

Modello di asset centrale eolica

Il seguente modello di asset rappresenta una centrale eolica che comprende più turbine eoliche. Questo modello di asset definisce una gerarchia rispetto al modello di turbina eolica. Ciò consente al parco eolico di calcolare i valori (come la potenza media) a partire dai dati di tutte le turbine eoliche del parco eolico.

Nota

Questo modello di esempio è simile al modello di parco eolico illustrato nella AWS IoT SiteWise demo. Per ulteriori informazioni, consulta Utilizzo della AWS IoT SiteWise demo.

Questo modello di asset dipende da Modello di asset turbina eolica. Sostituisci i valori propertyId e childAssetModelId con quelli di un modello di asset turbina eolica esistente.


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

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Creazione di modelli di asset e modelli di componenti

Definizione delle gerarchie dei modelli di asset