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, die von Greengrass-Core-Geräten zu übertragen sind. AWS Cloud
Weitere Informationen zur Konfiguration und Verwendung des Stream-Managers in benutzerdefinierten Komponenten finden Sie unterDatenströme auf Greengrass-Core-Geräten verwalten.
Themen
Versionen
Diese Komponente hat die folgenden Versionen:
-
2.3.x
-
2.2.x
-
2.1.x
-
2.0.x
Anmerkung
Wenn Sie den 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 den 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 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:
-
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 Ausführung der Stream Manager-Komponente wird in einer VPC unterstützt. Um diese Komponente in einer VPC bereitzustellen, 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-Datenströme:
com.amazonaws.region.kinesis-streams -
AWS IoT SiteWise:
com.amazonaws.region.iotsitewise.data
-
-
Wenn Sie Daten in Amazon S3 in der
us-east-1Region veröffentlichen, versucht diese Komponente standardmäßig, den globalen S3-Endpunkt zu verwenden. Dieser Endpunkt ist jedoch nicht über den Amazon S3-VPC-Schnittstellenendpunkt verfügbar. Weitere Informationen finden Sie unter Einschränkungen und Einschränkungen von AWS PrivateLink für Amazon S3. Um dieses Problem zu lösen, 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-1Region verwendet, indem Sie sie-Daws.s3UseUsEast1RegionalEndpoint=regionalin einrichtenJVM_ARGS. -
Erstellen Sie einen Amazon S3-Gateway-VPC-Endpunkt anstelle eines Amazon S3-Schnittstellen-VPC-Endpunkts. S3-Gateway-Endpunkte unterstützen den Zugriff auf den globalen S3-Endpunkt. Weitere Informationen finden Sie unter Erstellen eines Gateway-Endpunkts.
-
-
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 |
|---|---|---|---|
|
|
443 | Nein |
Erforderlich, wenn Sie Daten in Firehose veröffentlichen. |
|
|
443 | Nein |
Erforderlich, wenn Sie Daten in veröffentlichen. AWS IoT SiteWise |
|
|
443 | Nein |
Erforderlich, wenn Sie Daten in S3-Buckets veröffentlichen. Sie können den Namen jedes Buckets, in dem Sie Daten veröffentlichen, durch den Namen ersetzen |
AWS IoT Analytics abgesetzt
AWS IoT Analytics wurde am 15. Dezember 2025 eingestellt. Der iotanalytics. Endpunkt ist nicht mehr funktionsfähig. Wenn Sie Streams mit region.amazonaws.com.rproxy.goskope.comIoTAnalyticsConfig Exportzielen konfiguriert haben, entfernen Sie sie, um kontinuierliche fehlgeschlagene Exportversuche zu vermeiden. Weitere Informationen finden Sie unter AWS IoT Analytics Kanäle (eingestellt).
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
Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Komponentenrezeptreferenz.
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. Diese Befehle ermöglichen es dem Standardsystembenutzerggc_user, diesen Ordner zu lesen und in ihn zu schreiben.sudo mkdir /var/greengrass/streams sudo chown ggc_user /var/greengrass/streams sudo chmod 700 /var/greengrass/streamsStandard:
/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ällig 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. Das Stream Manager SDK steuert die Interaktion zwischen Clients und Stream Manager. Dieser Parameter bestimmt, welche Clients das Stream Manager SDK aufrufen können, um mit Streams zu arbeiten. Weitere Informationen finden Sie unter Stream Manager-Client-Authentifizierung.
Wenn Sie angeben
true, erlaubt das Stream Manager SDK nur Greengrass-Komponenten als Clients.Wenn Sie angeben
false, erlaubt das Stream Manager SDK, 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 CPU und der Arbeitsspeicher Ihrer Core-Geräte-Hardware sind begrenzende 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 Export-Streams auf Geräten mit eingeschränkten Einschränkungen 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-Anforderung gebündelt werden.
Anmerkung
Der Stream-Manager verwendet die
sizeThresholdForMultipartUploadBytesStreams-Eigenschaft, um zu bestimmen, ob der Export nach Amazon S3 als ein- 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. STREAM_MANAGER_EXPORTER_KINESIS_INTER_CALL_DELAY_MS-
(Optional) Die Verzögerung in Millisekunden, die der Stream-Manager zwischen aufeinanderfolgenden Anforderungen wartet, wenn er Streams an Kinesis Data Streams-Ziele exportiert. Diese Verzögerung gilt nur, wenn der Stream-Manager das Shard-Layout des Zieldatenstreams nicht ermitteln kann. Dies kann passieren, wenn die Greengrass-Token-Exchange-Rolle die kinesis:ListShards Berechtigung nicht beinhaltet. Wenn der Stream-Manager das Shard-Layout ermitteln kann, verwendet er anstelle dieser Verzögerung ein shard-bewusstes Pacing. Um die Fallback-Verzögerung auszuschalten, setzen Sie diesen Parameter auf.
0Standard:
1000(1 Sekunde) LOG_LEVEL-
(Optional) Die Protokollierungsstufe 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. Trennen Sie mehrere Argumente durch Leerzeichen.
Verwenden Sie diesen Parameter nur, wenn Sie die von der JVM verwendeten Standardeinstellungen außer Kraft setzen müssen. Beispielsweise müssen Sie möglicherweise die Standard-Heap-Größe erhöhen, wenn Sie eine große Anzahl von Streams exportieren möchten.
startupTimeoutSeconds-
(Optional) Die maximale Zeit in Sekunden, die die Komponente zum Starten benötigt. Der Status der Komponente ändert sich,
ERROREDwenn dieser Timeout überschritten wird.Standard:
120
Beispiel Beispiel: Aktualisierung der Konfiguration zum Zusammenführen
Die folgende Beispielkonfiguration legt fest, 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/v2C:\greengrass\v2durch den Pfad zum AWS IoT Greengrass Stammordner.
Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
|
Version |
Änderungen |
|---|---|
|
2.3.1 |
|
|
2.3.0 |
|
|
2.2.1 |
|
|
2.2.0 |
|
|
2.1.13 |
|
|
2.1.12 |
|
|
2.1.11 |
Die Version wurde für die Greengrass Nucleus-Version 2.12.0 aktualisiert. |
|
2.1.10 |
|
|
2.1.9 |
Die Version wurde für die Greengrass Nucleus-Version 2.11.0 aktualisiert. |
|
2.1.8 |
|
|
2.1.7 |
|
|
2.1.6 |
|
|
2.1.5 |
Die Version wurde für die Greengrass Nucleus-Version 2.10.0 aktualisiert. |
|
2.1.4 |
|
|
2.1.3 |
|
|
2.1.2 |
|
|
2.1.1 |
Die Version wurde für die Greengrass Nucleus-Version 2.8.0 aktualisiert. |
|
2.1.0 |
|
|
2.0.15 |
Die Version wurde für die Veröffentlichung von Greengrass Nucleus Version 2.6.0 aktualisiert. |
|
2.0.14 |
Diese Version enthält Fehlerkorrekturen und Verbesserungen. |
|
2.0.13 |
Die Version wurde für die Greengrass Nucleus-Version 2.5.0 aktualisiert. |
| 2.0.12 |
|
|
2.0.11 |
Version für die Veröffentlichung von Greengrass Nucleus Version 2.4.0 aktualisiert. |
|
2.0.10 |
Die Version wurde für die Greengrass Nucleus-Version 2.3.0 aktualisiert. |
|
2.0.9 |
Version für die Veröffentlichung von Greengrass Nucleus Version 2.2.0 aktualisiert. |
|
2.0.8 |
Die Version wurde für die Greengrass Nucleus-Version 2.1.0 aktualisiert. |
|
2.0.7 |
Erste Version |