

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.

# AWS IoT SiteWise Tutorials
<a name="tutorials"></a>

Willkommen auf der AWS IoT SiteWise Tutorial-Seite. Diese wachsende Sammlung von Tutorials vermittelt Ihnen das Wissen und die Fähigkeiten, die Sie benötigen, um sich mit den Feinheiten von vertraut zu machen. AWS IoT SiteWise Diese Tutorials bieten eine Vielzahl grundlegender Themen, die auf Ihre Bedürfnisse zugeschnitten sind. Während Sie sich mit den Tutorials befassen, erhalten Sie wertvolle Einblicke in verschiedene Aspekte von. AWS IoT SiteWise

Jedes Tutorial verwendet ein bestimmtes Ausrüstungsbeispiel. Diese Tutorials sind für Testumgebungen vorgesehen und verwenden fiktive Firmennamen, Modelle, Vermögenswerte, Eigenschaften usw. In den Tutorials finden Sie allgemeine Anleitungen. Die Tutorials sind nicht für den direkten Einsatz in einer Produktionsumgebung vorgesehen, es sei denn, sie werden sorgfältig geprüft und an die individuellen Anforderungen Ihres Unternehmens angepasst.

**Topics**
+ [Berechnung der Gesamtanlageneffektivität in AWS IoT SiteWise](calculate-oee.md)
+ [Daten aufnehmen, um Dinge AWS IoT SiteWise zu erstellen AWS IoT](ingest-data-from-iot-things.md)
+ [Integrieren Sie Daten mithilfe eines MQTT-fähigen V3-Gateways in SiteWise Edge](integrate_sitewise_edge_mqtt.md)
+ [Daten in Grafana visualisieren und teilen](visualize-with-grafana.md)
+ [Visualisieren und teilen Sie Windparkdaten in SiteWise Monitor](monitor-wind-farm.md)
+ [Aktualisierungen von Immobilienwerten in Amazon DynamoDB veröffentlichen](publish-to-amazon-dynamodb.md)

# Berechnung der Gesamtanlageneffektivität in AWS IoT SiteWise
<a name="calculate-oee"></a>

Dieses Tutorial enthält ein Beispiel dafür, wie die Gesamtanlageneffektivität (OEE) für einen Herstellungsprozess berechnet wird. Folglich können Ihre OEE-Berechnungen oder -Formeln von den hier dargestellten abweichen. Im Allgemeinen ist OEE definiert als `Availability * Quality * Performance`. Weitere Informationen über die Berechnung der OEE finden Sie unter [Overall equipment effectiveness](https://en.wikipedia.org/wiki/Overall_equipment_effectiveness) auf *Wikipedia*.

## Voraussetzungen
<a name="oee-requirements"></a>

Um dieses Tutorial abzuschließen, müssen Sie die Datenerfassung für ein Gerät mit den folgenden drei Daten-Streams konfigurieren:
+ `Equipment_State`— Ein numerischer Code, der den Zustand der Maschine darstellt, z. B. Leerlauf, Störung, geplanter Stopp oder Normalbetrieb.
+ `Good_Count`— Ein Datenstrom, bei dem jeder Datenpunkt die Anzahl der erfolgreichen Operationen seit dem letzten Datenpunkt enthält.
+ `Bad_Count`— Ein Datenstrom, bei dem jeder Datenpunkt die Anzahl der erfolglosen Operationen seit dem letzten Datenpunkt enthält.

Informationen zum Konfigurieren der Datenerfassung finden Sie im Abschnitt [Daten aufnehmen in AWS IoT SiteWise](industrial-data-ingestion.md). Wenn keine industriellen Operationen verfügbar sind, können Sie ein Skript schreiben, das Beispieldaten über die AWS IoT SiteWise -API generiert und hochlädt.

## Berechnen der OEE
<a name="how-to-calculate-oee"></a>

In diesem Tutorial erstellen Sie ein Komponentenmodell, das die OEE aus drei Dateneingabe-Streams berechnet: `Equipment_State`, `Good_Count`, und `Bad_Count`. Stellen Sie sich in diesem Beispiel eine allgemeine Verpackungsmaschine vor, beispielsweise eine Maschine, die zum Verpacken von Zucker, Kartoffelchips oder Farbe verwendet wird. Erstellen Sie in der [AWS IoT SiteWise Konsole](https://console.aws.amazon.com/iotsitewise/) ein AWS IoT SiteWise Asset-Modell mit den folgenden Messungen, Transformationen und Metriken. Anschließend können Sie ein Asset erstellen, das die Verpackungsmaschine darstellt, und beobachten, wie die Gesamtanlageneffektivität AWS IoT SiteWise berechnet wird.

Definieren Sie die folgenden [Messungen](measurements.md), um die Rohdaten-Streams von der Verpackungsmaschine darzustellen.

**Messungen**
+ `Equipment_State`— Ein Datenstrom (oder eine Messung), der den aktuellen Zustand der Verpackungsmaschine in numerischen Codes wiedergibt: 
  + `1024`— Die Maschine befindet sich im Leerlauf. 
  + `1020`— Ein Fehler, z. B. ein Fehler oder eine Verzögerung. 
  + `1000`— Ein geplanter Stopp.
  + `1111`— Ein normaler Betrieb.
+ `Good_Count`— Ein Datenstrom, bei dem jeder Datenpunkt die Anzahl der erfolgreichen Operationen seit dem letzten Datenpunkt enthält.
+ `Bad_Count`— Ein Datenstrom, bei dem jeder Datenpunkt die Anzahl der erfolglosen Operationen seit dem letzten Datenpunkt enthält.

Legen Sie mithilfe des `Equipment_State`-Messdaten-Streams und der darin enthaltenen Codes die folgenden [Transformationen](transforms.md) (oder abgeleiteten Messungen) fest. Transformationen haben eine one-to-one Beziehung zu Rohmessungen.

**Transformationen**
+ `Idle = eq(Equipment_State, 1024)`— Ein transformierter Datenstrom, der den Ruhezustand der Maschine enthält.
+ `Fault = eq(Equipment_State, 1020)`— Ein transformierter Datenstrom, der den Fehlerstatus der Maschine enthält.
+ `Stop = eq(Equipment_State, 1000)`— Ein transformierter Datenstrom, der den geplanten Stoppstatus der Maschine enthält.
+ `Running = eq(Equipment_State, 1111)`— Ein transformierter Datenstrom, der den normalen Betriebszustand der Maschine enthält.

Definieren Sie anhand der Rohmessungen und der transformierten Messungen die folgenden [Metriken](metrics.md), die Maschinendaten über bestimmte Zeitintervalle aggregieren. Wählen Sie für jede Metrik dasselbe Zeitintervall aus, wenn Sie die Metriken in diesem Abschnitt definieren.

**Metriken**
+ `Successes = sum(Good_Count)`— Die Anzahl der erfolgreich befüllten Pakete im angegebenen Zeitintervall.
+ `Failures = sum(Bad_Count)`— Die Anzahl der Pakete, die im angegebenen Zeitintervall nicht erfolgreich gefüllt wurden.
+ `Idle_Time = statetime(Idle)`— Die gesamte Leerlaufzeit der Maschine (in Sekunden) pro festgelegtem Zeitintervall.
+ `Fault_Time = statetime(Fault)`— Die Gesamtfehlerzeit der Maschine (in Sekunden) pro festgelegtem Zeitintervall.
+ `Stop_Time = statetime(Stop)`— Die gesamte geplante Stoppzeit der Maschine (in Sekunden) pro festgelegtem Zeitintervall.
+ `Run_Time = statetime(Running)`— Die Gesamtbetriebszeit (in Sekunden) der Maschine ohne Probleme pro festgelegtem Zeitintervall.
+ `Down_Time = Idle_Time + Fault_Time + Stop_Time`— Die gesamte Ausfallzeit der Maschine (in Sekunden) über das angegebene Zeitintervall, berechnet als Summe der Maschinenzustände außer`Run_Time`.
+ `Availability = Run_Time / (Run_Time + Down_Time)`— Die Betriebszeit der Maschine oder der Prozentsatz der geplanten Zeit, während der die Maschine während des angegebenen Zeitintervalls betriebsbereit ist.
+ `Quality = Successes / (Successes + Failures)`— Der Prozentsatz der erfolgreich abgefüllten Pakete der Maschine in den angegebenen Zeitintervallen.
+ `Performance = ((Successes + Failures) / Run_Time) / Ideal_Run_Rate`— Die Leistung der Maschine im angegebenen Zeitintervall als Prozentsatz der für Ihren Prozess idealen Durchlaufgeschwindigkeit (in Sekunden). 

  Ihre `Ideal_Run_Rate` beläuft sich beispielsweise auf 60 Pakete pro Minute (1 Paket pro Sekunde). Wenn Ihr Wert pro Minute oder pro Stunde angegeben `Ideal_Run_Rate` wird, müssen Sie ihn durch den entsprechenden Umrechnungsfaktor für Einheiten dividieren, da er in Sekunden angegeben `Run_Time` ist. 
+ `OEE = Availability * Quality * Performance`— Die Gesamtanlageneffektivität der Maschine über das angegebene Zeitintervall. Diese Formel berechnet OEE als Bruchteil von 1.

**Anmerkung**  
 Wenn OEE als Transformation definiert ist, werden die Ausgabewerte für jeden der Eingabewerte berechnet. Es besteht die Möglichkeit, dass unerwartete Werte generiert werden, da bei der Transformationsauswertung die neuesten verfügbaren Werte für alle beitragenden Eigenschaften in der Formel berücksichtigt werden. Bei Eigenschaftenaktualisierungen mit demselben Zeitstempel können Ausgabewerte durch Aktualisierungen anderer eingehender Eigenschaften überschrieben werden. Wenn beispielsweise Verfügbarkeit, Qualität und Leistung berechnet werden, wird die Gesamtanlageneffektivität anhand der letzten verfügbaren Datenpunkte für die anderen beiden Eigenschaften berechnet. Diese beitragenden Werte haben dieselben Zeitstempel und führen zu falschen OEE-Ausgabewerten. Die Reihenfolge ist für die Berechnung von Transformationen nicht garantiert. 

# Daten aufnehmen, um Dinge AWS IoT SiteWise zu erstellen AWS IoT
<a name="ingest-data-from-iot-things"></a>

In diesem Tutorial erfahren Sie, wie Sie mithilfe AWS IoT SiteWise von AWS IoT Geräteschatten Daten aus einer Flotte von Geräten aufnehmen. *Geräteschatten* sind JSON-Objekte, die aktuelle Statusinformationen für ein AWS IoT Gerät speichern. Weitere Informationen finden Sie unter [Device Shadow Service](https://docs.aws.amazon.com/iot/latest/developerguide/iot-device-shadows.html) im *AWS IoT Entwicklerhandbuch*.

Nachdem Sie dieses Tutorial abgeschlossen haben, können Sie einen Vorgang einrichten, der auf AWS IoT Dingen AWS IoT SiteWise basiert. Indem Sie AWS IoT Dinge verwenden, können Sie Ihren Betrieb in andere nützliche Funktionen von integrieren AWS IoT. Sie können beispielsweise AWS IoT Funktionen für die folgenden Aufgaben konfigurieren:
+ Konfigurieren Sie zusätzliche Regeln für das Streamen von Daten zu [AWS IoT Events](https://docs.aws.amazon.com/iotevents/latest/developerguide/)[Amazon DynamoDB](https://docs.aws.amazon.com/dynamodb/) und anderen AWS Services. Weitere Informationen finden Sie unter [Regeln](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html) im *AWS IoT Entwicklerhandbuch*.
+ Indexieren, durchsuchen und aggregieren Sie Ihre Gerätedaten mit dem AWS IoT Fleet Indexing Service. Weitere Informationen finden Sie unter [Fleet Indexing Service](https://docs.aws.amazon.com/iot/latest/developerguide/iot-indexing.html) im *AWS IoT Entwicklerhandbuch*.
+ Prüfen und sichern Sie Ihre Geräte mit AWS IoT Device Defender. Weitere Informationen finden Sie unter [AWS IoT Device Defender](https://docs.aws.amazon.com/iot-device-defender/latest/devguide/what-is-device-defender.html) im *AWS IoT -Entwicklerhandbuch*.

In diesem Tutorial erfahren Sie, wie Sie Daten aus den Geräteschatten AWS IoT von Dingen in Assets aufnehmen. AWS IoT SiteWise Dazu erstellen Sie ein oder mehrere AWS IoT Dinge und führen ein Skript aus, das den Geräteshadow jedes Dings mit Daten zur CPU- und Speichernutzung aktualisiert. In diesem Tutorial verwenden Sie CPU- und Speichernutzungsdaten, um realistische Sensordaten zu imitieren. Anschließend erstellen Sie eine Regel mit einer AWS IoT SiteWise Aktion, die diese Daten bei AWS IoT SiteWise jeder Aktualisierung des Geräteshadows an ein Asset sendet. Weitere Informationen finden Sie unter [Daten AWS IoT SiteWise mithilfe AWS IoT Core von Regeln aufnehmen](iot-rules.md).

**Topics**
+ [Voraussetzungen](#rule-ingestion-tutorial-prerequisites)
+ [Schritt 1: Erstellen Sie eine AWS IoT Richtlinie](#ingestion-tutorial-create-iot-policy)
+ [Schritt 2: Erstellen und konfigurieren Sie ein AWS IoT Ding](#rule-tutorial-create-iot-thing)
+ [Schritt 3: Erstellen Sie ein Geräte-Asset-Modell](#rule-tutorial-create-device-model)
+ [Schritt 4: Erstellen Sie ein Geräteflotten-Asset-Modell](#rule-tutorial-create-fleet-model)
+ [Schritt 5: Erstellen und konfigurieren Sie ein Geräte-Asset](#rule-tutorial-create-device-assets)
+ [Schritt 6: Erstellen und konfigurieren Sie ein Geräteflotten-Asset](#rule-tutorial-create-fleet-asset)
+ [Schritt 7: Erstellen Sie in AWS IoT Core eine Regel, um Daten an Geräteressourcen zu senden](#rule-tutorial-create-iot-rule)
+ [Schritt 8: Führen Sie das Geräteclient-Skript aus](#rule-tutorial-run-script)
+ [Schritt 9: Ressourcen nach dem Tutorial bereinigen](#rule-tutorial-clean-up-resources)

## Voraussetzungen
<a name="rule-ingestion-tutorial-prerequisites"></a>

Zum Durcharbeiten dieses Tutorials ist Folgendes erforderlich:
+ Ein AWS Konto. Falls Sie noch keines haben, beachten Sie die Informationen unter [Richten Sie ein Konto ein AWS](getting-started.md#set-up-aws-account).
+ Ein Entwicklungscomputer, auf demWindows, macOSLinux, oder ausgeführt wird, Unix um auf den zuzugreifen AWS-Managementkonsole. Weitere Informationen finden Sie unter [Erste Schritte mit AWS-Managementkonsole](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/getting-started.html).
+ Ein AWS Identity and Access Management (IAM-) Benutzer mit Administratorrechten.
+ Python3 ist auf Ihrem Entwicklungscomputer oder auf dem Gerät installiert, das Sie als Objekt registrieren möchten AWS IoT .

## Schritt 1: Erstellen Sie eine AWS IoT Richtlinie
<a name="ingestion-tutorial-create-iot-policy"></a>

Erstellen Sie in diesem Verfahren eine AWS IoT Richtlinie, die es Ihren AWS IoT Dingen ermöglicht, auf die in diesem Tutorial verwendeten Ressourcen zuzugreifen.

------
#### [ Console ]

Gehen Sie wie folgt vor, um mithilfe der AWS IoT Core Konsole eine AWS IoT Richtlinie zu erstellen:

**Um eine AWS IoT Richtlinie zu erstellen**

1. Melden Sie sich an der [AWS-Managementkonsole](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/what-is.html) an.

1. Sehen Sie sich die [AWS Regionen](https://docs.aws.amazon.com/general/latest/gr/iot-sitewise.html) an, in denen AWS IoT SiteWise es unterstützt wird. Wechseln Sie ggf. zu einer dieser unterstützten Regionen.

1. Navigieren Sie zur [AWS IoT -Konsole](https://console.aws.amazon.com/iot/). Wenn die Schaltfläche **Gerät Connect** angezeigt wird, wählen Sie sie aus.

1. Wählen Sie im linken Navigationsbereich **Sicherheit** und dann **Richtlinien** aus.

1. Wählen Sie **Erstellen** aus.

1. Geben Sie einen Namen für die AWS IoT Richtlinie ein (z. B.**SiteWiseTutorialDevicePolicy**).

1. Wählen Sie unter **Richtliniendokument** die Option **JSON** aus, um die folgende Richtlinie im JSON-Format einzugeben. Ersetzen Sie *region* und *account-id* durch Ihre Region und Konto-ID, z. B. **us-east-1** und**123456789012**.

------
#### [ JSON ]

****  

   ```
   {
     "Version":"2012-10-17",		 	 	 
     "Statement": [
       {
         "Effect": "Allow",
         "Action": "iot:Connect",
         "Resource": "arn:aws:iot:us-east-1:123456789012:client/SiteWiseTutorialDevice*"
       },
       {
         "Effect": "Allow",
         "Action": "iot:Publish",
         "Resource": [
           "arn:aws:iot:us-east-1:123456789012:topic/$aws/things/${iot:Connection.Thing.ThingName}/shadow/update",
           "arn:aws:iot:us-east-1:123456789012:topic/$aws/things/${iot:Connection.Thing.ThingName}/shadow/delete",
           "arn:aws:iot:us-east-1:123456789012:topic/$aws/things/${iot:Connection.Thing.ThingName}/shadow/get"
         ]
       },
       {
         "Effect": "Allow",
         "Action": "iot:Receive",
         "Resource": [
           "arn:aws:iot:us-east-1:123456789012:topic/$aws/things/${iot:Connection.Thing.ThingName}/shadow/update/accepted",
           "arn:aws:iot:us-east-1:123456789012:topic/$aws/things/${iot:Connection.Thing.ThingName}/shadow/delete/accepted",
           "arn:aws:iot:us-east-1:123456789012:topic/$aws/things/${iot:Connection.Thing.ThingName}/shadow/get/accepted",
           "arn:aws:iot:us-east-1:123456789012:topic/$aws/things/${iot:Connection.Thing.ThingName}/shadow/update/rejected",
           "arn:aws:iot:us-east-1:123456789012:topic/$aws/things/${iot:Connection.Thing.ThingName}/shadow/delete/rejected"
         ]
       },
       {
         "Effect": "Allow",
         "Action": "iot:Subscribe",
         "Resource": [
           "arn:aws:iot:us-east-1:123456789012:topicfilter/$aws/things/${iot:Connection.Thing.ThingName}/shadow/update/accepted",
           "arn:aws:iot:us-east-1:123456789012:topicfilter/$aws/things/${iot:Connection.Thing.ThingName}/shadow/delete/accepted",
           "arn:aws:iot:us-east-1:123456789012:topicfilter/$aws/things/${iot:Connection.Thing.ThingName}/shadow/get/accepted",
           "arn:aws:iot:us-east-1:123456789012:topicfilter/$aws/things/${iot:Connection.Thing.ThingName}/shadow/update/rejected",
           "arn:aws:iot:us-east-1:123456789012:topicfilter/$aws/things/${iot:Connection.Thing.ThingName}/shadow/delete/rejected"
         ]
       },
       {
         "Effect": "Allow",
         "Action": [
           "iot:GetThingShadow",
           "iot:UpdateThingShadow",
           "iot:DeleteThingShadow"
         ],
         "Resource": "arn:aws:iot:us-east-1:123456789012:thing/SiteWiseTutorialDevice*"
   
       }
     ]
   }
   ```

------

1. Wählen Sie **Erstellen** aus.

------
#### [ AWS CLI ]

**Wichtig**  
Diese Richtlinie verwendet Platzhalter, um die AWS IoT SiteWise CLI-Größenbeschränkungen einzuhalten. Für restriktivere Berechtigungen mit expliziten Themenpfaden erstellen Sie die Richtlinie stattdessen über die AWS IoT SiteWise Konsole. Weitere Informationen finden Sie im Beispiel für eine IoT-Richtlinie auf der Registerkarte.

Verwenden Sie den folgenden AWS CLI Befehl, um eine IoT-Richtlinie zu erstellen:

```
aws iot create-policy \
  --policy-name "SiteWiseTutorialDevicePolicy" \
  --policy-document '{
    "Version": "2012-10-17",		 	 	 
    "Statement": [
      {
        "Effect": "Allow",
        "Action": "iot:Connect",
        "Resource": "arn:aws:iot:region:account-id:client/SiteWiseTutorialDevice*"
      },
      {
        "Effect": "Allow",
        "Action": ["iot:Publish", "iot:Receive"],
        "Resource": [
          "arn:aws:iot:region:account-id:topic/$aws/things/${iot:Connection.Thing.ThingName}/shadow/*"
        ]
      },
      {
        "Effect": "Allow",
        "Action": "iot:Subscribe",
        "Resource": [
          "arn:aws:iot:region:account-id:topicfilter/$aws/things/${iot:Connection.Thing.ThingName}/shadow/*"
        ]
      },
      {
        "Effect": "Allow",
        "Action": [
          "iot:GetThingShadow",
          "iot:UpdateThingShadow",
          "iot:DeleteThingShadow"
        ],
        "Resource": "arn:aws:iot:region:account-id:thing/SiteWiseTutorialDevice*"
      }
    ]
  }'
```

Verwenden Sie den folgenden Befehl, um zu überprüfen, ob Ihre Richtlinie erfolgreich erstellt wurde:

```
aws iot get-policy --policy-name "SiteWiseTutorialDevicePolicy"
```

------

Diese Richtlinie ermöglicht es Ihren AWS IoT Geräten, mithilfe von MQTT-Nachrichten Verbindungen herzustellen und mit Geräteschatten zu kommunizieren. Weitere Informationen zu MQTT-Nachrichten finden Sie unter [Was ist](https://aws.amazon.com/what-is/mqtt/) MQTT? . Um mit Geräteschatten zu interagieren, veröffentlichen und empfangen Ihre AWS IoT Dinge MQTT-Nachrichten zu Themen, die mit `$aws/things/thing-name/shadow/` beginnen. Diese Richtlinie enthält eine Ding-Richtlinienvariable, die als`${iot:Connection.Thing.ThingName}`. Diese Variable ersetzt in jedem Thema den Namen der verbundenen Sache. Die `iot:Connect` Anweisung beschränkt, welche Geräte Verbindungen herstellen können, und stellt so sicher, dass die Richtlinienvariable thing nur Namen ersetzen kann, die mit `SiteWiseTutorialDevice` beginnen.

Weitere Informationen finden Sie unter [Ding-Richtlinienvariablen](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policy-variables.html) im *AWS IoT Entwicklerhandbuch*.

**Anmerkung**  
Diese Richtlinie gilt für Objekte, deren Namen mit `SiteWiseTutorialDevice` beginnen. Um einen anderen Namen für Ihre Objekte zu verwenden, müssen Sie die Richtlinie entsprechend aktualisieren.

## Schritt 2: Erstellen und konfigurieren Sie ein AWS IoT Ding
<a name="rule-tutorial-create-iot-thing"></a>

In diesem Verfahren erstellen und konfigurieren Sie ein AWS IoT Ding. Sie können Ihren Entwicklungscomputer als ein AWS IoT Ding bezeichnen. Denken Sie im weiteren Verlauf daran, dass die Prinzipien, die Sie hier lernen, auch auf konkrete Projekte angewendet werden können. Sie haben die Flexibilität, AWS IoT Dinge auf jedem Gerät zu erstellen und einzurichten, auf dem ein AWS IoT SDK ausgeführt werden kann, einschließlich AWS IoT Greengrass FreeRTOS. Weitere Informationen finden Sie unter [AWS IoT SDKs](https://docs.aws.amazon.com/iot/latest/developerguide/iot-sdks.html) im *AWS IoT -Entwicklerhandbuch*.

------
#### [ Console ]

**Um etwas zu erstellen und zu konfigurieren AWS IoT**

1. Öffnen Sie eine Befehlszeile, und führen Sie den folgenden Befehl aus, um ein Verzeichnis für dieses Lernprogramm zu erstellen.

   ```
   mkdir iot-sitewise-rule-tutorial
   cd iot-sitewise-rule-tutorial
   ```

1. Führen Sie den folgenden Befehl aus, um ein Verzeichnis für die Zertifikate Ihres Objekts zu erstellen.

   ```
   mkdir device1
   ```

   Wenn Sie zusätzliche Objekte erstellen, erhöhen Sie die Nummer im Verzeichnisnamen entsprechend, um zu verfolgen, welche Zertifikate zu welchem Objekt gehören.

1. Navigieren Sie zur [AWS IoT -Konsole](https://console.aws.amazon.com/iot/).

1. Wählen Sie im linken Navigationsbereich im Abschnitt **Verwalten** die Option **Alle Geräte** aus. Wählen Sie dann **Things (Objekte)** aus.

1. Wenn das Dialogfeld **You don‘t have any things yet (Sie haben noch keine Objekte)** angezeigt wird, wählen Sie **Create a thing (Objekt erstellen)** aus. Wählen Sie andernfalls **Dinge erstellen** aus.

1. Wählen Sie auf der Seite „**Dinge erstellen**“ die Option „**Ein einzelnes Ding erstellen**“ und dann „**Weiter**“ aus.

1. Geben Sie auf der Seite „**Dingeigenschaften angeben**“ einen Namen für Ihr AWS IoT Ding ein (z. B.**SiteWiseTutorialDevice1**) und wählen Sie dann **Weiter**. Wenn Sie zusätzliche Objekte erstellen, erhöhen Sie die Nummer im Namen des Objekts entsprechend.
**Wichtig**  
Der Name des Dings muss mit dem Namen übereinstimmen, der in der Richtlinie verwendet wurde, die Sie in *Schritt 1: AWS IoT Richtlinie erstellen* erstellt haben. Andernfalls kann Ihr Gerät keine Verbindung zu herstellen AWS IoT.

1. Wählen Sie auf der Seite **Gerätezertifikat konfigurieren — *optional*** die Option **Neues Zertifikat automatisch generieren (empfohlen)** und anschließend **Weiter** aus. Mithilfe von Zertifikaten können AWS IoT Sie Ihre Geräte sicher identifizieren.

1. Wählen Sie auf der Seite **Richtlinien an Zertifikat anhängen — *optional*** die Richtlinie aus, die Sie in *Schritt 1: AWS IoT Richtlinie erstellen* erstellt haben, und wählen Sie **Ding erstellen** aus.

1. Gehen **Sie im Dialogfeld Zertifikate und Schlüssel herunterladen** wie folgt vor:

   1. Wählen Sie die **Download**-Links, um das Zertifikat, den öffentlichen Schlüssel und den privaten Schlüssel Ihres Objekts herunterzuladen. Speichern Sie alle drei Dateien in dem Verzeichnis, das Sie für die Zertifikate Ihres Objekts erstellt haben (zum Beispiel **iot-sitewise-rule-tutorial/device1**).
**Wichtig**  
Dies ist das einzige Mal, dass Sie das Zertifikat und die Schlüssel Ihres Objekts herunterladen können, die Sie benötigen, damit Ihr Gerät erfolgreich eine Verbindung mit AWS IoT herstellen kann.

   1. Wählen Sie den Link **Herunterladen**, um ein Root-CA-Zertifikat herunterzuladen. Speichern Sie das CA-Stammzertifikat der Zertifizierungsstelle in **iot-sitewise-rule-tutorial**. Wir empfehlen Ihnen, Amazon Root CA 1 herunterzuladen.

1. Wählen Sie **Fertig** aus.

------
#### [ AWS CLI ]

Gehen Sie wie folgt vor, um ein Objekt zu erstellen und zu konfigurieren AWS IoT , indem Sie AWS CLI:

1. Öffnen Sie eine Befehlszeile und führen Sie den folgenden Befehl aus, um ein Verzeichnis für dieses Tutorial zu erstellen:

   ```
   mkdir iot-sitewise-rule-tutorial
   ```

1. Navigieren Sie zum Verzeichnis für das Tutorial:

   ```
   cd iot-sitewise-rule-tutorial
   ```

1. Führen Sie den folgenden Befehl aus, um ein Verzeichnis für die Zertifikate Ihres Dings zu erstellen:

   ```
   mkdir device1
   ```

   Wenn Sie zusätzliche Objekte erstellen, erhöhen Sie die Nummer im Verzeichnisnamen entsprechend, um zu verfolgen, welche Zertifikate zu welchem Objekt gehören.

1. Erstelle ein AWS IoT Ding:

   ```
   aws iot create-thing --thing-name "SiteWiseTutorialDevice1"
   ```
**Wichtig**  
Der Name des Dings muss dem Namensmuster entsprechen, das in der Richtlinie verwendet wurde, die Sie in Schritt 1 erstellt haben. Andernfalls kann Ihr Gerät keine Verbindung zu herstellen AWS IoT.

1. Erstellen Sie ein Zertifikat und speichern Sie die Dateien. Notieren Sie sich den Zertifikat-ARN aus der Ausgabe — Sie benötigen ihn in den nächsten Schritten:

   ```
   aws iot create-keys-and-certificate \
       --set-as-active \
       --certificate-pem-outfile "device1/device.pem.crt" \
       --public-key-outfile "device1/public.pem.key" \
       --private-key-outfile "device1/private.pem.key"
   ```

1. Hängen Sie die Richtlinie, die Sie in Schritt 1 erstellt haben, an das Zertifikat an:

   ```
   aws iot attach-policy \
       --policy-name "SiteWiseTutorialDevicePolicy" \
       --target "certificate-arn"
   ```

1. Hängen Sie das Zertifikat an das Ding an:

   ```
   aws iot attach-thing-principal \
       --thing-name "SiteWiseTutorialDevice1" \
       --principal "certificate-arn"
   ```

1. Laden Sie das Amazon-Root-CA-Zertifikat herunter:

   ```
   curl https://www.amazontrust.com/repository/AmazonRootCA1.pem > AmazonRootCA1.pem
   ```

   Dieses Zertifikat ist erforderlich, damit Ihr Gerät erfolgreich eine Verbindung herstellen kann AWS IoT.

**Wichtig**  
Bewahren Sie Ihre Zertifikate und Schlüssel sicher auf. Sie können diese Anmeldeinformationen nicht erneut herunterladen, nachdem Sie sie erstellt haben.

------

Sie haben jetzt AWS IoT etwas auf Ihrem Computer registriert. Führen Sie einen der folgenden nächsten Schritte aus:
+ Fahren Sie mit *Schritt 3 fort: Erstellen eines Geräte-Asset-Modells*, ohne zusätzliche AWS IoT Dinge zu erstellen. Sie können dieses Lernprogramm mit nur einem Objekt abschließen.
+ Wiederholen Sie die Schritte in diesem Abschnitt auf einem anderen Computer oder Gerät, um weitere AWS IoT -Objekte zu erstellen. Für dieses Tutorial empfehlen wir, diese Option zu befolgen, damit Sie eindeutige CPU- und Speicherauslastungsdaten von mehreren Geräten erfassen können.
+ Wiederholen Sie die Schritte in diesem Abschnitt auf demselben Gerät (Ihrem Computer), um weitere AWS IoT -Objekte zu erstellen. Jedes Gerät AWS IoT empfängt ähnliche CPU- und Speichernutzungsdaten von Ihrem Computer. Verwenden Sie daher diesen Ansatz, um zu demonstrieren, dass nicht eindeutige Daten von mehreren Geräten aufgenommen werden.

## Schritt 3: Erstellen Sie ein Geräte-Asset-Modell
<a name="rule-tutorial-create-device-model"></a>

In diesem Verfahren erstellen Sie ein Asset-Modell, das Ihre Geräte repräsentiert, die CPU- und Speichernutzungsdaten streamen. AWS IoT SiteWise Um Daten in Anlagen zu verarbeiten, die Gerätegruppen repräsentieren, setzen Asset-Modelle konsistente Informationen für mehrere Anlagen desselben Typs voraus. Weitere Informationen finden Sie unter [Modellieren Sie Industrieanlagen](industrial-asset-models.md).

**So erstellen Sie ein Komponentenmodell, das ein Gerät darstellt**

1. Navigieren Sie zur [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/).

1. Wählen Sie im linken Navigationsbereich **Models (Modelle)** aus.

1. Wählen Sie **Asset-Modell erstellen** aus.

1. Geben Sie unter **Modelldetails** einen Namen für Ihr Modell ein. Beispiel, **SiteWise Tutorial Device Model**.

1. Führen Sie unter **Measurement definitions (Messungsdefinitionen)** die folgenden Schritte aus:

   1. Geben Sie unter **Name** **CPU Usage** ein.

   1. Geben Sie unter **Unit (Einheit)** **%** ein.

   1. Lassen Sie den **Data type (Datentyp)** bei **Double (Doppelt)**.

   Messungseigenschaften stellen die Rohdatenströme eines Geräts dar. Weitere Informationen finden Sie unter [Definieren Sie Datenströme von Geräten (Messungen)](measurements.md).

1. Wählen Sie **Neue Messung hinzufügen**, um eine zweite Messeigenschaft hinzuzufügen.

1. Führen Sie in der zweiten Zeile unter **Measurement definitions (Messungsdefinitionen)** die folgenden Schritte aus:

   1. Geben Sie unter **Name** **Memory Usage** ein.

   1. Geben Sie unter **Unit (Einheit)** **%** ein.

   1. Lassen Sie den **Data type (Datentyp)** bei **Double (Doppelt)**.

1. Führen Sie unter **Metric definitions (Metrikdefinitionen)** die folgenden Schritte aus:

   1. Geben Sie unter **Name** **Average CPU Usage** ein.

   1. Geben Sie unter **Formula (Formel)** **avg(CPU Usage)** ein. Wählen Sie **CPU Usage** aus der Autovervollständigungsliste aus, wenn sie angezeigt wird.

   1. Geben Sie unter **Time interval (Zeitintervall)** **5 minutes** ein.

   Metrikeigenschaften definieren Aggregationsberechnungen, die alle Eingabedatenpunkte über ein Intervall verarbeiten und einen einzelnen Datenpunkt pro Intervall ausgeben. Diese Metrikeigenschaft berechnet alle 5 Minuten die durchschnittliche CPU-Auslastung jedes Geräts. Weitere Informationen finden Sie unter [Aggregieren Sie Daten aus Immobilien und anderen Vermögenswerten (Metriken)](metrics.md).

1. Wählen Sie **Neue Metrik hinzufügen**, um eine zweite Metrikeigenschaft hinzuzufügen.

1. Führen Sie in der zweiten Zeile unter **Metric definitions (Metrikdefinitionen)** die folgenden Schritte aus:

   1. Geben Sie unter **Name** **Average Memory Usage** ein.

   1. Geben Sie unter **Formula (Formel)** **avg(Memory Usage)** ein. Wählen Sie **Memory Usage** aus der Autovervollständigungsliste aus, wenn sie angezeigt wird.

   1. Geben Sie unter **Time interval (Zeitintervall)** **5 minutes** ein.

   Diese Metrikeigenschaft berechnet alle 5 Minuten die durchschnittliche Speicherbelegung jedes Geräts.

1. (Optional) Fügen Sie weitere zusätzliche Metriken hinzu, die Sie pro Gerät berechnen möchten. Einige interessante Funktionen sind `min` und `max`. Weitere Informationen finden Sie unter [Verwenden Sie Formelausdrücke](formula-expressions.md). In *Schritt 4: Erstellen eines Geräteflotten-Asset-Modells* erstellen Sie ein übergeordnetes Asset, das anhand von Daten aus Ihrer gesamten Geräteflotte Kennzahlen berechnen kann.

1. Wählen Sie **Modell erstellen** aus.

## Schritt 4: Erstellen Sie ein Geräteflotten-Asset-Modell
<a name="rule-tutorial-create-fleet-model"></a>

In diesem Verfahren erstellen Sie ein Asset-Modell, AWS IoT SiteWise das Ihre Sammlung von Geräten symbolisiert. Innerhalb dieses Asset-Modells legen Sie eine Struktur fest, die es Ihnen ermöglicht, zahlreiche Geräte-Assets zu einem übergeordneten Flotten-Asset zu verknüpfen. Anschließend skizzieren Sie Kennzahlen im Flotten-Asset-Modell, um Daten aus allen verbundenen Gerätebeständen zu konsolidieren. Dieser Ansatz bietet Ihnen umfassende Einblicke in die Gesamtleistung Ihrer gesamten Flotte.

**So erstellen Sie ein Komponentenmodell, das eine Geräteflotte darstellt:**

1. Navigieren Sie zur [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/).

1. Wählen Sie im linken Navigationsbereich **Models (Modelle)** aus.

1. Wählen Sie **Asset-Modell erstellen** aus.

1. Geben Sie unter **Modelldetails** einen Namen für Ihr Modell ein. Beispiel, **SiteWise Tutorial Device Fleet Model**.

1. Führen Sie unter **Hierarchy definitions (Hierarchiedefinitionen)** die folgenden Schritte aus:

   1. Geben Sie unter **Hierarchy name (Hierarchiename)** **Device** ein.

   1. Wählen Sie unter **Hierarchy model (Hierarchiemodell)** das Gerätekomponentenmodell (**SiteWise Tutorial Device Model**).

   Eine Hierarchie definiert eine Beziehung zwischen einem übergeordneten (Flotten-) Komponentenmodell und einem untergeordneten (Geräte-) Komponentenmodell. Übergeordnete Komponenten können auf die Eigenschaftendaten von untergeordneten Komponenten zugreifen. Wenn Sie Komponenten später erstellen, müssen Sie untergeordnete Komponenten gemäß einer Hierarchiedefinition im übergeordneten Komponentenmodell den übergeordneten Komponenten zuordnen. Weitere Informationen finden Sie unter [Anlagenhierarchien stellen Gerätebeziehungen dar](industrial-asset-models.md#asset-hierarchies).

1. Führen Sie unter **Metric definitions (Metrikdefinitionen)** die folgenden Schritte aus:

   1. Geben Sie unter **Name** **Average CPU Usage** ein.

   1. Geben Sie unter **Formula (Formel)** **avg(Device \$1 Average CPU Usage)** ein. Wenn die Autovervollständigungsliste angezeigt wird, wählen Sie **Device**, um eine Hierarchie auszuwählen, und dann **Average CPU Usage**, um die Metrik aus der zuvor erstellten Gerätekomponente auszuwählen.

   1. Geben Sie unter **Time interval (Zeitintervall)** **5 minutes** ein.

   Diese Metrikeigenschaft berechnet die durchschnittliche CPU-Auslastung aller Gerätekomponenten, die einer Flottenkomponente über die **Device**-Hierarchie zugeordnet sind.

1. Wählen Sie **Neue Metrik hinzufügen**, um eine zweite Metrikeigenschaft hinzuzufügen.

1. Führen Sie in der zweiten Zeile unter **Metric definitions (Metrikdefinitionen)** die folgenden Schritte aus:

   1. Geben Sie unter **Name** **Average Memory Usage** ein.

   1. Geben Sie unter **Formula (Formel)** **avg(Device \$1 Average Memory Usage)** ein. Wenn die Autovervollständigungsliste angezeigt wird, wählen Sie **Device**, um eine Hierarchie auszuwählen, und dann **Average Memory Usage**, um die Metrik aus der zuvor erstellten Gerätekomponente auszuwählen.

   1. Geben Sie unter **Time interval (Zeitintervall)** **5 minutes** ein.

   Diese Metrikeigenschaft berechnet die durchschnittliche Speicherbelegung aller Gerätekomponenten, die einer Flottenkomponente über die **Device**-Hierarchie zugeordnet sind.

1. (Optional) Fügen Sie weitere zusätzliche Metriken hinzu, die Sie für Ihre gesamte Geräteflotte berechnen möchten.

1. Wählen Sie **Modell erstellen** aus.

## Schritt 5: Erstellen und konfigurieren Sie ein Geräte-Asset
<a name="rule-tutorial-create-device-assets"></a>

In diesem Verfahren generieren Sie ein Geräte-Asset, das auf Ihrem Geräte-Asset-Modell basiert. Anschließend definieren Sie Eigenschaftsaliase für jede Messungseigenschaft. Ein *Eigenschaftsalias* ist eine eindeutige Zeichenfolge, die eine Asset-Eigenschaft identifiziert. Später können Sie eine Eigenschaft für den Datenupload identifizieren, indem Sie die Aliase anstelle der Asset-ID und der Eigenschafts-ID verwenden. Weitere Informationen finden Sie unter [Datenströme verwalten für AWS IoT SiteWise](manage-data-streams.md). 

**So erstellen Sie eine Gerätekomponente und definieren Eigenschaftsaliase**

1. Navigieren Sie zur [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/).

1. Klicken Sie im linken Navigationsbereich auf **Assets (Komponenten)**.

1. Wählen Sie dann **Create asset (Komponente erstellen)** aus.

1. Wählen Sie unter **Modellinformationen** das Asset-Modell Ihres Geräts aus. **SiteWise Tutorial Device Model**

1. Geben Sie unter **Inventarinformationen** einen Namen für Ihr Asset ein. Beispiel, **SiteWise Tutorial Device 1**.

1. Wählen Sie dann **Create asset (Komponente erstellen)** aus.

1. Wählen Sie für Ihre neue Gerätekomponente **Edit (Bearbeiten)**.

1. Unter **Messungen**:

   1. Geben Sie unter **CPU Usage** **/tutorial/device/SiteWiseTutorialDevice1/cpu** als Eigenschaftenalias ein. Sie nehmen den Namen der AWS IoT Sache in den Eigenschaftsalias auf, sodass Sie mithilfe einer einzigen AWS IoT Regel Daten von all Ihren Geräten aufnehmen können.

   1. Geben Sie unter **Memory Usage** **/tutorial/device/SiteWiseTutorialDevice1/memory** als Eigenschaftenalias ein.

1. Wählen Sie **Speichern**.

Wenn Sie zuvor mehrere AWS IoT Dinge erstellt haben, wiederholen Sie die Schritte 3 bis 10 für jedes Gerät und erhöhen Sie die Zahl im Assetnamen und den Eigenschaftsaliasnamen entsprechend. Beispielsweise sollte der Name der zweiten Gerätekomponente **SiteWise Tutorial Device 2** sein und die Eigenschaftsaliase sollten **/tutorial/device/SiteWiseTutorialDevice2/cpu** und **/tutorial/device/SiteWiseTutorialDevice2/memory** sein.

## Schritt 6: Erstellen und konfigurieren Sie ein Geräteflotten-Asset
<a name="rule-tutorial-create-fleet-asset"></a>

In diesem Verfahren erstellen Sie ein Geräteflotten-Asset, das von Ihrem Geräteflotten-Assetmodell abgeleitet ist. Anschließend verknüpfen Sie Ihre individuellen Geräte-Assets mit dem Flotten-Asset. Diese Zuordnung ermöglicht es, anhand der metrischen Eigenschaften der Flottenanlage Daten von mehreren Geräten zusammenzustellen und zu analysieren. Diese Daten bieten Ihnen einen konsolidierten Überblick über die Gesamtleistung der gesamten Flotte.

**So erstellen Sie eine Geräteflottenkomponente und ordnen ihr Gerätekomponenten zu:**

1. Navigieren Sie zur [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/).

1. Klicken Sie im linken Navigationsbereich auf **Assets (Komponenten)**.

1. Wählen Sie dann **Create asset (Komponente erstellen)** aus.

1. Wählen Sie unter **Modellinformationen** das Asset-Modell Ihrer Geräteflotte aus**SiteWise Tutorial Device Fleet Model**.

1. Geben Sie unter **Inventarinformationen** einen Namen für Ihr Asset ein. Beispiel, **SiteWise Tutorial Device Fleet 1**.

1. Wählen Sie dann **Create asset (Komponente erstellen)** aus.

1. Wählen Sie für Ihre neue Geräteflottenkomponente **Edit (Bearbeiten)**.

1. Wählen Sie unter **Diesem Asset zugeordnete Assets** die Option **Verbundenes Asset hinzufügen** aus und gehen Sie wie folgt vor:

   1. Wählen Sie unter **Hierarchy (Hierarchie)** die Option **Device** aus. Diese Hierarchie identifiziert die hierarchische Beziehung zwischen Geräte- und Geräteflottenkomponenten. Sie haben diese Hierarchie im Geräteflottenkomponentenmodell früher in diesem Tutorial definiert.

   1. Wählen Sie unter **Asset (Komponente)** Ihre Gerätekomponente, **SiteWise Tutorial Device 1**, aus.

1. (Optional) Wenn Sie zuvor mehrere Geräte-Assets erstellt haben, wiederholen Sie die Schritte 8 bis 10 für jedes Geräte-Asset, das Sie erstellt haben.

1. Wählen Sie **Speichern**.

   Sie sollten nun Ihre Gerätekomponenten als Hierarchie sehen.

## Schritt 7: Erstellen Sie in AWS IoT Core eine Regel, um Daten an Geräteressourcen zu senden
<a name="rule-tutorial-create-iot-rule"></a>

In diesem Verfahren richten Sie eine Regel in ein AWS IoT Core. Die Regel dient dazu, Benachrichtigungen aus Geräteschatten zu interpretieren und die Daten an Ihre Geräteressourcen in zu übertragen AWS IoT SiteWise. Jedes Mal, wenn der Shadow Ihres Geräts aktualisiert wird, wird eine MQTT-Nachricht AWS IoT gesendet. Sie können eine Regel erstellen, die aktiv wird, wenn sich Geräteschatten basierend auf der MQTT-Nachricht ändern. In diesem Fall besteht das Ziel darin, die Aktualisierungsnachricht zu verarbeiten, die Eigenschaftswerte zu extrahieren und sie an Ihre Geräteressourcen in AWS IoT SiteWise zu übertragen. 

**Um eine Regel mit einer AWS IoT SiteWise Aktion zu erstellen**

1. Navigieren Sie zur [AWS IoT -Konsole](https://console.aws.amazon.com/iot/).

1. Wählen Sie im linken Navigationsbereich **Nachrichtenweiterleitung** und dann **Regeln** aus.

1. Wählen Sie **Regel erstellen** aus.

1. Geben Sie einen Namen und eine Beschreibung für Ihre Regel ein und wählen Sie **dann Weiter**.

1. Geben Sie die folgende SQL-Anweisung ein und wählen Sie **dann Weiter**.

   ```
   SELECT
     *
   FROM
     '$aws/things/+/shadow/update/accepted'
   WHERE
     startsWith(topic(3), "SiteWiseTutorialDevice")
   ```

   Diese Regelabfrageanweisung funktioniert, weil der Geräte-Schattenservice Schattenaktualisierungen in `$aws/things/thingName/shadow/update/accepted` veröffentlicht. Weitere Informationen zu Device Shadows finden Sie unter [Device Shadow Service](https://docs.aws.amazon.com/iot/latest/developerguide/iot-device-shadows.html) im *AWS IoT Entwicklerhandbuch*.

   In der `WHERE`-Klausel verwendet diese Regelabfrageanweisung die `topic(3)`-Funktion, um den Namen des Objekts aus dem dritten Segment des Themas abzurufen. Anschließend filtert die Anweisung Geräte heraus, die Namen haben, die nicht mit denen der Geräte für das Tutorial übereinstimmen. Weitere Informationen zu AWS IoT SQL finden Sie in der [AWS IoT SQL-Referenz](https://docs.aws.amazon.com/iot/latest/developerguide/iot-sql-reference.html) im *AWS IoT Entwicklerhandbuch*.

1. Wählen Sie unter **Regelaktionen** die Option **Nachrichtendaten an Asset-Eigenschaften senden in** aus AWS IoT SiteWise und gehen Sie wie folgt vor:

   1. Wählen Sie **By property alias (Nach Eigenschaftenalias)**.

   1. Geben Sie unter **Property alias (Eigenschaftenalias)** **/tutorial/device/\$1\$1topic(3)\$1/cpu** ein.

      Die `${...}` Syntax ist eine Ersatzvorlage. AWS IoT wertet den Inhalt in den geschweiften Klammern aus. Diese Substitutionsvorlage ruft den Namen des Objekts aus dem Thema ab, um einen Alias zu erstellen, der für jedes Thema eindeutig ist. *Weitere Informationen finden Sie im [Entwicklerhandbuch unter AWS IoT Substitutionsvorlagen](https://docs.aws.amazon.com/iot/latest/developerguide/iot-substitution-templates.html).*
**Anmerkung**  <a name="substitution-template-limitations"></a>
Da ein Ausdruck in einer Substitutionsvorlage getrennt von der `SELECT`-Anweisung ausgewertet wird, können Sie keine Substitutionsvorlage verwenden, um auf einen Alias zu verweisen, der mit einer `AS`-Klausel erstellt wurde. Zusätzlich zu den unterstützten Funktionen und Operatoren können Sie nur in der ursprünglichen Nutzlast vorhandene Informationen referenzieren.

   1. Geben **\$1\$1concat(topic(3), "-cpu-", floor(state.reported.timestamp))\$1** Sie im Feld **Eintrags-ID — *optional*** den Wert ein.

      Der Eintrag identifiziert jeden Versuch, einen Wert einzugeben, IDs eindeutig. Wenn ein Eintrag einen Fehler zurückgibt, finden Sie die Eintrags-ID in der Fehlerausgabe, um das Problem zu beheben. Die Substitutionsvorlage in dieser Eintrags-ID kombiniert den Namen des Objekts und den gemeldeten Zeitstempel des Geräts. Beispielsweise könnte die resultierende Eintrags-ID wie `SiteWiseTutorialDevice1-cpu-1579808494` aussehen.

   1. Geben Sie unter **Time in seconds (Zeit in Sekunden)** **\$1\$1floor(state.reported.timestamp)\$1** ein.

      Diese Substitutionsvorlage berechnet die Zeit in Sekunden aus dem gemeldeten Zeitstempel des Geräts. In diesem Tutorial melden Geräte Zeitstempel in Sekunden nach Unix-Epoche als Gleitkommazahl.

   1. Geben **\$1\$1floor((state.reported.timestamp % 1) \$1 1E9)\$1** Sie im Feld **Offset in Nanos — *optional*** den Wert ein.

      Diese Substitutionsvorlage berechnet die Verschiebung in Nanosekunden aus der Zeit in Sekunden, indem der Dezimalteil des gemeldeten Zeitstempels des Geräts konvertiert wird.
**Anmerkung**  
AWS IoT SiteWise setzt voraus, dass Ihre Daten einen aktuellen Zeitstempel in der Unix-Epochenzeit haben. Wenn Ihre Geräte die Zeit nicht genau melden, können Sie die aktuelle Zeit von der AWS IoT -Regelengine mit [timestamp()](https://docs.aws.amazon.com/iot/latest/developerguide/iot-sql-functions.html#iot-function-timestamp)abrufen. Diese Funktion meldet die Zeit in Millisekunden. Daher müssen Sie die Zeitparameter Ihrer Regelaktion auf die folgenden Werte aktualisieren:  
Geben Sie unter **Time in seconds (Zeit in Sekunden)** **\$1\$1floor(timestamp() / 1E3)\$1** ein.
Geben Sie unter **Offset in Nanos (Verschiebung in Nanosekunden)** **\$1\$1(timestamp() % 1E3) \$1 1E6\$1** ein.

   1. Wählen Sie unter **Data type (Datentyp)** die Option **Double (Doppelt)**.

      Dieser Datentyp muss mit dem Datentyp der Komponenteneigenschaft übereinstimmen, die Sie im Komponentenmodell definiert haben.

   1. Geben Sie unter **Value (Wert)** **\$1\$1state.reported.cpu\$1** ein. In Substitutionsvorlagen verwenden Sie den `.`-Operator, um einen Wert aus einer JSON-Struktur abzurufen.

   1. Wählen Sie **Add entry (Eintrag hinzufügen)**, um einen neuen Eintrag für die Speicherbelegungseigenschaft hinzuzufügen, und führen Sie die folgenden Schritte für diese Eigenschaft erneut aus:

      1. Wählen Sie **By property alias (Nach Eigenschaftenalias)**.

      1. Geben Sie unter **Property alias (Eigenschaftenalias)** **/tutorial/device/\$1\$1topic(3)\$1/memory** ein.

      1. Geben Sie im **Feld Eintrags-ID — *optional*** den Wert ein. **\$1\$1concat(topic(3), "-memory-", floor(state.reported.timestamp))\$1**

      1. Geben Sie unter **Time in seconds (Zeit in Sekunden)** **\$1\$1floor(state.reported.timestamp)\$1** ein.

      1. Geben **\$1\$1floor((state.reported.timestamp % 1) \$1 1E9)\$1** Sie im Feld **Offset in Nanos — *optional*** den Wert ein.

      1. Wählen Sie unter **Data type (Datentyp)** die Option **Double (Doppelt)**.

      1. Geben Sie unter **Value (Wert)** **\$1\$1state.reported.memory\$1** ein.

   1. Wählen Sie unter **IAM-Rolle** die Option **Neue Rolle erstellen** aus, um eine IAM-Rolle für diese Regelaktion zu erstellen. Diese Rolle ermöglicht AWS IoT die Übertragung von Daten auf Eigenschaften in Ihrer Geräteflotte und deren Asset-Hierarchie.

   1. Geben Sie einen Rollennamen ein und wählen Sie **Create**.

1. (Optional) Konfigurieren Sie eine Fehleraktion, die Sie zur Problembehandlung Ihrer Regel verwenden können. Weitere Informationen finden Sie unter [Problembehandlung bei einer Regel ()AWS IoT SiteWise](troubleshoot-rule.md#rule-tutorial-troubleshoot-rule).

1. Wählen Sie **Weiter** aus.

1. Überprüfen Sie die Einstellungen und wählen Sie **Erstellen**, um die Regel zu erstellen.

## Schritt 8: Führen Sie das Geräteclient-Skript aus
<a name="rule-tutorial-run-script"></a>

In diesem Tutorial verwenden Sie kein echtes Gerät, um Daten zu melden. Stattdessen führen Sie ein Skript aus, um den Geräteschatten AWS IoT Ihres Geräts mit der CPU- und Speicherauslastung zu aktualisieren, um echte Sensordaten nachzuahmen. Um das Skript auszuführen, müssen Sie zuerst die erforderlichen Python Pakete installieren. In diesem Verfahren installieren Sie die erforderlichen Python Pakete und führen dann das Geräteclientskript aus.

**So konfigurieren und führen Sie das Geräte-Clientskript aus**

1. Navigieren Sie zur [AWS IoT -Konsole](https://console.aws.amazon.com/iot/).

1. Wählen Sie unten im linken Navigationsbereich **Settings (Einstellungen)** aus.

1. Speichern Sie Ihren benutzerdefinierten Endpunkt zur Verwendung mit dem Geräte-Clientskript. Sie verwenden diesen Endpunkt, um mit den Schatten Ihres Objekts zu interagieren. Dieser Endpunkt ist eindeutig für Ihr Konto in der aktuellen Region.

   Ihr benutzerdefinierter Endpunkt sollte wie im folgenden Beispiel aussehen.

   ```
   identifier.iot.region.amazonaws.com
   ```

1. Öffnen Sie eine Befehlszeile, und führen Sie den folgenden Befehl aus, um zu dem zuvor erstellten Tutorialverzeichnis zu navigieren.

   ```
   cd iot-sitewise-rule-tutorial
   ```

1. Führen Sie den folgenden Befehl aus, um das AWS IoT-Geräte-SDK for Python zu installieren:

   ```
   pip3 install AWSIoTPythonSDK
   ```

   Weitere Informationen finden Sie [AWS IoT-Geräte-SDK for Python](https://docs.aws.amazon.com/iot/latest/developerguide/iot-sdks.html#iot-python-sdk)im *AWS IoT Entwicklerhandbuch*

1. Führen Sie den folgenden Befehl aus, um psutil, eine plattformübergreifende Prozess- und Systemdienstprogrammbibliothek, zu installieren.

   ```
   pip3 install psutil
   ```

   Weitere Informationen finden Sie unter [psutil](https://pypi.org/project/psutil/) im *Python-Paketindex*.

1. Erstellen Sie eine Datei mit dem Namen `thing_performance.py` im Verzeichnis `iot-sitewise-rule-tutorial`, und kopieren Sie dann den folgenden Python-Code in diese Datei.

   ```
   import AWSIoTPythonSDK.MQTTLib as AWSIoTPyMQTT
   
   import json
   import psutil
   import argparse
   import logging
   import time
   
   
   # Configures the argument parser for this program.
   def configureParser():
       parser = argparse.ArgumentParser()
       parser.add_argument(
           "-e",
           "--endpoint",
           action="store",
           required=True,
           dest="host",
           help="Your AWS IoT custom endpoint",
       )
       parser.add_argument(
           "-r",
           "--rootCA",
           action="store",
           required=True,
           dest="rootCAPath",
           help="Root CA file path",
       )
       parser.add_argument(
           "-c",
           "--cert",
           action="store",
           required=True,
           dest="certificatePath",
           help="Certificate file path",
       )
       parser.add_argument(
           "-k",
           "--key",
           action="store",
           required=True,
           dest="privateKeyPath",
           help="Private key file path",
       )
       parser.add_argument(
           "-p",
           "--port",
           action="store",
           dest="port",
           type=int,
           default=8883,
           help="Port number override",
       )
       parser.add_argument(
           "-n",
           "--thingName",
           action="store",
           required=True,
           dest="thingName",
           help="Targeted thing name",
       )
       parser.add_argument(
           "-d",
           "--requestDelay",
           action="store",
           dest="requestDelay",
           type=float,
           default=1,
           help="Time between requests (in seconds)",
       )
       parser.add_argument(
           "-v",
           "--enableLogging",
           action="store_true",
           dest="enableLogging",
           help="Enable logging for the AWS IoT Device SDK for Python",
       )
       return parser
   
   
   # An MQTT shadow client that uploads device performance data to AWS IoT at a regular interval.
   class PerformanceShadowClient:
       def __init__(
           self,
           thingName,
           host,
           port,
           rootCAPath,
           privateKeyPath,
           certificatePath,
           requestDelay,
       ):
           self.thingName = thingName
           self.host = host
           self.port = port
           self.rootCAPath = rootCAPath
           self.privateKeyPath = privateKeyPath
           self.certificatePath = certificatePath
           self.requestDelay = requestDelay
   
       # Updates this thing's shadow with system performance data at a regular interval.
       def run(self):
           print("Connecting MQTT client for {}...".format(self.thingName))
           mqttClient = self.configureMQTTClient()
           mqttClient.connect()
           print("MQTT client for {} connected".format(self.thingName))
           deviceShadowHandler = mqttClient.createShadowHandlerWithName(
               self.thingName, True
           )
   
           print("Running performance shadow client for {}...\n".format(self.thingName))
           while True:
               performance = self.readPerformance()
               print("[{}]".format(self.thingName))
               print("CPU:\t{}%".format(performance["cpu"]))
               print("Memory:\t{}%\n".format(performance["memory"]))
               payload = {"state": {"reported": performance}}
               deviceShadowHandler.shadowUpdate(
                   json.dumps(payload), self.shadowUpdateCallback, 5
               )
               time.sleep(args.requestDelay)
   
       # Configures the MQTT shadow client for this thing.
       def configureMQTTClient(self):
           mqttClient = AWSIoTPyMQTT.AWSIoTMQTTShadowClient(self.thingName)
           mqttClient.configureEndpoint(self.host, self.port)
           mqttClient.configureCredentials(
               self.rootCAPath, self.privateKeyPath, self.certificatePath
           )
           mqttClient.configureAutoReconnectBackoffTime(1, 32, 20)
           mqttClient.configureConnectDisconnectTimeout(10)
           mqttClient.configureMQTTOperationTimeout(5)
           return mqttClient
   
       # Returns the local device's CPU usage, memory usage, and timestamp.
       def readPerformance(self):
           cpu = psutil.cpu_percent()
           memory = psutil.virtual_memory().percent
           timestamp = time.time()
           return {"cpu": cpu, "memory": memory, "timestamp": timestamp}
   
       # Prints the result of a shadow update call.
       def shadowUpdateCallback(self, payload, responseStatus, token):
           print("[{}]".format(self.thingName))
           print("Update request {} {}\n".format(token, responseStatus))
   
   
   # Configures debug logging for the AWS IoT Device SDK for Python.
   def configureLogging():
       logger = logging.getLogger("AWSIoTPythonSDK.core")
       logger.setLevel(logging.DEBUG)
       streamHandler = logging.StreamHandler()
       formatter = logging.Formatter(
           "%(asctime)s - %(name)s - %(levelname)s - %(message)s"
       )
       streamHandler.setFormatter(formatter)
       logger.addHandler(streamHandler)
   
   
   # Runs the performance shadow client with user arguments.
   if __name__ == "__main__":
       parser = configureParser()
       args = parser.parse_args()
       if args.enableLogging:
           configureLogging()
       thingClient = PerformanceShadowClient(
           args.thingName,
           args.host,
           args.port,
           args.rootCAPath,
           args.privateKeyPath,
           args.certificatePath,
           args.requestDelay,
       )
       thingClient.run()
   ```

1. Führen Sie **thing\$1performance.py** über die Befehlszeile mit den folgenden Parametern aus:
   + `-n`, `--thingName` — Der Name Ihres Dings, z. **SiteWiseTutorialDevice1** B.
   + `-e`, `--endpoint` — Ihr benutzerdefinierter AWS IoT Endpunkt, den Sie zuvor in diesem Verfahren gespeichert haben.
   + `-r`, `--rootCA` — Der Pfad zu Ihrem AWS IoT Root-CA-Zertifikat.
   + `-c`, `--cert` — Der Pfad zu deinem AWS IoT Ding-Zertifikat.
   + `-k`, `--key` — Der Pfad zu Ihrem privaten Schlüssel AWS IoT für Ihr Ding-Zertifikat.
   + `-d`, `--requestDelay` — (Optional) Die Wartezeit in Sekunden zwischen den einzelnen Device-Shadow-Updates. Standard ist 1 Sekunde.
   + `-v`, `--enableLogging` — (Optional) Wenn dieser Parameter vorhanden ist, druckt das Skript Debug-Meldungen von. AWS IoT-Geräte-SDK for Python

   Ihr Befehl sollte ähnlich wie im folgenden Beispiel aussehen.

   ```
   python3 thing_performance.py \
     --thingName SiteWiseTutorialDevice1 \
     --endpoint identifier.iot.region.amazonaws.com \
     --rootCA AmazonRootCA1.pem \
     --cert device1/thing-id-certificate.pem.crt \
     --key device1/thing-id-private.pem.key
   ```

   Wenn Sie das Skript für zusätzliche AWS IoT Dinge ausführen, aktualisieren Sie den Namen und das Zertifikatsverzeichnis entsprechend.

1. Versuchen Sie, Programme auf Ihrem Gerät zu öffnen und zu schließen, um zu sehen, wie sich die CPU- und Speichernutzung ändern. Das Skript druckt jede Ablesung von CPU- und Speichernutzung. Wenn das Skript Daten erfolgreich zum Geräteschattenservice hochlädt, sollte die Ausgabe des Skripts wie im folgenden Beispiel aussehen.

   ```
   [SiteWiseTutorialDevice1]
   CPU:    24.6%
   Memory: 85.2%
   
   [SiteWiseTutorialDevice1]
   Update request e6686e44-fca0-44db-aa48-3ca81726f3e3 accepted
   ```

1. Gehen Sie folgendermaßen vor, um zu überprüfen, ob das Skript den Geräteschatten aktualisiert:

   1. Navigieren Sie zur [AWS IoT -Konsole](https://console.aws.amazon.com/iot/).

   1. Wählen Sie im linken Navigationsbereich **Alle Geräte** und dann **Dinge** aus.

   1. Wähle dein Ding, **SiteWiseTutorialDevice**.

   1. Wählen Sie die Registerkarte **Geräteschatten**, wählen Sie **Classic Shadow** und vergewissern Sie sich, dass der **Shadow-Status** wie im folgenden Beispiel aussieht.

      ```
      {
        "reported": {
          "cpu": 24.6,
          "memory": 85.2,
          "timestamp": 1579567542.2835066
        }
      }
      ```

      Wenn der Schattenstatus Ihres Dings leer ist oder nicht wie im vorherigen Beispiel aussieht, überprüfen Sie, ob das Skript ausgeführt wird und ob die Verbindung erfolgreich hergestellt wurde AWS IoT. Wenn das Skript beim Herstellen einer Verbindung zu weiterhin zu einem Timeout kommt AWS IoT, überprüfen Sie, ob Ihre [Ding-Richtlinie](#ingestion-tutorial-create-iot-policy) gemäß dieser Anleitung konfiguriert ist.

1. Gehen Sie folgendermaßen vor, um zu überprüfen, ob die Regelaktion Daten an AWS IoT SiteWise sendet:

   1. Navigieren Sie zur [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/).

   1. Klicken Sie im linken Navigationsbereich auf **Assets (Komponenten)**.

   1. Klicken Sie auf den Pfeil neben Ihrem Geräteflotten-Asset (**SiteWise Tutorial Device Fleet 1**), um dessen Asset-Hierarchie zu erweitern, und wählen Sie dann Ihr Geräte-Asset (**SiteWise Tutorial Device1**) aus.

   1. Wählen Sie **Measurements (Messungen)**.

   1. Stellen Sie sicher, dass die Zellen **Latest value (Letzter Wert)** Werte für die Eigenschaften **CPU Usage** und **Memory Usage** aufweisen.  
![\[Screenshot mit hervorgehobenem „Messungen“.\]](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/images/rule-ingestion/sitewise-view-measurement-values-console.png)

   1. Wenn die Eigenschaften **CPU Usage** und **Memory Usage** nicht über die neuesten Werte verfügen, aktualisieren Sie die Seite. Wenn nach einigen Minuten keine Werte angezeigt werden, finden Sie weitere Informationen unter [Problembehandlung bei einer Regel ()AWS IoT SiteWise](troubleshoot-rule.md#rule-tutorial-troubleshoot-rule).

Sie haben dieses Tutorial abgeschlossen. Wenn Sie Live-Visualisierungen Ihrer Daten untersuchen möchten, können Sie ein Portal in AWS IoT SiteWise Monitor konfigurieren. Weitere Informationen finden Sie unter [Überwachen Sie Daten mit AWS IoT SiteWise Monitor](monitor-data.md). Andernfalls können Sie **STRG\$1C** in der Eingabeaufforderung betätigen, um das Geräte-Clientskript zu stoppen. Es ist unwahrscheinlich, dass das Python-Programm so viele Nachrichten sendet, dass Kosten anfallen, aber es hat sich bewährt, das Programm zu beenden, wenn Sie fertig sind.

## Schritt 9: Ressourcen nach dem Tutorial bereinigen
<a name="rule-tutorial-clean-up-resources"></a>

**Anmerkung**  
Die in diesem Tutorial erstellten Ressourcen sind für das Tutorial [Daten in SiteWise Edge integrieren](integrate_sitewise_edge_mqtt.md) erforderlich. Bereinigen Sie die Ressourcen in diesem Schritt nicht, wenn Sie ihn abschließen möchten.

Nachdem Sie das Tutorial zur Erfassung von Daten aus AWS IoT Dingen abgeschlossen haben, sollten Sie Ihre Ressourcen bereinigen, um zusätzliche Kosten zu vermeiden.<a name="rule-tutorial-delete-assets"></a>

**So löschen Sie hierarchische Objekte in AWS IoT SiteWise**

1. [Navigieren Sie zur Konsole AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/)

1. Klicken Sie im linken Navigationsbereich auf **Assets (Komponenten)**.

1. Wenn Sie Elemente in löschen AWS IoT SiteWise, müssen Sie sie zunächst trennen.

   Führen Sie die folgenden Schritte aus, um die Zuordnung Ihrer Gerätekomponenten zu Ihrer Geräteflottenkomponente aufzuheben:

   1. Wählen Sie Ihr Geräteflotten-Asset (**SiteWise Tutorial Device Fleet 1**) aus.

   1. Wählen Sie **Bearbeiten** aus.

   1. Wählen Sie unter **Assets associated to this asset (Dieser Komponente zugeordnete Komponenten)** die Option **Disassociate (Zuordnung aufheben)** für jede Gerätekomponente, die dieser Geräteflottenkomponente zugeordnet ist.

   1. Wählen Sie **Speichern**.

      Sie sollten nun Ihre Gerätekomponenten nicht mehr als Hierarchie organisiert sehen.

1. Wählen Sie Ihre Gerätekomponente ( **SiteWise Tutorial Device 1**).

1. Wählen Sie **Löschen** aus.

1. Geben Sie in das Bestätigungsfeld **Delete** ein, und wählen Sie dann **Delete (Löschen)**.

1. Wiederholen Sie die Schritte 4 bis 6 für jedes Geräte-Asset und das Geräteflotten-Asset (**SiteWise Tutorial Device Fleet 1**).

**Um hierarchische Asset-Modelle zu löschen in AWS IoT SiteWise**

1. Navigieren Sie zur [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/).

1. Wenn Sie dies noch nicht getan haben, löschen Sie Ihre Geräte- und Geräteflottenkomponenten. Weitere Informationen finden Sie im [vorhergehenden Verfahren](#rule-tutorial-delete-assets). Sie können ein Modell nicht löschen, wenn Sie Komponenten haben, die aus diesem Modell erstellt wurden.

1. Wählen Sie im linken Navigationsbereich **Models (Modelle)** aus.

1. Wählen Sie Ihr Geräteflottenkomponentenmodell (**SiteWise Tutorial Device Fleet Model**).

   Wenn Sie hierarchische Anlagenmodelle löschen, löschen Sie zunächst das übergeordnete Anlagenmodell.

1. Wählen Sie **Löschen** aus.

1. Geben Sie in das Bestätigungsfeld **Delete** ein, und wählen Sie dann **Delete (Löschen)**.

1. Wiederholen Sie die Schritte 4 bis 6 für Ihr Gerätekomponentenmodell (**SiteWise Tutorial Device Model**).

**Um eine Regel zu deaktivieren oder zu löschen in AWS IoT Core**

1. Navigieren Sie zur [AWS IoT -Konsole](https://console.aws.amazon.com/iot/).

1. Wählen Sie im linken Navigationsbereich **Nachrichtenweiterleitung** und dann **Regeln** aus.

1. Wählen Sie Ihre Regel aus und klicken Sie auf **Löschen**.

1. Geben Sie im Bestätigungsdialogfeld den Namen der Regel ein und wählen Sie dann **Löschen**.

# Integrieren Sie Daten mithilfe eines MQTT-fähigen V3-Gateways in SiteWise Edge
<a name="integrate_sitewise_edge_mqtt"></a>

Dieses Tutorial führt Sie durch die Integration von Geräten und Sensoren von Drittanbietern, die das MQTT-Messaging-Protokoll verwenden, mit dem AWS IoT SiteWise MQTT-fähigen V3-Gateway. Sie erfahren, wie Sie ein AWS IoT SiteWise Edge-Gateway einrichten, um Daten von Ihren MQTT-fähigen Geräten zu sammeln und zu überwachen. AWS IoT SiteWise ermöglicht es Ihnen, Daten zu Industrieanlagen zu sammeln, zu verarbeiten und zu überwachen. Nutzen Sie SiteWise Edge-Funktionen, um den industriellen IoT-Betrieb zu optimieren und Rohdaten in umsetzbare Erkenntnisse umzuwandeln.

In diesem Tutorial verwenden wir Daten aus einer Windpark-Demonstration, um wichtige Konzepte zu veranschaulichen. Nachdem Sie sich mit dem Prozess vertraut gemacht haben, können Sie das Tutorial mit Ihren eigenen Daten wiederholen.

 Nachdem Sie dieses Tutorial abgeschlossen haben, können Sie die folgenden Aufgaben ausführen:
+ Richten Sie ein MQTT-fähiges V3-Gateway ein und konfigurieren Sie es für den Empfang von Daten von Industriegeräten
+ Verarbeiten und validieren Sie eingehende MQTT-Nachrichten von Ihren Geräten am Netzwerkrand
+ Zeigen Sie Gerätedaten AWS IoT SiteWise mithilfe einer Visualisierungsplattform eines Drittanbieters an
+ Senden Sie verarbeitete Daten von Ihrem Edge-Gateway an das AWS Cloud , um eine zentrale Speicherung und weitere Analysen zu ermöglichen

Darüber hinaus können Sie die Funktionen Ihres Edge-Gateways nutzen, indem Sie eine Verbindung zu anderen AWS IoT Diensten herstellen, um die folgenden Aufgaben auszuführen:
+ Konfigurieren Sie AWS IoT Regeln, um Daten an Dienste wie [Amazon S3](https://aws.amazon.com/s3/), [Amazon Timestream](https://aws.amazon.com/timestream/) und [AWS Lambda](https://aws.amazon.com/lambda/)weiterzuleiten.
+ Verwenden Sie diese [AWS IoT Device Defender](https://aws.amazon.com/iot-device-defender/)Option, um Ihre Gateway-Konfigurationen aus der Ferne zu verwalten und zu aktualisieren.
+ Implementieren Sie mithilfe von AWS IoT Sicherheitsfunktionen eine sichere Geräteauthentifizierung und -autorisierung. Weitere Informationen finden Sie unter [AWS IoT Sicherheit](https://docs.aws.amazon.com/iot/latest/developerguide/iot-security.html) im *AWS IoT Entwicklerhandbuch*.
+ Erstellen Sie automatisierte Warnmeldungen und Benachrichtigungen auf der Grundlage von Gerätedaten. Weitere Informationen finden Sie unter [Regeln für AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html) im *AWS IoT Entwicklerhandbuch*.

**Anmerkung**  
Dieses Tutorial bezieht sich auf Dienste, Tools und Dokumentation von Drittanbietern. AWS ist kein Anbieter oder Lieferant für Produkte oder Dienstleistungen von Drittanbietern und kann die Richtigkeit der Informationen externer Anbieter nicht garantieren. Evaluieren und validieren Sie alle Tools von Drittanbietern vor der Bereitstellung.

**Topics**
+ [Voraussetzungen](#gateway-tutorial-prerequisites)
+ [Schritt 1: Erstellen Sie eine AWS IoT Richtlinie](#gateway-tutorial-create-iot-policy)
+ [Schritt 2: Erstellen und konfigurieren Sie ein AWS IoT Ding](#gateway-tutorial-create-and-configure-aws-iot-thing)
+ [Schritt 3: Konfigurieren Sie Ihr SiteWise Edge-MQTT-fähiges V3-Gateway](#gateway-tutorial-configure-your-edge-gateway)
+ [Schritt 4: Installieren Sie die SiteWise Edge-Gateway-Software](#install-gateway-software)
+ [Schritt 5: Konfigurieren Sie den EMQX-Broker für die Verbindung zu externen Anwendungen](#configure-emqx-broker-external-applications)
+ [Schritt 6: Veröffentlichen Sie Daten mit Mosquitto](#add-mqtt-data-source)
+ [Schritt 7: Ziele angeben](#specify-destinations)
+ [Schritt 8: Pfadfilter angeben](#specify-path-filters)
+ [Schritt 9: Konfigurieren Sie Ihre AWS IoT-Ressourcen](#configure-iot-resources)
+ [Schritt 10: Visualisieren Sie Ihre Daten](#visualize-your-data)
+ [Schritt 11: Ressourcen nach dem Tutorial bereinigen](#tutorial-clean-up-resources)
+ [Weitere Ressourcen](#additional-resources)

## Voraussetzungen
<a name="gateway-tutorial-prerequisites"></a>

Zum Durcharbeiten dieses Tutorials ist Folgendes erforderlich:
+ Ein AWS-Konto. Falls Sie noch keines haben, beachten Sie die Informationen unter [Richten Sie ein Konto ein AWS](getting-started.md#set-up-aws-account).
+ Ein AWS Identity and Access Management (IAM-) Benutzer mit Administratorrechten. Weitere Informationen finden Sie unter [Identitäts- und Zugriffsmanagement für AWS IoT SiteWise](security-iam.md).
+ Die neueste Version von ist auf Ihrem Gerät Python installiert.

**Wichtig**  
Für dieses Tutorial müssen Ressourcen verwendet werden, die im Tutorial [Daten aufnehmen](ingest-data-from-iot-things.md) erstellt wurden. Sie müssen es abschließen, bevor Sie mit diesem Tutorial fortfahren können.

## Schritt 1: Erstellen Sie eine AWS IoT Richtlinie
<a name="gateway-tutorial-create-iot-policy"></a>

In diesem Tutorial wird die AWS IoT Richtlinie verwendet, die Sie im Tutorial [Daten aufnehmen](ingest-data-from-iot-things.md) erstellt haben. Diese Richtlinie legt die Sicherheitsregeln für Ihre Geräte fest und erstellt eine digitale Darstellung Ihrer externen Geräte und Sensoren in AWS IoT. Die Richtlinie ermöglicht es Ihren Geräten von Drittanbietern, Daten AWS IoT Core mithilfe von MQTT (Message Queuing Telemetry Transport) zu senden. [Weitere Informationen zu MQTT-Nachrichten finden Sie unter Was ist MQTT?](https://aws.amazon.com/what-is/mqtt/) .

------
#### [ Console ]

Stellen Sie sicher, dass eine AWS IoT Richtlinie abgeschlossen ist. Eine ausführliche Anleitung finden Sie in [Schritt 1](ingest-data-from-iot-things.md#ingestion-tutorial-create-iot-policy) im Tutorial [Daten aufnehmen](ingest-data-from-iot-things.md).

**Um zu überprüfen, ob Sie über eine aktive AWS IoT Richtlinie verfügen**

1. Navigieren Sie zur [AWS IoT -Konsole](https://console.aws.amazon.com/iot/).

1. Wählen Sie im linken Navigationsbereich **Securities** und dann **Policies** aus.

1. Wählen Sie die Richtlinie aus, die Sie erstellt haben. Beispiel, **SiteWiseTutorialDevicePolicy**.

1. Vergewissern Sie sich, dass der Status der Richtlinie als Aktiv aufgeführt ist.

------
#### [ AWS CLI ]

Stellen Sie sicher, dass eine AWS IoT Richtlinie abgeschlossen ist. Eine ausführliche Anleitung finden Sie in [Schritt 1](ingest-data-from-iot-things.md#ingestion-tutorial-create-iot-policy) im Tutorial [Daten aufnehmen](ingest-data-from-iot-things.md).

Verwenden Sie den folgenden Befehl AWS CLI [get-policy](https://docs.aws.amazon.com/cli/latest/reference/iot/get-policy.html) in der *AWS CLI Befehlsreferenz*, um zu überprüfen, ob Sie über eine aktive AWS IoT Richtlinie verfügen:

```
aws iot get-policy --policy-name "SiteWiseTutorialDevicePolicy"
```

------

Diese Richtlinie ermöglicht es Ihren AWS IoT Geräten, mithilfe von MQTT-Nachrichten Verbindungen herzustellen und mit Geräteschatten zu kommunizieren. Um mit Geräteschatten zu interagieren, veröffentlichen und empfangen Ihre AWS IoT Geräte MQTT-Nachrichten zu Themen, die mit beginnen. `$aws/things/thing-name/shadow/` Diese Richtlinie enthält eine Ding-Richtlinienvariable, die als`${iot:Connection.Thing.ThingName}`. Diese Variable ersetzt in jedem Thema den Namen der verbundenen Sache. Die `iot:Connect` Anweisung beschränkt, welche Geräte Verbindungen herstellen können, und stellt so sicher, dass die Richtlinienvariable thing nur Namen ersetzen kann, die mit `SiteWiseTutorialDevice` beginnen.

Weitere Informationen finden Sie unter [Ding-Richtlinienvariablen](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policy-variables.html) im *AWS IoT Entwicklerhandbuch*.

**Anmerkung**  
Diese Richtlinie gilt für Objekte, deren Namen mit `SiteWiseTutorialDevice` beginnen. Um einen anderen Namen für Ihre Objekte zu verwenden, müssen Sie die Richtlinie entsprechend aktualisieren.

## Schritt 2: Erstellen und konfigurieren Sie ein AWS IoT Ding
<a name="gateway-tutorial-create-and-configure-aws-iot-thing"></a>

Registrieren Sie in diesem Schritt Ihr Edge-Gerät als AWS IoT Ding und generieren Sie die Zertifikate und Schlüssel Ihres Dings, die für die sichere Kommunikation mit AWS IoT SiteWise Edge benötigt werden. Dieser Prozess bildet die Grundlage dafür, dass Ihr Gerät Daten von Drittanbietern über Ihr MQTT-fähiges V3-Gateway senden kann. 

------
#### [ Console ]

Stellen Sie sicher, dass die Erstellungs- und Konfigurationsschritte für eine Sache abgeschlossen sind. AWS IoT Eine ausführliche Anleitung finden Sie in [Schritt 2](ingest-data-from-iot-things.md#rule-tutorial-create-iot-thing) im Tutorial [Daten aufnehmen](ingest-data-from-iot-things.md).

**Um zu überprüfen, ob Sie ein aktives AWS IoT Objekt haben**

1. Navigieren Sie zur [AWS IoT -Konsole](https://console.aws.amazon.com/iot/).

1. Wählen Sie im linken Navigationsbereich **Alle Geräte** und dann **Dinge** aus.

1. Wählen Sie das Ding aus, das Sie erstellt haben. Beispiel, **SiteWiseTutorialDevice1**.

1. Vergewissern Sie sich, dass der Status unter **Zertifikate** als aktiv aufgeführt ist.

------
#### [ AWS CLI ]

Stellen Sie sicher, dass die Erstellungs- und Konfigurationsschritte für ein Objekt AWS IoT abgeschlossen sind. Eine ausführliche Anleitung finden Sie in [Schritt 2](ingest-data-from-iot-things.md#rule-tutorial-create-iot-thing) im Tutorial [Daten aufnehmen](ingest-data-from-iot-things.md).

Verwenden Sie den folgenden AWS CLI Befehl, um zu überprüfen, ob Sie über eine aktive AWS IoT Richtlinie verfügen:

```
 aws iot describe-thing --thing-name "SiteWiseTutorialDevice1"
```

------

Nachdem Sie diese Schritte abgeschlossen haben, können Sie Ihr Gerät sicher mit AWS IoT SiteWise Edge verbinden. Sie haben ein lokales Verzeichnis zum Speichern Ihrer Zertifikate und Schlüssel erstellt, die Sie für die MQTT-Authentifizierung generiert haben. Ihr Gerät ist als Objekt in AWS IoT der [AWS IoT Konsole](https://console.aws.amazon.com/iot/) registriert und Ihr Gerät ist bereit, Daten in SiteWise Edge zu integrieren. Sie können Ihre Industrieanlagen oder andere Geräte an die AWS IoT Plattform anschließen und mit der Datenaufnahme in SiteWise Edge beginnen. 

## Schritt 3: Konfigurieren Sie Ihr SiteWise Edge-MQTT-fähiges V3-Gateway
<a name="gateway-tutorial-configure-your-edge-gateway"></a>

Erstellen Sie in diesem Schritt Ihr AWS IoT SiteWise Edge-MQTT-fähiges V3-Gateway und konfigurieren Sie es für den Empfang von Daten vom EMQX-Broker. Das Gateway fungiert als Brücke zwischen Ihren Geräten und. AWS IoT Auf diese Weise können Sie Daten lokal am Edge verarbeiten, bevor Sie sie an den senden AWS Cloud. Diese Konfiguration reduziert die Bandbreite und verringert die Verzögerungen bei der Cloud-Verarbeitung.

------
#### [ Console ]

**Um Ihr AWS IoT SiteWise MQTT-fähiges V3-Gateway zu erstellen**

1. Melden Sie sich bei der [AWS-Managementkonsole](https://console.aws.amazon.com/) an, und öffnen Sie die [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/). 

1. **Wählen Sie im linken Navigationsbereich **Edge-Gateways** und dann Create Gateway aus.**

1. Wählen Sie unter **Bereitstellungsziel** die Option **Selbst gehostetes Gateway** aus.

1. *Wählen Sie unter Optionen für selbst gehostetes Gateway die Option **MQTT-fähig,** V3-Gateway — empfohlen aus.*

1. **Unter Gateway-Konfiguration:**

   1. Geben Sie im Feld **Gateway-Name** einen Namen für Ihr Gateway ein. Beispiel, **SiteWise Tutorial Device Gateway**.

   1. Wählen Sie **unter Greengrass Device OS** die entsprechende Option für Ihr Gerät aus.

1. Unter **Erweiterte Konfiguration**:

   1. Wählen Sie **Standard-Setup**.

   1. Geben Sie einen Namen für das Greengrass-Core-Gerät ein oder verwenden Sie den von AWS IoT SiteWise generierten Namen. 

1. Wählen Sie **Create gateway (Gateway erstellen)**.

1. Wählen Sie im Bestätigungsdialogfeld **Generieren und herunterladen**, um ein Installationsprogramm für Ihr SiteWise Edge-Gateway zu generieren. Weitere Informationen finden Sie unter [Erstellen eines selbst gehosteten SiteWise Edge-Gateways](create-gateway-ggv2.md#configure-gateway-console).

**Warnung**  
Speichern Sie die Installationsdatei an einem sicheren Ort. Diese Datei kann nicht neu generiert werden und wird benötigt, um das Gateway-Setup in späteren Schritten abzuschließen.

------
#### [ AWS CLI ]

Wird verwendet AWS CLI , um ein selbst gehostetes Gateway zu erstellen. Sie müssen einen Namen für das Gateway angeben und die Plattform und die Gateway-Version angeben. Weitere Informationen finden Sie unter [CreateGateway](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateGateway.html) in der *AWS IoT SiteWise -API-Referenz*.

Wenn Sie dieses Beispiel verwenden möchten, ersetzen Sie die Platzhalter für Benutzereingaben durch Ihre Informationen.

```
aws iotsitewise create-gateway \
    --gateway-name SiteWise Tutorial Device Gateway \
    --gateway-platform greengrassV2={coreDeviceThingName=your-core-device-thing-name, coreDeviceOperatingSystem=LINUX_AMD64} \                        
    --gateway-version 3 \
    [--cli-input-json your-configuration]
```
+ `gateway-name`— Ein eindeutiger Name für das Gateway, zum Beispiel`SiteWise Tutorial Device Gateway`.
+ `gateway-platform`— Geben Sie ein`greengrassV2`. Weitere Informationen finden Sie unter [CreateGateway](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateGateway.html) in der *AWS IoT SiteWise -API-Referenz*.
  + `coreDeviceThingName`— Der Name der AWS IoT Sache für Ihr AWS IoT Greengrass V2 Kerngerät. Beispiel, `SiteWiseTutorialDevice1`.
  + `coreDeviceOperatingSystem`— Das Betriebssystem des Kerngeräts in AWS IoT Greengrass V2. Für Gateway-Version 3 ist die Angabe des Betriebssystems erforderlich. Zu den Optionen gehören:`LINUX_AARCH64`, und`LINUX_AMD64`. `WINDOWS_AMD64`
+ `gateway-version`— Die Version des Gateways.
  + Wird `3` für die Gateway-Version verwendet, um ein MQTT-fähiges V3-Gateway zu erstellen.
+ `cli-input-json`— Eine JSON-Datei mit Anforderungsparametern.

 Verwenden Sie den folgenden AWS CLI Befehl, um zu überprüfen, ob Ihr Gateway erfolgreich erstellt wurde:

```
aws iotsitewise describe-gateway --gateway-id your-gateway-id
```

------

## Schritt 4: Installieren Sie die SiteWise Edge-Gateway-Software
<a name="install-gateway-software"></a>

Verwenden Sie zur Installation der Gateway-Software das Installationspaket, das Sie im vorherigen Schritt heruntergeladen haben. Der Installationsvorgang konfiguriert die erforderlichen Komponenten, startet den Greengrass-Core-Service und registriert Ihr Gerät bei. AWS IoT Greengrass Stellen Sie nach Abschluss der Installation sicher, dass Ihr Gateway in der [AWS IoT SiteWise Konsole](https://console.aws.amazon.com/iotsitewise/) unter **Edge-Gateways** angezeigt wird und dass der Greengrass-Dienst auf Ihrem Gerät ordnungsgemäß ausgeführt wird.

Detaillierte Anweisungen finden Sie unter [Installieren Sie die AWS IoT SiteWise Edge-Gateway-Software auf Ihrem lokalen Gerät](install-gateway-software-on-local-device.md).

## Schritt 5: Konfigurieren Sie den EMQX-Broker für die Verbindung zu externen Anwendungen
<a name="configure-emqx-broker-external-applications"></a>

**Anmerkung**  
 Sie müssen Ihr SiteWise Edge-MQTT-fähiges V3-Gateway bereitgestellt haben, bevor Sie fortfahren können. Das Gateway bietet die erforderlichen Infrastruktur- und Sicherheitseinstellungen, die für die Konfiguration des EMQX-Brokers erforderlich sind. Die Broker-Konfiguration schlägt ohne eine aktive Gateway-Bereitstellung fehl. 

Konfigurieren Sie den EMQX-Broker, um eine sichere Kommunikation zwischen Ihren IoT-Geräten und externen Anwendungen zu ermöglichen. Der EMQX-Broker fungiert als zentraler Messaging-Hub, der Daten zwischen Ihren IoT-Geräten, Gateways und Anwendungen weiterleitet. Der EMQX-Broker gewährleistet eine zuverlässige Nachrichtenzustellung auf Ihrem Gateway und den verbundenen Anwendungen am Edge. Weitere Informationen finden Sie unter [Connect externe Anwendungen mit dem EMQX-Broker](connect-external-applications-emqx.md).

**Um den EMQX-Broker zu konfigurieren**

1. Richten Sie den EMQX-Broker ein. Ausführliche Anweisungen zur Konfiguration finden Sie in den Schritten 1—14 unter [Aktualisieren der EMQX-Bereitstellungskonfiguration für die](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-emqx-broker.html#update-emqx-broker-authentication) Authentifizierung.

1. Richten Sie MQTT-Themen für die Windparküberwachung ein. Weitere Informationen zu den MQTT-Anforderungen finden Sie unter. [Anforderungen an das MQTT-Thema](connect-broker-payload-format.md#connect-broker-mqtt-requirements)

   1. CPU-Auslastung: `SiteWiseTutorialDevice/cpu`

   1. Speichernutzung: `SiteWiseTutorialDevice/memory`

   1. Zeitstempel: `SiteWiseTutorialDevice/timestamp`

1. Überprüfen Sie Ihre Konfiguration und schließen Sie die Bereitstellung ab.

   1. Wählen Sie **Bestätigen**, um Ihre Einstellungen zu speichern.

   1. Wählen Sie **Weiter**, bis Sie zum Schritt **Überprüfen** gelangen.

   1. Wählen Sie auf der Seite **Review (Prüfen)** die Option **Deploy (Bereitstellen)** aus.

   1. Warten Sie, bis die Bereitstellung erfolgreich abgeschlossen wurde, bevor Sie fortfahren.

1. Bereiten Sie Nachrichten im Payload-Format vor, um sie an den EMQX-Broker zu senden. Weitere Informationen zur Strukturierung von Payloads finden Sie unter [Aktualisieren der EMQX-Bereitstellungskonfiguration für die Authentifizierung](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-emqx-broker.html#update-emqx-broker-authentication).

1. Implementieren Sie die folgenden Sicherheitsmaßnahmen:

   1. Verwenden Sie die TLS-Verschlüsselung (Transport Layer Security) (Port 8833), um Daten bei der Übertragung zu schützen. Weitere Informationen finden Sie unter [Konfigurieren Sie TLS für sichere Verbindungen zum EMQX-Broker auf Edge AWS IoT SiteWise](connect-app-to-broker.md#configure-tls-emqx-broker).

   1. Richten Sie die Authentifizierung mit Benutzername und Passwort ein, um die Geräteidentitäten zu überprüfen. Diese Sicherheitsmaßnahme trägt zum Schutz Ihrer Daten bei und stellt sicher, dass nur autorisierte Geräte eine Verbindung zu Ihrem System herstellen können. Weitere Informationen finden Sie unter [Aktivieren Sie die Authentifizierung mit Benutzername und Passwort](configure-emqx-broker.md#emqx-broker-username-password-auth).

Mit EMQX können Sie Autorisierungsregeln erstellen, die auf Kennungen wie Benutzername, IP-Adresse oder Client-ID basieren. Dies ist nützlich, um den Zugriff auf Ihre Daten zu kontrollieren. Weitere Informationen finden Sie unter [Richten Sie Autorisierungsregeln für AWS IoT SiteWise Edge in EMQX ein](authorization-rules-emqx-broker.md).

Nach erfolgreicher Bereitstellung ist Ihr EMQX-Broker konfiguriert und bereit, eine sichere Verbindung mit externen Anwendungen herzustellen.

**Anmerkung**  
Das Payload-Format muss einer bestimmten Struktur folgen, damit AWS IoT SiteWise Edge Ihre Daten ordnungsgemäß verarbeiten und aufnehmen kann. Weitere Informationen zur erforderlichen Struktur finden Sie unter. [Struktur der JSON-Nutzlast](connect-broker-payload-format.md#connect-broker-json-payload)

**Beispiel: Fügen Sie JSON-Payloads für CPU, Arbeitsspeicher und Zeitstempel hinzu**

**CPU-JSON-Nutzlast**

```
{
  "propertyAlias": "SiteWiseTutorialDevice/cpu",
  "propertyValues": [
    {
      "quality": "GOOD",
      "timestamp": {
        "offsetInNanos": 0,
        "timeInSeconds": 1753206441
      },
      "value": {
        "integerValue": 45.2
      }
    }
  ]
}
```

**JSON-Nutzlast des Speichers**

```
{
  "propertyAlias": "SiteWiseTutorialDevice/memory",
  "propertyValues": [
    {
      "quality": "GOOD",
      "timestamp": {
        "offsetInNanos": 0,
        "timeInSeconds": 1753206441
      },
      "value": {
        "integerValue": 67.8
      }
    }
  ]
}
```

**JSON-Nutzlast mit Zeitstempel**

```
{
  "propertyAlias": "SiteWiseTutorialDevice/timestamp",
  "propertyValues": [
    {
      "quality": "GOOD",
      "timestamp": {
        "offsetInNanos": 0,
        "timeInSeconds": 1753206441
      },
      "value": {
        "integerValue": 23.5
      }
    }
  ]
}
```

**Anmerkung**  
Jede JSON-Nutzlast muss separat als einzelne Nachricht veröffentlicht werden. Kombinieren Sie nicht mehrere Eigenschaftswerte in einer einzigen Nachricht. Senden Sie jede CPU-, Speicher- und Zeitstempel-Payload als eigene MQTT-Publikation.

Die Payload definiert die erforderliche JSON-Struktur, die Ihre IoT-Geräte verwenden müssen, um Gerätedaten über den EMQX-Broker an Edge zu senden. SiteWise Dieses Format stellt sicher, dass Ihre Geräte identifiziert und die Sensorwerte verarbeitet werden AWS IoT SiteWise können. Nachdem Sie diese Konfigurationen und Nutzlaststrukturen implementiert haben, ist Ihr Windpark-Überwachungssystem bereit, Daten zu sammeln und zu verarbeiten. 

## Schritt 6: Veröffentlichen Sie Daten mit Mosquitto
<a name="add-mqtt-data-source"></a>

Nachdem Sie Ihr MQTT-fähiges V3-Gateway erstellt haben, konfigurieren Sie Eclipse Mosquitto so, dass Testdaten an Edge gesendet werden. SiteWise Mosquitto ist ein Open-Source-MQTT-Nachrichtenbroker, der das MQTT-Protokoll für einfache Nachrichtenübermittlung zwischen Geräten verwendet. Mit dem Mosquitto-Client können Sie Nachrichten zu MQTT-Themen veröffentlichen und dabei Daten von Windparksensoren simulieren. Simulieren Sie mit Mosquitto Gerätedaten, ohne dass Dienste oder zusätzliche Geräte von Drittanbietern erforderlich sind. Weitere Informationen finden Sie in der [Dokumentation](https://mosquitto.org) auf der offiziellen Eclipse Mosquitto-Website. In diesem Tutorial werden lokale Daten aus dem Tutorial [Daten aufnehmen und fiktive Daten](ingest-data-from-iot-things.md) zu Demonstrationszwecken verwendet. 

**Verwenden Sie den Mosquitto CLI-Client, um den SiteWise Edge EMQX-Broker zu testen**

1. Installieren Sie Mosquitto auf Ihrem lokalen Gerät. Eine ausführliche Anleitung finden [Sie unter Mosquitto herunterladen auf der offiziellen Eclipse Mosquitto-Website](https://mosquitto.org/download/).

1. Weitere Informationen zum Anschließen externer Anwendungen zur Übertragung von Industriedaten finden Sie unter. [Connect externe Anwendungen mit dem EMQX-Broker](connect-external-applications-emqx.md)

**Wichtig**  
Stellen Sie sicher, dass die MQTT-Verbindungseinstellungen, die Sie hier konfigurieren, mit den Einstellungen übereinstimmen, die im Befehl Mosquitto publish verwendet wurden. Der Host muss die IP-Adresse oder der Hostname Ihres Edge-Gateways sein. SiteWise Der Port ist normalerweise 1883 (oder 8883 bei Verwendung von SSL/TLS).

Verwenden Sie Mosquitto, um Testdaten zu veröffentlichen. Öffnen Sie eine Befehlszeile und führen Sie die folgenden Befehle aus:

**Beispiel: CPU-Eigenschaft**

```
mosquitto_pub -h localhost -p 1883 -t "SiteWiseTutorialDevice/cpu" -m '{
  "propertyAlias": "SiteWiseTutorialDevice/cpu",
  "propertyValues": [
    {
      "quality": "GOOD",
      "timestamp": {
        "timeInSeconds": 1753206441,
        "offsetInNanos": 0
      },
      "value": {
        "integerValue": 45.2
      }
    }
  ]
}'
```

**Beispiel: Speichereigenschaft**

```
mosquitto_pub -h localhost -p 1883 -t "SiteWiseTutorialDevice/memory" -m '{
  "propertyAlias": "SiteWiseTutorialDevice/memory",
  "propertyValues": [
    {
      "quality": "GOOD",
      "timestamp": {
        "timeInSeconds": 1753206441,
        "offsetInNanos": 0
      },
      "value": {
        "integerValue": 72.1
      }
    }
  ]
}'
```

**Beispiel: Eigenschaft Timestamp**

```
mosquitto_pub -h localhost -p 1883 -t "SiteWiseTutorialDevice/timestamp" -m '{
  "propertyAlias": "SiteWiseTutorialDevice/timestamp",
  "propertyValues": [
    {
      "quality": "GOOD",
      "timestamp": {
        "timeInSeconds": 1753206441,
        "offsetInNanos": 0
      },
      "value": {
        "integerValue": 1683000000
      }
    }
  ]
}'
```

**Anmerkung**  
Die Verwendung von `localhost` als EMQX-Brokeradresse dient nur zu Demonstrationszwecken. In Produktionsumgebungen oder beim Herstellen einer Verbindung von externen Geräten müssen Sie die entsprechende EMQX-Broker-Adresse für Ihre spezifische Bereitstellungskonfiguration verwenden. Ausführliche Verbindungsanweisungen finden Sie unter. [Connect eine Anwendung mit dem EMQX-Broker auf Edge AWS IoT SiteWise](connect-app-to-broker.md)

## Schritt 7: Ziele angeben
<a name="specify-destinations"></a>

Geben Sie in diesem Schritt Ziele an, um zu bestimmen, wohin Ihre Quelldaten geleitet werden sollen. Verwenden Sie AWS IoT SiteWise Amazon S3 S3-Pufferung als Ziel. Diese Option bietet eine skalierbare Möglichkeit, Ihre IoT-Daten zu speichern und zu verarbeiten. 

------
#### [ Console ]

**Um Ziele hinzuzufügen**

1. Navigieren Sie zur [AWS IoT SiteWise Konsole](https://console.aws.amazon.com/iotsitewise/) und wählen Sie **Edge-Gateways** aus.

1. Wählen Sie unter **SiteWise Tutorial Device Gateway** die Option **Ziele hinzufügen** aus.

1. Wählen Sie unter **Zieldetails** die Option **Mit Amazon S3 AWS IoT SiteWise gepuffert** aus. Weitere Informationen zu Zieltypen finden Sie unter [AWS IoT SiteWise Gateway-Ziele](gw-destinations.md#source-destination).

1. Geben Sie unter **Zielname** einen Namen für Ihr Ziel ein, `SiteWise Tutorial S3 Destination` z. B.

1. Geben Sie unter **S3-Upload-Einstellungen** Ihren S3-Bucket-Standort ein. Beispiel, `s3://sitewise-tutorial-mqtt-data-[your-account-id]`. Weitere Informationen zu Amazon S3 finden Sie unter [Erstellen, Konfigurieren und Arbeiten mit Amazon S3 S3-Buckets](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html) im *Amazon Simple Storage Service-Benutzerhandbuch*.

1. Geben Sie unter **Häufigkeit des Daten-Uploads** einen Wert zwischen 1 Minute und 30 Tagen ein. Beispiel, `1 minute`.

1. Unter **Datenspeichereinstellungen**:

   1. Deaktivieren Sie die Option **Daten in Speicher kopieren**. Diese Einstellung wird zwar für Produktionsumgebungen empfohlen, für dieses Tutorial benötigen Sie sie jedoch nicht. Wenn Sie diese Option deaktivieren, wird die Option **Daten aus S3 löschen** automatisch deaktiviert.

1. Wählen Sie **Add destination** (Ziel hinzufügen).

**Anmerkung**  
In diesem Tutorial wird ein Intervall von 1 Minute zum Testen verwendet. Nachdem Sie das Tutorial abgeschlossen haben, können Sie dieses Intervall an Ihre Produktionsanforderungen anpassen oder es löschen, um zusätzliche Kosten zu vermeiden.

------
#### [ AWS CLI ]

**Beispiel: Erstellen Sie ein neues AWS IoT SiteWise Ziel, das mit Amazon S3 gepuffert wurde**

Verwenden Sie den [update-gateway-capability-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotsitewise/update-gateway-capability-configuration.html)in der *AWS CLI Befehlsreferenz angegebenen*, um den Herausgeber zu konfigurieren. Stellen Sie den Parameter `capabilityNamespace` auf `iotsitewise:publisher:3` ein.

```
{
    "sources": [
      {
        "type": "MQTT"
      }
    ],
    "destinations": [
      {
        "type": "SITEWISE_BUFFERED",
        "name": "your-s3-destination-name",
        "config": {
          "targetBucketArn": "arn:aws:s3:::amzn-s3-demo-bucket/Optional/SomeFolder",
          "publishPolicy": {
            "publishFrequency": "1m",
            "localSizeLimitGB": 10
          },
          "siteWiseImportPolicy": {
            "enableSiteWiseStorageImport": true,
            "enableDeleteAfterImport": true,
            "bulkImportJobRoleArn": "arn:aws:iam::123456789012:role/your-role-name"
          }
        },
        "filters": [
          {
            "type": "PATH",
            "config": {
              "paths": [
                "#"
              ]
            }
          }
        ]
      }
    ]
  }
```

Weitere Informationen zu Zielen finden Sie unter[Fügen Sie ein AWS IoT SiteWise gepuffertes Ziel mit Amazon S3 hinzu](destinations-buffered.md).

------

## Schritt 8: Pfadfilter angeben
<a name="specify-path-filters"></a>

In diesem Schritt konfigurieren Sie Pfadfilter, um anzugeben, welche MQTT-Themen für Ihre Windpark-Gerätedaten überwacht werden sollen.

Pfadfilter folgen der Platzhalterspezifikation für MQTT-Themen, die zwei Sonderzeichen unterstützt:
+ `+`— Dieses Symbol steht für einen Platzhalter mit einer Ebene, der einer beliebigen Zeichenfolge auf einer einzelnen Ebene entspricht.
+ `#`— Dieses Symbol steht für einen Platzhalter mit mehreren Ebenen, der einer beliebigen Anzahl von Ebenen in der Themenhierarchie entspricht.

**Anmerkung**  
Weitere Informationen zu anderen Pfadfiltern finden Sie unter. [Sonderzeichen in Pfadfilternamen](gw-destinations.md#path-filters-special-characters)

------
#### [ Console ]

**So konfigurieren Sie Ihre Pfadfilter**

Unter **Pfadfilter**:

1. Navigieren Sie zur [AWS IoT SiteWise Konsole](https://console.aws.amazon.com/iotsitewise/) und wählen Sie **Edge-Gateways** aus.

1. Wählen Sie unter **SiteWise Tutorial Device Gateway** die Option **Ziele hinzufügen** aus.

1. Wählen Sie **Pfadfilter hinzufügen**, um die folgenden Pfadfilter manuell einzugeben:
   + `SiteWiseTutorialDevice/#`
   + `windfarm/+/turbine/+/performance/#`
   + `cpu/+/idle-time`
   + `cpu/+/interruption-count/+`
   + `+/memory/consumption`
   + `timestamp/+/measurement`
   + `device/+/status/+`
   + `system/+/performance-log`

1. Wählen Sie **Add destination** (Ziel hinzufügen).

Weitere Informationen zu bewährten Methoden für Pfadfilter finden Sie unter[Bewährte Methoden für Pfadfilter](gw-destinations.md#create-effective-path-filters).

------
#### [ AWS CLI ]

Verwenden Sie die folgenden AWS CLI Befehle, um Ihre Pfadfilter zu konfigurieren:

**Beispiel 1: Gerätedaten mit Platzhaltern**

```
{
 "destinations": [
   {
     "name": "All Device Data Destination"
   }
 ],
 "filters": [
   {
     "type": "PATH",
     "config": {
       "paths": [
         "SiteWiseTutorialDevice/#",
         "windfarm/+/turbine/+/performance/#"
       ]
     }
   }
 ]
}
```

Diese Pfadfilterkonfiguration verwendet Platzhalter mit mehreren Ebenen (\$1), um alle Daten aus der Turbine SiteWiseTutorialDevice und alle Leistungsdaten von beliebigen Turbinen im Windpark zu erfassen.

**Beispiel 2: CPU- und Speicherleistung**

```
{
 "destinations": [
   {
     "name": "Performance Metrics Destination"
   }
 ],
 "filters": [
   {
     "type": "PATH",
     "config": {
       "paths": [
         "cpu/+/idle-time",
         "+/memory/consumption",
         "cpu/+/interruption-count/+"
       ]
     }
   }
 ]
}
```

In diesem Beispiel werden verschiedene CPU-Metriken (Leerlaufzeit und Anzahl der Unterbrechungen) und Daten zum Speicherverbrauch geräteübergreifend erfasst.

**Beispiel 3: Gerätediagnose**

```
{
 "destinations": [
   {
     "name": "Device Diagnostics Destination"
   }
 ],
 "filters": [
   {
     "type": "PATH",
     "config": {
       "paths": [
        "device/+/status/+",
        "system/+/performance-log"
       ]
     }
   }
 ]
}
```

Diese Konfiguration verwendet den `+` Platzhalter, um Diagnosedaten von mehreren Geräten zu erfassen, insbesondere Systemleistungsprotokolle und Gerätestatusaktualisierungen.

Diese drei Pfadfilter entsprechen den MQTT-Themen, die Sie verwenden, um Testdaten mit Mosquitto zu veröffentlichen. Die Filter stellen sicher, dass Ihr SiteWise Edge-Gateway die relevanten MQTT-Nachrichten erfasst und verarbeitet. Weitere Informationen zum Hinzufügen von Pfadfiltern finden Sie unter[Fügen Sie Pfadfilter zu AWS IoT SiteWise Edge-Zielen hinzu](destinations-add-path-filters.md).

------

## Schritt 9: Konfigurieren Sie Ihre AWS IoT-Ressourcen
<a name="configure-iot-resources"></a>

In diesem Schritt erstellen Sie die erforderlichen AWS IoT SiteWise Anlagenmodelle und Ressourcen, um Ihre simulierten Geräte von Drittanbietern darzustellen und die Datenaufnahme über Ihr Edge-Gateway zu ermöglichen.

[Bevor Sie mit diesem Schritt beginnen, sollten Sie die Schritte 3 bis 8 des Lernprogramms Daten aufnehmen abgeschlossen haben.](ingest-data-from-iot-things.md) In diesen Schritten werden die grundlegenden Komponenten für die Integration Ihrer Drittanbieterdaten über das MQTT-fähige V3-Gateway festgelegt. Außerdem richten Sie Regeln ein, die definieren, wie Ihre Sensordaten in das System einfließen AWS IoT SiteWise, und führen ein Geräteclient-Skript aus, das industrielle Windparkdaten simuliert.

**Um Ihre AWS IoT-Ressourcenkonfiguration zu validieren**

1. Verwenden Sie den folgenden AWS CLI Befehl, um zu überprüfen, ob Sie Ihr Tutorial-Gerätemodell und Ihr SiteWise Tutorial-Geräteflottenmodell erstellt und SiteWise ordnungsgemäß konfiguriert haben:

   ```
   aws iotsitewise describe-asset-model --asset-model-id your-device-model-id
   ```

   Verwenden Sie den folgenden AWS CLI Befehl, um die ID Ihrer Objektmodelle abzurufen:

   ```
   aws iotsitewise list-asset-models
   ```

1. Verwenden Sie den folgenden AWS CLI Befehl, um zu überprüfen, ob Sie Ihr Tutorial Device 1-Asset und Ihr SiteWise SiteWise Tutorial Device Fleet 1-Asset erstellt und ordnungsgemäß konfiguriert haben:

   ```
   aws iotsitewise describe-asset --asset-id your-asset-id
   ```

   Verwenden Sie den folgenden AWS CLI Befehl, um die ID Ihrer Assets abzurufen:

   ```
   aws iotsitewise list-assets
   ```

## Schritt 10: Visualisieren Sie Ihre Daten
<a name="visualize-your-data"></a>

Richten Sie die Open-Source-Version von Grafana ein, um die Gerätedaten Ihres Windparks zu visualisieren. Grafana ist eine Visualisierungsplattform, die Ihre Betriebsdaten in Echtzeit anzeigt. Mithilfe dieser Dashboards können Sie die betriebliche Effizienz verfolgen und den Wartungsbedarf in Ihrer gesamten Infrastruktur ermitteln. Weitere Informationen zur Integration finden Sie unter[Integrieren Sie AWS IoT SiteWise mit Grafana](grafana-integration.md).

**Um Grafana einzurichten**

1. Anweisungen zum Herunterladen und Installieren der neuesten Version von Grafana finden [Sie unter Grafana installieren auf der offiziellen Grafana-Website](https://grafana.com/docs/grafana/latest/setup-grafana/installation/#install-grafana).

1. Detaillierte Konfigurationsanweisungen für Ihr Betriebssystem finden Sie unter [Grafana konfigurieren](https://grafana.com/docs/grafana/latest/setup-grafana/configure-grafana/#configure-grafana) auf der offiziellen Grafana-Website.

1. Konfigurieren Sie die AWS IoT SiteWise Datenquelle. Dadurch können Sie das AWS IoT SiteWise Plugin auf Ihrem Grafana einrichten. Eine ausführliche Anleitung zur Verwendung des Plug-ins finden Sie unter [Connect zu einer AWS IoT SiteWise Datenquelle](https://docs.aws.amazon.com/grafana/latest/userguide/using-iotsitewise-in-AMG.html) herstellen im *Amazon Managed Grafana-Benutzerhandbuch*.

**Wichtig**  
Stellen Sie sicher, dass Sie über die neueste Version von Grafana verfügen, um die Kompatibilität mit der AWS IoT SiteWise Datenquelle zu gewährleisten.

Nachdem Sie diese Schritte abgeschlossen haben, können Sie Grafana-Dashboards erstellen und anpassen, um die Betriebskennzahlen Ihres Windparks anzuzeigen. Auf diese Weise können Sie die Leistung Ihres Windparks an der Peripherie in Echtzeit verfolgen und analysieren.

**Anmerkung**  
Dieses Tutorial verwendet zwar die Open-Source-Version von Grafana, bietet AWS aber auch Amazon Managed Grafana für Produktionsumgebungen. Amazon Managed Grafana ist ein vollständig verwalteter Service, der die Einrichtung, Konfiguration und Wartung Ihrer eigenen Grafana-Server überflüssig macht.  
Erwägen Sie ein Upgrade auf Amazon Managed Grafana, wenn Sie bereit sind, Ihre Lösung zu skalieren. Detaillierte Anweisungen zum Verbinden Ihrer SiteWise Daten mit Grafana finden Sie im Tutorial [Daten in Grafana visualisieren und teilen](visualize-with-grafana.md).

Sie haben das Tutorial abgeschlossen. In diesem Verfahren haben Sie AWS IoT SiteWise Edge so konfiguriert, dass Gerätedaten von Drittanbietern mithilfe eines MQTT-fähigen V3-Gateways integriert werden. Dieses Setup ermöglicht es Ihnen, Daten zu Industrieanlagen am Netzwerkrand zu sammeln, zu verarbeiten und zu visualisieren, wodurch Latenz und Betriebskosten reduziert werden. Mithilfe der Windpark-Demo haben Sie Betriebsmetriken wie CPU- und Speicherauslastungsdaten über Ihr MQTT-fähiges V3-Gateway gesammelt und verarbeitet.

Um Ihre IoT-Lösung zu verbessern, sollten Sie erwägen, erweiterte Funktionen wie die Erkennung von Anomalien durch Nutzung [Erkennen Sie Anomalien mit Lookout for Equipment](anomaly-detection.md) oder Integration mit anderen AWS Diensten wie [Amazon Quick im Amazon Quick](https://docs.aws.amazon.com/quicksight/latest/user/welcome.html) *User Guide* für erweiterte Analysen zu erkunden.

## Schritt 11: Ressourcen nach dem Tutorial bereinigen
<a name="tutorial-clean-up-resources"></a>

Nachdem Sie dieses Tutorial zur Integration von Daten in AWS IoT SiteWise Edge abgeschlossen haben, sollten Sie Ihre Ressourcen bereinigen, um zusätzliche Kosten zu vermeiden.

**So löschen Sie hierarchische Assets in AWS IoT SiteWise**

1. Navigieren Sie zur [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/).

1. Klicken Sie im linken Navigationsbereich auf **Assets (Komponenten)**.

1. Wenn Sie Elemente in löschen AWS IoT SiteWise, müssen Sie sie zunächst trennen.

   Führen Sie die folgenden Schritte aus, um die Zuordnung Ihrer Gerätekomponenten zu Ihrer Geräteflottenkomponente aufzuheben:

   1. Wählen Sie Ihr Geräteflotten-Asset (**SiteWise Tutorial Device Fleet 1**) aus.

   1. Wählen Sie **Bearbeiten** aus.

   1. Wählen Sie unter **Assets associated to this asset (Dieser Komponente zugeordnete Komponenten)** die Option **Disassociate (Zuordnung aufheben)** für jede Gerätekomponente, die dieser Geräteflottenkomponente zugeordnet ist.

   1. Wählen Sie **Speichern**.
**Anmerkung**  
 Die Geräte-Assets sind jetzt nicht mehr hierarchisch organisiert.

1. Wählen Sie Ihre Gerätekomponente ( **SiteWise Tutorial Device 1**).

1. Wählen Sie **Löschen** aus.

1. Geben Sie im Bestätigungsdialogfeld die Eingabe ein**Delete**, und wählen Sie dann **Löschen**.

1. Wiederholen Sie die Schritte 4 bis 6 für jedes Geräte-Asset und das Geräteflotten-Asset (**SiteWise Tutorial Device Fleet 1**).

**Um hierarchische Objektmodelle zu löschen AWS IoT SiteWise**

1. Navigieren Sie zur [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/).

1. Löschen Sie Ihr Gerät und Ihre Geräteflotten-Assets.

1. Wählen Sie im linken Navigationsbereich **Models (Modelle)** aus.

1. Wählen Sie Ihr Geräteflottenkomponentenmodell (**SiteWise Tutorial Device Fleet Model**). Sie können ein Modell nicht löschen, wenn Sie Komponenten haben, die aus diesem Modell erstellt wurden.

   Wenn Sie hierarchische Asset-Modelle löschen, löschen Sie zunächst das übergeordnete Asset-Modell.

1. Wählen Sie **Löschen** aus.

1. Geben Sie im Bestätigungsdialogfeld die Eingabe ein**Delete**, und wählen Sie dann **Löschen**.

1. Wiederholen Sie die Schritte 4 bis 6 für Ihr Gerätekomponentenmodell (**SiteWise Tutorial Device Model**).

**Um eine Regel zu deaktivieren oder zu löschen in AWS IoT Core**

1. Navigieren Sie zur [AWS IoT -Konsole](https://console.aws.amazon.com/iot/).

1. Wählen Sie im linken Navigationsbereich **Nachrichtenweiterleitung** und dann **Regeln** aus.

1. Wählen Sie Ihre Regel aus und klicken Sie auf **Löschen**.

1. Geben Sie im Bestätigungsdialogfeld den Namen der Regel ein und wählen Sie dann **Löschen**.

**Um einen Amazon S3 S3-Bucket zu löschen**

1. Navigieren Sie zur [Amazon S3 S3-Konsole](https://console.aws.amazon.com/s3/).

1. Wählen Sie im linken Navigationsbereich die Option **Allzweck-Bucket** aus.

1. Wählen Sie in der Bucket-Liste das Optionsfeld neben dem Bucket aus, den Sie erstellt haben, und wählen Sie dann oben auf der Seite **Leer** aus.

1. Bestätigen Sie im Bestätigungsdialogfeld den Löschvorgang und wählen Sie dann **Leeren** aus.

1. Wenn der Bucket leer ist, wählen Sie **Löschen**, um den Bucket zu löschen.

1. Geben Sie im Bestätigungsdialogfeld den Namen Ihres Buckets ein, um das Löschen zu bestätigen.

1. Wählen Sie **Bucket löschen** aus.

**Um ein SiteWise Edge-Gateway zu löschen**

1. Navigieren Sie zur [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/).

1. Wählen Sie im linken Navigationsbereich **Edge-Gateways** aus.

1. Wählen Sie unter Gateways das Gateway aus, das Sie für dieses Tutorial erstellt haben. Beispiel, `SiteWise Tutorial Device Gateway`.

1. Wählen Sie **Löschen** aus.

1. Um zu bestätigen, dass Sie das Gateway löschen möchten, geben Sie den Text **Delete** in das Bestätigungsdialogfeld ein und wählen Sie dann im angezeigten Fenster **Löschen** aus.

**Um dein IoT-Ding zu löschen**

1. Navigieren Sie zur [AWS IoT -Konsole](https://console.aws.amazon.com/iot/).

1. Wählen Sie im linken Navigationsbereich **Verwalten** und dann **Dinge** aus.

1. Wählen Sie das IoT-Ding aus, das Sie für dieses Tutorial erstellt haben. Beispiel, `SiteWiseTutorialDevice1`.

1. Wählen Sie **Löschen** aus.

1. Geben Sie im Bestätigungsdialogfeld den Namen des Dings ein und wählen Sie dann **Löschen**.

**Um AWS IoT Greengrass Core zu deinstallieren**

Deinstallieren Sie die AWS IoT Greengrass Core-Software von Ihrem lokalen Gerät. Ausführliche Anweisungen finden [Sie unter Deinstallieren der AWS IoT Greengrass Core-Software](https://docs.aws.amazon.com/greengrass/v2/developerguide/uninstall-greengrass-core-v2.html) im *AWS IoT Greengrass Entwicklerhandbuch, Version 2.*

**Wichtig**  
Durch die Deinstallation von Greengrass werden alle lokalen Konfigurationen und Daten entfernt. Stellen Sie sicher, dass Sie alle wichtigen Informationen gesichert haben, bevor Sie fortfahren.

**(Optional) Um Ressourcen von Drittanbietern zu löschen**

Erwägen Sie nach Abschluss dieses Tutorials, alle externen Ressourcen, die Sie erstellt haben, herunterzufahren. Auf diese Weise können Sie verhindern, dass Gebühren von Drittanbietern anfallen.

## Weitere Ressourcen
<a name="additional-resources"></a>

Weitere Informationen finden Sie in den folgenden Ressourcen:
+ [Interagiere mit anderen AWS Diensten](interact-with-other-services.md)
+ [Verwenden Sie AWS IoT SiteWise Edge-Gateways](gateways.md)
+ [Fehlerbehebung bei einem SiteWise Edge-Gateway](troubleshooting-gateway.md)
+ [Bewährte Sicherheitsmethoden für AWS IoT SiteWise](security-best-practices.md)
+ [AWS IoT-Preisgestaltung](https://aws.amazon.com/iot-sitewise/pricing/)
+ [Daten aufnehmen in AWS IoT SiteWise](industrial-data-ingestion.md)
+ [Verwenden Sie Tags in AWS IoT SiteWise](tag-basics.md)

# Daten in Grafana visualisieren und teilen
<a name="visualize-with-grafana"></a>

Dieses Tutorial führt Sie durch die Konfiguration des AWS IoT SiteWise Datenquellen-Plugins mit Grafana, einer Datenvisualisierungsplattform. Mit Grafana können Sie Dashboards erstellen, die Ihre Industriedaten visualisieren und überwachen. In diesem Tutorial wird ein Beispieldatensatz aus einer Windpark-Demonstration verwendet, um wichtige Konzepte zu veranschaulichen. Nachdem Sie sich mit dem Prozess vertraut gemacht haben, können Sie das Tutorial mit Ihren eigenen Daten wiederholen.

 Nachdem Sie dieses Tutorial abgeschlossen haben, können Sie Folgendes tun:
+ Sammeln, Abfragen und Analysieren von Daten aus Industrieanlagen
+ Erstellen Sie interaktive Grafana-Dashboards zur Visualisierung von Kennzahlen zur Anlagenleistung
+ Überwachen Sie Betriebsdaten über eine einheitliche Oberfläche
+ Teilen Sie mithilfe der Kollaborationsfunktionen von Grafana Erkenntnisse mit Ihrem Team
+ Kombinieren Sie AWS IoT SiteWise Daten mit anderen AWS Datenquellen wie [Amazon CloudWatch oder Amazon](https://aws.amazon.com/cloudwatch/) [Timestream](https://aws.amazon.com/timestream/)

**Topics**
+ [Voraussetzungen](#grafana-tutorial-prerequisites)
+ [Schritt 1: Konfigurieren Sie Ihren Amazon Managed Grafana-Arbeitsbereich](#configure-workspace)
+ [Schritt 2: Als Datenquelle hinzufügen AWS IoT SiteWise](#add-iot-data-source)
+ [Schritt 3: Erstellen Sie ein Dashboard, um Ihre Daten zu untersuchen und zu visualisieren](#explore-your-data)
+ [(optional) Schritt 4: Richten Sie Warnmeldungen ein, um die Leistung zu überwachen](#set-up-alerts)
+ [Schritt 5: Ressourcen nach dem Tutorial bereinigen](#clean_up_resources)
+ [Weitere Ressourcen](#additional-resources)

## Voraussetzungen
<a name="grafana-tutorial-prerequisites"></a>

Zum Durcharbeiten dieses Tutorials ist Folgendes erforderlich:
+ Ein AWS-Konto. Falls Sie noch keines haben, beachten Sie die Informationen unter [Richten Sie ein Konto ein AWS](getting-started.md#set-up-aws-account).
+ Ein AWS Identity and Access Management (IAM-) Benutzer mit Administratorrechten. Detaillierte Anweisungen finden Sie unter [Wie AWS IoT SiteWise funktioniert mit IAM](security_iam_service-with-iam.md).
+ Eine laufende AWS IoT SiteWise Demo.
**Anmerkung**  
Dieses Tutorial erfordert die Verwendung von Ressourcen, die in Use [the AWS IoT SiteWise demo](getting-started-demo.md) erstellt wurden. Sie müssen es abschließen, bevor Sie mit diesem Tutorial fortfahren können. 

  Die Erstellung der Demo dauert in der Regel etwa 3 Minuten. Wenn die Demo nicht erstellt werden kann, deutet dies möglicherweise auf unzureichende Berechtigungen in Ihrem AWS Konto hin. Wechseln Sie in diesem Fall zu einem Konto mit Administratorzugriff. Weitere Informationen zu erforderlichen Berechtigungen finden Sie unter [Wie AWS IoT SiteWise funktioniert mit IAM](security_iam_service-with-iam.md).
**Wichtig**  
Behalten Sie alle Demo-Ressourcen, bis Sie dieses Tutorial abgeschlossen haben. Das Löschen von Komponenten kann die Funktionalität der Demo beeinträchtigen und Ihre Fähigkeit beeinträchtigen, Daten in Grafana anzuzeigen.

## Schritt 1: Konfigurieren Sie Ihren Amazon Managed Grafana-Arbeitsbereich
<a name="configure-workspace"></a>

In diesem Verfahren erstellen und konfigurieren Sie einen Amazon Managed Grafana-Arbeitsbereich zur Visualisierung Ihrer Windparkdaten.

1. Melden Sie sich bei der [Amazon Managed Grafana-Konsole](https://console.aws.amazon.com/grafana/) an.

1. Wählen Sie **Workspace erstellen**.

1. Geben Sie unter **Workspace-Details** einen Namen für Ihren Workspace ein, z. B. **SiteWiseTutorialDemo**

1. Wählen Sie unter **Grafana-Version** die neueste Version aus. Wählen Sie diese Version für die meisten up-to-date Funktionen und Fähigkeiten. Weitere Informationen zu verschiedenen Versionssätzen finden Sie unter [Unterschiede zwischen Grafana-Versionen](https://docs.aws.amazon.com/grafana/latest/userguide/version-differences.html) im *Amazon Managed Grafana-Benutzerhandbuch*.

1. Wählen Sie **Weiter** aus.

1. Wählen Sie unter **Authentifizierungszugriff** die Option **AWS IAM** Identity Center aus.
   + Wenn AWS IAM Identity Center in Ihrem Konto nicht aktiviert ist, werden Sie aufgefordert, es zuerst einzurichten. Eine ausführliche Anleitung zur Einrichtung des Benutzerzugriffs finden Sie unter [Beispiele für identitätsbasierte Richtlinien für Amazon Managed Grafana](https://docs.aws.amazon.com/grafana/latest/userguide/security_iam_id-based-policy-examples.html#security_iam_id-based-policy-examples-create-workspace-standalone) im *Amazon Managed Grafana-Benutzerhandbuch*.

1. **Wählen Sie unter **Berechtigungstyp die Option Service managed** aus.** Amazon Managed Grafana erstellt und konfiguriert automatisch die erforderlichen IAM-Rollen und -Berechtigungen für alle AWS Datenquellen, die Sie in diesem Workspace verwenden möchten. Für Mitgliedskonten von Organisationen ist die Option Service managed nur verfügbar, wenn das Konto als delegierter Administrator benannt ist. *Informationen zur Einrichtung delegierter Administratorkonten finden Sie unter [Registrieren eines delegierten Administrator-Mitgliedskontos](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-delegated-admin.html) im CloudFormation Benutzerhandbuch.*

1. Führen Sie unter **Workspace-Konfigurationsoptionen** die folgenden Aktionen aus:

   1. Wählen Sie **Grafana-Warnung einschalten aus.** Mit dieser Einstellung können Sie Benachrichtigungen über eine zentrale Oberfläche in Ihrem Workspace erstellen und verwalten. Weitere Informationen finden Sie unter [Arbeiten mit Grafana-Benachrichtigungen im Amazon](https://docs.aws.amazon.com/grafana/latest/userguide/alerts-overview.html) *Managed Grafana-Benutzerhandbuch*.

   1. Wählen Sie **Plugin-Verwaltung einschalten** aus. Auf diese Weise können Sie Plugins in Ihrem Workspace installieren, aktualisieren und deinstallieren. Weitere Informationen finden Sie unter [Erweitern Sie Ihren Workspace mit Plugins](https://docs.aws.amazon.com/grafana/latest/userguide/grafana-plugins.html) im *Amazon Managed Grafana-Benutzerhandbuch*.
**Wichtig**  
Achten Sie darauf, die Plugin-Verwaltung zu aktivieren. Wenn Sie diese Option nicht auswählen, können Sie im folgenden Schritt keine Datenquelle hinzufügen AWS IoT SiteWise .

1. Wählen Sie unter **Netzwerkzugriffskontrolle** die Option **Offener Zugriff** aus. In diesem Tutorial verwenden Sie Demo-Daten, damit Sie den Workspace öffentlich zugänglich machen können.
   + **Offener Zugang** — Ermöglicht den öffentlichen Zugriff auf deinen Workspace.
   + **Eingeschränkter Zugriff** — Beschränkt den Zugriff auf bestimmte IP-Bereiche oder VPC-Endpunkte. Weitere Informationen finden Sie unter [So funktioniert VPC-Konnektivität](https://docs.aws.amazon.com/grafana/latest/userguide/AMG-configure-vpc.html#AMG-VPC-how-it-works) im *Amazon Managed Grafana-Benutzerhandbuch*.

1. Wählen Sie **Weiter** aus.

1. Wählen Sie auf der Seite **Einstellungen für verwaltete Serviceberechtigungen** die Option **Girokonto** aus, damit Amazon Managed Grafana automatisch Richtlinien und Berechtigungen für den Zugriff auf AWS Daten in Ihrem Konto erstellt.

1. Wählen Sie unter **Datenquellen** die Option aus **AWS IoT SiteWise**. Weitere Informationen finden Sie unter [Connect zu einer AWS IoT SiteWise Datenquelle](https://docs.aws.amazon.com/grafana/latest/userguide/using-iotsitewise-in-AMG.html) herstellen im *Amazon Managed Grafana-Benutzerhandbuch*.

1. (Optional) Wählen Sie unter **Benachrichtigungskanäle** **Amazon SNS** aus, damit Grafana-Benachrichtigungen über Amazon SNS gesendet werden können. Dadurch wird eine IAM-Richtlinie erstellt, die das Veröffentlichen von Themen in Amazon SNS ermöglicht, deren Namen mit Grafana beginnen. Sie müssen die Einrichtung des Benachrichtigungskanals später in Ihrer Grafana-Konsole im Workspace abschließen.

1. Bestätigen Sie die Workspace-Details und wählen Sie **Workspace erstellen**. Dieser Vorgang dauert ein paar Minuten.

1. Weisen Sie auf der Registerkarte **Authentifizierung** unter **AWS IAM Identity Center** Ihrem Workspace Benutzer oder Gruppen zu, indem Sie wie folgt vorgehen:

   1. Um dem Benutzer zuzuweisen, der die AWS IoT SiteWise Daten verwalten soll, wählen Sie **Neuen Benutzer oder neue Gruppe zuweisen**. Wählen **Sie dann in der Dropdownliste **Aktionen** die Option Zum Administrator** ernennen aus, um dem Benutzer Administratorrechte zu gewähren.
**Wichtig**  
Um den Grafana-Workspace zu verwalten, müssen Sie die `Admin` Rolle mindestens einem Benutzer zuweisen. Dieser Benutzer hat vollen Zugriff auf die Grafana-Workspace-Konsole.

Sie haben jetzt Ihren Grafana-Workspace eingerichtet und konfiguriert. Im nächsten Schritt können Sie eine Datenquelle hinzufügen AWS IoT SiteWise und mit der Erstellung von Visualisierungen für Ihre Windparkdaten beginnen. Von Ihrem Workspace aus können Sie Ihre Industriedaten in Echtzeit abfragen, visualisieren und analysieren. Weitere Informationen zu Amazon Managed Grafana-Workspaces finden Sie unter [Verwenden Sie Ihren Grafana-Workspace](https://docs.aws.amazon.com/grafana/latest/userguide/using-grafana-workspace.html) im *Amazon Managed Grafana-Benutzerhandbuch*.

## Schritt 2: Als Datenquelle hinzufügen AWS IoT SiteWise
<a name="add-iot-data-source"></a>

Um Ihnen bei der Visualisierung Ihrer Daten zu helfen, enthält Amazon Managed Grafana das AWS Data Sources-Plugin, das den Verbindungsprozess vereinfacht. AWS-Services Dieses Plugin ist in Ihrem Workspace vorinstalliert und bietet eine einheitliche Oberfläche für die Erkennung und Konfiguration von AWS Ressourcen als Datenquellen. Für die Visualisierung Ihres Windparks verwenden Sie dieses Plugin, um AWS IoT SiteWise eine Verbindung herzustellen. Weitere Informationen finden Sie unter [Connect zu einer AWS IoT SiteWise Datenquelle](https://docs.aws.amazon.com/grafana/latest/userguide/using-iotsitewise-in-AMG.html) herstellen im *Amazon Managed Grafana-Benutzerhandbuch*.

Bevor Sie mit der Abfrage Ihrer Windparkdaten beginnen können, benötigt das AWS Data Sources-Plugin die entsprechenden Berechtigungen für den Zugriff auf Ihre AWS IoT SiteWise Ressourcen. Diese Berechtigungen wurden automatisch konfiguriert, AWS IoT SiteWise als Sie im vorherigen Schritt eine Datenquelle ausgewählt haben. Weitere Informationen zu Plugin-Berechtigungen finden Sie unter [Erforderliche Berechtigungen](https://docs.aws.amazon.com/grafana/latest/userguide/AMG-configure-permissions.html) im *Amazon Managed Grafana-Benutzerhandbuch*.

**Um eine Verbindung AWS IoT SiteWise zu Ihrem Grafana-Workspace herzustellen**

1. Öffnen Sie die [Amazon Managed Grafana-Konsole](https://console.aws.amazon.com/grafana/). Wählen Sie auf Ihrer Workspace-Detailseite die URL aus, die unter **Grafana-Workspace-URL** angezeigt wird. Die Workspace-URL öffnet die Anmeldeseite der Grafana Workspace Console.

1. Wählen Sie **Mit AWS IAM Identity Center anmelden** und geben Sie Ihre Anmeldeinformationen ein. Diese Anmeldeinformationen funktionieren nur, wenn Sie auf die E-Mail von Amazon Managed Grafana geantwortet haben, in der Sie aufgefordert wurden, ein Passwort für IAM Identity Center zu erstellen.

1. Wählen Sie im linken Navigationsbereich **Apps**, dann **AWS Datenquellen** und dann die **AWS-Services**Registerkarte aus.

1. Wählen Sie unter **Jetzt installieren** aus **AWS IoT SiteWise**, um die neueste Version des AWS IoT SiteWise Plug-ins zu installieren.

1. Navigieren Sie zur Registerkarte **Datenquellen** und wählen Sie **IoT SiteWise** als Dienst aus.

1. Wählen Sie unter **Standardregion** die Region aus, aus der Sie Daten abrufen möchten, z. B. **USA Ost (Nord-Virginia)**.

1. Nachdem Sie die Parameter für das Plugin angegeben haben, wählen Sie **Datenquelle hinzufügen** aus.

1. Wählen Sie **Gehe zu Einstellungen**.

1. Wählen Sie unter **Verbindungsdetails** die Option **Speichern und testen** aus, um sicherzustellen, dass der Dienst funktioniert.

## Schritt 3: Erstellen Sie ein Dashboard, um Ihre Daten zu untersuchen und zu visualisieren
<a name="explore-your-data"></a>

Erstellen Sie in diesem Schritt ein Grafana-Dashboard, um die zuvor erstellten Demo-Windparkdaten zu visualisieren. Dashboards helfen Ihnen bei der Überwachung Ihrer Daten, indem sie mehrere Visualisierungen in einer einzigen Ansicht anzeigen. Mithilfe von Dashboards können Sie Kennzahlen verfolgen, Muster analysieren und Erkenntnisse aus Ihren Industriedaten gewinnen. Weitere Informationen finden Sie unter [Erstellen Sie Ihr erstes Dashboard](https://docs.aws.amazon.com/grafana/latest/userguide/getting-started-grafanaui.html) im *Amazon Managed Grafana-Benutzerhandbuch*.

**Um dein erstes Dashboard in Grafana zu erstellen**

1. Wählen Sie im linken Navigationsbereich **Dashboards** und dann **Dashboard erstellen aus, um mit der Erstellung Ihres ersten Dashboards** zu beginnen.

1. Wählen Sie **Visualisierung hinzufügen** aus. Dadurch wird der Panel-Editor geöffnet, in dem Sie Datenquellen, Abfragen und Visualisierungseinstellungen konfigurieren können.

1. Wählen Sie auf der Registerkarte **Abfrage** die AWS IoT SiteWise Datenquelle aus dem Dropdownmenü aus.

1. Wählen Sie unter **Abfragetyp** im Dropdownmenü die Option **Eigenschaftswertaggregate** abrufen aus, um aggregierte Werte für Asset-Eigenschaften im Zeitverlauf abzurufen.

1. Wählen Sie **Erkunden** aus, um die verfügbaren Vermögenswerte in Ihrer Hierarchie anzuzeigen. Wählen Sie auf der Registerkarte **Hierarchie** die Option **Demo Wind Farm Asset** und dann **Demo Turbine Asset 1** aus.

1. Wählen Sie unter **Eigenschaft** aus den verfügbaren Eigenschaften die Option **Durchschnittliche Leistung** aus. Wählen Sie **Abfragen ausführen** aus, um die Abfrage auszuführen, sodass Sie eine Vorschau der Ausgabe anzeigen können. Die Visualisierung wird aktualisiert und zeigt nun die durchschnittlichen Leistungsdaten für`Demo Turbine Asset 1`.

1. Geben Sie dem neuen Bereich im rechten Navigationsbereich einen Titel, z. **Turbine Demo 1 (Average Power)** B. Wählen Sie **Apply (Übernehmen)**, um die Änderungen zu speichern.
**Warnung**  
Wenn Sie Änderungen am Dashboard vornehmen, speichern Sie das Dashboard, bevor Sie die Seite aktualisieren oder die Seite verlassen. Andernfalls verlieren Sie Ihren Fortschritt.

1. Wählen Sie in der oberen rechten Ecke **Dashboard speichern** aus. Sie werden aufgefordert, einen Namen für Ihr Dashboard einzugeben, zum Beispiel. **SiteWise Wind Farm Demo Dashboard**

1. Wählen Sie **Speichern**.

Informationen zum Teilen von Dashboards finden Sie unter [Teilen von Dashboards und Panels](https://docs.aws.amazon.com/grafana/latest/userguide/v10-dash-sharing.html) im *Amazon Managed Grafana-Benutzerhandbuch*.

**Um ein weiteres Fenster zur Visualisierung der Windgeschwindigkeit hinzuzufügen**

1. Wählen Sie **Visualisierung hinzufügen** aus, um ein leeres Fenster zu öffnen.

1. Wählen Sie auf der Registerkarte **Abfrage** die AWS IoT SiteWise Datenquelle aus dem Dropdownmenü aus.

1. Wählen Sie unter **Abfragetyp** im Dropdownmenü die Option **Eigenschaftswert abrufen** aus und wählen Sie `Demo Wind Farm Asset` dann unter **Asset** die Option aus. `Demo Turbine Asset 1`

1. Wählen Sie unter **Eigenschaft** aus den verfügbaren Eigenschaften die Option **Windgeschwindigkeit** aus. Wählen Sie **Abfragen ausführen** aus, um die Änderungen zu aktualisieren.

1. Wählen Sie unter **Visualisierung** die Option **Messgerät** aus. Messgeräte eignen sich am besten zur Anzeige einzelner Echtzeitmetriken wie der Windgeschwindigkeit.

1. Geben Sie dem neuen Bereich im rechten Navigationsbereich einen Titel, z. B. **Turbine Demo 1 (Wind Speed)**

1. Wählen Sie in den Bedienfeldoptionen unter **Standardoptionen** die Option **Einheit** aus. Wählen Sie „**Geschwindigkeit**“ und anschließend „**meters/second (m/s)**“.

1. Wählen Sie **Apply (Übernehmen)**, um die Änderungen zu speichern.

   Die folgende Abbildung zeigt, wie Ihre Grafana-Dashboards aussehen könnten, wenn Sie diesen Schritt abschließen.  
![\[Beispiel-Dashboards, die mit den Demodaten des Windparks erstellt wurden.\]](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/images/updated-grafana.png)

## (optional) Schritt 4: Richten Sie Warnmeldungen ein, um die Leistung zu überwachen
<a name="set-up-alerts"></a>

Warnmeldungen weisen auf Statusänderungen hin, nachdem sie aufgetreten sind, um Leistungsprobleme mit Ihren Industrieanlagen zu identifizieren. Weitere Informationen finden Sie unter [Amazon Managed Grafana-Warnmeldungen](https://docs.aws.amazon.com/grafana/latest/userguide/alerts-overview.html) im *Amazon Managed Grafana-Benutzerhandbuch*.

**Um Benachrichtigungen in Grafana einzurichten**

1. Wählen Sie auf der Registerkarte **Regel** die `Turbine Demo 1 (Average Power)` Optionen **Alle bis auswerten** `5m` und **Für** bis `15m` aus. Diese Konfiguration bewertet den durchschnittlichen Stromverbrauch alle 5 Minuten und löst eine Warnung aus, wenn der Zustand länger als 15 Minuten andauert.

1. Wählen Sie unter **Bedingungen** die Option **LIEGT UNTER** UND geben Sie Watt ein**7,020**. Mit dieser Einstellung werden Sie benachrichtigt, wenn die durchschnittlichen Turbinenbedingungen länger als 5 Minuten unter 7.020 Watt fallen. Weitere Informationen zum Erstellen von Benachrichtigungen finden Sie unter [Felder für Warnmeldungsregeln](https://docs.aws.amazon.com/grafana/latest/userguide/old-create-alerts.html#old-alert-rule-fields) im *Amazon Managed Grafana-Benutzerhandbuch*.

Sie haben das Tutorial abgeschlossen. In diesem Verfahren haben Sie einen Grafana-Workspace erstellt und ihn für die Visualisierung von AWS IoT SiteWise Windparkdaten konfiguriert. Sie haben ein interaktives Dashboard mit mehreren Widget-Typen erstellt, darunter ein Zeitreihendiagramm für die durchschnittliche Leistung und ein Messgerät für die Windgeschwindigkeit. Außerdem richten Sie Warnmeldungen ein, um die Turbinenleistung zu überwachen, sodass Sie potenzielle Probleme erkennen können, bevor sie die Produktion stören. Sie können Ihr Dashboard weiter verbessern, indem Sie weitere Visualisierungen hinzufügen, zusätzliche Warnmeldungen erstellen oder andere AWS Datenquellen verbinden, um tiefere Einblicke in Ihre industriellen Abläufe zu erhalten.

## Schritt 5: Ressourcen nach dem Tutorial bereinigen
<a name="clean_up_resources"></a>

Nachdem Sie dieses Tutorial zur Datenvisualisierung mit Grafana abgeschlossen haben, sollten Sie Ihre Ressourcen bereinigen, um zusätzliche Kosten zu vermeiden.

**Um die Demo zu löschen AWS IoT SiteWise **

1. Navigieren Sie zur [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/).

1. Wählen Sie in der oberen rechten Ecke der Seite die Option Demo **löschen** aus.

1. Geben Sie in das Bestätigungsfeld **DELETE** ein, und wählen Sie dann **Delete (Löschen)**.

Weitere Informationen finden Sie unter [Löschen Sie die AWS IoT SiteWise Demo](getting-started-demo.md#delete-getting-started-demo).

Wenn Sie ein Amazon Managed Grafana löschen, werden auch alle Konfigurationsdaten für diesen Workspace gelöscht. Dazu gehören Dashboards, Datenquellenkonfiguration, Benachrichtigungen und Snapshots.

**Um einen Amazon Managed Grafana-Workspace zu löschen**

1.  Öffnen Sie die [Amazon Managed Grafana-Konsole](https://console.aws.amazon.com/grafana/).

1. Wählen Sie im linken Navigationsbereich das Menüsymbol.

1. Wählen Sie **Alle Workspaces**.

1. Wählen Sie den Namen des Workspace, den Sie löschen möchten.

1. Wählen Sie **Löschen** aus.

1. Um den Löschvorgang zu bestätigen, gib den Namen des Workspace ein und wähle **Löschen**.
**Anmerkung**  
Mit diesem Verfahren wird ein Workspace gelöscht. Andere Ressourcen dürfen nicht gelöscht werden. Beispielsweise werden IAM-Rollen, die vom Workspace verwendet wurden, nicht gelöscht (sie können jedoch entsperrt werden, wenn sie nicht mehr verwendet werden).

Weitere Informationen finden Sie unter [Löschen eines Amazon Managed Grafana-Workspace](https://docs.aws.amazon.com/grafana/latest/userguide/AMG-edit-delete-workspace.html) im *Amazon Managed Grafana-Benutzerhandbuch*.

## Weitere Ressourcen
<a name="additional-resources"></a>

Weitere Informationen zur Visualisierung von Daten finden Sie in den folgenden Ressourcen:
+ [Fehlerbehebung bei Amazon Managed Grafana-Identität und Zugriff](https://docs.aws.amazon.com/grafana/latest/userguide/security_iam_troubleshoot.html) im *Amazon Managed Grafana-Benutzerhandbuch*
+ [Bewährte Sicherheitsmethoden](https://docs.aws.amazon.com/grafana/latest/userguide/AMG-Security-Best-Practices.html) im *Amazon Managed Grafana-Benutzerhandbuch*
+ [Integrieren Sie AWS IoT SiteWise mit Grafana](grafana-integration.md)
+ [Verarbeiten und visualisieren Sie Daten mit SiteWise Edge- und Open-Source-ToolsVerarbeiten und visualisieren Sie Daten am Edge](open-source-edge-integrations.md)
+ [Benutzer, Teams und Berechtigungen](https://docs.aws.amazon.com/grafana/latest/userguide/Grafana-administration-authorization.html) im *Amazon Managed Grafana-Benutzerhandbuch*
+ [Amazon Managed Grafana-Berechtigungen und Richtlinien für AWS Datenquellen](https://docs.aws.amazon.com/grafana/latest/userguide/AMG-manage-permissions.html) im *Amazon Managed Grafana-Benutzerhandbuch*

# Visualisieren und teilen Sie Windparkdaten in SiteWise Monitor
<a name="monitor-wind-farm"></a>

In diesem Tutorial wird erklärt, wie Industriedaten über verwaltete Webanwendungen, sogenannte Portale, visualisiert und gemeinsam genutzt AWS IoT SiteWise Monitor werden können. Jedes *Portal* umfasst Projekte, sodass Sie flexibel wählen können, auf welche Daten innerhalb jedes Projekts zugegriffen werden kann. Geben Sie anschließend Personen in Ihrer Organisation an, die auf jedes Portal zugreifen können. Ihre Benutzer melden sich mit AWS IAM Identity Center Konten bei Portalen an, sodass Sie Ihren vorhandenen Identitätsspeicher oder einen von verwalteten Speicher verwenden können AWS.

Sie und Ihre Benutzer mit ausreichenden Berechtigungen können in jedem Projekt Dashboards erstellen, um Ihre industriellen Daten sinnvoll zu visualisieren. Anschließend können Ihre Benutzer diese Dashboards anzeigen, um schnell Einblicke in Ihre Daten zu erhalten und Ihren Betrieb zu überwachen. Sie können administrative oder schreibgeschützte Berechtigungen für jedes Projekt für jeden Benutzer in Ihrem Unternehmen konfigurieren. Weitere Informationen finden Sie unter [Überwachen Sie Daten mit AWS IoT SiteWise Monitor](monitor-data.md).

Im Laufe des Tutorials erweitern Sie die AWS IoT SiteWise Demo, indem Sie einen Beispieldatensatz für einen Windpark bereitstellen. Sie konfigurieren ein Portal in SiteWise Monitor, erstellen ein Projekt und Dashboards zur Visualisierung der Windparkdaten. Das Tutorial behandelt auch die Erstellung zusätzlicher Benutzer sowie die Zuweisung von Berechtigungen, um das Projekt und die zugehörigen Dashboards zu besitzen oder anzusehen.

**Anmerkung**  
Wenn Sie SiteWise Monitor verwenden, wird Ihnen pro Benutzer, der sich bei einem Portal anmeldet, eine Gebühr berechnet (pro Monat). In diesem Tutorial erstellen Sie drei Benutzer, aber Sie müssen sich nur mit einem Benutzer anmelden. Nachdem Sie dieses Tutorial abgeschlossen haben, fallen Gebühren für einen Benutzer an. Weitere Informationen finden Sie unter [AWS IoT SiteWise  – Preise](https://aws.amazon.com/iot-sitewise/pricing/).

**Topics**
+ [Voraussetzungen](#monitor-tutorial-prerequisites)
+ [Schritt 1: Erstellen Sie ein Portal in Monitor SiteWise](#monitor-tutorial-create-portal)
+ [Schritt 2: Melden Sie sich bei einem Portal an](#monitor-tutorial-sign-in-portal)
+ [Schritt 3: Erstellen Sie ein Windparkprojekt](#monitor-tutorial-create-project)
+ [Schritt 4: Erstellen Sie ein Dashboard zur Visualisierung von Windparkdaten](#monitor-tutorial-create-dashboard)
+ [Schritt 5: Erkunden Sie das Portal](#monitor-tutorial-explore-portal)
+ [Schritt 6: Bereinigen Sie die Ressourcen nach dem Tutorial](#monitor-tutorial-clean-up-resources)

## Voraussetzungen
<a name="monitor-tutorial-prerequisites"></a>

Zum Durcharbeiten dieses Tutorials ist Folgendes erforderlich:
+ Ein AWS-Konto. Falls Sie noch keines haben, beachten Sie die Informationen unter [Richten Sie ein Konto ein AWS](getting-started.md#set-up-aws-account).
+ Ein Entwicklungscomputer, auf demWindows, macOSLinux, oder ausgeführt wird, Unix um auf den zuzugreifen AWS-Managementkonsole. Weitere Informationen finden Sie unter [Was ist AWS-Managementkonsole?](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/what-is.html)
+ Ein AWS Identity and Access Management (IAM-) Benutzer mit Administratorrechten.
+ Eine laufende AWS IoT SiteWise Windpark-Demo. Wenn Sie die Demo einrichten, definiert sie Modelle und Anlagen AWS IoT SiteWise und streamt Daten an sie, um einen Windpark darzustellen. Weitere Informationen finden Sie unter [Benutze die AWS IoT SiteWise Demo](getting-started-demo.md).
+ Wenn Sie IAM Identity Center in Ihrem Konto aktiviert haben, melden Sie sich bei Ihrem AWS Organizations Verwaltungskonto an. Weitere Informationen zu finden Sie unter [Terminologie und Konzepte für AWS Organizations](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html). Wenn Sie IAM Identity Center nicht aktiviert haben, werden Sie es in diesem Tutorial aktivieren und Ihr Konto als Verwaltungskonto einrichten.

  Wenn Sie sich nicht bei Ihrem AWS Organizations Verwaltungskonto anmelden können, können Sie das Tutorial teilweise abschließen, sofern Sie einen IAM Identity Center-Benutzer in Ihrer Organisation haben. In diesem Fall können Sie das Portal und die Dashboards erstellen, aber Sie können keine neuen IAM Identity Center-Benutzer erstellen, um sie Projekten zuzuweisen.

## Schritt 1: Erstellen Sie ein Portal in Monitor SiteWise
<a name="monitor-tutorial-create-portal"></a>

In diesem Verfahren erstellen Sie ein Portal in AWS IoT SiteWise Monitor. Jedes *Portal* ist eine verwaltete Webanwendung, bei der Sie und Ihre Benutzer sich mit AWS IAM Identity Center Konten anmelden können. Mit IAM Identity Center können Sie den vorhandenen Identitätsspeicher Ihres Unternehmens verwenden oder einen eigenen erstellen, der von verwaltet wird AWS. Die Mitarbeiter Ihres Unternehmens können sich anmelden, ohne einen separaten AWS-Konten Account erstellen zu müssen.

**So erstellen Sie ein Portal**

1. Melden Sie sich bei der [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/) an.

1. Prüfen Sie, [AWS IoT SiteWise welche Endgeräte und Kontingente](https://docs.aws.amazon.com/general/latest/gr/iot-sitewise.html) unterstützt werden, und wechseln Sie bei AWS IoT SiteWise Bedarf zwischen den Regionen. Sie müssen die AWS IoT SiteWise Demo in derselben Region ausführen.

1. Wählen Sie im linken Navigationsbereich die Option **Portale** aus.

1. Wählen Sie **Create Portal (Portal erstellen)** aus.

1. Wenn Sie IAM Identity Center bereits aktiviert haben, fahren Sie mit Schritt 6 fort. Gehen Sie andernfalls wie folgt vor, um IAM Identity Center zu aktivieren:

   1. Geben Sie auf der Seite **Aktivieren AWS IAM Identity Center (SSO)** Ihre **E-Mail-Adresse**, Ihren **Vornamen** und **Nachnamen** ein, um einen IAM Identity Center-Benutzer für Sie als Portaladministrator zu erstellen. Verwenden Sie eine E-Mail-Adresse, auf die Sie zugreifen können, damit Sie eine E-Mail erhalten, mit der Sie ein Passwort für Ihren neuen IAM Identity Center-Benutzer festlegen können.

      In einem Portal erstellt der Portaladministrator Projekte und weist Benutzer Projekten zu. Sie können später weitere Benutzer erstellen.  
![\[Die Seite „Aktivieren AWS IAM Identity Center (SSO)“ des Prozesses „Portal erstellen“.\]](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/images/sitewise-enable-sso-console.png)

   1. Wählen Sie **Create user** (Benutzer erstellen) aus.

1. Führen Sie auf der Seite **Portalkonfiguration** die folgenden Schritte aus:

   1. Geben Sie einen Namen für Ihr Portal ein, z. B. **WindFarmPortal**.

   1. (Optional) Geben Sie eine Beschreibung für Ihr Portal ein. Wenn Sie über mehrere Portale verfügen, verwenden Sie aussagekräftige Beschreibungen, um den Überblick über die Inhalte der einzelnen Portale zu behalten.

   1. (Optional) Laden Sie ein Bild hoch, das im Portal angezeigt werden soll.

   1. Geben Sie eine E-Mail-Adresse ein, an die sich Portalbenutzer wenden können, wenn sie ein Problem mit dem Portal haben und Hilfe vom AWS Administrator Ihres Unternehmens benötigen, um das Problem zu lösen.

   1. Wählen Sie **Create Portal (Portal erstellen)** aus.

1. Auf der Seite **Administratoren einladen** können Sie dem Portal IAM Identity Center-Benutzer als Administratoren zuweisen. Portaladministratoren verwalten Berechtigungen und Projekte innerhalb eines Portals. Gehen Sie auf dieser Seite wie folgt vor:

   1. Wählen Sie einen Benutzer als Portaladministrator aus. Wenn Sie IAM Identity Center zu einem früheren Zeitpunkt in diesem Tutorial aktiviert haben, wählen Sie den Benutzer aus, den Sie erstellt haben.  
![\[Die Seite „Administratoren einladen“ des Prozesses „Portal erstellen“.\]](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/images/monitor-wind-farm/sitewise-invite-portal-administrators-console.png)

   1. (Optional) Wählen Sie **Send invite to selected users (Einladung an ausgewählte Benutzer senden)** aus. Ihr E-Mail-Client wird geöffnet und eine Einladung wird im Nachrichtentext angezeigt. Sie können die E-Mail anpassen, bevor Sie sie an die Portaladministratoren senden. Sie können die E-Mail-Nachricht auch später an Ihre Portaladministratoren senden. Wenn Sie SiteWise Monitor zum ersten Mal ausprobieren und der Portaladministrator sein werden, müssen Sie sich keine E-Mail senden.

   1. Wählen Sie **Weiter** aus.

1. Auf der Seite **„Benutzer zuweisen**“ können Sie dem Portal IAM Identity Center-Benutzer zuweisen. Portaladministratoren können diese Benutzer später als Projekteigentümer oder -betrachter zuweisen. Projekteigentümer können Dashboards in Projekten erstellen. Projektbetrachter haben nur Lesezugriff auf die ihnen zugewiesenen Projekte. Auf dieser Seite können Sie IAM Identity Center-Benutzer erstellen, die Sie dem Portal hinzufügen möchten.
**Anmerkung**  
Wenn Sie nicht mit Ihrem AWS Organizations Verwaltungskonto angemeldet sind, können Sie keine IAM Identity Center-Benutzer erstellen. Wählen Sie **Benutzer zuweisen** aus, um das Portal ohne Portalbenutzer zu erstellen, und überspringen Sie dann diesen Schritt.

   Gehen Sie auf dieser Seite wie folgt vor:

   1. Führen Sie die folgenden Schritte zweimal aus, um zwei IAM Identity Center-Benutzer zu erstellen:

      1. Wählen Sie **Benutzer erstellen**, um ein Dialogfeld zu öffnen, in dem Sie Details für den neuen Benutzer eingeben können.

      1. Geben Sie eine **E-Mail-Adresse**, einen **Vornamen** und einen **Nachnamen** für den neuen Benutzer ein. IAM Identity Center sendet dem Benutzer eine E-Mail, damit er sein Passwort einrichten kann. Wenn Sie sich als diese Benutzer beim Portal anmelden möchten, wählen Sie eine E-Mail-Adresse aus, auf die Sie zugreifen können. Jede E-Mail-Adresse muss eindeutig sein. Ihre Benutzer melden sich mit ihrer E-Mail-Adresse als Benutzernamen beim Portal an.  
![\[Die Seite „Portaldetails“ mit Hervorhebung von „Benutzer zuweisen“.\]](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/images/sso-widget-create-user-console.png)

      1. Wählen Sie **Create user** (Benutzer erstellen) aus.

   1. Wählen Sie die beiden IAM Identity Center-Benutzer aus, die Sie im vorherigen Schritt erstellt haben.  
![\[Die Seite „Benutzer zuweisen“, auf der die neuen IAM Identity Center-Benutzer hervorgehoben sind.\]](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/images/monitor-wind-farm/sitewise-choose-users-to-assign-console.png)

   1. Wählen Sie **Benutzer zuweisen**, um diese Benutzer zum Portal hinzuzufügen.

   Die Seite „Portale“ wird geöffnet, wobei das neue Portal aufgelistet ist.

## Schritt 2: Melden Sie sich bei einem Portal an
<a name="monitor-tutorial-sign-in-portal"></a>

In diesem Verfahren melden Sie sich mit dem AWS IAM Identity Center Benutzer, den Sie dem Portal hinzugefügt haben, bei Ihrem neuen Portal an.

**So melden Sie sich bei einem Portal an**

1. Wählen Sie auf der Seite **Portale** den **Link** Ihres neuen Portals aus, um das Portal in einer neuen Registerkarte zu öffnen.  
![\[Die Seite „Portale“ mit dem hervorgehobenen Link des Windparkportals.\]](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/images/monitor-wind-farm/sitewise-choose-portal-link-console.png)

1. Wenn Sie zu Beginn des Tutorials Ihren ersten IAM Identity Center-Benutzer erstellt haben, gehen Sie wie folgt vor, um ein Passwort für Ihren Benutzer zu erstellen:

   1. Überprüfen Sie Ihre E-Mail nach der Betreffzeile **Invitation to join AWS IAM Identity Center**.

   1. Öffnen Sie diese Einladungs-E-Mail und wählen Sie **Accept invitation** aus.

   1. Legen Sie im neuen Fenster ein Passwort für Ihren IAM Identity Center-Benutzer fest.

   Wenn Sie sich später als zweiter und dritter IAM Identity Center-Benutzer, den Sie zuvor erstellt haben, am Portal anmelden möchten, können Sie auch diese Schritte ausführen, um Passwörter für diese Benutzer festzulegen.
**Anmerkung**  
Wenn Sie keine E-Mail erhalten haben, können Sie in der IAM Identity Center-Konsole ein Passwort für Ihren Benutzer generieren. *Weitere Informationen finden Sie im Benutzerhandbuch unter [Zurücksetzen des IAM Identity Center-Benutzerkennworts für einen Endbenutzer](https://docs.aws.amazon.com/singlesignon/latest/userguide/reset-password-for-user.html).AWS IAM Identity Center *

1. Geben Sie Ihr IAM Identity Center ein und. **Username**Password**** Wenn Sie Ihren IAM Identity Center-Benutzer zu einem früheren Zeitpunkt in diesem Tutorial erstellt haben, **Username**ist dies die E-Mail-Adresse des Portal-Administratorbenutzers, den Sie erstellt haben.

   Alle Portalbenutzer, einschließlich des Portaladministrators, müssen sich mit ihren IAM Identity Center-Benutzeranmeldedaten anmelden. Diese Anmeldeinformationen sind in der Regel nicht mit den Anmeldeinformationen identisch, mit denen Sie sich bei der AWS-Managementkonsole anmelden.  
![\[Die Portal-Anmeldeseite.\]](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/images/monitor-wind-farm/portal-sign-in-console.png)

1. Wählen Sie **Sign in**.

   Ihr Portal wird geöffnet.

## Schritt 3: Erstellen Sie ein Windparkprojekt
<a name="monitor-tutorial-create-project"></a>

In diesem Verfahren erstellen Sie ein Projekt in Ihrem Portal. *Projekte* sind Ressourcen, die eine Reihe von Berechtigungen, Ressourcen und Dashboards definieren, die Sie konfigurieren können, um Asset-Daten in diesem Projekt zu visualisieren. Mit Projekten definieren Sie, wer Zugriff auf welche Teilmengen Ihrer Operation hat und wie die Daten dieser Teilmengen visualisiert werden. Sie können Portalbenutzer als Eigentümer oder Betrachter für jedes Projekt zuweisen. Projekteigentümer können Dashboards erstellen, um Daten zu visualisieren und das Projekt mit anderen Benutzern zu teilen. Projektbetrachter können Dashboards anzeigen, sie aber nicht bearbeiten. Weitere Informationen zu Rollen in SiteWise Monitor finden Sie unter[SiteWise Rollen überwachen](monitor-data.md#monitor-roles).

**So erstellen Sie ein Windparkprojekt**

1. Wählen Sie im linken Navigationsbereich Ihres Portals die Registerkarte **Assets** aus. Auf der Seite **Assets** können Sie alle im Portal verfügbaren Assets erkunden und Assets zu Projekten hinzufügen.

1. Wählen Sie im Komponentenbrowser die Option **Demo Wind Farm Asset** aus. Wenn Sie ein Asset auswählen, können Sie die aktuellen und historischen Daten dieses Assets untersuchen. Sie können auch drückenShift, um mehrere Vermögenswerte auszuwählen und deren Daten zu vergleichen side-by-side.

1. Wählen **Sie oben links „Asset zum Projekt hinzufügen**“. Projekte enthalten Dashboards, die Ihre Portalbenutzer anzeigen können, um Ihre Daten zu erkunden. Jedes Projekt hat Zugriff auf eine Teilmenge Ihrer Ressourcen in AWS IoT SiteWise. Wenn Sie einem Projekt eine Komponente hinzufügen, können alle Benutzer mit Zugriff auf dieses Projekt auch auf Daten für diese Komponente und ihre untergeordneten Elemente zugreifen.  
![\[Die Seite „Anlagen“, auf der das Demo-Windpark-Asset und „Anlage zum Projekt hinzufügen“ hervorgehoben sind.\]](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/images/monitor-wind-farm/portal-add-asset-project-console.png)

1. Wählen **Sie im Dialogfeld „Objekt zum Projekt hinzufügen**“ die Option „**Neues Projekt erstellen**“ und anschließend „**Weiter**“.  
![\[Das Dialogfeld „Objekt zum Projekt hinzufügen“, in dem „Neues Projekt erstellen“ hervorgehoben ist.\]](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/images/monitor-wind-farm/portal-choose-new-project-console.png)

1. Geben **Sie im Dialogfeld Neues Projekt erstellen** einen **Projektnamen** und eine **Projektbeschreibung** für Ihr Projekt ein und wählen Sie dann **Asset zum Projekt hinzufügen**.  
![\[Das Dialogfeld „Neues Projekt erstellen“.\]](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/images/monitor-wind-farm/portal-create-new-project-console.png)

   Die Seite Ihres neuen Projekts wird geöffnet.

1. Auf der Projektseite können Sie Portalbenutzer als Eigentümer oder Betrachter dieses Projekts hinzufügen.
**Anmerkung**  
Wenn Sie nicht bei Ihrem AWS Organizations Verwaltungskonto angemeldet sind, haben Sie möglicherweise keine Portalbenutzer, die Sie diesem Projekt zuweisen können. Sie können diesen Schritt also überspringen.

   Gehen Sie auf dieser Seite wie folgt vor:

   1. Wählen Sie unter **Projektinhaber** die Option **Eigentümer hinzufügen** oder **Benutzer bearbeiten** aus.  
![\[Die Seite „Projektdetails“ mit Hervorhebung von „Benutzer zuweisen“ und „Benutzer bearbeiten“.\]](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/images/project-add-owners-console.png)

   1. Wählen Sie den Benutzer, der als Projekteigentümer hinzugefügt werden soll (z. B. **Mary Major**), und dann das Symbol **>>** aus.  
![\[Das Dialogfeld „Projekteigentümer“, in dem ein Benutzer hervorgehoben ist.\]](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/images/monitor-wind-farm/project-choose-owner-console.png)

   1. Wählen Sie **Speichern**.

      Ihr IAM Identity Center-Benutzer **Mary Major**kann sich bei diesem Portal anmelden, um die Dashboards in diesem Projekt zu bearbeiten und dieses Projekt mit anderen Benutzern in diesem Portal zu teilen.

   1. Wählen Sie unter **Projekt-Viewer** die Option **Zuschauer hinzufügen oder Benutzer** **bearbeiten** aus.

   1. Wählen Sie den Benutzer aus, der als Projektbetrachter hinzugefügt werden soll (z. B. **Mateo Jackson**), und wählen Sie dann das Symbol **>>**.

   1. Wählen Sie **Speichern**.

      Ihr IAM Identity Center-Benutzer **Mateo Jackson**kann sich bei diesem Portal anmelden, um die Dashboards im Windparkprojekt anzusehen, aber nicht zu bearbeiten.

## Schritt 4: Erstellen Sie ein Dashboard zur Visualisierung von Windparkdaten
<a name="monitor-tutorial-create-dashboard"></a>

In diesem Verfahren erstellen Sie Dashboards, um die Demo-Windparkdaten zu visualisieren. Dashboards enthalten anpassbare Visualisierungen der Komponentendaten Ihres Projekts. Jede Visualisierung kann einen anderen Typ haben, z. B. ein Liniendiagramm, ein Balkendiagramm oder eine KPI-Anzeige (Key Performance Indicator). Sie können den Visualisierungstyp auswählen, der für Ihre Daten am besten geeignet ist. Projekteigentümer können Dashboards bearbeiten, wohingegen Projektbetrachter nur Dashboards anzeigen können, um Einblicke zu gewinnen.

**So erstellen Sie ein Dashboard mit Visualisierungen**

1. Wählen Sie auf der Seite Ihres neuen Projekts die Option **Dashboard erstellen aus, um ein Dashboard** zu erstellen und dessen Bearbeitungsseite zu öffnen.

   Auf der Bearbeitungsseite eines Dashboards können Sie Komponenteneigenschaften aus der Komponentenhierarchie in das Dashboard ziehen, um Visualisierungen zu erstellen. Anschließend können Sie Titel, Legendentitel, Typ, Größe und Position jeder Visualisierung im Dashboard bearbeiten.

1. Geben Sie einen Namen für Ihr Dashboard ein.  
![\[Die Bearbeitungsseite „Dashboard“ mit dem hervorgehobenen Dashboard-Namen.\]](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/images/monitor-wind-farm/dashboard-edit-console.png)

1. Ziehen Sie **Total Average Power** von der **Demo Wind Farm Asset** in das Dashboard, um eine Visualisierung zu erstellen.  
![\[Die Bearbeitungsseite „Dashboard“ mit der Eigenschaft „Durchschnittliche Gesamtleistung“, auf der eine Anlageneigenschaft auf das Dashboard gezogen wird.\]](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/images/monitor-wind-farm/dashboard-add-total-power-console.png)

1. Wählen **Demo Turbine Asset 1**Sie aus, ob die Eigenschaften für diese Anlage angezeigt werden sollen, und ziehen Sie sie dann **Wind Speed**auf das Dashboard, um eine Visualisierung für die Windgeschwindigkeit zu erstellen.  
![\[Die Bearbeitungsseite „Dashboard“ mit der hervorgehobenen Eigenschaft „Windgeschwindigkeit“ einer Windkraftanlage.\]](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/images/monitor-wind-farm/dashboard-add-wind-speed-console.png)

1. Fügen Sie **Wind Speed** der neuen Visualisierung der Windgeschwindigkeit für jede **Demo Turbine Asset 2**, **3** und **4** (in dieser Reihenfolge) hinzu.

   Ihre **Wind Speed**-Visualisierung sollte dem folgenden Screenshot ähnlich aussehen.  
![\[Eine „Windgeschwindigkeit“-Visualisierung, die die Windgeschwindigkeiten von vier Demo-Windkraftanlagen-Komponenten enthält.\]](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/images/monitor-wind-farm/dashboard-add-all-wind-speeds-console.png)

1. Wiederholen Sie die Schritte 4 und 5 für die **Torque (KiloNewton Meter)**Eigenschaften der Windturbinen, um eine Visualisierung für das Drehmoment der Windturbine zu erstellen.

1. Wählen Sie das Symbol für den Visualisierungstyp für die **Torque (KiloNewton Meter)**-Visualisierung und dann das Balkendiagrammsymbol aus.  
![\[Eine Visualisierung des Typs „Drehmoment (KiloNewton Meter)“ mit Symbolen für den Visualisierungstyp und das Balkendiagramm.\]](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/images/monitor-wind-farm/dashboard-change-torque-visualization-type-console.png)

1. Wiederholen Sie die Schritte 4 und 5 für die **Wind Direction**Eigenschaften der Windturbinen, um eine Visualisierung der Windrichtung zu erstellen.

1. Wählen Sie das Symbol für den Visualisierungstyp für die **Wind Direction**-Visualisierung und dann das KPI-Diagrammsymbol (**30%**) aus.  
![\[Eine „Windrichtung“-Visualisierung mit den hervorgehobenen Symbolen des Visualisierungstyps und des KPI-Diagramms.\]](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/images/monitor-wind-farm/dashboard-change-wind-direction-visualization-type-console.png)

1. (Optional) Nehmen Sie nach Bedarf weitere Änderungen an Titel, Legendentitel, Typ, Größe und Position der Visualisierung vor.

1. Wählen Sie oben rechts **Dashboard speichern**, um Ihr Dashboard zu speichern.

   Ihr Dashboard sollte dem folgenden Screenshot ähnlich aussehen.  
![\[Ein komplettes Windpark-Dashboard.\]](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/images/monitor-wind-farm/wind-farm-dashboard-console.png)

1. (Optional) Erstellen Sie für jede Windkraftanlagen-Komponente ein zusätzliches Dashboard.

   Als bewährte Methode empfehlen wir, für jede Komponente ein Dashboard zu erstellen, damit Ihre Projektbetrachter alle Probleme mit den einzelnen Komponenten untersuchen können. Sie können jeder Visualisierung nur bis zu 5 Komponenten hinzufügen. Daher müssen Sie in vielen Szenarien mehrere Dashboards für Ihre hierarchischen Komponenten erstellen.

   Ein Dashboard für eine Demo-Windkraftanlage könnte ähnlich dem folgenden Screenshot aussehen.  
![\[Ein komplettes Dashboard für Windkraftanlagen.\]](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/images/monitor-wind-farm/wind-turbine-dashboard-console.png)

1. (Optional) Ändern Sie die Zeitachse oder wählen Sie Datenpunkte in einer Visualisierung aus, um die Daten im Dashboard zu erkunden. Weitere Informationen finden Sie im *AWS IoT SiteWise Monitor Anwendungsleitfaden* unter [Dashboards anzeigen](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/view-dashboards.html).

## Schritt 5: Erkunden Sie das Portal
<a name="monitor-tutorial-explore-portal"></a>

In diesem Verfahren können Sie das Portal als Benutzer mit weniger Berechtigungen als ein AWS IoT SiteWise Portaladministrator erkunden.

**Um das Portal zu erkunden und das Tutorial zu beenden**
+ (Optional) Wenn Sie dem Projekt weitere Benutzer als Eigentümer oder Betrachter hinzugefügt haben, können Sie sich als diese Benutzer beim Portal anmelden. Auf diese Weise können Sie das Portal als Benutzer mit weniger Berechtigungen als ein Portaladministrator erkunden.
**Wichtig**  
Ihnen wird für jeden Benutzer, der sich bei einem Portal anmeldet, eine Gebühr berechnet. Weitere Informationen finden Sie unter [AWS IoT SiteWise  – Preise](https://aws.amazon.com/iot-sitewise/pricing/).

  Gehen Sie wie folgt vor, um das Portal als andere Benutzer zu erkunden:

  1. Wählen Sie unten links im Portal **Abmelden aus**, um die Webanwendung zu beenden.

  1. **Wählen Sie oben rechts im IAM Identity Center-Anwendungsportal Abmelden, um sich von Ihrem IAM Identity Center-Benutzer abzumelden.**

  1. Melden Sie sich beim Portal als der IAM Identity Center-Benutzer an, den Sie als Projektinhaber oder Projektbetrachter zugewiesen haben. Weitere Informationen finden Sie unter [Schritt 2: Melden Sie sich bei einem Portal an](#monitor-tutorial-sign-in-portal).

 Sie haben das Tutorial abgeschlossen. Wenn Sie mit der Erkundung Ihres Demo-Windparks in SiteWise Monitor fertig sind, folgen Sie dem nächsten Verfahren, um Ihre Ressourcen zu bereinigen. 

## Schritt 6: Bereinigen Sie die Ressourcen nach dem Tutorial
<a name="monitor-tutorial-clean-up-resources"></a>

Nachdem Sie das Tutorial abgeschlossen haben, können Sie Ihre Ressourcen bereinigen. Es fallen keine Gebühren für AWS IoT SiteWise an, wenn sich Benutzer nicht bei Ihrem Portal anmelden, aber Sie können Ihr Portal und Ihre AWS-IAM-Identity-Center-Verzeichnis -Benutzer löschen. Ihre Demo-Windparkkomponenten werden am Ende der Dauer gelöscht, die Sie beim Erstellen der Demo gewählt haben, oder Sie können die Demo manuell löschen. Weitere Informationen finden Sie unter [Löschen Sie die AWS IoT SiteWise Demo](getting-started-demo.md#delete-getting-started-demo).

Gehen Sie wie folgt vor, um Ihre Portal- und IAM Identity Center-Benutzer zu löschen.

**So löschen Sie ein Portal**

1. Navigieren Sie zur [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/).

1. Wählen Sie im linken Navigationsbereich die Option **Portale** aus.

1. Wählen Sie Ihr Portal **WindFarmPortal**und anschließend **Löschen** aus.

   Wenn Sie ein Portal oder ein Projekt löschen, sind die Komponenten, die gelöschten Projekten zugeordnet sind, nicht betroffen.  
![\[Die Seite „Portale“ mit Hervorhebung des Windparkportals und „Löschen“.\]](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/images/monitor-wind-farm/sitewise-choose-delete-portal-console.png)

1. Wählen **Sie im Dialogfeld Portal löschen** die Option **Administratoren und Benutzer entfernen** aus.  
![\[Das Dialogfeld „Portal löschen“, in dem „Administratoren und Benutzer entfernen“ hervorgehoben ist.\]](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/images/sitewise-delete-portal-remove-users-console.png)

1. Geben Sie **delete** ein, um das Löschen zu bestätigen, und wählen Sie dann **Löschen**.  
![\[Das Dialogfeld „Portal löschen“, in dem „Löschen“ hervorgehoben ist.\]](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/images/sitewise-delete-portal-confirm-delete-console.png)

**Um IAM Identity Center-Benutzer zu löschen**

1. Navigieren Sie zur [IAM Identity Center-Konsole](https://console.aws.amazon.com/singlesignon).

1. Wählen Sie im linken Navigationsbereich **Benutzer** aus.

1. Aktivieren Sie das Kontrollkästchen für jeden zu löschenden Benutzer und wählen Sie **Benutzer löschen** aus.  
![\[Die IAM Identity Center-Seite „Benutzer“, auf der „Benutzer löschen“ hervorgehoben ist.\]](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/images/monitor-wind-farm/sso-choose-delete-users-console.png)

1. Geben ****DELETE**Sie im Dialogfeld „Benutzer löschen**“ den Text ein und wählen Sie dann **Benutzer löschen** aus.  
![\[IAM Identity Center-Dialogfeld „Benutzer löschen“.\]](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/images/monitor-wind-farm/sso-delete-users-console.png)

# Aktualisierungen von Immobilienwerten in Amazon DynamoDB veröffentlichen
<a name="publish-to-amazon-dynamodb"></a>

In diesem Tutorial wird eine bequeme Methode zum Speichern Ihrer Daten mithilfe von [Amazon DynamoDB](https://aws.amazon.com/dynamodb/) vorgestellt, sodass Sie einfacher auf historische Asset-Daten zugreifen können, ohne die API wiederholt abfragen zu müssen. AWS IoT SiteWise Nachdem Sie dieses Tutorial abgeschlossen haben, können Sie benutzerdefinierte Software erstellen, die Ihre Anlagendaten nutzt, z. B. eine Live-Karte der Windgeschwindigkeit und -richtung in einem gesamten Windpark. Wenn Sie Ihre Daten überwachen und visualisieren möchten, ohne eine benutzerdefinierte Softwarelösung zu implementieren, finden Sie weitere Informationen unter[Überwachen Sie Daten mit AWS IoT SiteWise Monitor](monitor-data.md).

In diesem Tutorial bauen Sie auf der AWS IoT SiteWise Demo auf, die einen Beispieldatensatz für einen Windpark enthält. Sie konfigurieren Eigenschaftswertaktualisierungen aus der Windpark-Demo, um Daten über AWS IoT Kernregeln an eine von Ihnen DynamoDB DynamoDB-Tabelle zu senden. Wenn Sie Eigenschaftswertaktualisierungen aktivieren, AWS IoT SiteWise sendet Ihre Daten AWS IoT Core in MQTT-Nachrichten an. Definieren Sie dann AWS IoT Core-Regeln, die je nach Inhalt dieser Nachrichten Aktionen ausführen, z. B. die DynamoDB-Aktion. Weitere Informationen finden Sie unter [Interagiere mit anderen AWS Diensten](interact-with-other-services.md).

**Topics**
+ [Voraussetzungen](#dynamodb-tutorial-prerequisites)
+ [Schritt 1: Konfigurieren Sie die Konfiguration AWS IoT SiteWise , um Aktualisierungen von Eigenschaftswerten zu veröffentlichen](#dynamodb-tutorial-enable-value-notifications)
+ [Schritt 2: Erstellen Sie eine Regel in Core AWS IoT](#dynamodb-tutorial-create-iot-rule)
+ [Schritt 3: Konfiguration der DynamoDB-Regelaktion](#dynamodb-tutorial-configure-rule-action)
+ [Schritt 4: Erkunden Sie Daten in DynamoDB](#dynamodb-tutorial-explore-dynamodb-data)
+ [Bereinigen von Ressourcen](#dynamodb-tutorial-clean-up-resources)
+ [Weitere Ressourcen](#dynamodb-tutorial-additional-resources)

## Voraussetzungen
<a name="dynamodb-tutorial-prerequisites"></a>

Zum Durcharbeiten dieses Tutorials ist Folgendes erforderlich:
+ Ein. AWS-Konto Falls Sie noch keines haben, beachten Sie die Informationen unter [Richten Sie ein Konto ein AWS](getting-started.md#set-up-aws-account).
+ Ein Entwicklungscomputer, auf dem Windows, macOS, Linux oder Unix ausgeführt wird, um auf die zuzugreifen AWS-Managementkonsole. Weitere Informationen finden Sie unter [Was ist der AWS-Managementkonsole?](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/what-is.html)
+ Ein AWS Identity and Access Management (IAM-) Benutzer mit Administratorrechten. Detaillierte Anweisungen finden Sie unter [Wie AWS IoT SiteWise funktioniert mit IAM](security_iam_service-with-iam.md).
+ Eine laufende AWS IoT SiteWise Demo. Weitere Informationen finden Sie unter [Benutze die AWS IoT SiteWise Demo](getting-started-demo.md).

**Anmerkung**  
Dieses Tutorial erfordert die Verwendung von Ressourcen, die in der erstellt wurden[Benutze die AWS IoT SiteWise Demo](getting-started-demo.md). Sie müssen es abschließen, bevor Sie mit diesem Tutorial fortfahren können.

**Wichtig**  
Behalten Sie alle Demo-Ressourcen, bis Sie dieses Tutorial abgeschlossen haben. Das Löschen von Komponenten kann die Funktionalität der Demo beeinträchtigen und Ihre Fähigkeit, das Tutorial abzuschließen, beeinträchtigen.

## Schritt 1: Konfigurieren Sie die Konfiguration AWS IoT SiteWise , um Aktualisierungen von Eigenschaftswerten zu veröffentlichen
<a name="dynamodb-tutorial-enable-value-notifications"></a>

In diesem Verfahren aktivieren Sie Benachrichtigungen über Eigenschaftswerte für die Eigenschaften **Wind Speed** Ihrer Demo-Turbinenkomponenten. Nachdem Sie Benachrichtigungen über Eigenschaftswerte aktiviert haben, AWS IoT SiteWise veröffentlicht Sie jede Wertaktualisierung in einer MQTT-Nachricht in AWS IoT Core.

**So aktivieren Sie Benachrichtigungen über Eigenschaftswerte für Komponenteneigenschaften:**

1. Melden Sie sich bei der [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/) an.

1. Überprüfen Sie die [AWS IoT SiteWise Endpunkte und Kontingente](https://docs.aws.amazon.com/general/latest/gr/iot-sitewise.html), auf denen dies unterstützt AWS IoT SiteWise wird, und wechseln Sie AWS gegebenenfalls zwischen den Regionen. Wechseln Sie zu einer Region, in der Sie die AWS IoT SiteWise Demo ausführen.

1. Klicken Sie im linken Navigationsbereich auf **Assets (Komponenten)**.

1. Wählen Sie den Pfeil neben **Demo Wind Farm Asset** aus, um die Hierarchie der Windparkkomponente zu erweitern.

1. Wählen Sie eine Demoturbine und **Edit (Bearbeiten)** aus.

1. Wählen Sie **Measurements (Messungen)**.

1. Aktualisieren Sie den **MQTT-Benachrichtigungsstatus** der **Wind Speed**Immobilie auf **AKTIV**.

1. Wählen Sie unten auf der Seite die Option **Save** aus.

1. Wiederholen Sie die Schritte 5 bis 7 für jede Demo-Turbinenkomponente.

1. Wählen Sie eine Demoturbine aus (z. B. **Demo Turbine Asset 1**).

1. Wählen Sie **Measurements (Messungen)**.

1. Wählen Sie das Kopiersymbol neben der Eigenschaft **Wind Speed** aus, um das Benachrichtigungsthema in die Zwischenablage zu kopieren. Speichern Sie das Benachrichtigungsthema zur späteren zu verwendende Verwendung in diesem Tutorial. Sie müssen nur das Benachrichtigungsthema einer Turbine aufzeichnen.

   Das Benachrichtigungsthema sollte wie im folgenden Beispiel aussehen.

   ```
   $aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE
   ```

## Schritt 2: Erstellen Sie eine Regel in Core AWS IoT
<a name="dynamodb-tutorial-create-iot-rule"></a>

In diesem Schritt erstellen Sie eine Regel in AWS IoT Core, die die Benachrichtigungen über den Eigenschaftswert analysiert und Daten in eine Amazon DynamoDB-Tabelle einfügt. AWS IoT Kernregeln analysieren MQTT-Nachrichten und führen Aktionen aus, die auf dem Inhalt und dem Thema jeder Nachricht basieren. Anschließend erstellen Sie eine Regel mit einer DynamoDB-Aktion, um Daten in eine DynamoDB-Tabelle einzufügen, die Sie im Rahmen dieses Tutorials erstellen.

**So erstellen Sie eine Regel mit einer DynamoDB-Aktion**

1. Navigieren Sie zur [AWS IoT -Konsole](https://console.aws.amazon.com/iot/).

1. **Wählen Sie im linken Navigationsbereich **Message Routing** und dann Rules aus.**

1. Wählen Sie **Regel erstellen** aus.

1. **Geben Sie unter Regeleigenschaften angeben** einen Namen und eine Beschreibung für die Regel ein.

1. Suchen Sie das Benachrichtigungsthema, das Sie zuvor in diesem Tutorial gespeichert haben.

   ```
   $aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE
   ```

   Ersetzen Sie die Asset-ID (die ID danach`assets/`) im Thema durch eine`+`. Dadurch wird die Windgeschwindigkeit-Eigenschaft für alle Demo-Windturbinenanlagen ausgewählt. Der `+`-Themenfilter akzeptiert alle Knoten einer einzelnen Ebene in einem Thema. Ihr Thema sollte wie das folgende Beispiel aussehen.

   ```
   $aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/+/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE
   ```

1. Geben Sie die folgende Regelabfrageanweisung ein. Ersetzen Sie das Thema im `FROM`-Abschnitt durch Ihr Benachrichtigungsthema.

   ```
   SELECT
     payload.assetId AS asset,
     (SELECT VALUE (value.doubleValue) FROM payload.values) AS windspeed,
     timestamp() AS timestamp
   FROM
     '$aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/+/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE' 
   WHERE
     type = 'PropertyValueUpdate'
   ```

1. Navigieren Sie unter **Regelaktionen** zu **Aktion 1.**

1. **Wählen Sie auf der Seite Aktion auswählen** die Option **Dynamo DBv2** aus. Dadurch wird die Nachricht in mehrere Spalten einer DynamoDB-Tabelle aufgeteilt

1. Wählen Sie unter **Tabellenname** die Option Neue Tabelle **erstellen** aus. Sie erstellen eine Amazon DynamoDB-Tabelle, um Windgeschwindigkeitsdaten aus der Regelaktion zu erhalten.

1. Geben Sie in der [DynamoDB-Konsole](https://console.aws.amazon.com/dynamodb/) unter **Tabellenname** einen Namen für Ihre Tabelle ein.

1. Gehen Sie für den **Partitionsschlüssel** wie folgt vor:

   1. Geben Sie „**timestamp**“ als Partitionsschlüssel ein.

   1. Wählen Sie den Typ **Number (Nummer)** aus.

   1. Aktivieren Sie das Kontrollkästchen **Add sort key (Sortierschlüssel hinzufügen)**.

   1. Geben Sie **asset** als Sortierschlüssel ein, und belassen Sie den Standardsortierschlüsseltyp auf **String (Zeichenfolge)**.

1. Wählen Sie **Create table** (Tabelle erstellen) aus.

1. Kehren Sie mit der Seite **Configure action (Aktion konfigurieren)** zur Registerkarte zurück.

1. Aktualisieren Sie auf der **Aktionsseite „Regel anhängen**“ die Liste mit den **Tabellennamen** und wählen Sie Ihre neue DynamoDB-Tabelle aus, die Sie im vorherigen Schritt erstellt haben.

## Schritt 3: Konfiguration der DynamoDB-Regelaktion
<a name="dynamodb-tutorial-configure-rule-action"></a>

In diesem Schritt konfigurieren Sie die Amazon DynamoDB DynamoDB-Regelaktion, um Daten aus Eigenschaftswertaktualisierungen in Ihre neue DynamoDB-Tabelle einzufügen.

**So konfigurieren Sie die DynamoDB-Regelaktion**

1. Wählen Sie **Rolle erstellen** aus, um eine IAM-Rolle zu erstellen, die AWS IoT Core-Zugriff zur Ausführung der Regelaktion gewährt.

1. Geben Sie einen Rollennamen ein, zum Beispiel. `WindSpeedDataRole` Wählen Sie **Rolle erstellen** aus.

1. Wählen Sie **Weiter** aus.

1. Wählen Sie unten auf der Seite **Erstellen** aus, um die Erstellung der Regel abzuschließen.

   Ihre Demo-Asset-Daten sollten nun in Ihrer DynamoDB-Tabelle erscheinen.

## Schritt 4: Erkunden Sie Daten in DynamoDB
<a name="dynamodb-tutorial-explore-dynamodb-data"></a>

Erkunden Sie in diesem Schritt die Windgeschwindigkeitsdaten der Demo-Assets in Ihrer neuen Amazon DynamoDB-Tabelle.

**Um Asset-Daten in DynamoDB zu untersuchen**

1. Kehren Sie zu der Registerkarte mit der geöffneten DynamoDB-Tabelle zurück.

1. Wählen Sie in der Tabelle, die Sie zuvor erstellt haben, die Registerkarte **Tabellenelemente durchsuchen**, um die Daten in der Tabelle anzuzeigen. Aktualisieren Sie die Seite, wenn keine Zeilen in der Tabelle angezeigt werden. Wenn nach einigen Minuten keine Zeilen angezeigt werden, finden Sie weitere Informationen unter [Problembehandlung bei einer Regel (DynamoDB)](troubleshoot-rule.md#dynamodb-tutorial-troubleshoot-rule).

1. Wählen Sie in einer Zeile in der Tabelle das Bearbeitungssymbol aus, um die Daten zu erweitern.

1. Wählen Sie den Pfeil neben der Struktur **windspeed** aus, um die Liste der Datenpunkte für die Windgeschwindigkeit zu erweitern. Jede Liste enthält eine Reihe von Datenpunkten zur AWS IoT SiteWise Windgeschwindigkeit, an die die Windpark-Demo gesendet hat. Möglicherweise benötigen Sie ein anderes Datenformat, wenn Sie eine Regelaktion für Ihre eigene Verwendung einrichten. Weitere Informationen finden Sie unter [Benachrichtigungen über Vermögenseigenschaften abfragen in AWS IoT SiteWise](query-notification-messages.md).

Nachdem Sie das Tutorial abgeschlossen haben, können Sie die Regel deaktivieren oder löschen und Ihre DynamoDB-Tabelle löschen, um zusätzliche Gebühren zu vermeiden. Informationen zum Bereinigen Ihrer Ressourcen finden Sie unter. [Bereinigen von Ressourcen](#dynamodb-tutorial-clean-up-resources)

Sie können auch lernen, wie Sie benutzerdefinierte Anwendungen erstellen, um diese Daten zu nutzen und zu visualisieren. Eine Anleitung zur Visualisierung von AWS IoT SiteWise Daten finden Sie unter[Daten in Grafana visualisieren und teilen](visualize-with-grafana.md).

## Bereinigen von Ressourcen
<a name="dynamodb-tutorial-clean-up-resources"></a>

Nachdem Sie das Tutorial abgeschlossen haben, bereinigen Sie Ihre Ressourcen, um zusätzliche Kosten zu vermeiden.

**Um die Demo zu löschen AWS IoT SiteWise **

1. Navigieren Sie zur [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/).

1. Wählen Sie in der oberen rechten Ecke der Seite die Option Demo **löschen** aus.

1. Geben Sie in das Bestätigungsfeld **DELETE** ein, und wählen Sie dann **Delete (Löschen)**.

Weitere Informationen finden Sie unter [Löschen Sie die AWS IoT SiteWise Demo](getting-started-demo.md#delete-getting-started-demo).

Gehen Sie wie folgt vor, um Benachrichtigungen zur Aktualisierung von Eigenschaftswerten zu deaktivieren (falls Sie die Demo nicht gelöscht haben), Ihre AWS IoT Regel zu deaktivieren oder zu löschen und Ihre DynamoDB-Tabelle zu löschen.

**So deaktivieren Sie Aktualisierungsbenachrichtigungen für Komponenteneigenschaften:**

1. Navigieren Sie zur [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/).

1. Klicken Sie im linken Navigationsbereich auf **Assets (Komponenten)**.

1. Wählen Sie den Pfeil neben **Demo Wind Farm Asset** aus, um die Hierarchie der Windparkkomponente zu erweitern.

1. Wählen Sie eine Demoturbine und **Edit (Bearbeiten)** aus.

1. **Ändern Sie den **Benachrichtigungsstatus der **Wind Speed**Immobilie auf INAKTIV**.**

1. Wählen Sie unten auf der Seite die Option **Save asset (Komponente speichern)** aus.

1. Wiederholen Sie die Schritte 4 bis 6 für jede Demo-Turbinenkomponente.

**Um eine Regel zu deaktivieren oder zu löschen AWS IoT Core**

1. Navigieren Sie zur [AWS IoT -Konsole](https://console.aws.amazon.com/iot/).

1. Wählen Sie im linken Navigationsbereich **Nachrichtenweiterleitung** und dann **Regeln** aus.

1. Wählen Sie Ihre Regel aus und klicken Sie auf **Löschen**.

1. Geben Sie im Bestätigungsdialogfeld den Namen der Regel ein und wählen Sie dann Löschen.

**So löschen Sie eine DynamoDB-Tabelle**

1. Navigieren Sie zur [DynamoDB-Konsole](https://console.aws.amazon.com/dynamodb/).

1. Wählen Sie im linken Navigationsbereich **Tables (Tabellen)** aus.

1. Wählen Sie die Tabelle aus, die Sie zuvor erstellt haben, z. B. `WindSpeedData`

1. Wählen Sie **Löschen** aus.

1. Geben Sie im Bestätigungsdialogfeld ein, **confirm** um die Tabelle zu löschen.

## Weitere Ressourcen
<a name="dynamodb-tutorial-additional-resources"></a>

Weitere Informationen zur Arbeit mit DynamoDB und zur Überwachung Ihrer Daten finden Sie in den folgenden Ressourcen:
+ [Inklusive Monitoring-Metriken CloudWatch im](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Monitoring-metrics-with-Amazon-CloudWatch.html) *DynamoDB Developer Guide*
+ [Bewährte Methoden für das Entwerfen und effektive Verwenden von Partitionsschlüsseln finden Sie im](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/bp-partition-key-design.html) *DynamoDB-Entwicklerhandbuch*
+ [Regeln für AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html) *im Entwicklerhandbuch AWS IoT *
+ [Daten in Grafana visualisieren und teilen](visualize-with-grafana.md)