Problembehandlung und 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.

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 im AWS IoT Developer Guide. AWS IoT Core

2. Navigieren Sie zur CloudWatch -Konsole.

3. Wählen Sie im Navigationsbereich Protokollgruppen aus.

4. Wählen Sie die AWSIotLogsGruppe aus.

5. Wählen Sie einen aktuellen Protokolldatenstrom aus. CloudWatch Zeigt standardmäßig den neuesten Log-Stream zuerst an.

6. Wählen Sie einen Protokolleintrag, um die Protokollmeldung zu erweitern. Ihr Protokolleintrag könnte wie der folgende Screenshot aussehen.

   

7. Vergleichen Sie die Fehlermeldungen mit den Fehlern in diesem Thema, um Ihr Problem zu beheben.

Konfigurieren einer Aktion für die erneute Veröffentlichung eines Fehlers

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 CloudWatch Logs konfigurieren.

So fügen Sie einer Regel eine Aktion zur Wiederveröffentlichung eines Fehlers hinzu

1. Navigieren Sie zur AWS IoT -Konsole.

2. Wählen Sie im linken Navigationsbereich Act (Agieren) und dann Rules (Regeln) aus.

3. Wählen Sie Ihre Regel aus.

4. Wählen Sie unter Error action (Fehleraktion) die Option Add action (Aktion hinzufügen)aus.

5. Wählen Sie Nachricht zu einem Thema erneut veröffentlichen aus. AWS IoT

   

6. Klicken Sie unten auf der Seite auf Configure action (Aktion konfigurieren).

7. Geben Sie im Feld Thema ein eindeutiges Thema ein (z. B.sitewise/windfarm/rule/error). AWS IoT Core veröffentlicht die Fehlermeldungen zu diesem Thema erneut.

8. Wählen Sie „Auswählen“, um AWS IoT Core Zugriff für die Ausführung der Fehleraktion zu gewähren.

9. Wählen Sie neben der Rolle, die Sie für die Regel erstellt haben, Select (Auswählen).

10. Wählen Sie Update Role (Rolle aktualisieren) aus, um der Rolle die zusätzlichen Berechtigungen hinzuzufügen.

11. Wählen Sie Aktion hinzufügen aus.

    Die Fehleraktion Ihrer Regel sollte dem folgenden Screenshot ähnlich aussehen.

    

12. 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.

2. Wählen Sie auf der linken Navigationsseite Test, um den MQTT-Testclient zu öffnen.

3. 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).

   

4. 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 von -Problemen

Verwenden Sie die folgenden Informationen, um Regelprobleme zu beheben.

Problembereiche

• Fehler: Das Mitglied muss innerhalb von 604.800 Sekunden vor und 300 Sekunden nach dem aktuellen Zeitstempel sein
• Fehler: Eigenschaftswert stimmt nicht mit dem Datentyp <type> überein
• Fehler: Benutzer: <role-arn>ist nicht berechtigt, Folgendes auszuführen: iotsitewise: on resource BatchPutAssetPropertyValue
• Fehler: iot.amazonaws.com kann Folgendes nicht ausführen: sts: auf der Ressource: AssumeRole <role-arn>
• Info: Es wurden keine Anforderungen gesendet. PutAssetPropertyValueEntries war nach der Ausführung von Ersatzvorlagen leer.

Fehler: Das Mitglied muss innerhalb von 604.800 Sekunden vor und 300 Sekunden nach dem aktuellen Zeitstempel sein

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 <type> ü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: <role-arn>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 Zuordnen von industriellen Datenströmen zu Komponenteneigenschaften.

• Ü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ährung AWS IoT des erforderlichen Zugriffs.

Fehler: iot.amazonaws.com kann Folgendes nicht ausführen: sts: auf der Ressource: AssumeRole <role-arn>

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.

Info: Es wurden keine Anforderungen 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 im AWS IoT Entwicklerhandbuch.

Fehlerbehebung bei einer Regel

Folgen Sie den Schritten in diesem Verfahren, um Fehler in Ihrer Regel zu beheben, falls die Daten zur CPU- und Speichernutzung 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 und AWS IoT SiteWise Regelaktion.

So fügen Sie einer Regel eine Aktion zur Wiederveröffentlichung eines Fehlers hinzu

1. Navigieren Sie zur AWS IoT -Konsole.

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

3. Wählen Sie die Regel aus, die Sie zuvor erstellt haben, und klicken Sie auf Bearbeiten.

4. Wählen Sie unter Fehleraktion — optional die Option Fehleraktion hinzufügen aus.

5. Wählen Sie Eine Nachricht zu einem AWS IoT Thema erneut veröffentlichen aus.

6. 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.

7. Wählen Sie die Rolle aus, die Sie zuvor erstellt haben (z. B. SiteWiseTutorialDeviceRuleRole).

8. Wählen Sie Aktualisieren.

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.

2. Wählen Sie auf der linken Navigationsseite MQTT-Testclient aus, um den MQTT-Testclient zu öffnen.

3. 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 und AWS IoT SiteWise Regelaktion.

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

Fehlerbehebung bei einer Regel

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 Überwachung mit CloudWatch Protokollen im AWS IoT Entwicklerhandbuch.

So fügen Sie einer Regel eine Aktion zur Wiederveröffentlichung eines Fehlers hinzu

1. Navigieren Sie zur AWS IoT -Konsole.

2. Wählen Sie im linken Navigationsbereich Act (Agieren) und dann Rules (Regeln) aus.

3. Wählen Sie die Regel aus, die Sie zuvor erstellt haben.

   

4. Wählen Sie unter Error action (Fehleraktion) die Option Add action (Aktion hinzufügen)aus.

5. Wähle „Nachricht zu einem AWS IoT Thema erneut veröffentlichen“.

   

6. Klicken Sie unten auf der Seite auf Configure action (Aktion konfigurieren).

7. Geben Sie im Feld Thema windspeed/error ein. AWS IoT Core wird die Fehlermeldungen zu diesem Thema erneut veröffentlichen.

   

8. Wählen Sie „Auswählen“, um AWS IoT Core Zugriff auf die Ausführung der Fehleraktion mithilfe der zuvor erstellten Rolle zu gewähren.

9. Wählen Sie Select (Auswählen) neben Ihrer Rolle aus.

   

10. Wählen Sie Update Role (Rolle aktualisieren) aus, um der Rolle die zusätzlichen Berechtigungen hinzuzufügen.

    

11. Wählen Sie Add action (Aktion hinzufügen) aus, um das Hinzufügen der Fehleraktion abzuschließen.

12. 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 die Option Test aus.

2. Geben Sie im Feld Subscription topic (Abonnementthema) „windspeed/error“ ein und wählen Sie Subscribe to topic (Thema abonnieren) aus.

   

3. 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, sodass sie das aktualisierte Asset-Modell und die aktualisierten Eigenschaften-IDs wiedergibt.