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 Aggregaten für Asset-Eigenschaften.

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 (00: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 12:00:00 Uhr usw.).

  • 1 Woche — 1 Woche (7 Tage), berechnet am Ende jedes Sonntags 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).

  Unterstützte Zeitzonen

  • (UTC+ 00:00) Koordinierte Weltzeit

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

  • (UTC+ 02:00) Osteuropäisch

  • (UTC03+:00) Ostafrikanische Zeit

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

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

  • (UTC+ 05:30) Indische Normalzeit

  • (UTC+ 06:00) Normalzeit in Bangladesch

  • (UTC+ 07:00) Vietnamesische Normalzeit

  • (UTC+ 08:00) China Taiwan 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) Midway-Inseln-Zeit

  • (UTC- 10:00) Hawaii-Standardzeit

  • (UTC- 09:00) Alaska-Standardzeit

  • (UTC- 08:00) Pazifische Standardzeit

  • (UTC- 07:00) Phoenix-Standardzeit

  • (UTC- 06:00) Zentrale Standardzeit

  • (UTC- 05:00) Östliche Normalzeit

  • (UTC- 04:00) Zeit in Puerto Rico und den 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:30 Uhr () definieren. PST

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 Offsetzeit 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 ist am 2. Juli 2021 um 06:30:30 Uhr () usw. PST

Definieren Sie Metriken ()AWS CLI

Wenn Sie eine Metrik für ein Asset-Modell mit dem definieren AWS IoT SiteWise API, 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 TumblingWindowin der AWS IoT SiteWise APIReferenz.

  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 () definieren. PST

  
  {
      "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 ist am 2. Juli 2021 um 06:30:30 Uhr () usw. PST

• 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 CreateAssetModelAnforderungs-Payload angeben, um eine Metrikeigenschaft 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 Assets 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 CreateAssetModelAnforderungs-Payload angeben, um eine Metrikeigenschaft 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"
      }
    ],
    ...
}