Erstellen eines Komponentenmodells (Konsole)Ein Asset-Modell erstellen (AWS CLI)Beispiel für Komponentenmodelle

Erstellen von Komponentenmodellen

AWS IoT SiteWise Anlagenmodelle treiben die Standardisierung Ihrer Industriedaten voran. Ein Komponentenmodell enthält einen Namen, eine Beschreibung, Komponenteneigenschaften und Definitionen der Komponentenhierarchie. Sie können beispielsweise ein Windturbinenmodell mit Temperatur, Umdrehungen pro Minute (RPM) und Leistungseigenschaften definieren. Anschließend können Sie ein Windparkmodell mit einer Nettoleistungseigenschaft und einer Windturbinenhierarchiedefinition definieren.

Anmerkung

Es empfiehlt sich, bei der Modellierung mit den Knoten der untersten Ebene zu beginnen. Erstellen Sie das Windturbinenmodell beispielsweise vor dem Windparkmodell. Komponentenhierarchiedefinitionen enthalten Verweise auf vorhandene Komponentenmodelle. Wenn Sie diesen Ansatz verfolgen, können Sie Komponentenhierarchien bei der Modellerstellung definieren.
Anlagenmodelle können keine anderen Anlagenmodelle enthalten. Wenn Sie ein Modell definieren müssen, das Sie als Unterbaugruppe in einem anderen Modell referenzieren können, sollten Sie stattdessen ein Komponenten--> Modell erstellen. Weitere Informationen finden Sie unter Komponentenmodelle erstellen.

In den folgenden Abschnitten wird beschrieben, wie Sie die AWS IoT SiteWise Konsole oder API verwenden, um Objektmodelle zu erstellen. In den folgenden Abschnitten werden auch die verschiedenen Arten von Komponenteneigenschaften und Komponentenhierarchien beschrieben, die Sie zum Erstellen von Modellen verwenden können.

Themen

Erstellen eines Komponentenmodells (Konsole)
Ein Asset-Modell erstellen (AWS CLI)
Beispiel für Komponentenmodelle
Definition von Hierarchien für Anlagenmodelle

Erstellen eines Komponentenmodells (Konsole)

Sie können die AWS IoT SiteWise Konsole verwenden, um ein Asset-Modell zu erstellen. Die AWS IoT SiteWise Konsole bietet verschiedene Funktionen, z. B. die auto Vervollständigung von Formeln, mit denen Sie gültige Anlagenmodelle definieren können.

So erstellen Sie ein Komponentenmodell (Konsole)

Navigieren Sie zur AWS IoT SiteWise -Konsole.
Klicken Sie im Navigationsbereich auf Models (Modelle).
Wählen Sie Modell erstellen aus.
Gehen Sie auf der Seite Modell erstellen wie folgt vor:
1. Geben Sie unter Name einen Namen für das Komponentenmodell ein, z. B. Wind Turbine oder Wind Turbine Model. Dieser Name muss für alle Modelle in Ihrem Konto in dieser Region eindeutig sein.
2. (Optional) Fügen Sie eine externe ID für das Modell hinzu. Dies ist eine benutzerdefinierte ID. Weitere Informationen finden Sie unter Objekte mit externen IDs referenzieren im AWS IoT SiteWise -Benutzerhandbuch.
3. (Optional) Fügen Sie Messungsdefinitionen für das Modell hinzu. Messungen stellen Datenströme von Ihren Geräten dar. Weitere Informationen finden Sie unter Definition von Datenströmen aus Geräten (Messungen).
4. (Optional) Fügen Sie Transformationsdefinitionen für das Modell hinzu. Transformationen sind Formeln, die Daten von einem Formular auf ein anderes abbilden. Weitere Informationen finden Sie unter Daten transformieren (transformiert).
5. (Optional) Fügen Sie Metrik-Definitionen für das Modell hinzu. Metriken sind Formeln, die Daten über Zeitintervalle aggregieren. Mit Metriken können Daten aus zugehörigen Anlagen eingegeben werden, sodass Sie Werte berechnen können, die Ihren Betrieb oder einen Teil Ihres Betriebs repräsentieren. Weitere Informationen finden Sie unter Aggregieren von Daten aus Immobilien und anderen Vermögenswerten (Metriken).
6. (Optional) Fügen Sie Hierarchiedefinitionen für das Modell hinzu. Hierarchien sind Beziehungen zwischen Anlagen. Weitere Informationen finden Sie unter Definition von Hierarchien für Anlagenmodelle.
7. (Optional) Fügen Sie Tags für das Komponentenmodell hinzu. Weitere Informationen finden Sie unter Verschlagworten Sie Ihre Ressourcen AWS IoT SiteWise.
8. Wählen Sie Modell erstellen aus.
Wenn Sie ein Asset-Modell erstellen, navigiert die AWS IoT SiteWise Konsole zur Seite des neuen Modells. Auf dieser Seite sehen Sie den Status, des Modells, der anfänglich WIRD ERSTELLT lautet. Diese Seite wird automatisch aktualisiert. Sie können daher einfach abwarten, bis der Status des Modells aktualisiert wird.

Anmerkung
Das Erstellen von Komponentenmodellen kann für komplexe Modelle einige Minuten in Anspruch nehmen. Wenn der Status des Asset-Modells AKTIV ist, können Sie das Asset-Modell verwenden, um Assets zu erstellen. Weitere Informationen finden Sie unter Komponenten- und Modellzustände.
(Optional) Nachdem Sie Ihr Asset-Modell erstellt haben, können Sie Ihr Asset-Modell für den Edge konfigurieren. Weitere Informationen zu SiteWise Edge finden Sie unterAktivierung der Edge-Datenverarbeitung.
1. Wählen Sie auf der Modellseite Configure for Edge aus.
2. Wählen Sie auf der Seite mit der Modellkonfiguration die Edge-Konfiguration für Ihr Modell aus. Dadurch wird gesteuert, AWS IoT SiteWise wo die mit diesem Asset-Modell verknüpften Eigenschaften berechnet und gespeichert werden können. Weitere Informationen zur Konfiguration Ihres Modells für den Edge finden Sie unterEdge-Fähigkeit einrichten.
3. Wählen Sie für die benutzerdefinierte Kantenkonfiguration den Standort aus, AWS IoT SiteWise an dem Sie die einzelnen Eigenschaften Ihres Asset-Modells berechnen und speichern möchten.
  
  Anmerkung
  Die zugehörigen Transformationen und Metriken müssen für denselben Standort konfiguriert werden. Weitere Informationen zur Konfiguration Ihres Modells für den Edge finden Sie unterEdge-Fähigkeit einrichten.
4. Wählen Sie Speichern. Auf der Modellseite sollte Ihre Edge-Konfiguration jetzt konfiguriert sein.

Ein Asset-Modell erstellen (AWS CLI)

Sie können das AWS Command Line Interface (AWS CLI) verwenden, um ein Asset-Modell zu erstellen.

Verwenden Sie die CreateAssetModel-Operation, um ein Asset-Modell mit Eigenschaften und Hierarchien zu erstellen. Diese Operation erwartet eine Nutzlast mit der folgenden Struktur.


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

Um ein Asset-Modell zu erstellen ()AWS CLI

Erstellen Sie eine Datei namens asset-model-payload.json und kopieren Sie dann das folgende JSON-Objekt in die Datei.


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

  ],
  "assetModelHierarchies": [

  ],
  "assetModelCompositeModels": [

  ]
}

Verwenden Sie Ihren bevorzugten JSON-Texteditor, um die Datei asset-model-payload.json für Folgendes zu bearbeiten:
1. Geben Sie einen Namen (assetModelName) für das Komponentenmodell ein, z. B. Wind Turbine oder Wind Turbine Model. Dieser Name muss in diesem Fall für alle Asset- und Komponentenmodelle in Ihrem Konto eindeutig sein AWS-Region.
2. (Optional) Geben Sie eine externe ID (assetModelExternalId) für das Asset-Modell ein. Dies ist eine benutzerdefinierte ID. Weitere Informationen finden Sie unter Objekte mit externen IDs referenzieren im AWS IoT SiteWise -Benutzerhandbuch.
3. (Optional) Geben Sie eine Beschreibung (assetModelDescription) für das Komponentenmodell ein oder entfernen Sie das assetModelDescription-Schlüssel-Wert-Paar.
4. (Optional) Definieren Sie Komponenteneigenschaften (assetModelProperties) für das Modell. Weitere Informationen finden Sie unter Definieren von Dateneigenschaften.
5. (Optional) Definieren Sie Komponentenhierarchien (assetModelHierarchies) für das Modell. Weitere Informationen finden Sie unter Definition von Hierarchien für Anlagenmodelle.
6. (Optional) Definieren Sie Alarme für das Modell. Alarme überwachen andere Eigenschaften, sodass Sie erkennen können, wann Geräte oder Prozesse besondere Aufmerksamkeit erfordern. Jede Alarmdefinition ist ein zusammengesetztes Modell (assetModelCompositeModels), das die vom Alarm verwendeten Eigenschaften standardisiert. Weitere Informationen finden Sie unter Daten mit Alarmen überwachen und Definition von Alarmen für Anlagenmodelle.
7. (Optional) Fügen Sie Tags (tags) für das Komponentenmodell hinzu. Weitere Informationen finden Sie unter Verschlagworten Sie Ihre Ressourcen AWS IoT SiteWise.
Führen Sie den folgenden Befehl aus, um aus der Definition in der JSON-Datei ein Komponentenmodell zu erstellen.
```
aws iotsitewise create-asset-model --cli-input-json file://asset-model-payload.json
```
Die Operation gibt eine Antwort zurück, die die assetModelId enthält, auf die Sie beim Erstellen einer Komponente verweisen. Die Antwort enthält auch den Zustand des Modells (assetModelStatus.state), der anfänglich CREATING lautet. Der Status des Komponentenmodells ist CREATING, bis die Änderungen weitergegeben werden.

Anmerkung
Das Erstellen von Komponentenmodellen kann für komplexe Modelle einige Minuten in Anspruch nehmen. Um den aktuellen Status Ihres Anlagenmodells zu überprüfen, verwenden Sie die Operation DescribeAssetModell, indem Sie die assetModelId angeben. Wenn der Status des Komponentenmodells „ACTIVE“ lautet, können mit dem Komponentenmodell Komponenten erstellen. Weitere Informationen finden Sie unter Komponenten- und Modellzustände.
(Optional) Erstellen Sie benutzerdefinierte Verbundmodelle für Ihr Anlagenmodell. Mit benutzerdefinierten Verbundmodellen können Sie Eigenschaften innerhalb des Modells gruppieren oder eine Unterbaugruppe einbeziehen, indem Sie auf ein Komponentenmodell verweisen. Weitere Informationen finden Sie unter Erstellen von benutzerdefinierten Verbundmodellen (Komponenten).

Beispiel für Komponentenmodelle

Dieser Abschnitt enthält Beispieldefinitionen für Objektmodelle, die Sie verwenden können, um Objektmodelle mit den SDKs AWS CLI und AWS IoT SiteWise zu erstellen. Diese Anlagenmodelle stellen eine Windturbine und einen Windpark dar. Windkraftanlagen nehmen Sensorrohdaten auf und berechnen Werte wie Leistung und durchschnittliche Windgeschwindigkeit. Windparkanlagen berechnen Werte wie die Gesamtleistung aller Windturbinen im Windpark.

Windturbinen-Komponentenmodell

Das folgende Komponentenmodell stellt eine Turbine in einem Windpark dar. Die Windturbine nimmt Sensordaten auf, um Werte wie Leistung und durchschnittliche Windgeschwindigkeit zu berechnen.

Anmerkung

Dieses Beispielmodell ähnelt dem Windturbinenmodell aus der AWS IoT SiteWise Demo. Weitere Informationen finden Sie unter Die AWS IoT SiteWise Demo verwenden.


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

Windpark-Komponentenmodell

Das folgende Komponentenmodell stellt einen Windpark dar, der aus mehreren Windturbinen besteht. Dieses Anlagenmodell definiert eine Hierarchie für das Windturbinenmodell. Auf diese Weise kann der Windpark Werte (z. B. die Durchschnittsleistung) anhand von Daten für alle Windturbinen im Windpark berechnen.

Anmerkung

Dieses Beispielmodell ähnelt dem Windparkmodell aus der AWS IoT SiteWise Demo. Weitere Informationen finden Sie unter Die AWS IoT SiteWise Demo verwenden.

Dieses Komponentenmodell hängt von der Windturbinen-Komponentenmodell ab. Ersetzen Sie die Werte propertyId und childAssetModelId durch die Werte eines vorhandenen Komponentenmodells für Windturbinen.


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

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Erstellung von Asset- und Komponentenmodellen

Definition von Hierarchien für Anlagenmodelle