Erstellen Sie Asset-Modelle - AWS IoT SiteWise

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Erstellen Sie Asset-Modelle

AWS IoT SiteWise Anlagenmodelle fördern die Standardisierung Ihrer Industriedaten. 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 Erstellen Sie Komponentenmodelle.

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

Erstellen Sie ein Asset-Modell (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)
  1. Navigieren Sie zur AWS IoT SiteWise -Konsole.

  2. Klicken Sie im Navigationsbereich auf Models (Modelle).

  3. Wählen Sie Modell erstellen aus.

  4. 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 Referenzobjekte mit externen IDs 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 Definieren Sie Datenströme von 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 Sie 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 Definieren Sie die Hierarchien der Anlagenmodelle.

    7. (Optional) Fügen Sie Tags für das Komponentenmodell hinzu. Weitere Informationen finden Sie unter Kennzeichnen Sie Ihre AWS IoT SiteWise Ressourcen.

    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 können Sie den Status des Modells sehen, der anfänglich CREATINGlautet. 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. Sobald der Status des Asset-Modells lautet ACTIVE, können Sie das Asset-Modell verwenden, um Assets zu erstellen. Weitere Informationen finden Sie unter Komponenten- und Modellzustände.

  5. (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 unterEdge-Datenverarbeitung einschalten.

    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 Save (Speichern) aus. Auf der Modellseite sollte Ihre Edge-Konfiguration jetzt konfiguriert sein.

Erstellen Sie ein Asset-Modell (AWS CLI)

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

Verwenden Sie die CreateAssetModelOperation, 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
  1. Erstellen Sie eine Datei mit dem Namen asset-model-payload.json und kopieren Sie dann das folgende JSON Objekt in die Datei.

    { "assetModelType": "ASSET_MODEL", "assetModelName": "", "assetModelDescription": "", "assetModelProperties": [ ], "assetModelHierarchies": [ ], "assetModelCompositeModels": [ ] }
  2. Verwenden Sie Ihren bevorzugten JSON Texteditor, um die asset-model-payload.json Datei 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 Referenzobjekte mit externen IDs 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 Sie Dateneigenschaften.

    5. (Optional) Definieren Sie Komponentenhierarchien (assetModelHierarchies) für das Modell. Weitere Informationen finden Sie unter Definieren Sie die Hierarchien der 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 erhalten Sie unter Überwachen Sie Daten mit Alarmen und Definieren Sie Alarme für Asset-Modelle.

    7. (Optional) Fügen Sie Tags (tags) für das Komponentenmodell hinzu. Weitere Informationen finden Sie unter Kennzeichnen Sie Ihre AWS IoT SiteWise Ressourcen.

  3. Führen Sie den folgenden Befehl aus, um aus der Definition in der JSON Datei ein Asset-Modell 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 Asset-Modells zu überprüfen, verwenden Sie den DescribeAssetModelVorgang, indem Sie den angebenassetModelId. Wenn der Status des Komponentenmodells „ACTIVE“ lautet, können mit dem Komponentenmodell Komponenten erstellen. Weitere Informationen finden Sie unter Komponenten- und Modellzustände.

  4. (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 Sie benutzerdefinierte Verbundmodelle (Komponenten).

Beispiel für Komponentenmodelle

Dieser Abschnitt enthält Beispieldefinitionen für Anlagenmodelle, die Sie verwenden können, um Objektmodelle mit dem AWS CLI und zu erstellen. AWS IoT SiteWise SDKs 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 Benutze die 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": [] }

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 Benutze die AWS IoT SiteWise Demo.

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