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.
Themen
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 |
---|---|---|---|
|
443 | Nein |
Erforderlich, wenn Sie Daten veröffentlichen in. AWS IoT Analytics |
|
443 | Nein |
Erforderlich, wenn Sie Daten in Firehose veröffentlichen. |
|
443 | Nein |
Erforderlich, wenn Sie Daten veröffentlichen für AWS IoT SiteWise. |
|
443 | Nein |
Erforderlich, wenn Sie Daten in S3-Buckets veröffentlichen. Sie können es |
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
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:
/work/aws.greengrass.StreamManager/greengrass/v2
STREAM_MANAGER_SERVER_PORT
-
(Optional) Die lokale Portnummer, die für die Kommunikation mit dem Stream Manager verwendet werden soll.
Sie können angeben
0
, 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 angeben
true
, SDK erlaubt der Stream Manager nur Greengrass-Komponenten als Clients.Wenn Sie dies angeben
false
, 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.
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
oder/greengrass/v2
C:\greengrass\v2
mit dem Pfad zum AWS IoT Greengrass Stammordner.
Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
Version |
Änderungen |
---|---|
2.1.13 |
|
2.1.12 |
|
2.1.11 |
Die Version wurde für die Version 2.12.0 von Greengrass Nucleus aktualisiert. |
2.1.10 |
|
2.1.9 |
Die Version wurde für die Version 2.11.0 von Greengrass Nucleus aktualisiert. |
2.1.8 |
|
2.1.7 |
|
2.1.6 |
|
2.1.5 |
Die Version wurde für die Version 2.10.0 von Greengrass Nucleus aktualisiert. |
2.1.4 |
|
2.1.3 |
|
2.1.2 |
|
2.1.1 |
Die Version wurde für die Version 2.8.0 von Greengrass Nucleus aktualisiert. |
2.1.0 |
|
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 |
|
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 |