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

Stream-Manager

Die Stream-Manager-Komponente (aws.greengrass.StreamManager) ermöglicht es Ihnen, Datenströme zu verarbeiten, um sie AWS Cloud von Greengrass-Kerngeräten an die zu übertragen.

Weitere Informationen zur Konfiguration und Verwendung des Stream-Managers in benutzerdefinierten Komponenten finden Sie unterDatenströme auf Greengrass-Kerngeräten verwalten.

Versionen

Diese Komponente hat die folgenden Versionen:

  • 2.1.x

  • 2.0.x

Anmerkung

Wenn Sie Stream Manager verwenden, um Daten in die Cloud zu exportieren, können Sie Version 2.0.7 der Stream Manager-Komponente nicht auf eine Version zwischen v2.0.8 und v2.0.11 aktualisieren. Wenn Sie Stream Manager zum ersten Mal bereitstellen, empfehlen wir dringend, die neueste Version der Stream Manager-Komponente bereitzustellen.

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:

  • Die Token-Exchange-Rolle muss den Zugriff auf die AWS Cloud Ziele ermöglichen, die Sie mit Stream Manager verwenden. Weitere Informationen finden Sie unter:

  • Die Stream Manager-Komponente wird für die Ausführung in a unterstütztVPC. Um diese Komponente in a bereitzustellenVPC, ist Folgendes erforderlich.

    • Die Stream Manager-Komponente muss mit dem AWS Service verbunden sein, für den Sie Daten veröffentlichen.

      • Amazon S3: com.amazonaws.region.s3

      • Amazon Kinesis Data Streams: com.amazonaws.region.kinesis-streams

      • AWS IoT SiteWise: com.amazonaws.region.iotsitewise.data

    • Wenn Sie Daten in Amazon S3 in der us-east-1 Region veröffentlichen, versucht diese Komponente standardmäßig, den globalen S3-Endpunkt zu verwenden. Dieser Endpunkt ist jedoch nicht über den Endpunkt der Amazon S3 VPC S3-Schnittstelle verfügbar. Weitere Informationen finden Sie unter Einschränkungen und Einschränkungen von AWS PrivateLink für Amazon S3. Um dieses Problem zu beheben, können Sie aus den folgenden Optionen wählen.

      • Konfigurieren Sie die Stream Manager-Komponente so, dass sie den regionalen S3-Endpunkt in der us-east-1 Region verwendet, indem Sie sie -Daws.s3UseUsEast1RegionalEndpoint=regional in einrichtenJVM_ARGS.

      • Erstellen Sie einen Amazon S3 VPC S3-Gateway-Endpunkt anstelle eines Amazon S3 VPC S3-Schnittstellenendpunkts. S3-Gateway-Endpunkte unterstützen den Zugriff auf den globalen S3-Endpunkt. Weitere Informationen finden Sie unter Einen Gateway-Endpunkt erstellen.

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 Zulassen von Gerätedatenverkehr über einen Proxy oder eine Firewall.

Endpunkt Port Erforderlich Beschreibung

iotanalytics.region.amazonaws.com

443 Nein

Erforderlich, wenn Sie Daten veröffentlichen in. AWS IoT Analytics

kinesis.region.amazonaws.com

443 Nein

Erforderlich, wenn Sie Daten in Firehose veröffentlichen.

data.iotsitewise.region.amazonaws.com

443 Nein

Erforderlich, wenn Sie Daten veröffentlichen für AWS IoT SiteWise.

*.s3.amazonaws.com

443 Nein

Erforderlich, wenn Sie Daten in S3-Buckets veröffentlichen.

Sie können es * durch den Namen jedes Buckets ersetzen, in dem Sie Daten veröffentlichen.

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.

2.1.13

In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.1.11 bis 2.1.10 dieser Komponente aufgeführt.

-Abhängigkeit Kompatible Versionen Art der Abhängigkeit
Grüngraskern >=2.0.0 <2.14.0 Weich
Token-Austauschdienst >=0.0.0 Hart
2.1.11 - 2.1.12

In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.1.11 bis 2.1.10 dieser Komponente aufgeführt.

-Abhängigkeit Kompatible Versionen Art der Abhängigkeit
Grüngraskern >=2.0.0 <2.13.0 Weich
Token-Austauschdienst >=0.0.0 Hart
2.1.9 – 2.1.10

In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.1.9 bis 2.1.10 dieser Komponente aufgeführt.

-Abhängigkeit Kompatible Versionen Art der Abhängigkeit
Grüngraskern >=2.0.0 <2.12.0 Weich
Token-Austauschdienst >=0.0.0 Hart
2.1.5 – 2.1.8

In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.1.5 bis 2.1.8 dieser Komponente aufgeführt.

-Abhängigkeit Kompatible Versionen Art der Abhängigkeit
Grüngraskern >=2.0.0 <2.11.0 Weich
Token-Austauschdienst >=0.0.0 Hart
2.1.2 – 2.1.4

In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.1.2 bis 2.1.4 dieser Komponente aufgeführt.

-Abhängigkeit Kompatible Versionen Art der Abhängigkeit
Grüngraskern >=2.0.0 <2.10.0 Weich
Token-Austauschdienst >=0.0.0 Hart
2.1.1

In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.1 dieser Komponente aufgeführt.

-Abhängigkeit Kompatible Versionen Art der Abhängigkeit
Grüngraskern >=2.0.0 <2.9.0 Weich
Token-Austauschdienst >=0.0.0 Hart
2.1.0

In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.0 dieser Komponente aufgeführt.

-Abhängigkeit Kompatible Versionen Art der Abhängigkeit
Grüngraskern >=2.0.0 <2.8.0 Weich
Token-Austauschdienst >=0.0.0 Hart
2.0.15

In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.15 dieser Komponente aufgeführt.

-Abhängigkeit Kompatible Versionen Art der Abhängigkeit
Grüngraskern >=2.0.0 <2.7.0 Weich
Token-Austauschdienst >=0.0.0 Hart
2.0.13 and 2.0.14

In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.0.13 und 2.0.14 dieser Komponente aufgeführt.

-Abhängigkeit Kompatible Versionen Art der Abhängigkeit
Grüngraskern >=2.0.0 <2.6.0 Weich
Token-Austauschdienst >=0.0.0 Hart
2.0.11 and 2.0.12

In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.0.11 und 2.0.12 dieser Komponente aufgeführt.

-Abhängigkeit Kompatible Versionen Art der Abhängigkeit
Grüngraskern >=2.0.0 <2.5.0 Weich
Token-Austauschdienst >=0.0.0 Hart
2.0.10

In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.10 dieser Komponente aufgeführt.

-Abhängigkeit Kompatible Versionen Art der Abhängigkeit
Grüngraskern >=2.0.0 <2.4.0 Weich
Token-Austauschdienst >=0.0.0 Hart
2.0.9

In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.9 dieser Komponente aufgeführt.

-Abhängigkeit Kompatible Versionen Art der Abhängigkeit
Grüngraskern >=2.0.0 <2.3.0 Weich
Token-Austauschdienst >=0.0.0 Hart
2.0.8

In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.8 dieser Komponente aufgeführt.

-Abhängigkeit Kompatible Versionen Art der Abhängigkeit
Grüngraskern >=2.0.0 <2.2.0 Weich
Token-Austauschdienst >=0.0.0 Hart
2.0.7

In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.7 dieser Komponente aufgeführt.

-Abhängigkeit Kompatible Versionen Art der Abhängigkeit
Grüngraskern >=2.0.3 <2.1.0 Weich
Token-Austauschdienst >=0.0.0 Hart

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

Konfiguration

Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.

STREAM_MANAGER_STORE_ROOT_DIR

(Optional) Der absolute Pfad des lokalen Verzeichnisses, das zum Speichern von Streams verwendet wird. Dieser Wert muss mit einem Schrägstrich (z. B. /data) beginnen.

Sie müssen einen vorhandenen Ordner angeben, und der Systembenutzer, der die Stream Manager-Komponente ausführt, muss über Lese- und Schreibberechtigungen für diesen Ordner verfügen. Sie können beispielsweise die folgenden Befehle ausführen, um einen Ordner zu erstellen und zu konfigurieren/var/greengrass/streams, den Sie als Stream-Manager-Stammordner angeben. Mit diesen Befehlen kann der Standardsystembenutzer,ggc_user, in diesen Ordner lesen und in ihn schreiben.

sudo mkdir /var/greengrass/streams sudo chown ggc_user /var/greengrass/streams sudo chmod 700 /var/greengrass/streams

Standard: /greengrass/v2/work/aws.greengrass.StreamManager

STREAM_MANAGER_SERVER_PORT

(Optional) Die lokale Portnummer, die für die Kommunikation mit dem Stream Manager verwendet werden soll.

Sie können angeben0, dass ein zufälliger verfügbarer Port verwendet werden soll.

Standard: 8088

STREAM_MANAGER_AUTHENTICATE_CLIENT

(Optional) Sie können festlegen, dass sich Clients authentifizieren müssen, bevor sie mit dem Stream Manager interagieren können. Der Stream Manager SDK steuert die Interaktion zwischen Clients und Stream Manager. Dieser Parameter bestimmt, welche Clients den Stream Manager aufrufen könnenSDK, um mit Streams zu arbeiten. Weitere Informationen finden Sie unter Stream Manager-Client-Authentifizierung.

Wenn Sie angebentrue, SDK erlaubt der Stream Manager nur Greengrass-Komponenten als Clients.

Wenn Sie dies angebenfalse, SDK lässt der Stream Manager zu, dass alle Prozesse auf dem Kerngerät Clients sind.

Standard: true

STREAM_MANAGER_EXPORTER_MAX_BANDWIDTH

(Optional) Die durchschnittliche maximale Bandbreite (in Kilobit pro Sekunde), die der Stream-Manager zum Exportieren von Daten verwenden kann.

Standard: keine Einschränkung

STREAM_MANAGER_EXPORTER_THREAD_POOL_SIZE

(Optional) Die maximale Anzahl aktiver Threads, die der Stream-Manager zum Exportieren von Daten verwenden kann.

Die optimale Größe hängt von der Hardware, dem Stream-Volume und der geplanten Anzahl der Exportstreams ab. Wenn die Exportgeschwindigkeit langsam ist, können Sie diese Einstellung anpassen, um die optimale Größe für Ihre Hardware und Ihren Geschäftsfall zu ermitteln. Die Hardware Ihres Kerngeräts CPU und der Arbeitsspeicher sind limitierende Faktoren. Um zu starten, können Sie versuchen, diesen Wert gleich der Anzahl der Prozessorkerne auf dem Gerät festzulegen.

Achten Sie darauf, keine Größe festzulegen, die höher ist, als Ihre Hardware unterstützen kann. Jeder Stream verbraucht Hardwareressourcen. Versuchen Sie daher, die Anzahl der Exportstreams auf beschränkten Geräten zu begrenzen.

Standard: 5 Threads

STREAM_MANAGER_EXPORTER_S3_DESTINATION_MULTIPART_UPLOAD_MIN_PART_SIZE_BYTES

(Optional) Die Mindestgröße (in Byte) eines Teils in einem mehrteiligen Upload auf Amazon S3. Stream Manager verwendet diese Einstellung und die Größe der Eingabedatei, um zu bestimmen, wie Daten in einer mehrteiligen PUT Anfrage gebündelt werden.

Anmerkung

Stream Manager verwendet die sizeThresholdForMultipartUploadBytes Streams-Eigenschaft, um zu bestimmen, ob der Export nach Amazon S3 als einteiliger oder mehrteiliger Upload erfolgen soll. AWS IoT Greengrass Komponenten können diesen Schwellenwert festlegen, wenn sie einen Stream erstellen, der nach Amazon S3 exportiert wird.

Standard: 5242880 (5 MB). Dies ist auch der Mindestwert.

LOG_LEVEL

(Optional) Die Protokollierungsebene für die Komponente. Wählen Sie aus den folgenden Protokollebenen, die hier in der Reihenfolge der Stufen aufgeführt sind:

  • TRACE

  • DEBUG

  • INFO

  • WARN

  • ERROR

Standard: INFO

JVM_ARGS

(Optional) Die benutzerdefinierten Java Virtual Machine-Argumente, die beim Start an den Stream-Manager übergeben werden sollen. Trennen Sie mehrere Argumente durch Leerzeichen.

Verwenden Sie diesen Parameter nur, wenn Sie die von der verwendeten Standardeinstellungen überschreiben müssenJVM. Beispielsweise müssen Sie möglicherweise die Standard-Heap-Größe erhöhen, wenn Sie eine große Anzahl von Streams exportieren möchten.

Beispiel: Aktualisierung der Konfigurationszusammenführung

In der folgenden Beispielkonfiguration wird angegeben, dass ein nicht standardmäßiger Port verwendet werden soll.

{ "STREAM_MANAGER_SERVER_PORT": "18088" }

Lokale Protokolldatei

Diese Komponente verwendet die folgende Protokolldatei.

Linux
/greengrass/v2/logs/aws.greengrass.StreamManager.log
Windows
C:\greengrass\v2\logs\aws.greengrass.StreamManager.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.greengrass.StreamManager.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\aws.greengrass.StreamManager.log -Tail 10 -Wait

Änderungsprotokoll

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

Version

Änderungen

2.1.13

Fehlerkorrekturen und Verbesserungen

Unterstützt FIPS Endpunkte für AWS IoT SiteWise

2.1.12

Fehlerkorrekturen und Verbesserungen

Aktualisiert die Reihenfolge, in der Anmeldeinformationen verwendet werden, sodass Greengrass-Anmeldeinformationen für AWS Serviceanfragen bevorzugt werden.

2.1.11

Die Version wurde für die Version 2.12.0 von Greengrass Nucleus aktualisiert.

2.1.10

Fehlerkorrekturen und Verbesserungen

Behebt ein Problem, bei dem die HTTPS Proxykonfiguration der Zertifikatskette der Greengrass Certificate Authority (CA) nicht vertraut.

2.1.9

Die Version wurde für die Version 2.11.0 von Greengrass Nucleus aktualisiert.

2.1.8

Fehlerkorrekturen und Verbesserungen

Behebt ein Problem, bei dem der Stream-Manager unendlich viele Versuche mit fehlgeschlagenen SiteWise Exporten wiederholt. InvalidRequestException

2.1.7

Fehlerkorrekturen und Verbesserungen

Behebt ein Problem, bei dem der Stream-Manager die Proxykonfiguration nicht korrekt lesen kann.

2.1.6

Fehlerkorrekturen und Verbesserungen

Behebt ein Problem, das bei bestimmten ARMv8 Prozessoren, einschließlich des Jetson Nano, zu einem Absturz beim Start führen konnte.

2.1.5

Die Version wurde für die Version 2.10.0 von Greengrass Nucleus aktualisiert.

2.1.4

Fehlerkorrekturen und Verbesserungen
  • Behebt ein Problem, bei dem Einträge für dasselbe Eigenschafts-Asset mit demselben Zeitstempel innerhalb eines einzigen Batches ConflictingOperationException von zurückgegeben werden SiteWise API, was dazu führt, dass der Stream-Manager es kontinuierlich wiederholt.

  • Aktualisiert das Standard-Verbindungs-Timeout von 3 Sekunden auf 1 Minute.

2.1.3

Fehlerkorrekturen und Verbesserungen

Behebt ein Startproblem unter Windows OS, wenn es als SYSTEM Benutzer ausgeführt wird.

2.1.2

Fehlerkorrekturen und Verbesserungen
  • Behebt ein Problem unter Windows-Betriebssystemen, die eine andere Sprache als Englisch verwenden.

  • Die Version wurde für die Version 2.9.0 von Greengrass Nucleus aktualisiert.

2.1.1

Die Version wurde für die Version 2.8.0 von Greengrass Nucleus aktualisiert.

2.1.0

Neue Features

2.0.15

Die Version wurde für die Version 2.6.0 von Greengrass Nucleus aktualisiert.

2.0.14

Diese Version enthält Fehlerkorrekturen und Verbesserungen.

2.0.13

Die Version wurde für die Version 2.5.0 von Greengrass Nucleus aktualisiert.

2.0.12
Fehlerkorrekturen und Verbesserungen

Behebt ein Problem, das ein Upgrade von Stream Manager v2.0.7 auf eine Version zwischen v2.0.8 und v2.0.11 verhinderte. Wenn Sie den Stream Manager verwenden, um Daten in die Cloud zu exportieren, können Sie jetzt ein Upgrade auf Version 2.0.12 durchführen.

2.0.11

Die Version wurde für die Version 2.4.0 von Greengrass Nucleus aktualisiert.

2.0.10

Die Version wurde für die Version 2.3.0 von Greengrass Nucleus aktualisiert.

2.0.9

Die Version wurde für die Version 2.2.0 von Greengrass Nucleus aktualisiert.

2.0.8

Die Version wurde für die Version 2.1.0 von Greengrass Nucleus aktualisiert.

2.0.7

Erste Version