View a markdown version of this page

SiteWise IoT-Herausgeber - AWS IoT Greengrass
VersionenTypBetriebssystemVoraussetzungenAbhängigkeitenKonfigurationEingabedatenLokale ProtokolldateiProblembehandlung und DebuggingLizenzenÄnderungsprotokollWeitere Informationen finden Sie auch unter

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

Die SiteWise IoT-Publisher-Komponente (aws.iot.SiteWiseEdgePublisher) ermöglicht AWS IoT SiteWise Gateways den Export von Daten vom Edge zum AWS Cloud.

Weitere Informationen zu AWS IoT SiteWise Gateways finden Sie im AWS IoT SiteWise Benutzerhandbuch unter AWS IoT SiteWise Using at the Edge.

Versionen

Diese Komponente hat die folgenden Versionen:

  • 4.1.x

  • 4.0.x

  • 3.2.x

  • 3.1.x

  • 3.0.x

  • 2.4.x

  • 2.3.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 Lifecycle-Skripte 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 18.04 oder höher

      Architektur: x86_64 (AMD64) oder ARMv8 (Aarch64)

    • Betriebssystem: Red Hat Enterprise Linux (RHEL) 8

      Architektur: x86_64 (AMD64) oder ARMv8 (Aarch64)

    • Betriebssystem: Amazon Linux 2

      Architektur: x86_64 (AMD64) oder ARMv8 (Aarch64)

    • Betriebssystem: Debian 11

      Architektur: x86_64 (AMD64) oder ARMv8 (Aarch64)

    • Betriebssystem: Windows Server 2019 oder höher

      Architektur: x86_64 (AMD64)

  • Das Greengrass-Core-Gerät muss eine Verbindung zum Internet herstellen.

  • Das Greengrass-Core-Gerät muss autorisiert sein, um die iotsitewise:BatchPutAssetPropertyValue Aktion auszuführen. Weitere Informationen finden Sie unter Autorisieren von Kerngeräten für die Interaktion mit AWS Diensten.

    Beispiel Berechtigungsrichtlinie
    JSON
    {
    "Version":"2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "iotsitewise:BatchPutAssetPropertyValue",
            "Resource": "*"
        }
    ]
}

Endpunkte und Ports

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 Geräteverkehr über einen Proxy oder eine Firewall zulassen.

Endpoint Port Erforderlich Description

data.iotsitewise.region.amazonaws.com

 443 Ja

Veröffentlichen Sie Daten in. AWS IoT SiteWise

Abhängigkeiten

Wenn Sie eine Komponente bereitstellen, werden AWS IoT Greengrass auch kompatible Versionen ihrer Abhängigkeiten bereitgestellt. Das bedeutet, dass Sie die Anforderungen für die Komponente und alle ihre Abhängigkeiten erfüllen müssen, um die Komponente erfolgreich bereitzustellen. 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 die Abhängigkeiten für jede Version der Komponente auch 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.2.x dieser Komponente aufgeführt.

-Abhängigkeit Kompatible Versionen Typ der Abhängigkeit
Nukleus von Greengrass > =2,3,0<3,0,0 Hart
Stream-Manager =2,3,0 =200,10<3,0.0 Hart

Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Komponentenrezeptreferenz. ComponentDependencies

Konfiguration

Diese Komponente hat keine Konfigurationsparameter.

Sie können die AWS IoT SiteWise Konsole oder API verwenden, um die SiteWise IoT-Publisher-Komponente zu konfigurieren. Weitere Informationen finden Sie unter Schritt 3: Publisher konfigurieren — optional im AWS IoT SiteWise Benutzerhandbuch.

Eingabedaten

Diese Komponente liest PutAssetPropertyValueEntry Nachrichten aus dem AWS IoT Greengrass Stream Manager. Weitere Informationen finden Sie unter PutAssetPropertyValueEntry in der AWS IoT SiteWise -API-Referenz.

Lokale Protokolldatei

Diese Komponente verwendet die folgende Protokolldatei.

Linux
/greengrass/v2/logs/aws.iot.SiteWiseEdgePublisher.log
Windows
C:\greengrass\v2\logs\aws.iot.SiteWiseEdgePublisher.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 durch den Pfad zum AWS IoT Greengrass Stammordner.

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

Problembehandlung und Debugging

Diese Komponente enthält ein neues Ereignisprotokoll, das Kunden bei der Identifizierung und Behebung von Problemen hilft. Die Protokolldatei ist von der lokalen Protokolldatei getrennt und befindet sich im folgenden Verzeichnis. Ersetzen Sie /greengrass/v2 oder C:\greengrass\v2 durch den Pfad zum AWS IoT Greengrass Stammordner.

Linux
/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/logs/IotSiteWisePublisherEvents.log
Windows
C:\greengrass\v2\work\aws.iot.SiteWiseEdgePublisher\logs\IotSiteWisePublisherEvents.log

Dieses Protokoll enthält detaillierte Informationen und Anweisungen zur Problembehandlung. Informationen zur Fehlerbehebung werden zusammen mit der Diagnose bereitgestellt. Sie enthalten eine Beschreibung, wie das Problem behoben werden kann, und manchmal auch Links zu weiteren Informationen. Zu den Diagnoseinformationen gehören die folgenden:

  • Schweregrad

  • Zeitstempel

  • Zusätzliche ereignisspezifische Informationen

Beispiel Beispielprotokoll
accountBeingThrottled:
  Summary: Data upload speed slowed due to quota limits
  Level: WARN
  Timestamp: '2023-06-09T21:30:24.654Z'
  Description: The IoT SiteWise Publisher is limited to the "Rate of data points ingested"
    quota for a customers account. See the associated documentation and associated
    metric for the number of requests that were limited for more information. Note
    that this may be temporary and not require any change, although if the issue continues
    you may need to request an increase for the mentioned quota.
  FurtherInformation:
  - https://docs.aws.amazon.com/iot-sitewise/latest/userguide/quotas.html
  - https://docs.aws.amazon.com/iot-sitewise/latest/userguide/troubleshooting-gateway.html#gateway-issue-data-streams
  AssociatedMetrics:
  - Name: TotalErrorCount
    Description: The total number of errors of this type that occurred.
    Value: 327724.0
  AssociatedData:
  - Name: AggregatePropertyAliases
    Description: The aggregated property aliases of the throttled data.
    FileLocation: /greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/./logs/data/AggregatePropertyAliases_1686346224654.log

Lizenzen

Diese Komponente wird im Rahmen des Greengrass Core-Softwarelizenzvertrags veröffentlicht.

Änderungsprotokoll

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

Version

Änderungen

4.1.4
Fehlerbehebungen und Verbesserungen

  • Der SiteWise IoT-Publisher meldet jetzt Systemintegritätskennzahlen wie Speicher- und CPU-Auslastung des SiteWise IoT-Publishers an CloudWatch.

  • Die Fehlerberichterstattung wurde aktualisiert, AWS IoT Greengrass sodass der SiteWise IoT-Publisher neu gestartet wird, wenn der Startworkflow teilweise ausfällt.

4.1.3
Fehlerbehebungen und Verbesserungen

  • Behebt ein Speicherleck beim Datenprüfvorgang.

  • Behebt Sicherheitslücken.

4.1.2
Fehlerbehebungen und Verbesserungen

  • Behebt ein Problem beim Synchronisieren großer Konfigurationen.

  • Verzögerungen beim Abonnement wirken sich nicht AWS IoT Core mehr auf den Startvorgang aus.

  • Verzögerungen bei der Initialisierung von Checkpoints wirken sich nicht mehr auf den Startvorgang aus.

4.1.1
Fehlerbehebungen und Verbesserungen

  • Behebt ein Problem, das zu einer hohen CPU- und Speicherauslastung auf Classic-Streams und V2-Gateways führt, wenn nach einem Neustart des Publishers Daten über ein AWS IoT SiteWise gepuffertes Amazon S3-Ziel gesendet werden.

  • Fügt Unterstützung für das Überschreiben des Standardverhaltens bei der Komponentenprotokollierung hinzu, indem eine optionale Datei erstellt wird, die sich unter: befindet. /greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/log4j2.xml

4.1.0
Neue Features

  • Fügt ein Befehlszeilentool zur Verwaltung integrierter EMQX-MQTT-Broker-Benutzer hinzu. Diese Schnittstelle ermöglicht die Verwaltung von Benutzerkonten und konfiguriert Zugriffskontrollrichtlinien für die Veröffentlichung und Abonnementberechtigungen von MQTT-Themen.

Fehlerbehebungen und Verbesserungen

  • Korrigiert die Berechnung, die bestimmt, wie viele eindeutige Aliase in eine einzelne Parquet-Datei mit gepufferter Aufnahme passen.

4.0.3
Fehlerbehebungen und Verbesserungen

  • Aktualisiert das Maximum an eindeutigen Aliasen pro AWS IoT SiteWise gepufferter Aufnahmedatei, sodass das Cloud-Limit von 10.000 erreicht wird.

  • Behebt ein AWS IoT Greengrass Logging-Problem, das fälschlicherweise ungültige Dienststatus meldet.

  • Fügt eine Validierung hinzu, um doppelte Stream-Namen in Amazon S3-Zielkonfigurationen in Classic-Streams, V2-Gateways zu verhindern.

  • Behebt ein Kompatibilitätsproblem mit AWS IoT SiteWise gepufferter Aufnahme in nicht standardmäßigen Partitionen. AWS

  • Behebt ein Problem, das zu doppelter Datenaufnahme führt.

4.0.2
Fehlerbehebungen und Verbesserungen

  • Behebt ein Problem, das das Hochladen von Daten nach Ablauf der Batch-Wartezeit verhindert.

  • Fügt eine Überprüfung hinzu, um zu überprüfen MQTT-enabled, ob jede Zielkonfiguration in V3-Gateways einzigartig ist.

4.0.1
Fehlerbehebungen und Verbesserungen

  • Behebt ein Problem, das verhindert, dass Daten hochgeladen werden, AWS IoT SiteWise wenn Sie die Konfiguration für die maximale Batch-Wartezeit deaktivieren.

  • Behebt ein Problem, bei dem die IoTSiteWisePublisher.NumberOfSubscriptionsToMqttBroker Metrik die Anzahl der eindeutigen Themen, die beim MQTT-Broker abonniert wurden, falsch angibt.

4.0.0
Neue Features

Fügt Unterstützung für MQTT-enabled V3-Gateways zusätzlich zu klassischen Streams und V2-Gateways hinzu (früher bekannt als selbst gehostete SiteWise Edge-Gateways).

Fehlerbehebungen und Verbesserungen

  • Behebt ein Problem, bei dem die PublishSuccessCount Metrik negative Werte meldet.

  • Behebt ein Problem, bei dem der Publisher nicht innerhalb von 100 Sekunden startet und in den BROKEN Status wechselt.

  • Behebt Sicherheitslücken.

3.2.0
Neue Features

  • Unterstützung für die Aufnahme von Null- und NaN-Werten hinzugefügt, wenn die Aufnahme aktiviert ist. AWS IoT SiteWise Informationen zum Anzeigen oder Ändern der Null- und NaN-Konfiguration finden Sie in den AWS IoT SiteWise APIs und. DescribeStorageConfiguration PutStorageConfiguration

Fehlerbehebungen und Verbesserungen

  • Behebt Probleme, die zu beschädigten Checkpoint-Datenbankdateien führen.

  • Behebt Probleme beim Generieren doppelter Metriken.

3.1.4
Warnung

Version 3.1.4 wurde am 20. Februar 2025 eingestellt. Die Verbesserungen in dieser Version sind in späteren Versionen dieser Komponente verfügbar.

Fehlerbehebungen und Verbesserungen

  • Behebt Probleme, die nach dem Offline-Betrieb zu längeren Startzeiten als erwartet führen konnten.

3.1.3
Fehlerbehebungen und Verbesserungen

  • Behebt ein Problem, bei dem die Ereignisprotokolldatei unter erstellt /greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/logs/IoTSiteWisePublisherEvents.log wurde, aber keine Ereignisse protokolliert wurden.

  • Fügt die folgenden CloudWatch Metriken zur Überwachung der Verbindung mit dem MQTT-Broker hinzu:

    • IoTSiteWisePublisher.IsConnectedToMqttBroker

    • IoTSiteWisePublisher.NumberOfSubscriptionsToMqttBroker

    • IoTSiteWisePublisher.NumberOfUniqueMqttTopicsReceived

    • IoTSiteWisePublisher.MqttMessageReceivedSuccessCount

    • IoTSiteWisePublisher.MqttReceivedSuccessBytes

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

  • Behebt ein Problem, bei dem die BatchCreateJob API immer noch aufgerufen wird, auch wenn das Hochladen einer Parquet-Datei auf S3 fehlschlägt.

3.1.2
Fehlerbehebungen und Verbesserungen

  • Behebt das in Version 3.1.1 eingeführte Problem der hohen CPU-Auslastung.

3.1.1
Warnung

Version 3.1.1 wurde am 12. März 2024 eingestellt. Die Verbesserungen in dieser Version sind in späteren Versionen dieser Komponente verfügbar.

Fehlerbehebungen und Verbesserungen

  • Fügt zusätzliche Protokollierung hinzu, die die betroffenen Datenaliase identifiziert, wenn ein Fehler auftritt.

  • Fügt die lokale Durchsetzung von AWS IoT SiteWise API-Grenzwerten in Bezug auf das Alter der aufgenommenen Daten hinzu.

  • Behebt das Problem, bei dem Publisher die Checkpoints der StreamManager Streams verwechselt, wenn es mehrere Amazon S3-Ziele gibt.

  • Behebt Leistungsengpässe bei der Art und Weise, wie der Publisher aus den Streams liest. StreamManager

3.1.0
Neue Features

  • Integriert die Unterstützung für die Veröffentlichung von Daten als Parquet-Dateien in Amazon S3.

  • Fügt Unterstützung für AWS IoT SiteWise gepufferte Aufnahme hinzu.

3.0.0
Fehlerbehebungen und Verbesserungen

  • Behebt Probleme im Zusammenhang mit der Proxyunterstützung.

Neue Features

  • Ermöglicht die Unterstützung der Datenaufnahme von einem MQTT-Broker.

2.4.1
Fehlerbehebungen und Verbesserungen

  • Aktivieren Sie die Komponente, damit sie mit Java Corretto 11-Versionen 11.0.20.8.1 und höher funktioniert. Die Komponentenversionen 2.4.0 und 2.3.3 zeigen die "Could not find or load main class" Fehlermeldung an, wenn sie mit Java Corretto Version 11.0.20.8.1 verwendet werden.

2.4.0
Neue Features

  • Fügt ein neues Ereignisprotokoll hinzu, um die Identifizierung und Behebung von Problemen zu erleichtern.

Fehlerbehebungen und Verbesserungen

  • Verbessert die Publisher-Checkpoint-Wiederherstellung.

2.3.3
Fehlerbehebungen und Verbesserungen

  • Verbessert die Fähigkeit, hohe Durchsätze zu unterstützen.

2.3.2
Fehlerbehebungen und Verbesserungen

  • Korrigiert die HTTP-Proxyunterstützung beim Herunterladen der Publisher-Konfiguration.

2.3.1
Neue Features

  • Fügt Unterstützung für die Installation von Data Collection Pack auf der Linux ARMv8-Architektur hinzu.

  • Mindestanforderungen für Linux ARMv8:

    • Arbeitsspeicher: 4 GB

    • CPU: ARM Cortex-A72 oder gleichwertige Spezifikation

2.2.3
Fehlerbehebungen und Verbesserungen

  • Entfernt den Wiederholungsversuch für eine generische Ausnahme, die nicht in der abrufbaren Ausnahmeliste enthalten war.

2.2.2
Fehlerbehebungen und Verbesserungen

  • Führt die Unterstützung für das Hochladen von Daten AWS IoT SiteWise über einen HTTP-Proxyserver wieder ein.

2.2.1
Anmerkung

Diese Version unterstützt keine HTTP-Proxykonfiguration. Version 2.2.2 und höher führen die Unterstützung für diese Funktion wieder ein.

Neue Features

  • Fügt dieser Komponente Unterstützung hinzu, um die Komprimierung beim Hochladen von Daten umzuschalten. AWS IoT SiteWise

2.2.0
Anmerkung

Diese Version unterstützt keine HTTP-Proxykonfiguration. Version 2.2.2 und höher führen die Unterstützung für diese Funktion wieder ein.

Neue Features

  • Aktualisiert diese Komponente, um Daten zu komprimieren, bevor sie an den Dienst gesendet werden. AWS IoT SiteWise

    • In den meisten Fällen reduziert diese Änderung die Bandbreitennutzung im Vergleich zu früheren Versionen dieser Komponente um 75 Prozent.

    • In den meisten Fällen erhöht diese Änderung die CPU-Auslastung um bis zu 5 Prozent. Auf Gateways, die große Datenmengen verarbeiten, kann diese Änderung die CPU-Auslastung um bis zu 15 Prozent erhöhen.

    • Diese Änderung wirkt sich nicht auf die AWS IoT SiteWise Servicegebühren oder die Nutzung des Servicekontingents aus.

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

Fehlerbehebungen und Verbesserungen

  • Behebt ein Problem, das verhindert, dass diese Komponente gestartet wird, wenn die Checkpoint-Datei beschädigt ist.

2.1.4
Fehlerbehebungen und Verbesserungen

  • Korrigiert die Kompatibilität mit Java-Version 8.

2.1.3
Warnung

Diese Version ist nicht mehr verfügbar, außer in den Regionen USA Ost (Ohio), Kanada (Central) und AWS GovCloud (US-East). Für die Ausführung dieser Komponentenversion ist Java-Version 11 oder höher erforderlich. Die Verbesserungen in dieser Version sind in späteren Versionen dieser Komponente verfügbar.

Fehlerbehebungen und Verbesserungen

  • Verbessert Fehlermeldungen, wenn Sie diese Komponente auf nicht unterstützten Geräten bereitstellen.

  • Aktualisierungen zur Protokollierung von Fehlern, wenn Datenuploads fehlschlagen.

2.1.2
Fehlerbehebungen und Verbesserungen

  • Updates zum Aufrufen der Funktion zum Exportieren abgelaufener Daten, sobald die Daten ablaufen.

2.1.1

Fehlerbehebungen und Verbesserungen.

2.1.0
Neue Features

  • Fügt Unterstützung hinzu, um die neuesten Daten zuerst in der Cloud zu veröffentlichen.

  • Integriert die Unterstützung dafür, abgelaufene Daten nicht in der Cloud zu veröffentlichen.

  • Integriert die Unterstützung für das lokale Speichern abgelaufener Daten.

Fehlerbehebungen und Verbesserungen

  • Reduziert die Festplatte I/O und die entsprechende Latenz.

2.0.2

Fehlerbehebungen und Verbesserungen.

2.0.1

Erste Version

Weitere Informationen finden Sie auch unter