View a markdown version of this page

Aggregieren Sie Daten aus Immobilien und anderen Vermögenswerten (Metriken) - AWS IoT SiteWise
Definieren Sie Metriken (Konsole)Definieren Sie Metriken (AWS CLI)

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.

Aggregieren Sie Daten aus Immobilien und anderen Vermögenswerten (Metriken)

Metriken sind mathematische Ausdrücke, die Aggregierungsfunktionen verwenden, um alle Eingabedatenpunkte zu verarbeiten und einen einzelnen Datenpunkt pro angegebenem Zeitintervall auszugeben. Eine Metrik kann beispielsweise die stündliche Durchschnittstemperatur aus einem Temperaturdaten-Stream berechnen.

Metriken können Daten aus Metriken zugehöriger Komponenten eingeben, sodass Sie Statistiken berechnen können, die einen Einblick in die Operation oder eine Teilmenge der Operation gewähren. Beispielsweise kann eine Metrik die durchschnittliche stündliche Temperatur für alle Windturbinen in einem Windpark berechnen. Weitere Informationen zum Definieren von Verknüpfungen zwischen Komponenten finden Sie unter Definieren Sie Hierarchien der Anlagenmodelle.

Metriken können auch Daten aus anderen Eigenschaften eingeben, ohne die Daten für jedes Zeitintervall zu aggregieren. Wenn Sie ein Attribut in einer Formel angeben, AWS IoT SiteWise wird bei der Berechnung der Formel der neueste Wert für dieses Attribut verwendet. Wenn Sie eine Metrik in einer Formel angeben, AWS IoT SiteWise wird der letzte Wert für das Zeitintervall verwendet, über das die Formel berechnet wird. Das bedeutet, dass Sie Kennzahlen wie OEE = Availability * Quality * Performance AvailabilityQuality, wo und Performance wie alle anderen Metriken für dasselbe Anlagenmodell definieren können.

AWS IoT SiteWise berechnet außerdem automatisch eine Reihe grundlegender Aggregationsmetriken für alle Asset-Eigenschaften. Um Berechnungskosten zu reduzieren, können Sie diese Aggregate verwenden, anstatt benutzerdefinierte Metriken für grundlegende Berechnungen zu definieren. Weitere Informationen finden Sie unter Fragen Sie Aggregate von Anlageneigenschaften ab in AWS IoT SiteWise.

Definieren Sie Metriken (Konsole)

Wenn Sie in der AWS IoT SiteWise Konsole eine Metrik für ein Anlagenmodell definieren, geben Sie die folgenden Parameter an:

  • Name — Der Name der Eigenschaft.

  • Datentyp — Der Datentyp der Transformation, der Double oder String sein kann.

  • Externe ID — (Optional) Dies ist eine benutzerdefinierte ID. Weitere Informationen finden Sie unter Referenzobjekte mit externen IDs im AWS IoT SiteWise -Benutzerhandbuch.

  • Formel — Der metrische Ausdruck. Metrische Ausdrücke können Aggregationsfunktionen verwenden, um Daten aus einer Eigenschaft für alle zugehörigen Anlagen in einer Hierarchie einzugeben. Beginnen Sie mit der Eingabe oder drücken Sie die NACH-UNTEN-TASTE, um die Funktion zur automatischen Vervollständigung zu öffnen. Weitere Informationen finden Sie unter Verwenden Sie Formelausdrücke.

    Wichtig

    Bei Metriken kann es sich nur um Eigenschaften vom Typ Integer, Double, Boolean oder String handeln. Boolesche Werte werden in 0 (falsch) und 1 (wahr) konvertiert.

    Wenn Sie Metrikeingabevariablen im Ausdruck einer Metrik definieren, muss für diese Eingaben dasselbe Zeitintervall wie für die Ausgabemetrik gelten.

    Formelausdrücke können nur Doppel- oder Zeichenfolgenwerte ausgeben. Verschachtelte Ausdrücke können andere Datentypen ausgeben, z. B. Zeichenketten, aber die Formel als Ganzes muss zu einer Zahl oder Zeichenfolge ausgewertet werden. Sie können die Funktion jp verwenden, um eine Zeichenfolge in eine Zahl zu konvertieren. Der boolesche Wert muss 1 (wahr) oder 0 (falsch) sein. Weitere Informationen finden Sie unter Undefinierte, unendliche und Überlaufwerte.

  • Zeitintervall — Das metrische Zeitintervall. AWS IoT SiteWise unterstützt die folgenden Zeitintervalle im Tumbling-Fenster, wobei jedes Intervall beginnt, wenn das vorherige endet:

    • 1 Minute — 1 Minute, berechnet am Ende jeder Minute (12:00:00 Uhr, 12:01:00 Uhr, 12:02:00 Uhr usw.).

    • 5 Minuten — 5 Minuten, berechnet am Ende aller fünf Minuten, beginnend mit der Stunde (12:00:00 Uhr, 12:05:00 Uhr, 12:10:00 Uhr usw.).

    • 15 Minuten — 15 Minuten, berechnet am Ende aller fünfzehn Minuten, beginnend mit der Stunde (12:00:00 Uhr, 12:15:00 Uhr, 12:30:00 Uhr usw.).

    • 1 Stunde — 1 Stunde (60 Minuten), berechnet am Ende jeder Stunde in UTC (12:00:00 Uhr, 01:00:00 Uhr, 02:00:00 Uhr usw.).

    • 1 Tag — 1 Tag (24 Stunden), berechnet am Ende jedes Tages in UTC (Montag 12:00:00 Uhr, Dienstag 00:00:00 Uhr usw.).

    • 1 Woche — 1 Woche (7 Tage), berechnet am Ende eines jeden Sonntags in UTC (jeden Montag um 12:00:00 Uhr).

    • Benutzerdefiniertes Intervall — Sie können ein beliebiges Zeitintervall zwischen einer Minute und einer Woche eingeben.

  • Offsetdatum — (Optional) Das Referenzdatum, ab dem Daten aggregiert werden sollen.

  • Offset-Zeit — (optional) Die Referenzzeit, ab der Daten aggregiert werden sollen. Die Offset-Zeit muss zwischen 00:00:00 und 23:59:59 liegen.

  • Offset-Zeitzone — (Optional) Die Zeitzone für den Offset. Wenn sie nicht angegeben ist, ist die Standard-Offset-Zeitzone die koordinierte Weltzeit (UTC). Sehen Sie sich die folgenden unterstützten Zeitzonen an.

  • (UTC+ 00:00) Koordinierte Weltzeit

  • (UTC+ 01:00) Europäische Zentralzeit

  • (UTC+ 02:00) Osteuropäische

  • (UTC03+:00) Ostafrikanische Zeit

  • (UTC+ 04:00) Nahöstliche Zeit

  • (UTC+ 05:00) Pakistanische Lahore-Zeit

  • (UTC+ 05:30) Indische Normalzeit

  • (UTC+ 06:00) Bangladeschische Normalzeit

  • (UTC+ 07:00) Vietnamesische Normalzeit

  • (UTC+ 08:00) Chinesisch-Taiwanische Taipeh-Zeit

  • (UTC+ 09:00) Japanische Normalzeit

  • (UTC+ 09:30) Australische Zentralzeit

  • (UTC+ 10:00) Australische Ostzeit

  • (UTC+ 11:00) Salomonische Normalzeit

  • (UTC+ 12:00) Neuseeländische Normalzeit

  • (UTC-11:00) Zeit auf den Midway-Inseln

  • (UTC-10:00) Hawaii-Normalzeit

  • (UTC-09:00) Alaska-Normalzeit

  • (UTC-08:00) Pazifische Normalzeit

  • (UTC-07:00) Phoenix-Normalzeit

  • (UTC-06:00) Zentrale Standardzeit

  • (UTC-05:00) Östliche Normalzeit

  • (UTC-04:00) Zeit für Puerto Rico und die Amerikanischen Jungferninseln

  • (UTC-03:00) Argentinische Normalzeit

  • (UTC-02:00) Südgeorgische Zeit

  • (UTC-01:00) Zentralafrikanische Zeit

Beispiel benutzerdefiniertes Zeitintervall mit einem Offset (Konsole)

Das folgende Beispiel zeigt Ihnen, wie Sie ein 12-Stunden-Zeitintervall mit einem Offset am 20. Februar 2021 um 18:30 Uhr (PST) definieren.

Um ein benutzerdefiniertes Intervall mit einem Offset zu definieren

  1. Wählen Sie für Zeitintervall die Option Benutzerdefiniertes Intervall aus.

  2. Führen Sie für Zeitintervall einen der folgenden Schritte aus:

    • Geben Sie Stunden ein12, und wählen Sie dann Stunden aus.

    • Geben Sie ein720, und wählen Sie dann Minuten aus.

    • Geben Sie ein43200, und wählen Sie dann Sekunden aus.

    Wichtig

    Das Zeitintervall muss unabhängig von der Einheit eine Ganzzahl sein.

  3. Wählen Sie für Offsetdatum die Option 2021/02 /20 aus.

  4. Geben 18:30:30 Sie für Offset-Zeit den Wert ein.

  5. Wählen Sie für Offset-Zeitzone die Option (UTC-08:00) Pacific Standard Time aus.

Wenn Sie die Metrik am 1. Juli 2021 vor oder um 18:30 Uhr (PST) erstellen, erhalten Sie das erste Aggregationsergebnis am 1. Juli 2021 um 18:30:30 Uhr (PST). Das zweite Aggregationsergebnis ist am 2. Juli 2021 um 06:30:30 Uhr (PST) usw.

Definieren Sie Metriken (AWS CLI)

Wenn Sie mit der AWS IoT SiteWise API eine Metrik für ein Anlagenmodell definieren, geben Sie die folgenden Parameter an:

  • name— Der Name der Eigenschaft.

  • dataType— Der Datentyp der Metrik, der DOUBLE oder sein kannSTRING.

  • externalId— (Optional) Dies ist eine benutzerdefinierte ID. Weitere Informationen finden Sie unter Referenzobjekte mit externen IDs im AWS IoT SiteWise -Benutzerhandbuch.

  • expression— Der metrische Ausdruck. Metrische Ausdrücke können Aggregationsfunktionen verwenden, um Daten aus einer Eigenschaft für alle zugehörigen Anlagen in einer Hierarchie einzugeben. Weitere Informationen finden Sie unter Verwenden Sie Formelausdrücke.

  • window— Das Zeitintervall und der Offset für das Taumelfenster der Metrik, wobei jedes Intervall beginnt, wenn das vorherige endet:

    • interval— Das Zeitintervall für das Taumelfenster. Das Zeitintervall muss zwischen einer Minute und einer Woche liegen.

    • offsets— Der Offset für das taumelnde Fenster.

    Weitere Informationen finden Sie unter TumblingWindow in der AWS IoT SiteWise -API-Referenz.

    Beispiel benutzerdefiniertes Zeitintervall mit einem Offset (AWS CLI)

    Das folgende Beispiel zeigt Ihnen, wie Sie ein 12-Stunden-Zeitintervall mit einem Offset am 20. Februar 2021 um 18:30:30 Uhr (PST) definieren.

    
{
    "window": {
        "tumbling": {
            "interval": "12h",
            "offset": " 2021-07-23T18:30:30-08"
        }
    }
}

    Wenn Sie die Metrik am 1. Juli 2021 vor oder um 18:30 Uhr (PST) erstellen, erhalten Sie das erste Aggregationsergebnis am 1. Juli 2021 um 18:30:30 Uhr (PST). Das zweite Aggregationsergebnis ist am 2. Juli 2021 um 06:30:30 Uhr (PST) usw.

  • variables— Die Liste der Variablen, die die anderen Eigenschaften Ihres Assets oder Ihrer untergeordneten Assets definieren, die im Ausdruck verwendet werden sollen. Jede Variablenstruktur enthält einen einfachen Namen, der in dem Ausdruck verwendet werden soll, sowie eine value-Struktur zur Identifizierung der mit dieser Variablen zu verknüpfenden Eigenschaft. Die value-Struktur enthält folgende Informationen:

    • propertyId— Die ID der Eigenschaft, aus der Werte abgerufen werden sollen. Sie können den Namen der Eigenschaft anstelle der ID verwenden, wenn die Eigenschaft im aktuellen Modell (und nicht in einem Modell aus einer Hierarchie) definiert ist.

    • hierarchyId— (Optional) Die ID der Hierarchie, aus der untergeordnete Vermögenswerte für die Eigenschaft abgefragt werden sollen. Sie können den Namen der Hierarchiedefinition anstelle der ID verwenden. Wenn Sie diesen Wert weglassen, AWS IoT SiteWise wird die Eigenschaft im aktuellen Modell gesucht.

    Wichtig

    Bei Metriken kann es sich nur um Eigenschaften vom Typ Integer, Double, Boolean oder String handeln. Boolesche Werte werden in 0 (falsch) und 1 (wahr) konvertiert.

    Wenn Sie Metrikeingabevariablen im Ausdruck einer Metrik definieren, muss für diese Eingaben dasselbe Zeitintervall wie für die Ausgabemetrik gelten.

    Formelausdrücke können nur Doppel- oder Zeichenfolgenwerte ausgeben. Verschachtelte Ausdrücke können andere Datentypen ausgeben, z. B. Zeichenketten, aber die Formel als Ganzes muss zu einer Zahl oder Zeichenfolge ausgewertet werden. Sie können die Funktion jp verwenden, um eine Zeichenfolge in eine Zahl zu konvertieren. Der boolesche Wert muss 1 (wahr) oder 0 (falsch) sein. Weitere Informationen finden Sie unter Undefinierte, unendliche und Überlaufwerte.

  • unit— (Optional) Die wissenschaftliche Einheit für die Eigenschaft, z. B. mm oder Celsius.

Beispiel Beispiel für eine Metrik-Definition

Das folgende Beispiel zeigt eine Metrikeigenschaft, die die Temperaturmessdaten einer Komponente aggregiert, um die maximale Durchschnittstemperatur in Fahrenheit zu berechnen. Dieses Objekt ist ein Beispiel für ein Objekt AssetModelProperty, das eine Metrik enthält. Sie können dieses Objekt als Teil der CreateAssetModel-Anforderungs-Nutzlast angeben, um eine Metrik-Eigenschaft zu erstellen. Weitere Informationen finden Sie unter Erstellen Sie ein Anlagenmodell (AWS CLI).


{
      ...
      "assetModelProperties": [
      ...
      {
        "name": "Max temperature",
        "dataType": "DOUBLE",
        "type": {
          "metric": {
            "expression": "max(temp_f)",
            "variables": [
              {
                "name": "temp_f",
                "value": {
                  "propertyId": "Temperature F"
                }
              }
            ],
            "window": {
              "tumbling": {
                "interval": "1h"
              }
            }
          }
        },
        "unit": "Fahrenheit"
      }
    ],
    ...
}
Beispiel Beispiel für eine Metrikdefinition, die Daten aus zugehörigen Anlagen eingibt

Das folgende Beispiel zeigt eine metrische Eigenschaft, die die Durchschnittsleistungsdaten mehrerer Windturbinen aggregiert, um die durchschnittliche Gesamtleistung für einen Windpark zu berechnen. Dieses Objekt ist ein Beispiel für ein Objekt AssetModelProperty, das eine Metrik enthält. https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_Metric.html Sie können dieses Objekt als Teil der CreateAssetModel-Anforderungs-Nutzlast angeben, um eine Metrik-Eigenschaft zu erstellen. 

{
      ...
      "assetModelProperties": [
      ...
      {
          "name": "Total Average Power",
          "dataType": "DOUBLE",
          "type": {
            "metric": {
              "expression": "avg(power)",
              "variables": [
                {
                  "name": "power",
                  "value": {
                    "propertyId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
                    "hierarchyId": "Turbine Asset Model"
                  }
                }
              ],
              "window": {
                "tumbling": {
                  "interval": "5m"
                }
              }
            }
        },
        "unit": "kWh"
      }
    ],
    ...
}