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. # Problembehebung AWS IoT SiteWise Verwenden Sie die folgenden Informationen, um Probleme mit zu beheben AWS IoT SiteWise. **Topics** + [Fehlerbehebung bei einem SiteWise Edge-Gateway](troubleshooting-gateway.md) + [Fehler bei einem AWS IoT SiteWise Portal beheben](troubleshooting-portal.md) + [Problembehandlung bei einer AWS IoT SiteWise Regelaktion](troubleshoot-rule.md) + [Problembehandlung bei Massenimport- und -exportvorgängen](troubleshooting-bulk.md) # Fehlerbehebung bei einem SiteWise Edge-Gateway Beheben Sie häufig auftretende Probleme mit dem AWS IoT SiteWise Edge-Gateway, indem Sie sich mit den entsprechenden Themen befassen. Sie können sich auch CloudWatch Messwerte ansehen, die von Ihren SiteWise Edge-Gateways gemeldet wurden, um Probleme mit Konnektivität oder Datenströmen zu beheben. Weitere Informationen finden Sie unter [Überwachen Sie AWS IoT SiteWise mit CloudWatch Amazon-Metriken](monitor-cloudwatch-metrics.md). **Topics** + [SiteWise Edge-Gateway-Protokolle konfigurieren und darauf zugreifen](#configure-gateway-logs) + [Behebung von Problemen mit dem SiteWise Edge-Gateway](#troubleshoot-gateway-issues) + [Fehlerbehebung bei der AWS IoT SiteWise Edge-Anwendung auf Siemens Industrial Edge](#troubleshoot-siemens-app) + [Fehlerbehebung bei Open-Source-Integrationen am Edge](#open-source-troubleshooting) + [Probleme beheben AWS IoT Greengrass](#troubleshoot-greengrass-issues) ## SiteWise Edge-Gateway-Protokolle konfigurieren und darauf zugreifen Bevor Sie SiteWise Edge-Gateway-Protokolle anzeigen können, müssen Sie Ihr SiteWise Edge-Gateway so konfigurieren, dass es CloudWatch Protokolle an Amazon Logs sendet oder Protokolle im lokalen Dateisystem speichert. + Verwenden Sie CloudWatch Logs, wenn Sie das verwenden möchten AWS-Managementkonsole , um die Protokolldateien Ihres SiteWise Edge-Gateways einzusehen. Weitere Informationen finden Sie unter [Verwenden Sie Amazon CloudWatch Logs](gateway-cloudwatch-logs.md). + Verwenden Sie lokale Dateisystemprotokolle, wenn Sie die Befehlszeile oder lokale Software verwenden möchten, um die Protokolldateien Ihres SiteWise Edge-Gateways anzuzeigen. Weitere Informationen finden Sie unter [Loggen Sie sich in den Dienst ein AWS IoT SiteWise](gateway-local-logs.md). ## Behebung von Problemen mit dem SiteWise Edge-Gateway Verwenden Sie die folgenden Informationen, um Probleme mit dem SiteWise Edge-Gateway zu beheben. **Topics** + [Pakete können nicht für SiteWise Edge-Gateways bereitgestellt werden](#gateway-issue-ggv2-packs) + [AWS IoT SiteWise empfängt keine Daten von OPC UA-Servern](#gateway-issue-data-streams) + [Im Dashboard werden keine Daten angezeigt](#gateway-issue-no-data) + [„Hauptklasse konnte nicht gefunden oder geladen werden“ wird in aws.iot angezeigt. SiteWiseEdgePublisher meldet sich bei einem Fehler von//an greengrass/v2/logs](#troubleshoot-java-issues) + [Ich sehe 'SESSION\$1TAKEN\$1OVER' oder 'com.aws.greengrass.mqttclient. MqttClient: Die Nachricht konnte nicht über Spooler veröffentlicht werden und es wird erneut versucht. ' in den Protokollen](#sa-troubleshoot-multiple-use) + [Ich sehe „com.aws.greengrass.deployment“. IotJobsHelper: Es wurde kein Bereitstellungsjob gefunden. ' oder 'Das Bereitstellungsergebnis wurde bereits gemeldet. ' in den Protokollen](#sa-troubleshoot-reuse) + [Beim Versuch, die Zeitstempeleinstellung in einer Eigenschaftsgruppe einer OPC UA-Datenquelle zu konfigurieren, wird der Status „SYNC\$1FAILED“ angezeigt](#troubleshoot-gateway-sync-failed-timestamp) + [Konvertierte Datentypen sind nicht enthalten](#troubleshoot-data-conversion) + [Probleme mit dem Trust Store](#troubleshoot-trust-stores) + [Probleme bei der Installation mit einem Proxy](#troubleshoot-proxy-during-installation) ### Pakete können nicht für SiteWise Edge-Gateways bereitgestellt werden Wenn die AWS IoT Greengrass Nucleus-Komponente (`aws.greengrass.Nucleus`) veraltet ist, können Sie möglicherweise keine Packs auf Ihrem SiteWise Edge-Gateway bereitstellen. Sie können die AWS IoT Greengrass V2 Konsole verwenden, um die AWS IoT Greengrass Nucleus-Komponente zu aktualisieren. **Um die AWS IoT Greengrass Nucleus-Komponente (Konsole) zu aktualisieren** 1. Navigieren Sie zur [AWS IoT Greengrass -Konsole](https://console.aws.amazon.com/greengrassIntro). 1. Wählen Sie im Navigationsbereich unter **AWS IoT Greengrass****Deployments** aus. 1. Wählen Sie in der Liste **Bereitstellungen** die Bereitstellung aus, die Sie überarbeiten möchten. 1. **Wählen Sie Überarbeiten aus.** 1. Wählen Sie auf der Seite **„Ziel angeben**“ die Option **Weiter**. 1. Geben Sie auf der Seite **Komponenten auswählen** unter **Öffentliche Komponenten** in das Suchfeld **aws.greengrass.Nucleus** **AWS.Greengrass.Nucleus** ein und wählen Sie dann aus. 1. Wählen Sie **Weiter** aus. 1. **Wählen Sie auf der Seite **Komponenten konfigurieren die Option Weiter** aus.** 1. Wählen Sie auf der Seite **Erweiterte Einstellungen konfigurieren** die Option **Weiter** aus. 1. Wählen Sie auf der Seite **Review (Prüfen)** die Option **Deploy (Bereitstellen)** aus. ### AWS IoT SiteWise empfängt keine Daten von OPC UA-Servern Wenn Ihre Geräte AWS IoT SiteWise keine von Ihren OPC UA-Servern gesendeten Daten empfangen, können Sie die Protokolle Ihres SiteWise Edge-Gateways durchsuchen, um Probleme zu beheben. Suchen Sie nach `swPublisher` Protokollen auf Informationsebene, die die folgende Meldung enthalten. ``` Emitting diagnostic name=PublishError.SomeException ``` Verwenden Sie je nach Typ *SomeException* im Protokoll die folgenden Ausnahmetypen und die entsprechenden Probleme, um Ihr SiteWise Edge-Gateway zu beheben: + **ResourceNotFoundException**— Ihre OPC UA-Server senden Daten, die keinem Eigenschaftsalias für ein Asset entsprechen. Diese Ausnahme kann in zwei Fällen auftreten: + Ihre Eigenschaftsaliase stimmen nicht genau mit Ihren OPC UA-Variablen überein, einschließlich der von Ihnen definierten Quellpräfixe. Überprüfen Sie, ob Ihre Eigenschaftenaliase und Quellpräfixe korrekt sind. + Sie haben Ihre OPC UA-Variablen nicht den Eigenschaften von Vermögenswerten zugeordnet. Weitere Informationen finden Sie unter [Datenströme verwalten für AWS IoT SiteWise](manage-data-streams.md). Wenn Sie bereits alle gewünschten OPC-UA-Variablen zugeordnet haben, können Sie filtern AWS IoT SiteWise, welche OPC-UA-Variablen das Edge-Gateway sendet. SiteWise Weitere Informationen finden Sie unter [Verwenden Sie OPC UA-Knotenfilter in Edge SiteWise](opc-ua-node-filters.md). + **InvalidRequestException**— Die Datentypen Ihrer OPC UA-Variablen stimmen nicht mit den Datentypen Ihrer Anlageneigenschaft überein. Wenn eine OPC UA-Variable beispielsweise einen Integer-Datentyp hat, muss Ihre entsprechende Asset-Eigenschaft vom Datentyp Integer sein. Eine Asset-Eigenschaft vom Typ Double kann keine ganzzahligen OPC UA-Werte empfangen. Um dieses Problem zu beheben, definieren Sie neue Eigenschaften mit den richtigen Datentypen. + **TimestampOutOfRangeException**— Ihr SiteWise Edge-Gateway sendet Daten, die außerhalb des zulässigen Bereichs liegen. AWS IoT SiteWise AWS IoT SiteWise lehnt alle Datenpunkte ab, deren Zeitstempel vor 7 Tagen in der Vergangenheit oder weniger als 5 Minuten in der future liegen. Wenn Ihr SiteWise Edge-Gateway die Stromversorgung oder die Verbindung zur AWS Cloud verloren hat, müssen Sie möglicherweise den Cache Ihres SiteWise Edge-Gateways leeren. + **ThrottlingException**oder **LimitExceededException**— Ihre Anfrage hat ein AWS IoT SiteWise Servicekontingent überschritten, z. B. die Rate der aufgenommenen Datenpunkte oder die Anforderungsrate für API-Operationen mit Objektdaten. Überprüfen Sie, dass Ihre Konfiguration [AWS IoT SiteWise Kontingente](endpoints-and-quotas.md#quotas) nicht überschreitet. ### Im Dashboard werden keine Daten angezeigt Wenn in Ihrem Dashboard keine Daten angezeigt werden, sind die **Publisher-Konfiguration** und die **Datenquelle** des SiteWise Edge-Gateways möglicherweise nicht synchron. Wenn sie nicht synchron sind, kann die Aktualisierung des Namens der Datenquelle die Synchronisierung von der Cloud zum Edge beschleunigen und so den Fehler „Nicht synchron“ beheben. **Um den Namen einer Datenquelle zu aktualisieren** 1. Navigieren Sie zur [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/). 1. Wählen Sie im Navigationsbereich **Edge-Gateways** aus. 1. Wählen Sie das SiteWise Edge-Gateway aus, das mit dem Dashboard verbunden ist. 1. Wählen Sie unter **Datenquellen** die Option **Bearbeiten** aus. 1. Wählen Sie einen neuen **Quellennamen** und klicken Sie auf **Speichern**, um Ihre Änderung zu bestätigen. 1. Überprüfen Sie Ihre Änderungen, indem Sie in der Tabelle **Datenquellen überprüfen, ob der Datenquellenname** aktualisiert wurde. ### „Hauptklasse konnte nicht gefunden oder geladen werden“ wird in aws.iot angezeigt. SiteWiseEdgePublisher meldet sich bei einem Fehler von//an greengrass/v2/logs Wenn Sie diesen Fehler sehen, müssen Sie möglicherweise die Java-Version Ihres SiteWise Edge-Gateways aktualisieren. + Führen Sie von einem Terminal folgenden Befehl aus: ``` java -version ``` Die Version von Java, mit der Ihr SiteWise Edge-Gateway ausgeführt wird, wird unter angezeigt`OpenJDK Runtime Environment`. Sie werden eine Antwort wie die folgende sehen: ``` openjdk version "11.0.20" 2023-07-18 LTS OpenJDK Runtime Environment Corretto011.0.20.8.1 (build 11.0.20+8-LTS OpenJDK 64-Bit Server VM Corretto-11.0.20.8.1 (build 11.0.20+8-LTS, mixed node) ``` Wenn Sie die Java-Version 11.0.20.8.1 ausführen, müssen Sie das IoT SiteWise Publisher-Paket auf Version 2.4.1 oder neuer aktualisieren. Nur die Java-Version 11.0.20.8.1 ist betroffen. Umgebungen mit anderen Java-Versionen können weiterhin ältere Versionen der IoT SiteWise Publisher-Komponente verwenden. Weitere Informationen zum Aktualisieren eines Komponentenpakets finden Sie unter. [Ändern Sie die Version der SiteWise Edge Gateway-Komponentenpakete](manage-gateways-ggv2.md#manage-gateway-update-packs) ### Ich sehe 'SESSION\$1TAKEN\$1OVER' oder 'com.aws.greengrass.mqttclient. MqttClient: Die Nachricht konnte nicht über Spooler veröffentlicht werden und es wird erneut versucht. ' in den Protokollen Wenn Sie unter eine Warnung `SESSION_TAKEN_OVER` oder einen Fehler `com.aws.greengrass.mqttclient.MqttClient: Failed to publish the message via Spooler and will retry.` in Ihren Protokollen sehen, versuchen Sie möglicherweise`/greengrass/v2/logs/greengrass.log`, dieselbe Konfigurationsdatei für mehrere SiteWise Edge-Gateways auf mehreren Geräten zu verwenden. Jedes SiteWise Edge-Gateway benötigt eine eigene Konfigurationsdatei, um eine Verbindung zu Ihrem AWS Konto herzustellen. ### Ich sehe „com.aws.greengrass.deployment“. IotJobsHelper: Es wurde kein Bereitstellungsjob gefunden. ' oder 'Das Bereitstellungsergebnis wurde bereits gemeldet. ' in den Protokollen Wenn Sie `com.aws.greengrass.deployment.IotJobsHelper: No deployment job found.` oder `Deployment result already reported.` in Ihren Protokollen unter sehen`/greengrass/v2/logs/greengrass.log`, versuchen Sie möglicherweise, dieselbe Konfigurationsdatei wiederzuverwenden. Es gibt mehrere Lösungen: + Wenn Sie die Konfigurationsdatei wiederverwenden möchten, gehen Sie wie folgt vor: 1. Navigieren Sie zur [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/). 1. Wählen Sie im Navigationsbereich **Edge-Gateways** aus. 1. Wählen Sie das SiteWise Edge-Gateway aus, das Sie wiederverwenden möchten. 1. Wählen Sie die Registerkarte **Updates**. 1. Wählen Sie eine andere Publisher-Version und anschließend **Bereitstellen** aus. Folgen Sie den Schritten unter[Erstellen Sie ein Gateway für Siemens Industrial Edge](sa-create-config.md), um eine neue Konfigurationsdatei zu erstellen. ### Beim Versuch, die Zeitstempeleinstellung in einer Eigenschaftsgruppe einer OPC UA-Datenquelle zu konfigurieren, wird der Status „SYNC\$1FAILED“ angezeigt Bei der AWS IoT SiteWise Aktualisierung der OPC UA-Collector-Komponente für AWS IoT Greengrass in Version 2.5.0 haben wir eine neue Zeitstempel-Konfigurationsoption eingeführt. Sie können den Zeitstempel entweder von Ihrem Gerät oder den Zeitstempel vom Server verwenden. Ältere Versionen der OPC UA-Collector-Komponente unterstützen diese Option nicht und können nicht synchronisiert werden. Es gibt zwei Möglichkeiten, den Status einer fehlgeschlagenen Datenquellensynchronisierung zu beheben. Es wird empfohlen, die IoT SiteWise OPC UA-Collector-Komponente auf Version 2.5.0 oder höher zu aktualisieren. Alternativ können Sie weiterhin die ältere Version der OPC UA-Collector-Komponente verwenden, wenn Sie den Zeitstempel auf setzen. `Source` Informationen zum Upgrade der SiteWise IoT-OPC-UA-Kollektorkomponente finden Sie unter[Aktualisieren Sie die Version einer Komponente AWS IoT SiteWise](manage-gateways-ggv2.md#update-component-version). Wir empfehlen, die neuesten Versionen aller Komponenten zu verwenden. **Anmerkung** Es gibt keine Datenunterbrechung, wenn der Synchronisierungsstatus einer Datenquelle fehlschlägt. Die Quelldaten fließen weiterhin in AWS IoT SiteWise. Die Konfiguration wird einfach nicht mit der IoT SiteWise OPC UA-Collector-Komponente in Ihrer AWS IoT Greengrass V2 Bereitstellung synchronisiert. **Um die Zeitstempelkonfiguration für eine Eigenschaftsgruppe zu ändern** 1. Navigieren Sie zur [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/). 1. Wählen Sie im Navigationsbereich **Edge-Gateways** aus. 1. Wählen Sie das Gateway aus, das bearbeitet werden soll. 1. Wählen Sie im Abschnitt **Datenquellen** die Datenquelle aus, deren Synchronisierungsstatus fehlgeschlagen ist, und klicken Sie auf **Bearbeiten**. 1. Erweitern Sie **Erweiterte Konfiguration** und dann **Gruppeneinstellungen**. 1. Wählen Sie unter **Timestamp** die Option **Quelle** aus. Wenn Sie **Source** auswählen, wird die `timestampToReturn` Eigenschaft aus der Konfiguration entfernt. Diese Einstellung ermöglicht standardmäßig die Erfassung des Datenquellen-Zeitstempels von Ihrem Gerät, sodass die Datenquelle mit der IoT SiteWise OPC UA-Collector-Komponente synchronisiert werden kann. 1. Wählen Sie **Speichern**. ### Konvertierte Datentypen sind nicht enthalten Wenn bei der Konvertierung von nicht unterstützten OPC UA-Datentypen in Zeichenketten ein Fehler auftritt AWS IoT SiteWise, kann das mehrere Gründe haben: + Der Datentyp, den Sie konvertieren möchten, ist ein komplexer Datentyp. Komplexe Datentypen werden nicht unterstützt. + Wenn **Destinations** as **AWS IoT SiteWise Buffered mit Amazon S3 verwendet** wird, wird der vollständige Zeichenkettenwert in Dateien beibehalten, die in einen Amazon S3 S3-Bucket übertragen werden. Wenn Sie später Daten aufnehmen AWS IoT SiteWise, werden vollständige Zeichenkettenwerte, die länger als 1024 Byte sind, zurückgewiesen. ### Probleme mit dem Trust Store Wenn Sie in SiteWise Edge auf Probleme im Zusammenhang mit Trust Stores stoßen, sollten Sie die folgenden Schritte zur Fehlerbehebung in Betracht ziehen: + Stellen Sie sicher, dass das AWS IoT Greengrass Root-CA-Zertifikat in den entsprechenden Trust Stores vorhanden und korrekt formatiert ist + Stellen Sie sicher, dass das KeyStore Java-Passwort korrekt festgelegt ist und SiteWise Edge-Komponenten darauf zugreifen können + Vergewissern Sie sich, dass alle benutzerdefinierten Zertifikate (z. B. für HTTPS-Proxys) das richtige Format (normalerweise PEM) haben und ordnungsgemäß in die Trust Stores importiert wurden + Stellen Sie sicher, dass die Trust Stores über die richtigen Dateiberechtigungen verfügen und für die Edge-Prozesse zugänglich sind SiteWise + Überprüfen Sie die SiteWise Edge-Protokolle auf SSL/TLS damit verbundene Fehler, die auf Probleme mit dem Trust Store hinweisen können + Testen Sie SSL/TLS Verbindungen unabhängig voneinander mithilfe von Tools wie `openssl` der Überprüfung der Trust Store-Funktionalität ### Probleme bei der Installation mit einem Proxy Wenn bei der Proxykonfiguration Probleme auftreten, sollten Sie die folgenden Schritte zur Fehlerbehebung in Betracht ziehen: + Stellen Sie sicher, dass die Proxy-URL korrekt formatiert ist und das richtige Schema (`http://`oder`https://`) enthält + Stellen Sie sicher, dass alle Proxy-Anmeldeinformationen URL-codiert sind, wenn sie Sonderzeichen enthalten + Vergewissern Sie sich, dass die Liste ohne Proxy alle erforderlichen lokalen Adressen und Dienstendpunkte enthält AWS + Stellen Sie bei HTTPS-Proxys sicher, dass das bereitgestellte CA-Zertifikat im PEM-Format vorliegt + Suchen Sie in den Installationsprotokollen nach spezifischen Fehlermeldungen, die möglicherweise auf die Ursache des Problems hinweisen + Testen Sie die Proxyverbindung unabhängig voneinander, um sicherzustellen, dass sie ordnungsgemäß funktioniert ## Fehlerbehebung bei der AWS IoT SiteWise Edge-Anwendung auf Siemens Industrial Edge Um Probleme mit der AWS IoT SiteWise Edge-Anwendung auf Ihrem Siemens Industrial Edge Gerät zu beheben, können Sie über die Portale Siemens Industrial Edge Management oder Siemens Industrial Edge Device (IED) auf die Protokolle für die Anwendung zugreifen. Weitere Informationen finden Sie in der Siemens-Dokumentation unter [Protokolle herunterladen](https://docs.eu1.edge.siemens.cloud/build_a_device/device_building/concepts/howto-download-edge-device-logs.html). ### Meine Daten werden nicht angezeigt in AWS IoT SiteWise + Stellen Sie sicher, dass es keine Probleme mit Ihren Databus Benutzern gibt und dass das Häkchensymbol für **Databus\$1Configuration grün statt** grau ist. + Möglicherweise verwenden Sie keine Version, Siemens Industrial Edge Management die enthält. Secure Storage Aktualisieren Sie Ihre Version von Siemens OS. Weitere Informationen finden Sie unter [Siemens Secure Storageund die AWS IoT SiteWise Edge-Anwendung](sitewise-edge-on-siemens.md#sa-secure-storage). ### Ich sehe „Konfigurationsdatei fehlt AWS\$1REGION“ in den Protokollen Wenn Sie `Config file missing AWS_REGION` in den Siemens-Protokollen sehen, dass die JSON-Datei der Konfigurationsdatei beschädigt wurde. Sie müssen eine neue Konfigurationsdatei erstellen. Folgen Sie den Schritten unter[Erstellen Sie ein Gateway für Siemens Industrial Edge](sa-create-config.md), um eine neue Konfigurationsdatei zu erstellen. ### In der Edge-Gateway-Konfiguration wird die Fehlermeldung „Nicht synchron“ angezeigt Wenn Sie nach Abschluss der Bereitstellung eine `Out of sync` Fehlermeldung auf Ihrem Siemens Industrial Edge Gateway sehen, bedeutet dies, dass die SiteWise IoT-Publisher-Komponente nicht mit Ihrem Gateway synchronisiert ist. Die SiteWise IoT-Publisher-Komponente arbeitet im Hintergrund auf Siemens Industrial Edge Gateways, um MQTT-Themenfunktionen bereitzustellen. Wir haben Siemens Industrial Edge Gateways so aktualisiert, dass sie den `iotsitewise:publisher:3` Capability-Namespace verwenden und nicht. `iotsitewise:publisher:2` Sie können auf die neueste Version des Herausgebers aktualisieren, um dieses Problem zu beheben. **Um auf die neueste Version des SiteWise IoT-Publishers zu aktualisieren** 1. Navigieren Sie zur [AWS IoT SiteWise -Konsole](https://console.aws.amazon.com/iotsitewise/). 1. Wählen Sie im Navigationsbereich **Edge-Gateways** aus. 1. Wählen Sie das Siemens Industrial Edge Gateway aus, das bearbeitet werden soll. 1. Wählen Sie im Abschnitt **Edge-Funktionen** die Option **Softwareversionen anzeigen** aus. 1. Wählen Sie im Dropdownmenü SiteWise Publisher die neueste Version des **IoT-Publishers** aus. 1. Wählen Sie **Fertig** aus. ## Fehlerbehebung bei Open-Source-Integrationen am Edge Dieser Abschnitt enthält Lösungen für häufig auftretende Probleme, die bei der Integration von Open-Source-Tools in Edge auftreten können. SiteWise **Anmerkung** Node-RED®, InfluxDB® und Grafana® sind keine Anbieter oder Lieferanten für Edge. SiteWise ### Verbindungsprobleme Node-RED kann keine Verbindung zum MQTT-Broker herstellen Stellen Sie sicher, dass der MQTT-Broker auf dem angegebenen Port läuft und darauf zugegriffen werden kann. Überprüfen Sie Ihre Netzwerkkonfiguration und stellen Sie sicher, dass die Broker-Adresse korrekt ist. Um den Status des MQTT-Brokers zu überprüfen, führen Sie Folgendes aus: ``` docker ps | grep emqx ``` InfluxDB-Verbindungsfehler Stellen Sie sicher, dass Ihr Authentifizierungstoken gültig ist und dass Sie die richtigen Organisations- und Bucket-Namen angegeben haben. Überprüfen Sie, ob InfluxDB läuft und darauf zugegriffen werden kann. Um den InfluxDB-Status zu überprüfen, führen Sie Folgendes aus: ``` curl -I http://localhost:8086 ``` Grafana kann keine Verbindung zu InfluxDB herstellen Stellen Sie sicher, dass die InfluxDB-Datenquellenkonfiguration in Grafana korrekt ist, einschließlich URL, Authentifizierungstoken, Organisation und Bucket. ### Probleme mit dem Datenfluss Es erscheinen keine Daten in AWS IoT SiteWise Vergewissern Sie sich, dass Ihr Eigenschaftsalias im Node-RED-Flow dem erwarteten Format entspricht. Stellen Sie sicher, dass die MQTT-Themenstruktur korrekt ist und dass das SiteWise Edge-Gateway ordnungsgemäß konfiguriert ist, um Daten vom MQTT-Broker zu empfangen. In InfluxDB sind keine SiteWise Edge-Daten gespeichert Stellen Sie sicher, dass der Node-RED-Retentionsfluss korrekt konfiguriert ist und dass der InfluxDB-Writer-Knoten über die richtigen Bucket- und Messeinstellungen verfügt. Überprüfen Sie die Node-RED-Debug-Ausgabe auf Fehler. Datenformatfehler Stellen Sie sicher, dass Ihre Datentransformationsfunktionen Daten korrekt zwischen Formaten konvertieren. Verwenden Sie die Node-RED-Debug-Knoten, um die Daten in jeder Phase des Datenflusses zu überprüfen. ### Leistungsprobleme Hohe CPU- oder Speicherauslastung Überwachen Sie die Ressourcennutzung und passen Sie die Konfiguration Ihrer Komponenten nach Bedarf an. Erwägen Sie, die Häufigkeit der Datenerfassung zu reduzieren oder Datenfilterung zu implementieren, um die Verarbeitungslast zu reduzieren. Um die Ressourcennutzung zu überwachen, führen Sie folgenden Befehl aus: ``` docker stats ``` Langsames Laden des Grafana-Dashboards Optimieren Sie Ihre InfluxDB-Abfragen und erwägen Sie, Ihren Dashboard-Panels Zeitbeschränkungen hinzuzufügen. Reduzieren Sie die Anzahl der angezeigten Datenpunkte, indem Sie geeignete Aggregationsfunktionen verwenden. ### Protokollierung und Diagnose Um Probleme zu beheben, überprüfen Sie die Protokolle für jede Komponente: Node-RED-Protokolle Zeigen Sie die Protokolle in der Node-RED-Konsole an oder führen Sie Folgendes aus: ``` docker logs node-red ``` InfluxDB-Protokolle Greifen Sie auf Protokolle zu, indem Sie Folgendes ausführen ``` docker logs influxdb ``` Grafana-Protokolle Logs anzeigen, indem Sie Folgendes ausführen: ``` docker logs grafana ``` SiteWise Edge-Protokolle Überprüfen Sie die SiteWise Edge-Gateway-Protokolle auf Probleme mit der MQTT-Verbindung und Datenverarbeitung. Weitere Informationen finden Sie unter [Fehlerbehebung bei einem SiteWise Edge-Gateway](#troubleshooting-gateway). ## Probleme beheben AWS IoT Greengrass Lösungen für viele Probleme bei der Konfiguration oder Bereitstellung Ihres SiteWise Edge-Gateways finden Sie AWS IoT Greengrass im *AWS IoT Greengrass Entwicklerhandbuch* unter [Problembehandlung](https://docs.aws.amazon.com/greengrass/v1/developerguide/gg-troubleshooting.html). AWS IoT Greengrass # Fehler bei einem AWS IoT SiteWise Portal beheben Beheben Sie häufig auftretende Probleme mit Ihren AWS IoT SiteWise Portalen. ## Benutzer und Administratoren können nicht auf das AWS IoT SiteWise Portal zugreifen Wenn Benutzer oder Administratoren nicht auf Ihr AWS IoT SiteWise Portal zugreifen können, verfügen Sie möglicherweise über eingeschränkte Berechtigungen in angehängten AWS Identity and Access Management (IAM-) Richtlinien, die erfolgreiche Anmeldungen verhindern. Sehen Sie sich die folgenden Beispiele für IAM-Richtlinien an, die zu einem Anmeldefehler führen können: **Anmerkung** Alle angehängten IAM-Richtlinien, die ein `"Condition"` Element enthalten, führen zu einem Anmeldefehler. **Beispiel 1**: Die Bedingung hier ist eine eingeschränkte IP, und dies führt zu einem Anmeldefehler. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iotsitewise:DescribePortal" ], "Resource": "*", "Condition": { "IpAddress": { "aws:SourceIp": [ "203.0.113.0/24" ] } } } ] } ``` ------ **Beispiel 2**: Die Bedingung hier ist ein eingeschlossenes Tag, und dies führt zu einem Anmeldefehler. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iotsitewise:DescribePortal" ], "Resource": "*", "Condition": { "StringLike": { "aws:ResourceTag/project": "*" } } } ] } ``` ------ Vermeiden Sie beim Hinzufügen von Benutzern oder Administratoren zum Portal die Erstellung von IAM-Richtlinien, die Benutzerberechtigungen einschränken, z. B. eingeschränkte IP-Adressen. Alle angehängten Richtlinien mit eingeschränkten Berechtigungen können keine Verbindung zum AWS IoT SiteWise Portal herstellen. # 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. # Problembehandlung bei Massenimport- und -exportvorgängen Informationen zur Behandlung und Diagnose von Fehlern, die während eines Übertragungsauftrags auftreten, finden Sie in der AWS IoT TwinMaker **GetMetadataTransferJob**API: 1. Rufen Sie nach dem Erstellen und Ausführen eines Übertragungsauftrags die **GetMetadataTransferJob**API auf: ``` aws iottwinmaker get-metadata-transfer-job \ --metadata-transfer-job-id your_metadata_transfer_job_id \ --region us-east-1 ``` 1. Der Status des Jobs ändert sich in einen der folgenden Zustände: + COMPLETED + CANCELLED + ERROR 1. Die **GetMetadataTransferJob**API gibt ein [ MetadataTransferJobProgress](https://docs.aws.amazon.com/iot-twinmaker/latest/apireference/API_MetadataTransferJobProgress.html)Objekt zurück. 1. Das **MetadataTransferJobProgress**Objekt enthält die folgenden Parameter: + **FailedCount**: Gibt die Anzahl der Assets an, die während des Übertragungsvorgangs ausgefallen sind. + **skippedCount**: Gibt die Anzahl der Assets an, die während des Übertragungsvorgangs übersprungen wurden. + **succeededCount**: Gibt die Anzahl der Assets an, die während des Übertragungsvorgangs erfolgreich waren. + **TotalCount**: Gibt die Gesamtzahl der am Übertragungsprozess beteiligten Vermögenswerte an. 1. Zusätzlich wird vom API-Aufruf ein **reportURL-Element** zurückgegeben, das eine vorsignierte URL enthält. Wenn Ihr Übertragungsauftrag Fehler enthält, die untersucht werden müssen, können Sie unter dieser URL einen vollständigen Fehlerbericht herunterladen.