SiteWise IoT-Prozessor - AWS IoT Greengrass

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.

SiteWise IoT-Prozessor

Die SiteWise IoT-Prozessorkomponente (aws.iot.SiteWiseEdgeProcessor) ermöglicht es AWS IoT SiteWise Gateways, Daten am Edge zu verarbeiten.

Mit dieser Komponente können AWS IoT SiteWise Gateways Asset-Modelle und Assets verwenden, um Daten auf Gateway-Geräten zu verarbeiten. Weitere Informationen zu AWS IoT SiteWise Gateways finden Sie unter Using AWS IoT SiteWise at the Edge im AWS IoT SiteWise Benutzerhandbuch.

Versionen

Diese Komponente hat die folgenden Versionen:

  • 3.3.x

  • 3.2.x

  • 3.1.x

  • 3.0.x

  • 2.2.x

  • 2.1.x

  • 2.0.x

Typ

Diese Komponente ist eine generische Komponente (aws.greengrass.generic). Der Greengrass-Kern führt die Lebenszyklusskripte der Komponente aus.

Weitere Informationen finden Sie unter Komponententypen.

Betriebssystem

Diese Komponente kann auf Kerngeräten installiert werden, auf denen die folgenden Betriebssysteme ausgeführt werden:

  • Linux

  • Windows

Voraussetzungen

Für diese Komponente gelten die folgenden Anforderungen:

  • Das Greengrass-Core-Gerät muss auf einer der folgenden Plattformen laufen:

    • Betriebssystem: Ubuntu 20.04 oder 18.04

      Architektur: x86_64 () AMD64

    • Betriebssystem: RedHat Enterprise Linux (8) RHEL

      Architektur: x86_64 () AMD64

    • Betriebssystem: Amazon Linux 2

      Architektur: x86_64 () AMD64

    • Betriebssystem: Windows Server 2019 oder später

      Architektur: x86_64 () AMD64

  • Das Greengrass-Core-Gerät muss eingehenden Verkehr auf Port 443 zulassen.

  • Das Greengrass-Core-Gerät muss ausgehenden Verkehr auf den Ports 443 und 8883 zulassen.

  • Die folgenden Ports sind für die Verwendung durch reserviert AWS IoT SiteWise: 80, 443, 3001, 4569, 4572, 8000, 8081, 8082, 8084, 8085, 8086, 8445, 9000, 9500, 11080 und 50010. Die Verwendung eines reservierten Ports für den Datenverkehr kann zu einem Verbindungsabbruch führen.

    Anmerkung

    Port 8087 ist nur für Version 2.0.15 und höher dieser Komponente erforderlich.

  • Die Greengrass-Geräterolle muss über Berechtigungen verfügen, die es Ihnen ermöglichen, AWS IoT SiteWise Gateways auf Ihren AWS IoT Greengrass V2 Geräten zu verwenden. Weitere Informationen finden Sie unter Anforderungen im AWS IoT SiteWise Benutzerhandbuch.

Endpunkte und Anschlüsse

Diese Komponente muss in der Lage sein, ausgehende Anfragen an die folgenden Endpunkte und Ports auszuführen, zusätzlich zu den Endpunkten und Ports, die für den Basisbetrieb erforderlich sind. Weitere Informationen finden Sie unter Zulassen von Gerätedatenverkehr über einen Proxy oder eine Firewall.

Endpunkt Port Erforderlich Beschreibung

model.iotsitewise.region.amazonaws.com

443 Ja

Informieren Sie sich über Ihre AWS IoT SiteWise Anlagen und Anlagemodelle.

edge.iotsitewise.region.amazonaws.com

443 Ja

Informieren Sie sich über die AWS IoT SiteWise Gateway-Konfiguration des Kerngeräts.

ecr.region.amazonaws.com

443 Ja

Laden Sie AWS IoT SiteWise Edge-Gateway-Docker-Images von Amazon Elastic Container Registry herunter.

iot.region.amazonaws.com

443 Ja

Holen Sie sich Geräteendpunkte für Ihre. AWS-Konto

sts.region.amazonaws.com

443 Ja

Holen Sie sich die ID von Ihrem AWS-Konto.

monitor.iotsitewise.region.amazonaws.com

443 Nein

Erforderlich, wenn Sie auf dem Kerngerät auf AWS IoT SiteWise Monitor Portale zugreifen.

Abhängigkeiten

Wenn Sie eine Komponente bereitstellen, stellt AWS IoT Greengrass auch kompatible Versionen ihrer Abhängigkeiten bereit. Das bedeutet, dass Sie die Anforderungen für die Komponente und all ihre Abhängigkeiten erfüllen müssen, um die Komponente erfolgreich bereitstellen zu können. In diesem Abschnitt werden die Abhängigkeiten für die veröffentlichten Versionen dieser Komponente sowie die semantischen Versionseinschränkungen aufgeführt, die die Komponentenversionen für jede Abhängigkeit definieren. Sie können auch die Abhängigkeiten für jede Version der Komponente in der AWS IoT Greengrass Konsole anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der Abhängigkeiten.

In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.0.x bis 2.1.x dieser Komponente aufgeführt.

-Abhängigkeit Kompatible Versionen Art der Abhängigkeit
Token-Austauschdienst >=2.0.3 <3.0.0 Hart
Stream-Manager >=2,0.3 =2.0.10 <3.0.0 Hart
Greengrass CLI >=2.3.0 <3.0.0 Hart

Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den Komponentenrezepten.

Konfiguration

Diese Komponente hat keine Konfigurationsparameter.

Lokale Protokolldatei

Diese Komponente verwendet die folgende Protokolldatei.

Linux
/greengrass/v2/logs/aws.iot.SiteWiseEdgeProcessor.log
Windows
C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeProcessor.log
Um die Protokolle dieser Komponente einzusehen
  • Führen Sie den folgenden Befehl auf dem Kerngerät aus, um die Protokolldatei dieser Komponente in Echtzeit anzuzeigen. Ersetzen Sie /greengrass/v2 oder C:\greengrass\v2 mit dem Pfad zum AWS IoT Greengrass Stammordner.

    Linux
    sudo tail -f /greengrass/v2/logs/aws.iot.SiteWiseEdgeProcessor.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeProcessor.log -Tail 10 -Wait

Lizenzen

Diese Komponente umfasst die folgende Software/Lizenzierung von Drittanbietern:

  • Apache-2.0

  • MIT

  • BSD-2-Klausel

  • BSD-3-Klausel

  • CDDL-1,0

  • CDDL-1,1

  • ISC

  • Zlib

  • GPL-3.0-mit- -Ausnahme GCC

  • Öffentliche Domäne

  • Python-2.0

  • Unicode-2015 DFS

  • BSD-1-Klausel

  • Öffnen SSL

  • EPL-1,0

  • EPL-2,0

  • GPL-2,0- with-classpath-exception

  • MPL-2,0

  • CC0-1,0

  • JSON

Diese Komponente wird im Rahmen der Greengrass Core Software-Lizenzvereinbarung veröffentlicht.

Änderungsprotokoll

In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.

Version

Änderungen

3.3.1

Neues Feature
  • SiteWise Edge wurde um optionale CORS Unterstützung erweitertAPIs, wodurch die ursprungsübergreifende Nutzung von Ressourcen verbessert wird. Diese Funktion verbessert die Flexibilität für Webanwendungen, die APIs mit dem interagieren.

3.3.0

Leistungsverbesserungen
  • Optimierter Cache-Aktualisierungsmechanismus zur Reduzierung der I/O-Auslastung zwischen AWS IoT SiteWise Asset-Synchronisierungen, indem nur Einträge für neue oder aktualisierte Assets aktualisiert werden.

  • Reduzierter Speicherbedarf für die Verwaltung eines Caches mit einer großen Anzahl synchronisierter Asset-Eigenschaften.

Fehlerkorrekturen und Verbesserungen
  • Es wurden Protokolle für die Aufnahme einzelner Eigenschaftswerte unterdrückt, wenn keine Aufnahmefehler aufgetreten sind. Dadurch wird das Protokollrauschen bei hohen Aufnahmeraten reduziert.

  • Die Lesbarkeit von Protokollen wurde verbessert, indem für bestimmte Protokolleinträge eine menschenlesbare Formatierung verwendet wurde.

  • Unterstützung für Java 17 und höher hinzugefügt.

3.2.1

Fehlerkorrekturen und Verbesserungen
  • Behebung eines Problems, bei dem die AWS IoT SiteWise API Anrufe nicht synchron mit SiteWise Edge paginiert wurden.

  • Problem behoben, bei dem die MessageRemaining.SiteWise_Edge_Stream Metrik nicht mehr veröffentlicht wurde.

  • Die folgenden CloudWatch Metriken wurden hinzugefügt, um die Verbindung mit dem MQTT Broker zu überwachen.

    • IoTSiteWiseProcessor.IsConnectedToMqttBroker

    • IoTSiteWiseProcessor.NumberOfSubscriptionsToMqttBroker

    • IoTSiteWiseProcessor.NumberOfUniqueMqttTopicsReceived

    • IoTSiteWiseProcessor.MqttMessageReceivedSuccessCount

    • IoTSiteWiseProcessor.MqttReceivedSuccessBytes

    Weitere Informationen zu diesen Metriken finden Sie unter AWS IoT Greengrass Version 2 Gateway-Metriken.

3.2.0

Leistungsverbesserungen
  • Optimieren Sie API Dienste so, dass sie einen geringeren Speicherbedarf haben und weniger Festplattenspeicher für die Installation benötigen

    • Dadurch wird der anfängliche Speicherverbrauch um 2 GB reduziert (verwendet jetzt 7,5 GB Arbeitsspeicher beim Start, 16 GB werden jedoch weiterhin empfohlen) und die Download-Größe um 500 MB reduziert (erfordert jetzt einen Download von 1,4 GB) für die gesamte Komponente.

Neue Features
  • GetAssetPropertyValueAggregatesAPIunterstützt jetzt 15-minütige Aggregationsfenster am Edge.

  • Die Ports 8081 und 8082 müssen nicht mehr verfügbar sein, damit diese Komponente ordnungsgemäß ausgeführt werden kann.

    Anmerkung

    Der lokale Endpunkt für die AWS IoT SiteWise DatenebeneAPIs, z. B.get-asset-property-value, wird von http://localhost:8081 zu geändert. http://localhost:11080/data Der lokale Endpunkt für die AWS IoT SiteWise Steuerungsebene APIslist-asset-models, z. B., wird von http://localhost:11080 zu geänderthttp://localhost:11080/control. AWS empfiehlt immer, die SiteWise HTTPS Edge-Gateway-Endpunkte zu verwenden. Diese Endpunkte haben sich nicht geändert.

Fehlerkorrekturen und Verbesserungen
  • Bei der Synchronisierung von AWS IoT SiteWise werden Ressourcen nun in einen gültigen Status versetzt, falls die vorherige Synchronisierung unterbrochen wurde. Dadurch werden Probleme behoben, bei denen einige Ressourcen nach einem erzwungenen Neustart beschädigt wurden.

  • Behebt ein seltenes Problem, bei dem eine Ressource am Edge beschädigt werden kann, wenn sie während der Synchronisierung geändert wird. Die Synchronisierung schlägt jetzt fehl, wenn dieser Zustand erkannt wird, und die Ressource wird bei der nächsten Synchronisierung erneut versucht.

  • Behebt ein Problem, durch das der HTTP Endpunkt extern aufgerufen werden konnte. APIs HTTPSKann jetzt nur verwendet werden, um APIs außerhalb der lokalen Loopback-Adresse anzurufen.

  • ListAssetsAPIzeigt jetzt die Asset-Hierarchien für Assets, die am Edge gespeichert sind.

  • Behebt ein Problem, bei dem das Data Processing Pack unter Windows nicht neu gestartet, aktualisiert oder herabgestuft werden konnte.

  • Behebt einen Fehler im Data Processing Pack für Windows OS, der Kunden daran hinderte, Anmeldeinformationen für die Verbindung mit einem MQTT Broker zu verwenden.

3.1.3

Fehlerkorrekturen und Verbesserungen
  • Behebung eines Problems, bei dem das Data Processing Pack fälschlicherweise eine erfolgreiche Synchronisierung meldete, obwohl einige Ressourcen tatsächlich ausgefallen sind.

  • Erlauben Sie, dass mehrere Objekte denselben Namen haben, solange sie nicht dasselbe übergeordnete Objekt haben.

3.1.1

Fehlerkorrekturen und Verbesserungen
  • Behebung eines Problems, bei dem die SigV4-Anfrage aufgrund einer nicht übereinstimmenden Zeitzone fehlschlägt.

  • Problem behoben, bei dem Transformations- und Metrikeigenschaften nicht mehr berechnet werden, wenn sie nach dem Neustart auf Attributen basieren.

  • Aktiviert die Unterstützung der benutzerdefinierten Stream Manager-Port-Konfiguration.

  • Behebt ein Problem, bei dem Eigenschaften, die mit dem Edge synchronisiert wurden, möglicherweise nicht mehr aktualisiert werden.

3.1.0

Fehlerkorrekturen und Verbesserungen
  • Problem behoben, bei dem ListAssetModels API das nächste Token nicht generiert werden konnte.

3.0.0

Neue Features
  • Ermöglicht die Unterstützung der Datenaufnahme durch einen MQTT Broker.

2.2.1

Fehlerkorrekturen und Verbesserungen
  • Passen Sie den Synchronisierungsprozess an, um die Datenspeicherung auf der Steuerungsebene besser an die Funktionsweise der Cloud anzupassen. Dies wirkt sich geringfügig auf das Upgrade aus.

    Anmerkung

    Daten der Steuerungsebene, die mit Version 2.2.1 oder höher synchronisiert wurden, sind nicht mit früheren Versionen kompatibel. Um ein Downgrade auf frühere Versionen durchzuführen, müssen Sie eine Neuinstallation durchführen. Dies hat keine Auswirkungen auf Upgrades. Daten, die auf früheren Versionen synchronisiert wurden, funktionieren mit Version 2.2.1.

  • Zusätzliche Änderungen an der AWS Anmeldeinformationskette zur Priorisierung AWS IoT Greengrass V2 von Anmeldeinformationen.

2.1.37

Fehlerkorrekturen und Verbesserungen
  • Verwerfen Sie den dependency-routing-service Prozess und übertragen Sie seine Funktionalität in den property-state-service Prozess, um den Ressourcenverbrauch durch die Kommunikation zwischen Prozessen zu reduzieren.

  • Erhöhen Sie das maximale Ergebnislimit für get-asset-property-value-history API auf 20.000, sodass es dem von verwendeten Grenzwert entspricht. AWS IoT SiteWise

  • Behebt ein Problem, bei dem das nächste Token nicht in paginierten Ergebnissen angegeben wurde, get-asset-property-value-history API obwohl kein maximales Ergebnislimit angegeben wurde.

2.1.35

Fehlerkorrekturen und Verbesserungen
  • Ändert die AWS Anmeldeinformationskette, um Anmeldeinformationen zu priorisieren AWS IoT Greengrass .

  • Behebt ein Problem mit der Kontoerkennung bei der Bereitstellung als Teil einer Dinggruppe AWS IoT .

2.1.34

Fehlerkorrekturen und Verbesserungen
  • Passt Metrik-/Transformationsberechnungen an, um Multithreading unter Linux zu verwenden. Windows führt aus Kompatibilitätsgründen weiterhin Single-Thread-Berechnungen durch.

  • Behebt ein Problem, bei dem metrische Berechnungen in einigen Berechnungsfenstern fehlten.

2.1.33

Fehlerkorrekturen und Verbesserungen
  • Behebt ein Problem mit der Meldung von Fehlerzuständen an die Greengrass-Konsole.

2.1.32

Fehlerkorrekturen und Verbesserungen
  • Integriert die Unterstützung für benutzerdefinierte Benutzernamen und Gruppen.

2.1.31

Fehlerkorrekturen und Verbesserungen
  • Integriert die Unterstützung für die Berechnung des zeitgewichteten Durchschnitts und der zeitgewichteten Standardabweichung für Daten, die modelliert wurden. AWS IoT SiteWise

2.1.29

Fehlerkorrekturen und Verbesserungen
  • Fügt Unterstützung für das Filtern von Assets in der Edge-Funktionalität hinzu.

2.1.28

Fehlerkorrekturen und Verbesserungen
  • Optimiert die Ressourcensynchronisierung, sodass eine große Anzahl von Assets vom Netzwerkrand bis zum Netzwerkrand synchronisiert AWS Cloud werden kann.

2.1.24

Fehlerkorrekturen und Verbesserungen
  • Behebt ein Problem, das dazu führte, dass das Dashboard verschwand, wenn eine Ressource zum zweiten Mal synchronisiert wurde.

2.1.23

Fehlerkorrekturen und Verbesserungen
  • Es wurde ein Timeout für den aws.iot.SiteWiseEdgeProcessor Installationsvorgang hinzugefügt, um Installationsfehler zu vermeiden, wenn die Internetverbindung langsam ist.

  • Optimierte Ressourcensynchronisierung zur Verbesserung der Synchronisierungseffizienz zwischen Cloud und Edge.

2.1.21

Warnung

Ein Upgrade von 2.0.x auf 2.1.x führt zum Verlust lokaler Daten.

Neue Features
  • Fügt Unterstützung für Windows Server 2019 oder höher hinzu.

  • Entfernt Docker für Linux-basierte Betriebssysteme.

2.0.16

Diese Version enthält Fehlerkorrekturen und Verbesserungen.

2.0.15

Fehlerkorrekturen und Verbesserungen
  • Ändert den Port, den diese Komponente für API Ressourcensynchronisierungsvorgänge verwendet, von 8085 auf 8087. Aus diesem Grund muss für diese Komponente jetzt Port 8087 verfügbar sein. Für diese Komponente muss weiterhin Port 8085 verfügbar sein.

  • Aktualisiert die AWS OpsHub Authentifizierung, sodass nicht autorisierte Benutzer sich nicht anmelden können, anstatt wenn ein Benutzer versucht, API Operationen aufzurufen.

2.0.14

Diese Version enthält Fehlerkorrekturen und Verbesserungen.

2.0.13

Fehlerkorrekturen und Verbesserungen
  • Behebt ein Problem, sodass diese Komponente, wenn sie Daten an Amazon CloudWatch Metrics meldet, jetzt korrekt angibt, welche Daten nicht modelliert sind.

2.0.9

Fehlerkorrekturen und Verbesserungen
  • Verbessert die Zuverlässigkeit beim Erstellen und Aktualisieren von AWS IoT SiteWise Ressourcen auf dem Kerngerät.

  • Fügt zusätzliche lokale API Operationen hinzu, mit denen Sie überwachen können, welche Komponenten auf dem Kerngerät installiert sind, welche Version die einzelnen Komponenten haben und welchen Status die einzelnen Komponenten haben. Sie können diese Informationen auf der Registerkarte Einstellungen in der AWS IoT SiteWise Anwendung AWS OpsHub for auf dem Kerngerät einsehen.

  • Fügt einen Integritätsstatus für die Docker-Container hinzu, die diese Komponente ausführt. Sie können den docker ps Befehl ausführen, um den Gesundheitsstatus der Container anzuzeigen.

2.0.7

Fehlerkorrekturen und Verbesserungen
  • Behebt die Unterstützung für die Anzeige von AWS IoT SiteWise Monitor Portalen auf dem Kerngerät.

2.0.6

Fehlerkorrekturen und Verbesserungen
  • Behebt die AWS IoT SiteWise statetime()earliest(), und latest() -Funktionen, die diese Komponente auf dem Kerngerät berechnet.

2.0.5

Fehlerkorrekturen und Verbesserungen
  • Fügt Unterstützung für die AWS IoT SiteWise pretrigger() Funktion in Transformationen hinzu, die diese Komponente auf dem Kerngerät berechnet.

  • Ändert den Pfad, in dem diese Komponente die Lightweight Directory Access Protocol (LDAP) -Konfiguration für die Authentifizierung speichert.

2.0.2

Erste Version

Weitere Informationen finden Sie auch unter