Aggregieren Sie Daten aus Immobilien und anderen Vermögenswerten (Metriken) - AWS IoT SiteWise
Metriken definieren (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 Aggregationsfunktionen verwenden, um alle Eingabedatenpunkte zu verarbeiten und einen einzelnen Datenpunkt pro festgelegtem 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 die 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 verwendet es bei der Berechnung der Formel den neuesten Wert für dieses Attribut. Wenn Sie eine Metrik in einer Formel angeben, AWS IoT SiteWise verwendet es den letzten Wert für das Zeitintervall, über das die Formel berechnet wird. Das bedeutet, dass Sie Metriken wie OEE = Availability * Quality * Performance AvailabilityQuality, wo und wie alle anderen Metriken für dasselbe Asset-Modell Performance sind, 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 Abfragen von Asset-Eigenschaftenaggregaten in AWS IoT SiteWise.

Metriken definieren (Konsole)

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

  • Name — Der Name der Immobilie.

  • 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 Abwärtspfeiltaste, um die Funktion zur auto 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 Zeichenfolge 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 Doppelwerte oder Zeichenkettenwerte ausgeben. Verschachtelte Ausdrücke können andere Datentypen ausgeben, z. B. Zeichenfolgen, aber die Formel als Ganzes muss eine Zahl oder Zeichenfolge ergeben. Sie können die Funktion jp verwenden, um eine Zeichenfolge in eine Zahl umzuwandeln. 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 Taumelfenster, wobei jedes Intervall beginnt, wenn das vorherige endet:

    • 1 Minute — 1 Minute, berechnet am Ende jeder Minute (00: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 vollen Stunde (00:00:00 Uhr, 12:05:00 Uhr, 00:10:00 Uhr usw.).

    • 15 Minuten — 15 Minuten, berechnet am Ende aller fünfzehn Minuten, beginnend mit der vollen Stunde (00:00:00 Uhr, 00: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 eines jeden Tages in UTC (Montag 12:00:00 Uhr, Dienstag 12:00:00 Uhr usw.).

    • 1 Woche — 1 Woche (7 Tage), berechnet am Ende jedes Sonntags in UTC (jeden Montag um 00: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.

  • Offsetzeit — (Optional) Die Referenzzeit, ab der Daten aggregiert werden sollen. Die Offsetzeit 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 standardmäßige Offset-Zeitzone die koordinierte Weltzeit (UTC).

    • (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) Pakistan Lahore-Zeit

    • (UTC+ 05:30) Indien Normalzeit

    • (UTC+ 06:00) Normalzeit in Bangladesch

    • (UTC+ 07:00) Vietnam Normalzeit

    • (UTC+ 09:00) Japan Normalzeit

    • (UTC+ 09:30) Australien Zentralzeit

    • (UTC+ 10:00) Australien Ostzeit

    • (UTC+ 11:00) Salomonische Normalzeit

    • (UTC+ 12:00) Neuseeland Normalzeit

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

    • (UTC- 10:00) Hawaii-Normalzeit

    • (UTC- 09:00) Alaska-Normalzeit

    • (UTC- 08:00) Pazifische Standardzeit

    • (UTC- 07:00) Phoenix-Standardzeit

    • (UTC- 06:00) Zentrale Standardzeit

    • (UTC- 05:00) Östliche Standardzeit

    • (UTC- 04:00) Zeit in Puerto Rico und den Amerikanischen Jungferninseln

    • (UTC- 03:00) Argentinien 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: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 aus.

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

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

    Wichtig

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

  3. Wählen Sie 2021/02/20 als Offset-Datum aus.

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

  5. Wählen Sie für Offset-Zeitzone (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 Uhr (PST). Das zweite Aggregationsergebnis wird am 2. Juli 2021 um 06:30:30 Uhr (PST) usw. angezeigt.

Definieren Sie Metriken ()AWS CLI

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

  • name— Der Name der Immobilie.

  • 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 Taumelfenster.

    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 Uhr (PST). Das zweite Aggregationsergebnis wird am 2. Juli 2021 um 06:30:30 Uhr (PST) usw. angezeigt.

  • variables— Die Variablenliste, die die anderen Eigenschaften Ihrer Anlage oder Ihrer untergeordneten Anlagen definiert, die in dem 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 Zeichenfolge 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 Doppelwerte oder Zeichenkettenwerte ausgeben. Verschachtelte Ausdrücke können andere Datentypen ausgeben, z. B. Zeichenfolgen, aber die Formel als Ganzes muss eine Zahl oder Zeichenfolge ergeben. Sie können die Funktion jp verwenden, um eine Zeichenfolge in eine Zahl umzuwandeln. 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 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 Asset-Modell (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 für eine Metrikdefinition, die Daten aus zugehörigen Anlagen eingibt

Das folgende Beispiel zeigt eine metrische Eigenschaft, die die durchschnittlichen Leistungsdaten 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. 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"
      }
    ],
    ...
}