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. # Problembehandlung bei einer AWS IoT SiteWise Regelaktion Um Probleme mit Ihrer AWS IoT SiteWise Regelaktion in zu beheben AWS IoT Core, können Sie eines der folgenden Verfahren ausführen: + Amazon CloudWatch Logs konfigurieren + Konfigurieren einer Fehler-Aktion für die erneute Veröffentlichung für Ihre Regel Vergleichen Sie anschließend die Fehlermeldungen mit den Fehlern in diesem Thema, um Ihr Problem zu beheben. **Topics** + [AWS IoT Core Protokolle konfigurieren](#configure-iot-logs) + [Konfigurieren Sie eine Aktion zum erneuten Veröffentlichen von Fehlern](#configure-republish-error-action) + [Beheben Sie Regelprobleme](#troubleshoot-rule-issues) + [Problembehandlung bei einer Regel ()AWS IoT SiteWise](#rule-tutorial-troubleshoot-rule) + [Problembehandlung bei einer Regel (DynamoDB)](#dynamodb-tutorial-troubleshoot-rule) ## AWS IoT Core Protokolle konfigurieren Sie können so konfigurieren AWS IoT , dass verschiedene Informationsebenen in CloudWatch Logs protokolliert werden. **Um CloudWatch Protokolle zu konfigurieren und darauf zuzugreifen** 1. Informationen zur Konfiguration der Protokollierung finden Sie unter [Monitoring with CloudWatch Logs](https://docs.aws.amazon.com/iot/latest/developerguide/cloud-watch-logs.html) im *AWS IoT Developer Guide*. AWS IoT Core 1. Navigieren Sie zur [CloudWatch -Konsole](https://console.aws.amazon.com/cloudwatch/). 1. Wählen Sie im Navigationsbereich **Protokollgruppen** aus. 1. Wählen Sie die Gruppe **AWSIotLogs** aus. 1. Wählen Sie einen aktuellen Protokolldatenstrom aus. CloudWatch Zeigt standardmäßig den neuesten Protokollstream zuerst an. 1. Wählen Sie einen Protokolleintrag, um die Protokollmeldung zu erweitern. Ihr Protokolleintrag könnte wie der folgende Screenshot aussehen. ![CloudWatch Bildschirmfoto „AWS IoT Logs“.](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/images/rule-ingestion/troubleshoot-rule-logs-console.png) 1. Vergleichen Sie die Fehlermeldungen mit den Fehlern in diesem Thema, um Ihr Problem zu beheben. ## Konfigurieren Sie eine Aktion zum erneuten Veröffentlichen von Fehlern Sie können eine Fehleraktion für Ihre Regel konfigurieren, um Fehlermeldungen zu verarbeiten. In diesem Verfahren konfigurieren Sie die Aktion zur Wiederveröffentlichung der Regel, um Fehlermeldungen im MQTT-Testclient anzuzeigen. **Anmerkung** Die Aktion zum erneuten Veröffentlichen eines Fehlers gibt nur das Äquivalent der `ERROR`-Ebenenprotokolle aus. Wenn Sie ausführlichere Protokolle wünschen, müssen Sie Logs [konfigurieren CloudWatch ](#configure-iot-logs). **So fügen Sie einer Regel eine Aktion zur Wiederveröffentlichung eines Fehlers hinzu** 1. Navigieren Sie zur [AWS IoT -Konsole](https://console.aws.amazon.com/iot/). 1. Wählen Sie im linken Navigationsbereich **Act (Agieren)** und dann **Rules (Regeln)** aus. 1. Wählen Sie Ihre Regel aus. 1. Wählen Sie unter **Error action (Fehleraktion)** die Option **Add action (Aktion hinzufügen)**aus. 1. Wählen Sie **Nachricht zu einem AWS IoT Thema erneut veröffentlichen**. ![AWS IoT Core Screenshot der Seite „Aktion auswählen“, auf der die Aktion „Erneut veröffentlichen“ hervorgehoben ist.](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/images/rule-ingestion/rule-choose-republish-action-console.png) 1. Klicken Sie unten auf der Seite auf **Configure action (Aktion konfigurieren)**. 1. Geben Sie im Feld **Thema** ein eindeutiges Thema ein (z. B.**sitewise/windfarm/rule/error**). AWS IoT Core veröffentlicht Fehlermeldungen zu diesem Thema erneut. 1. Wählen Sie **„Auswählen“**, um AWS IoT Core Zugriff zur Ausführung der Fehleraktion zu gewähren. 1. Wählen Sie neben der Rolle, die Sie für die Regel erstellt haben, **Select (Auswählen)**. 1. Wählen Sie **Update Role (Rolle aktualisieren)** aus, um der Rolle die zusätzlichen Berechtigungen hinzuzufügen. 1. Wählen Sie **Aktion hinzufügen** aus. Die Fehleraktion Ihrer Regel sollte dem folgenden Screenshot ähnlich aussehen. ![AWS IoT Core Seite „Regel“ Veröffentlichen Sie den Screenshot der Fehleraktion erneut.](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/images/rule-ingestion/rule-confirm-republish-error-action-console.png) 1. Klicken Sie oben links auf der Konsole auf den Zurück-Pfeil, um zur Startseite der AWS IoT Konsole zurückzukehren. Nachdem Sie die Aktion „Republish error (Fehler wiederveröffentlichen)“ eingerichtet haben, können Sie die Fehlermeldungen in AWS IoT Core im MQTT-Testclient anzeigen. Im folgenden Verfahren abonnieren Sie das Fehlerthema im MQTT-Testclient. Im MQTT-Testclient können Sie die Fehlermeldungen Ihrer Regel erhalten, um das Problem zu beheben. **So abonnieren Sie das Fehleraktionsthema.** 1. Navigieren Sie zur [AWS IoT -Konsole](https://console.aws.amazon.com/iot/). 1. Wählen Sie auf der linken Navigationsseite **Test**, um den MQTT-Testclient zu öffnen. 1. Geben Sie im Feld **Subscription topic (Abonnementsthema)** das zuvor konfigurierte Fehlerthema ein (z. B. **sitewise/windfarm/rule/error**), und wählen Sie **Subscribe to topic (Thema abonnieren)**. ![AWS IoT Core Screenshot der Seite „MQTT-Client“ mit hervorgehobener Schaltfläche „Thema abonnieren“.](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/images/rule-ingestion/troubleshoot-rule-subscribe-error-topic-console.png) 1. Achten Sie auf die angezeigten Fehlermeldungen, und erweitern Sie dann das `failures`-Array in einer beliebigen Fehlermeldung. Vergleichen Sie anschließend die Fehlermeldungen mit den Fehlern in diesem Thema, um Ihr Problem zu beheben. ## Beheben Sie Regelprobleme Verwenden Sie die folgenden Informationen, um Regelprobleme zu beheben. **Topics** + [Fehler: Das Mitglied muss sich innerhalb von 604.800 Sekunden vor und 300 Sekunden nach dem aktuellen Zeitstempel befinden](#rule-error-timestamp-out-of-range) + [Fehler: Eigenschaftswert stimmt nicht mit dem Datentyp überein](#rule-error-invalid-data-type) + [Fehler: Benutzer: ist nicht berechtigt, Folgendes auszuführen: iotsitewise: on resource BatchPutAssetPropertyValue](#rule-error-role-not-authorized) + [Fehler: iot.amazonaws.com kann Folgendes nicht ausführen: sts: auf der Ressource: AssumeRole ](#rule-error-unable-to-assume-role) + [Information: Es wurden keine Anfragen gesendet. PutAssetPropertyValueEntries war nach der Ausführung von Ersatzvorlagen leer.](#rule-info-request-was-empty) ### Fehler: Das Mitglied muss sich innerhalb von 604.800 Sekunden vor und 300 Sekunden nach dem aktuellen Zeitstempel befinden Ihr Zeitstempel ist älter als 7 Tage oder neuer als 5 Minuten, verglichen mit der aktuellen Unix-Epoche. Gehen Sie wie folgt vor: + Überprüfen Sie, ob Ihr Zeitstempel in Unix-Epoche (UTC) Zeit angegeben wird. Wenn Sie einen Zeitstempel mit einer anderen Zeitzone angeben, erhalten Sie diesen Fehler. + Vergewissern Sie sich, dass Ihr Zeitstempel in Sekunden angegeben ist. AWS IoT SiteWise erwartet, dass Zeitstempel in Zeit in Sekunden (in der Unix-Epochenzeit) und Offset in Nanosekunden aufgeteilt sind. + Vergewissern Sie sich, dass Sie Daten hochladen, die nicht später als 7 Tage in der Vergangenheit mit einem Zeitstempel versehen sind. ### Fehler: Eigenschaftswert stimmt nicht mit dem Datentyp überein Ein Eintrag in der Regelaktion hat einen anderen Datentyp als die Zielkomponenteneigenschaft. Beispielsweise ist Ihre Zielkomponenteneigenschaft `DOUBLE` und Ihr ausgewählter Datentyp ist **Integer (Ganzzahl)** oder Sie haben den Wert `integerValue` übergeben. Gehen Sie wie folgt vor: + Wenn Sie die Regel von der AWS IoT Konsole aus konfigurieren, überprüfen Sie, ob Sie für jeden Eintrag den richtigen **Datentyp** ausgewählt haben. + Wenn Sie die Regel über die API oder AWS Command Line Interface (AWS CLI) konfigurieren, überprüfen Sie, ob Ihr `value` Objekt das richtige Typfeld verwendet (z. B. `doubleValue` für eine `DOUBLE` Eigenschaft). ### Fehler: Benutzer: ist nicht berechtigt, Folgendes auszuführen: iotsitewise: on resource BatchPutAssetPropertyValue Ihre Regel ist nicht berechtigt, auf die Zielkomponenteneigenschaft zuzugreifen, oder die Zielkomponenteneigenschaft ist nicht vorhanden. Gehen Sie wie folgt vor: + Überprüfen Sie, ob Ihr Eigenschaftenalias korrekt ist, und ob Sie eine Komponenteneigenschaft mit dem angegebenen Eigenschaftenalias haben. Weitere Informationen finden Sie unter [Datenströme verwalten für AWS IoT SiteWise](manage-data-streams.md). + Überprüfen Sie, ob Ihre Regel über eine Rolle verfügt, und ob die Rolle die `iotsitewise:BatchPutAssetPropertyValue`-Berechtigung für die Zielkomponenteneigenschaft zulässt, z. B. über die Hierarchie der Zielkomponente. Weitere Informationen finden Sie unter [Gewähren AWS IoT Sie den erforderlichen Zugriff](grant-rule-access.md). ### Fehler: iot.amazonaws.com kann Folgendes nicht ausführen: sts: auf der Ressource: AssumeRole Ihr Benutzer ist nicht berechtigt, die Rolle in Ihrer Regel in (IAM) zu übernehmen. AWS Identity and Access Management Vergewissern Sie sich, dass Ihr Benutzer `iam:PassRole` Zugriff auf die Rolle in Ihrer Regel hat. Weitere Informationen finden Sie im *AWS IoT Entwicklerhandbuch* unter [Rollenberechtigungen weitergeben](https://docs.aws.amazon.com/iot/latest/developerguide/pass-role.html). ### Information: Es wurden keine Anfragen gesendet. PutAssetPropertyValueEntries war nach der Ausführung von Ersatzvorlagen leer. **Anmerkung** Diese Nachricht ist ein `INFO`-Ebenenprotokoll. Ihre Anforderung muss mindestens einen Eintrag mit allen erforderlichen Parametern aufweisen. Überprüfen Sie, ob die Parameter Ihrer Regel, einschließlich der Substitutionsvorlagen, zu nicht-leeren Werten führen. Substitutionsvorlagen können nicht auf Werte zugreifen, die in `AS`-Klauseln in Ihrer Regelabfrageanweisung definiert sind. Weitere Informationen finden Sie unter [Substitutionsvorlagen](https://docs.aws.amazon.com/iot/latest/developerguide/iot-substitution-templates.html) im *AWS IoT Entwicklerhandbuch*. ## Problembehandlung bei einer Regel ()AWS IoT SiteWise Folgen Sie den Schritten in diesem Verfahren, um Fehler in Ihrer Regel zu beheben, falls die Daten zur CPU- und Speicherauslastung nicht AWS IoT SiteWise wie erwartet angezeigt werden. In diesem Verfahren konfigurieren Sie die Aktion zur Wiederveröffentlichung der Regel, um Fehlermeldungen im MQTT-Testclient anzuzeigen. Zur Fehlerbehebung können Sie auch die CloudWatch Protokollierung in Logs konfigurieren. Weitere Informationen finden Sie unter [Problembehandlung bei einer AWS IoT SiteWise Regelaktion](#troubleshoot-rule). **So fügen Sie einer Regel eine Aktion zur Wiederveröffentlichung eines Fehlers hinzu** 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 die Regel aus, die Sie zuvor erstellt haben, und klicken Sie auf **Bearbeiten**. 1. Wählen Sie unter **Fehleraktion — *optional*** die Option **Fehleraktion hinzufügen** aus. 1. Wählen Sie **Nachricht zu einem AWS IoT Thema erneut veröffentlichen** aus. 1. Geben Sie im Feld **Thema** den Pfad zu Ihrem Fehler ein (z. B.**sitewise/rule/tutorial/error**). AWS IoT Core veröffentlicht die Fehlermeldungen zu diesem Thema erneut. 1. Wählen Sie die Rolle aus, die Sie zuvor erstellt haben (z. B. **SiteWiseTutorialDeviceRuleRole**). 1. Wählen Sie **Aktualisieren** aus. Nachdem Sie die Aktion „Republish error (Fehler wiederveröffentlichen)“ eingerichtet haben, können Sie die Fehlermeldungen in AWS IoT Core im MQTT-Testclient anzeigen. Im folgenden Verfahren abonnieren Sie das Fehlerthema im MQTT-Testclient. **So abonnieren Sie das Fehleraktionsthema.** 1. Navigieren Sie zur [AWS IoT -Konsole](https://console.aws.amazon.com/iot/). 1. Wählen Sie auf der linken Navigationsseite **MQTT-Testclient aus, um den MQTT-Testclient** zu öffnen. 1. **Geben Sie im Feld **Themenfilter** den Text Abonnieren ein **sitewise/rule/tutorial/error** und wählen Sie Abonnieren.** Wenn Fehlermeldungen angezeigt werden, zeigen Sie das `failures`-Array in einer beliebigen Fehlermeldung an, um Probleme zu diagnostizieren. Weitere Informationen zu möglichen Problemen und deren Behebung finden Sie unter [Problembehandlung bei einer AWS IoT SiteWise Regelaktion](#troubleshoot-rule). Wenn keine Fehler angezeigt werden, überprüfen Sie, ob Ihre Regel aktiviert ist und ob Sie das in der Aktion „Fehler wiederveröffentlichen“ konfigurierte Thema abonniert haben. Wenn nach dem Vorgehen weiterhin keine Fehler auftreten, überprüfen Sie, ob das Geräteskript ausgeführt wird und den Schatten des Geräts erfolgreich aktualisiert. **Anmerkung** Sie können auch das Shadow-Update-Thema Ihres Geräts abonnieren, um die Payload zu sehen, die Ihre AWS IoT SiteWise Aktion analysiert. Abonnieren Sie dazu das folgende Thema. ``` $aws/things/+/shadow/update/accepted ``` ## Problembehandlung bei einer Regel (DynamoDB) Folgen Sie den Schritten in diesem Verfahren, um Fehler in Ihrer Regel zu beheben, falls die Demo-Asset-Daten nicht wie erwartet in der DynamoDB-Tabelle angezeigt werden. In diesem Verfahren konfigurieren Sie die Aktion zur Wiederveröffentlichung der Regel, um Fehlermeldungen im MQTT-Testclient anzuzeigen. Zur Fehlerbehebung können Sie auch die Protokollierung in CloudWatch Logs konfigurieren. Weitere Informationen finden Sie unter [Überwachen mit CloudWatch –Protokollen](https://docs.aws.amazon.com/iot/latest/developerguide/cloud-watch-logs.html) im *Entwicklerhandbuch für AWS IoT *. **So fügen Sie einer Regel eine Aktion zur Wiederveröffentlichung eines Fehlers hinzu** 1. Navigieren Sie zur [AWS IoT -Konsole](https://console.aws.amazon.com/iot/). 1. Wählen Sie im linken Navigationsbereich **Act (Agieren)** und dann **Rules (Regeln)** aus. 1. Wählen Sie die Regel aus, die Sie zuvor erstellt haben. ![AWS IoT Screenshot der Kernseite „Regeln“.](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/images/interact-dynamo-db/rule-choose-rule-console.png) 1. Wählen Sie unter **Error action (Fehleraktion)** die Option **Add action (Aktion hinzufügen)**aus. 1. Wähle „**Nachricht zu einem AWS IoT Thema erneut veröffentlichen**“. ![AWS IoT Screenshot der Kernseite „Aktion auswählen“, auf der die Aktion „Erneut veröffentlichen“ hervorgehoben ist.](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/images/interact-dynamo-db/rule-choose-republish-action-console.png) 1. Klicken Sie unten auf der Seite auf **Configure action (Aktion konfigurieren)**. 1. Geben Sie im Feld **Thema** **windspeed/error** ein. AWS IoT Core wird die Fehlermeldungen zu diesem Thema erneut veröffentlichen. ![AWS IoT Screenshot der Core-Seite „Aktion „Erneute Veröffentlichung konfigurieren“, auf der das „Thema“ hervorgehoben ist.](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/images/interact-dynamo-db/rule-configure-republish-action-console.png) 1. Wählen **Sie „Auswählen“**, um AWS IoT Core Zugriff auf die Ausführung der Fehleraktion mithilfe der zuvor erstellten Rolle zu gewähren. 1. Wählen Sie **Select (Auswählen)** neben Ihrer Rolle aus. ![AWS IoT Screenshot der Core-Seite „Aktion „Erneute Veröffentlichung konfigurieren“, auf der die Schaltfläche zur Rollenauswahl hervorgehoben ist.](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/images/interact-dynamo-db/rule-select-role-console.png) 1. Wählen Sie **Update Role (Rolle aktualisieren)** aus, um der Rolle die zusätzlichen Berechtigungen hinzuzufügen. ![AWS IoT Screenshot der Kernseite „Aktion „Erneute Veröffentlichung konfigurieren“, auf der die Schaltfläche „Rolle aktualisieren“ hervorgehoben ist.](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/images/interact-dynamo-db/rule-update-role-console.png) 1. Wählen Sie **Add action (Aktion hinzufügen)** aus, um das Hinzufügen der Fehleraktion abzuschließen. 1. Wählen Sie den Zurück-Pfeil oben links auf der Konsole, um zur Startseite der AWS IoT Core-Konsole zurückzukehren. Nachdem Sie die Aktion „Fehler erneut veröffentlichen“ eingerichtet haben, können Sie die Fehlermeldungen im MQTT-Testclient in AWS IoT Core anzeigen. Im folgenden Verfahren abonnieren Sie das Fehlerthema im MQTT-Testclient. **So abonnieren Sie das Fehleraktionsthema.** 1. **Wählen Sie auf der linken Navigationsseite der AWS IoT Core-Konsole Test aus.** 1. Geben Sie im Feld **Subscription topic (Abonnementthema)** „**windspeed/error**“ ein und wählen Sie **Subscribe to topic (Thema abonnieren)** aus. ![AWS IoT Screenshot der Kernseite „MQTT-Client“, auf der die Schaltfläche „Thema abonnieren“ hervorgehoben ist.](http://docs.aws.amazon.com/de_de/iot-sitewise/latest/userguide/images/interact-dynamo-db/rule-subscribe-error-topic-console.png) 1. Achten Sie darauf, dass Fehlermeldungen angezeigt werden, und erkunden Sie das `failures`-Array in einer Fehlermeldung, um die folgenden häufigsten Probleme zu diagnostizieren: + Tippfehler in der Regelabfrageanweisung + Unzureichende Rollenberechtigungen Wenn keine Fehler angezeigt werden, überprüfen Sie, ob Ihre Regel aktiviert ist und ob Sie das in der Aktion „Fehler wiederveröffentlichen“ konfigurierte Thema abonniert haben. Wenn immer noch keine Fehler angezeigt werden, überprüfen Sie, ob Ihre Demo-Windparkkomponenten noch vorhanden sind und ob Sie Benachrichtigungen zu den Windgeschwindigkeitseigenschaften aktiviert haben. Wenn Ihre Demo-Assets abgelaufen sind und nicht mehr verfügbar sind AWS IoT SiteWise, können Sie eine neue Demo erstellen und die Regelabfrageanweisung aktualisieren, um das aktualisierte Asset-Modell und die aktualisierte Eigenschaft IDs widerzuspiegeln.