Fehlerbehebung bei einem SiteWise Edge-Gateway - AWS IoT SiteWise

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.

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.

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 Management Console , um die Protokolldateien Ihres SiteWise Edge-Gateways einzusehen. Weitere Informationen finden Sie unter Verwenden Sie Amazon CloudWatch Logs.

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

Behebung von Problemen mit dem SiteWise Edge-Gateway

Verwenden Sie die folgenden Informationen, um Probleme mit dem SiteWise Edge-Gateway zu beheben.

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.

  2. Wählen Sie im Navigationsbereich unter AWS IoT GreengrassDeployments aus.

  3. Wählen Sie in der Liste Bereitstellungen die Bereitstellung aus, die Sie überarbeiten möchten.

  4. Wählen Sie Überarbeiten aus.

  5. Wählen Sie auf der Seite „Ziel angeben“ die Option Weiter aus.

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

  7. Wählen Sie Weiter aus.

  8. Wählen Sie auf der Seite Komponenten konfigurieren die Option Weiter aus.

  9. Wählen Sie auf der Seite Erweiterte Einstellungen konfigurieren die Option Weiter aus.

  10. 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 Verwalten Sie Datenströme für AWS IoT SiteWise.

      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 .

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

  • ThrottlingExceptionoder 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 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.

  2. Wählen Sie im Navigationsbereich Edge-Gateways aus.

  3. Wählen Sie das SiteWise Edge-Gateway aus, das mit dem Dashboard verbunden ist.

  4. Wählen Sie unter Datenquellen die Option Bearbeiten aus.

  5. Wählen Sie einen neuen Quellennamen und klicken Sie auf Speichern, um Ihre Änderung zu bestätigen.

  6. Ü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 /error 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 angezeigtOpenJDK 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

Ich sehe 'SESSION_TAKEN_OVER' 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: 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.

    2. Wählen Sie im Navigationsbereich Edge-Gateways aus.

    3. Wählen Sie das SiteWise Edge-Gateway aus, das Sie wiederverwenden möchten.

    4. Wählen Sie die Registerkarte Updates.

    5. Wählen Sie eine andere Publisher-Version und anschließend Bereitstellen.

Folgen Sie den Schritten unterErstellen Sie ein Gateway für Siemens Industrial Edge, um eine neue Konfigurationsdatei zu erstellen.

Ich sehe den Status „SYNC_FAILED“, wenn ich versuche, die Zeitstempeleinstellung in einer Eigenschaftsgruppe auf einer OPC UA-Datenquelle zu konfigurieren

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, einen fehlgeschlagenen Synchronisierungsstatus der Datenquelle 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 unterAktualisieren Sie die Version einer Komponente AWS IoT SiteWise. 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.

  2. Wählen Sie im Navigationsbereich Edge-Gateways aus.

  3. Wählen Sie das zu bearbeitende Gateway aus.

  4. Wählen Sie im Abschnitt Datenquellen die Datenquelle aus, deren Synchronisierungsstatus fehlgeschlagen ist, und klicken Sie auf Bearbeiten.

  5. Erweitern Sie Erweiterte Konfiguration und dann Gruppeneinstellungen.

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

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

  • Vergewissern Sie sich, 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://oderhttps://) 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.

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

Ich sehe „Konfigurationsdatei fehlt AWS_REGION“ 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 unterErstellen Sie ein Gateway für Siemens Industrial Edge, 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.

  2. Wählen Sie im Navigationsbereich Edge-Gateways aus.

  3. Wählen Sie das zu Siemens Industrial Edge bearbeitende Gateway aus.

  4. Wählen Sie im Abschnitt Edge-Funktionen die Option Softwareversionen anzeigen aus.

  5. Wählen Sie im Dropdownmenü SiteWise Publisher die neueste Version des IoT-Publishers aus.

  6. Wählen Sie Erledigt 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.

Fehler im Datenformat

Stellen Sie sicher, dass Ihre Datentransformationsfunktionen Daten zwischen Formaten korrekt konvertieren. Verwenden Sie die Node-RED-Debug-Knoten, um die Daten in jeder Phase des Datenflusses zu überprüfen.

Probleme mit der Leistung

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.

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. AWS IoT Greengrass