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.
# AWS-mitgelieferte Komponenten
AWS IoT Greengrass stellt vorgefertigte Komponenten bereit und verwaltet sie, die Sie auf Ihren Geräten bereitstellen können. Zu diesen Komponenten gehören Funktionen (wie Stream Manager), AWS IoT Greengrass V1-Konnektoren (wie CloudWatch Metriken) und lokale Entwicklungstools (wie die AWS IoT Greengrass CLI). Sie können [diese Komponenten für ihre eigenständige Funktionalität auf Ihren Geräten bereitstellen](manage-deployments.md) oder sie als Abhängigkeiten in Ihren [benutzerdefinierten Greengrass-Komponenten](develop-greengrass-components.md) verwenden.
**Anmerkung**
Einige der AWS bereitgestellten Komponenten hängen von bestimmten Nebenversionen des Greengrass-Kerns ab. Aufgrund dieser Abhängigkeit müssen Sie diese Komponenten aktualisieren, wenn Sie den Greengrass Nucleus auf eine neue Nebenversion aktualisieren. Informationen zu den spezifischen Versionen von Nucleus, von denen jede Komponente abhängt, finden Sie im entsprechenden Komponententhema. Weitere Informationen zur Aktualisierung des Nucleus finden Sie unter[Aktualisieren Sie die AWS IoT Greengrass Core-Software (OTA)](update-greengrass-core-v2.md).
Wenn eine Komponente einen Komponententyp sowohl generisch als auch Lambda hat, ist die aktuelle Version der Komponente der generische Typ und eine frühere Version der Komponente ist der Lambda-Typ.
| Komponente | Description | [Komponententyp](develop-greengrass-components.md#component-types) | Unterstützes Betriebssystem | [Open-Source](open-source.md) | Nucleus Lite-kompatibel |
| --- | --- | --- | --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | Der AWS IoT Greengrass Kern der Core-Software. Verwenden Sie diese Komponente, um die Software auf Ihren Kerngeräten zu konfigurieren und zu aktualisieren. | Nucleus | Linux, Windows | [Ja](https://github.com/aws-greengrass/aws-greengrass-nucleus) | Nein |
| [Greengrass Nucleus Lite](greengrass-nucleus-lite-component.md) | Ein leichter Kern für Geräte mit beschränkten Ressourcen, optimiert für kostengünstige Edge-Geräte und großvolumige Anwendungen | NucleusLite | Linux | [Ja](https://github.com/aws-greengrass/aws-greengrass-lite) | Nein |
| [Authentifizierung auf Client-Geräten](client-device-auth-component.md) | Ermöglicht es lokalen IoT-Geräten, so genannten Client-Geräten, eine Verbindung zum Kerngerät herzustellen. | Plug-In | Linux, Windows | [Ja](https://github.com/aws-greengrass/aws-greengrass-client-device-auth) | Nein |
| [CloudWatch Metriken](cloudwatch-metrics-component.md) | Veröffentlicht benutzerdefinierte Metriken auf Amazon CloudWatch. | Generisch, Lambda | Linux, Windows | [Ja](https://github.com/aws-greengrass/aws-greengrass-cloudwatch-metrics) | Ja |
| [AWS IoT Device Defender](device-defender-component.md) | Informiert Administratoren über Änderungen im Status des Greengrass-Core-Geräts, um ungewöhnliches Verhalten zu erkennen. | Generisch, Lambda | Linux, Windows | [Ja](https://github.com/aws-greengrass/aws-greengrass-device-defender) | Nein |
| [Festplattenspooler](disk-spooler-component.md) | Aktiviert eine persistente Speicheroption für Nachrichten, an die von Greengrass-Core-Geräten gespoolt wurden. AWS IoT Core Diese Komponente speichert diese ausgehenden Nachrichten auf der Festplatte. | Plug-In | Linux, Windows | [Ja](https://github.com/aws-greengrass/aws-greengrass-disk-spooler) | Nein |
| [Docker-Anwendungsmanager](docker-application-manager-component.md) | Ermöglicht AWS IoT Greengrass das Herunterladen von Docker-Images von Docker Hub und Amazon Elastic Container Registry (Amazon ECR). | Generisch | Linux, Windows | Nein | Nein |
| [Edge-Anschluss für Kinesis Video Streams](kvs-edge-connector-component.md) | Liest Video-Feeds von lokalen Kameras, veröffentlicht die Streams in Kinesis Video Streams und zeigt die Streams in Grafana-Dashboards mit an. AWS IoT TwinMaker | Generisch | Linux | Nein | Nein |
| [Greengrass CLI](greengrass-cli-component.md) | Stellt eine Befehlszeilenschnittstelle bereit, mit der Sie lokale Bereitstellungen erstellen und mit dem Greengrass-Kerngerät und seinen Komponenten interagieren können. | Plug-In | Linux, Windows | [Ja](https://github.com/aws-greengrass/aws-greengrass-cli) | [Nein](https://github.com/aws-greengrass/aws-greengrass-lite/blob/main/docs/ggl-cli.md) |
| [IP-Detektor](ip-detector-component.md) | Meldet Verbindungsinformationen für den MQTT-Broker an AWS IoT Greengrass, sodass Client-Geräte herausfinden können, wie eine Verbindung hergestellt werden kann. | Plug-In | Linux, Windows | [Ja](https://github.com/aws-greengrass/aws-greengrass-ip-detector) | Nein |
| [Firehose](kinesis-firehose-component.md) | Veröffentlicht Daten über Amazon Data Firehose-Lieferdatenströme an Ziele in der AWS Cloud. | Lambda | Linux | Nein | Nein |
| [Lambda-Launcher](lambda-launcher-component.md) | Verwaltet Prozesse und Umgebungskonfigurationen für Lambda-Funktionen. | Generisch | Linux | Nein | Nein |
| [Lambda-Manager](lambda-manager-component.md) | Verwaltet die Kommunikation zwischen Prozessen und die Skalierung für Lambda-Funktionen. | Plug-In | Linux | Nein | Nein |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | Stellt Artefakte für jede Lambda-Laufzeit bereit. | Generisch | Linux | Nein | Nein |
| [Legacy-Abonnement-Router](legacy-subscription-router-component.md) | Verwaltet Abonnements für Lambda-Funktionen, die auf AWS IoT Greengrass V1 ausgeführt werden. | Generisch | Linux | Nein | Nein |
| [Lokale Debug-Konsole](local-debug-console-component.md) | Stellt eine lokale Konsole bereit, mit der Sie das Greengrass-Core-Gerät und seine Komponenten debuggen und verwalten können. | Plug-In | Linux, Windows | [Ja](https://github.com/aws-greengrass/aws-greengrass-localdebugconsole) | Nein |
| [Protokollmanager](log-manager-component.md) | Sammelt Protokolle und lädt sie auf das Greengrass-Core-Gerät hoch. | Plug-In | Linux, Windows | [Ja](https://github.com/aws-greengrass/aws-greengrass-log-manager) | Nein |
| [Komponenten für maschinelles Lernen](machine-learning-components.md) | Stellt Modelle für maschinelles Lernen und Beispiel-Inferenzcode bereit, mit denen Sie Inferenzen für maschinelles Lernen auf Greengrass-Kerngeräten durchführen können. | Siehe [Komponenten für maschinelles Lernen](machine-learning-components.md). | Nein |
| [Modbus-RTU-Protokolladapter](modbus-rtu-protocol-adapter-component.md) | Ruft Informationen von lokalen Modbus RTU-Geräten ab. | Lambda | Linux | Nein | Nein |
| [Nucleus-Telemetrie-Sender](nucleus-emitter-component.md) | Publiziert Telemetriedaten zur Systemintegrität, die vom Nucleus gesammelt wurden, zu einem lokalen Thema oder zu einem MQTT-Thema. AWS IoT Core | Plug-In | Linux, Windows | [Ja](https://github.com/aws-greengrass/aws-greengrass-telemetry-nucleus-emitter) | Nein |
| [MQTT-Brücke](mqtt-bridge-component.md) | Leitet MQTT-Nachrichten zwischen Client-Geräten weiter, veröffentlicht lokal AWS IoT Greengrass , abonniert und. AWS IoT Core | Plug-In | Linux, Windows | [Ja](https://github.com/aws-greengrass/aws-greengrass-mqtt-bridge) | Nein |
| [MQTT 3.1.1-Broker (Moquette)](mqtt-broker-moquette-component.md) | Führt einen MQTT 3.1.1-Broker aus, der Nachrichten zwischen Client-Geräten und dem Core-Gerät verarbeitet. | Plug-In | Linux, Windows | [Ja](https://github.com/aws-greengrass/aws-greengrass-moquette-mqtt) | Nein |
| [MQTT 5-Broker (EMAX)](mqtt-broker-emqx-component.md) | Führt einen MQTT 5-Broker aus, der Nachrichten zwischen Client-Geräten und dem Core-Gerät verarbeitet. | Generisch | Linux, Windows | Nein | Nein |
| [PKCS \$111 -Anbieter](pkcs11-provider-component.md) | Ermöglicht Greengrass-Komponenten den Zugriff auf einen privaten Schlüssel und ein Zertifikat, die Sie sicher in einem Hardware-Sicherheitsmodul (HSM) speichern. | Plug-In | Linux | [Ja](https://github.com/aws-greengrass/aws-greengrass-pkcs11-provider) | Nein |
| [Geheimer Manager](secret-manager-component.md) | Stellt Secrets from AWS Secrets Manager Secrets bereit, sodass Sie Anmeldeinformationen wie Passwörter sicher in benutzerdefinierten Komponenten auf dem Greengrass-Core-Gerät verwenden können. | Plug-In | Linux, Windows | [Ja](https://github.com/aws-greengrass/aws-greengrass-secret-manager) | Nein |
| [Sicheres Tunneling](secure-tunneling-component.md) | Ermöglicht AWS IoT sichere Tunnelverbindungen, mit denen Sie bidirektionale Kommunikation mit Greengrass-Core-Geräten herstellen können, die sich hinter eingeschränkten Firewalls befinden. | Generisch | Linux | Nein | Ja |
| [Schattenmanager](shadow-manager-component.md) | Ermöglicht die Interaktion mit Schatten auf dem Kerngerät. Es verwaltet die Speicherung von Shadow-Dokumenten und auch die Synchronisation lokaler Shadow-Zustände mit dem AWS IoT Device Shadow-Dienst. | Plug-In | Linux, Windows | [Ja](https://github.com/aws-greengrass/aws-greengrass-shadow-manager) | Nein |
| [Amazon SNS](sns-component.md) | Veröffentlicht Nachrichten zu Amazon SNS SNS-Themen. | Lambda | Linux | Nein | Nein |
| [Stream-Manager](stream-manager-component.md) | Streamt große Datenmengen aus lokalen Quellen in die. AWS Cloud | Generisch | Linux, Windows | Nein | Ja |
| [Systemprotokollweiterleitung](system-log-forwarder-component.md) | Laden Sie systemd-journald-Protokolle in den hoch. AWS Cloud | Generisch | Linux | [Ja](https://github.com/aws-greengrass/aws-greengrass-system-log-forwarder) | Ja |
| [Systemmanager-Agent](systems-manager-agent-component.md) | Verwalten Sie das Kerngerät mit AWS Systems Manager, mit dem Sie Geräte patchen, Befehle ausführen und vieles mehr können. | Generisch | Linux | [Ja](https://github.com/aws/amazon-ssm-agent/blob/mainline/packaging/greengrass/component.json) | Nein |
| [Token-Austauschdienst](token-exchange-service-component.md) | Stellt AWS Anmeldeinformationen bereit, die Sie für die Interaktion mit AWS Diensten verwenden können. | Generisch | Linux, Windows | Nein | Nein |
| [SiteWise IoT-OPC-UA-Kollektor](iotsitewise-opcua-collector-component.md) | Sammelt Daten von OPC-UA-Servern. | Generisch | Linux, Windows | Nein | Nein |
| [IoT SiteWise OPC UA-Datenquellensimulator](iotsitewise-opcua-data-source-simulator-component.md) | Führt einen lokalen OPC-UA-Server aus, der Beispieldaten generiert. | Generisch | Linux, Windows | Nein | Nein |
| [SiteWise IoT-Herausgeber](iotsitewise-publisher-component.md) | Veröffentlicht Daten in der AWS Cloud. | Generisch | Linux, Windows | Nein | Nein |
| [SiteWise IoT-Prozessor](iotsitewise-processor-component.md) | Verarbeitet Daten auf den Greengrass-Kerngeräten. | Generisch | Linux, Windows | Nein | Nein |
# Grüngraskern
Die Greengrass Nucleus-Komponente (`aws.greengrass.Nucleus`) ist eine obligatorische Komponente und die Mindestanforderung, um die AWS IoT Greengrass Core-Software auf einem Gerät auszuführen. Sie können diese Komponente so konfigurieren, dass Ihre AWS IoT Greengrass Core-Software per Fernzugriff angepasst und aktualisiert wird. Stellen Sie diese Komponente bereit, um Einstellungen wie Proxy, Geräterolle und AWS IoT Dingkonfiguration auf Ihren Kerngeräten zu konfigurieren.
**Anmerkung**
Ab der Greengrass-Version 2.14.0 ist eine für den Speicherbedarf optimierte Version der Nucleus-Gerätelaufzeit für Geräte mit eingeschränkten Randbedingungen verfügbar. Weitere Informationen zu Konfiguration und Verwendung finden Sie unter [Greengrass Nucleus Lite](https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html).
**Wichtig**
Wenn sich die Version der Nucleus-Komponente ändert oder wenn Sie bestimmte Konfigurationsparameter ändern, wird die AWS IoT Greengrass Core-Software — zu der auch der Nucleus und alle anderen Komponenten auf Ihrem Gerät gehören — neu gestartet, um die Änderungen zu übernehmen.
Wenn Sie eine Komponente bereitstellen, werden die neuesten unterstützten Versionen aller Abhängigkeiten dieser Komponente AWS IoT Greengrass installiert. Aus diesem Grund werden neue Patch-Versionen von AWS bereitgestellten öffentlichen Komponenten möglicherweise automatisch auf Ihren Kerngeräten bereitgestellt, wenn Sie einer Dinggruppe neue Geräte hinzufügen oder wenn Sie die Bereitstellung aktualisieren, die auf diese Geräte abzielt. Einige automatische Updates, wie z. B. ein Nucleus-Update, können dazu führen, dass Ihre Geräte unerwartet neu gestartet werden.
Um unbeabsichtigte Updates für eine Komponente zu verhindern, die auf Ihrem Gerät ausgeführt wird, empfehlen wir, dass Sie Ihre bevorzugte Version dieser Komponente direkt angeben, wenn Sie [eine Bereitstellung erstellen](create-deployments.md). Weitere Informationen zum Aktualisierungsverhalten der AWS IoT Greengrass Core-Software finden Sie unter[Aktualisieren Sie die AWS IoT Greengrass Core-Software (OTA)](update-greengrass-core-v2.md).
**Topics**
+ [Versionen](#greengrass-nucleus-component-versions)
+ [Anforderungen an Speichergeräte](#greengrass-v2-requirements)
+ [Unterstützte Plattformen](#greengrass-v2-supported-platforms)
+ [Betriebssystem](#greengrass-nucleus-component-os-support)
+ [Voraussetzungen](#greengrass-nucleus-component-requirements)
+ [Abhängigkeiten](#greengrass-nucleus-component-dependencies)
+ [Herunterladen und Installation](#greengrass-nucleus-component-install)
+ [Konfiguration](#greengrass-nucleus-component-configuration)
+ [Lokale Protokolldatei](#greengrass-nucleus-component-log-file)
+ [Änderungsprotokoll](#greengrass-nucleus-component-changelog)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 2.16.x
+ 2.15.x
+ 2.14.x
+ 2.13.x
+ 2.12.x
+ 2.11.x
+ 2.10.x
+ 2.9.x
+ 2.8.x
+ 2.7.x
+ 2.6.x
+ 2.5.x
+ 2.4.x
+ 2.3.x
+ 2.2.x
+ 2.1.x
+ 2.0.x
## Anforderungen an Speichergeräte
**Anmerkung**
Mithilfe AWS IoT Device Tester von können Sie überprüfen AWS IoT Greengrass , ob Ihr Gerät die AWS IoT Greengrass Core-Software ausführen und mit dem AWS Cloud kommunizieren kann. Weitere Informationen finden Sie unter [AWS IoT Device Tester Für AWS IoT Greengrass V2 verwenden](device-tester-for-greengrass-ug.md).
------
#### [ Linux ]
+ Die Verwendung eines [AWS-Region](https://en.wikipedia.org/wiki/Amazon_Web_Services#Availability_and_topology), der unterstützt AWS IoT Greengrass V2. Eine vollständige Liste der unterstützten Regionen finden Sie unter [AWS IoT Greengrass V2 -Endpunkte und -Kontingente](https://docs.aws.amazon.com/general/latest/gr/greengrassv2.html) in *Allgemeine AWS-Referenz*.
+ Für die AWS IoT Greengrass Core-Software stehen mindestens 256 MB Festplattenspeicher zur Verfügung. Diese Anforderung umfasst keine Komponenten, die auf dem Kerngerät bereitgestellt werden.
+ Der AWS IoT Greengrass Core-Software sind mindestens 96 MB RAM zugewiesen. Diese Anforderung umfasst keine Komponenten, die auf dem Kerngerät ausgeführt werden. Weitere Informationen finden Sie unter [Steuern Sie die Speicherzuweisung mit JVM-Optionen](configure-greengrass-core-v2.md#jvm-tuning).
+ Java Runtime Environment (JRE) Version 8 oder höher. Java muss in der Umgebungsvariablen [PATH](https://en.wikipedia.org/wiki/PATH_(variable)) auf dem Gerät verfügbar sein. Um Java zur Entwicklung benutzerdefinierter Komponenten zu verwenden, müssen Sie ein Java Development Kit (JDK) installieren. Wir empfehlen, dass Sie die [Langzeit-Support-Versionen von Amazon Corretto](https://aws.amazon.com/corretto/) oder [OpenJDK](https://openjdk.java.net/) verwenden. Version 8 oder höher ist erforderlich.
+ [GNU C-Bibliothek](https://www.gnu.org/software/libc/) (Glibc) Version 2.25 oder höher.
+ Sie müssen die AWS IoT Greengrass Core-Software als Root-Benutzer ausführen. Verwenden `sudo` Sie zum Beispiel.
+ Der Root-Benutzer, der die AWS IoT Greengrass Core-Software ausführt`root`, muss beispielsweise über die Berechtigung verfügen, `sudo` mit jedem Benutzer und jeder Gruppe zu arbeiten. Die `/etc/sudoers` Datei muss diesem Benutzer die Berechtigung geben, zusammen mit anderen Gruppen ausgeführt `sudo` zu werden. Die Zugriffsrechte für den Benutzer `/etc/sudoers` sollten wie im folgenden Beispiel aussehen.
```
root ALL=(ALL:ALL) ALL
```
+ Das Kerngerät muss in der Lage sein, ausgehende Anfragen an eine Reihe von Endpunkten und Ports auszuführen. Weitere Informationen finden Sie unter [Geräteverkehr über einen Proxy oder eine Firewall zulassen](allow-device-traffic.md).
+ Das `/tmp` Verzeichnis muss mit `exec` entsprechenden Berechtigungen bereitgestellt werden.
+ Alle folgenden Shell-Befehle:
+ `ps -ax -o pid,ppid`
+ `sudo`
+ `sh`
+ `kill`
+ `cp`
+ `chmod`
+ `rm`
+ `ln`
+ `echo`
+ `exit`
+ `id`
+ `uname`
+ `grep`
+ Ihr Gerät benötigt möglicherweise auch die folgenden optionalen Shell-Befehle:
+ (Fakultativ)`systemctl`. Dieser Befehl wird verwendet, um die AWS IoT Greengrass Core-Software als Systemdienst einzurichten.
+ (Optional) `useradd``groupadd`, und`usermod`. Diese Befehle werden verwendet, um den `ggc_user` Systembenutzer und die `ggc_group` Systemgruppe einzurichten.
+ (Fakultativ)`mkfifo`. Dieser Befehl wird verwendet, um Lambda-Funktionen als Komponenten auszuführen.
+ Um Systemressourcenlimits für Komponentenprozesse zu konfigurieren, muss auf Ihrem Gerät die Linux-Kernel-Version 2.6.24 oder höher ausgeführt werden.
+ Um Lambda-Funktionen ausführen zu können, muss Ihr Gerät zusätzliche Anforderungen erfüllen. Weitere Informationen finden Sie unter [Anforderungen an die Lambda-Funktion](setting-up.md#greengrass-v2-lambda-requirements).
------
#### [ Windows ]
+ Die Verwendung eines [AWS-Region](https://en.wikipedia.org/wiki/Amazon_Web_Services#Availability_and_topology), der unterstützt AWS IoT Greengrass V2. Eine vollständige Liste der unterstützten Regionen finden Sie unter [AWS IoT Greengrass V2 -Endpunkte und -Kontingente](https://docs.aws.amazon.com/general/latest/gr/greengrassv2.html) in *Allgemeine AWS-Referenz*.
+ Für die AWS IoT Greengrass Core-Software stehen mindestens 256 MB Festplattenspeicher zur Verfügung. Diese Anforderung umfasst keine Komponenten, die auf dem Kerngerät bereitgestellt werden.
+ Der AWS IoT Greengrass Core-Software sind mindestens 160 MB RAM zugewiesen. Diese Anforderung umfasst keine Komponenten, die auf dem Kerngerät ausgeführt werden. Weitere Informationen finden Sie unter [Steuern Sie die Speicherzuweisung mit JVM-Optionen](configure-greengrass-core-v2.md#jvm-tuning).
+ Java Runtime Environment (JRE) Version 8 oder höher. Java muss in der Systemvariablen [PATH](https://en.wikipedia.org/wiki/PATH_(variable)) auf dem Gerät verfügbar sein. Um Java zur Entwicklung benutzerdefinierter Komponenten zu verwenden, müssen Sie ein Java Development Kit (JDK) installieren. Wir empfehlen, dass Sie die [Langzeit-Support-Versionen von Amazon Corretto](https://aws.amazon.com/corretto/) oder [OpenJDK](https://openjdk.java.net/) verwenden. Version 8 oder höher ist erforderlich..
**Anmerkung**
Um Version 2.5.0 von [Greengrass Nucleus](#greengrass-nucleus-component) verwenden zu können, müssen Sie eine 64-Bit-Version von Java Runtime Environment (JRE) verwenden. Greengrass Nucleus Version 2.5.1 unterstützt 32-Bit und 64-Bit. JREs
+ Der Benutzer, der die AWS IoT Greengrass Core-Software installiert, muss Administrator sein.
+ Sie müssen die AWS IoT Greengrass Core-Software als Systemdienst installieren. Geben Sie an`--setup-system-service true`, wann Sie die Software installieren.
+ Jeder Benutzer, der Komponentenprozesse ausführt, muss in dem LocalSystem Konto vorhanden sein, und der Name und das Passwort des Benutzers müssen sich in der Credential Manager-Instanz für das LocalSystem Konto befinden. Sie können diesen Benutzer einrichten, wenn Sie den Anweisungen zur [Installation der AWS IoT Greengrass Core-Software](install-greengrass-core-v2.md) folgen.
+ Das Core-Gerät muss in der Lage sein, ausgehende Anfragen an eine Reihe von Endpunkten und Ports auszuführen. Weitere Informationen finden Sie unter [Geräteverkehr über einen Proxy oder eine Firewall zulassen](allow-device-traffic.md).
------
## Unterstützte Plattformen
AWS IoT Greengrass unterstützt offiziell Geräte, auf denen die folgenden Plattformen ausgeführt werden. Geräte mit Plattformen, die nicht in dieser Liste aufgeführt sind, funktionieren möglicherweise, AWS IoT Greengrass Tests werden jedoch nur auf diesen angegebenen Plattformen durchgeführt.
------
#### [ Linux ]
Architekturen:
+ Armv7l
+ Armv8 () AArch64
+ x86\$164
------
#### [ Windows ]
Architekturen:
+ x86\$164
Versionen:
+ Windows 10
+ Windows 11
+ Windows Server 2019
+ Windows Server 2022
**Anmerkung**
Einige AWS IoT Greengrass Funktionen werden derzeit auf Windows-Geräten nicht unterstützt. Weitere Informationen erhalten Sie unter [Kompatibilität der Greengrass-Funktionen](operating-system-feature-support-matrix.md) und [Überlegungen zu Funktionen](#greengrass-v2-windows-feature-considerations).
------
### Überlegungen zu Funktionen
Einige AWS IoT Greengrass Funktionen werden derzeit auf Windows-Geräten nicht unterstützt. Überprüfen Sie die Funktionsunterschiede, um zu überprüfen, ob ein Windows-Gerät Ihren Anforderungen entspricht. Weitere Informationen finden Sie unter [Kompatibilität der Greengrass-Funktionen](operating-system-feature-support-matrix.md).
[Um ein benutzerdefiniertes Linux-basiertes Betriebssystem zu erstellen, können Sie das BitBake Rezept für AWS IoT Greengrass im `meta-aws` Projekt verwenden.](https://github.com/aws/meta-aws/tree/master/recipes-iot) Das `meta-aws` Projekt bietet Rezepte, mit denen Sie AWS Edge-Softwarefunktionen in [eingebetteten Linux-Systemen](https://elinux.org/) erstellen können, die mit [OpenEmbedded](https://www.openembedded.org/wiki/Main_Page)Build-Frameworks von Yocto Project erstellt wurden. Das [Yocto-Projekt ist ein Open-Source-Kooperationsprojekt](https://www.yoctoproject.org/), das Ihnen hilft, maßgeschneiderte Linux-basierte Systeme für eingebettete Anwendungen unabhängig von der Hardwarearchitektur zu entwickeln. Das BitBake Rezept für AWS IoT Greengrass installiert, konfiguriert und führt die AWS IoT Greengrass Core-Software automatisch auf Ihrem Gerät aus.
Linux-Plattformen können auch AWS IoT Greengrass in einem Docker-Container ausgeführt werden. Weitere Informationen finden Sie unter [Führen Sie die AWS IoT Greengrass Core-Software in einem Docker-Container aus](run-greengrass-docker.md).
## Betriebssystem
Diese Komponente kann auf Kerngeräten installiert werden, auf denen die folgenden Betriebssysteme ausgeführt werden:
+ Linux
+ Windows
Weitere Informationen finden Sie unter [Unterstützte Plattformen](#greengrass-v2-supported-platforms).
## Voraussetzungen
Geräte müssen bestimmte Anforderungen erfüllen, um den Greengrass Nucleus und die AWS IoT Greengrass Core-Software installieren und ausführen zu können. Weitere Informationen finden Sie unter [Anforderungen an Speichergeräte](#greengrass-v2-requirements).
Die Greengrass Nucleus-Komponente wird für die Ausführung in einer VPC unterstützt. Um diese Komponente in einer VPC bereitzustellen, ist Folgendes erforderlich.
+ Die Greengrass Nucleus-Komponente muss über Konnektivität zu AWS IoT data, AWS IoT Credentials und Amazon S3 verfügen.
## Abhängigkeiten
Der Greengrass-Kern beinhaltet keine Komponentenabhängigkeiten. Einige der von AWS-bereitgestellten Komponenten beinhalten jedoch den Nukleus als Abhängigkeit. Weitere Informationen finden Sie unter [AWS-mitgelieferte Komponenten](public-components.md).
Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der [Rezeptreferenz für Komponenten](component-recipe-reference.md#recipe-reference-component-dependencies).
## Herunterladen und Installation
Sie können ein Installationsprogramm herunterladen, das die Greengrass Nucleus-Komponente auf Ihrem Gerät einrichtet. Dieses Installationsprogramm richtet Ihr Gerät als Greengrass-Core-Gerät ein. Es gibt zwei Arten von Installationen, die Sie durchführen können: eine Schnellinstallation, bei der die erforderlichen AWS Ressourcen für Sie erstellt werden, oder eine manuelle Installation, bei der Sie die AWS Ressourcen selbst erstellen. Weitere Informationen finden Sie unter [Installieren Sie die AWS IoT Greengrass Core-Software](install-greengrass-core-v2.md).
Sie können auch einem Tutorial folgen, um den Greengrass-Kern zu installieren und sich mit der Entwicklung von Greengrass-Komponenten vertraut zu machen. Weitere Informationen finden Sie unter [Tutorial: Erste Schritte mit AWS IoT Greengrass V2](getting-started.md).
## Konfiguration
Diese Komponente bietet die folgenden Konfigurationsparameter, die Sie bei der Bereitstellung der Komponente anpassen können. Einige Parameter setzen voraus, dass die AWS IoT Greengrass Core-Software neu gestartet wird, um wirksam zu werden. Weitere Informationen darüber, warum und wie diese Komponente konfiguriert wird, finden Sie unter[Konfiguration der AWS IoT Greengrass Core-Software](configure-greengrass-core-v2.md).
`iotRoleAlias`
Der AWS IoT Rollenalias, der auf eine Token-Exchange-IAM-Rolle verweist. Der Anbieter AWS IoT für Anmeldeinformationen übernimmt diese Rolle, damit das Greengrass-Core-Gerät mit AWS Diensten interagieren kann. Weitere Informationen finden Sie unter [Autorisieren Sie Kerngeräte für die Interaktion mit Diensten AWS](device-service-role.md).
Wenn Sie die AWS IoT Greengrass Core-Software mit dieser `--provision true` Option ausführen, stellt die Software einen Rollenalias bereit und legt seinen Wert in der Nucleus-Komponente fest.
`interpolateComponentConfiguration`
(Optional) Sie können den Greengrass-Kern aktivieren, um [Rezeptvariablen für Komponenten in Komponentenkonfigurationen](component-recipe-reference.md#recipe-variables) zu interpolieren und Konfigurationsupdates [zusammenzuführen](update-component-configurations.md#merge-configuration-update-recipe-variables). Wir empfehlen, diese Option auf zu setzen, `true` damit das Kerngerät Greengrass-Komponenten ausführen kann, die Rezeptvariablen in ihren Konfigurationen verwenden.
Diese Funktion ist für Version 2.6.0 und höher dieser Komponente verfügbar.
Standard: `false`
`networkProxy`
(Optional) Der Netzwerk-Proxy, der für alle Verbindungen verwendet werden soll. Weitere Informationen finden Sie unter [Verbindungsherstellung auf Port 443 oder über einen Netzwerk-Proxy](configure-greengrass-core-v2.md#configure-alpn-network-proxy).
Wenn Sie eine Änderung an diesem Konfigurationsparameter vornehmen, wird die AWS IoT Greengrass Core-Software neu gestartet, damit die Änderung wirksam wird.
Dieses Objekt enthält die folgenden Informationen:
`noProxyAddresses`
(Optional) Eine durch Kommas getrennte Liste von IP-Adressen oder Hostnamen, die vom Proxy ausgenommen sind.
`proxy`
Der Proxy, zu dem eine Verbindung hergestellt werden soll. Dieses Objekt enthält die folgenden Informationen:
`url`
Die URL des Proxyservers im Format`scheme://userinfo@host:port`.
+ `scheme`— Das Schema, das `http` oder sein muss`https`.
**Wichtig**
Greengrass-Core-Geräte müssen [Greengrass Nucleus](#greengrass-nucleus-component) v2.5.0 oder höher ausführen, um HTTPS-Proxys verwenden zu können.
Wenn Sie einen HTTPS-Proxy konfigurieren, müssen Sie das Proxy-Server-CA-Zertifikat zum Amazon-Root-CA-Zertifikat des Kerngeräts hinzufügen. Weitere Informationen finden Sie unter [Ermöglichen Sie dem Kerngerät, einem HTTPS-Proxy zu vertrauen](configure-greengrass-core-v2.md#https-proxy-certificate-trust).
+ `userinfo`— (Optional) Der Benutzername und das Passwort. Wenn Sie diese Informationen in der angeben`url`, ignoriert das Greengrass-Core-Gerät die Felder `username` und`password`.
+ `host`— Der Hostname oder die IP-Adresse des Proxyservers.
+ `port`— (Optional) Die Portnummer. Wenn Sie den Port nicht angeben, verwendet das Greengrass-Core-Gerät die folgenden Standardwerte:
+ `http`— 80
+ `https`— 443
`username`
(Optional) Der Benutzername, der den Proxyserver authentifiziert.
`password`
(Optional) Das Passwort, das den Proxyserver authentifiziert.
`mqtt`
(Optional) Die MQTT-Konfiguration für das Greengrass-Core-Gerät. Weitere Informationen finden Sie unter [Verbindungsherstellung auf Port 443 oder über einen Netzwerk-Proxy](configure-greengrass-core-v2.md#configure-alpn-network-proxy).
Wenn Sie eine Änderung an diesem Konfigurationsparameter vornehmen, wird die AWS IoT Greengrass Core-Software neu gestartet, damit die Änderung wirksam wird.
Dieses Objekt enthält die folgenden Informationen:
`port`
(Optional) Der Port, der für MQTT-Verbindungen verwendet werden soll.
Standard: `8883`
`keepAliveTimeoutMs`
(Optional) Die Zeitspanne in Millisekunden zwischen den einzelnen `PING` Nachrichten, die der Client sendet, um die MQTT-Verbindung aufrechtzuerhalten. Dieser Wert muss größer als sein. `pingTimeoutMs`
Standard: `60000` (60 Sekunden)
`pingTimeoutMs`
(Optional) Die Zeit in Millisekunden, die der Client auf den Empfang einer `PINGACK` Nachricht vom Server wartet. Wenn die Wartezeit das Timeout überschreitet, schließt das Kerngerät die MQTT-Verbindung und öffnet sie erneut. Dieser Wert muss kleiner als sein. `keepAliveTimeoutMs`
Standard: `30000` (30 Sekunden)
`operationTimeoutMs`
(Optional) Die Zeit in Millisekunden, die der Client auf den Abschluss von MQTT-Operationen (wie `CONNECT` oder) wartet. `PUBLISH` Diese Option gilt nicht für `PING` MQTT- oder Keep-Alive-Nachrichten.
Standard: `30000` (30 Sekunden)
`maxInFlightPublishes`
(Optional) Die maximale Anzahl unbestätigter MQTT QoS 1-Nachrichten, die gleichzeitig gesendet werden können.
Diese Funktion ist für Version 2.1.0 und höher dieser Komponente verfügbar.
Standard: `5`
Gültiger Bereich: Maximalwert von 100
`maxMessageSizeInBytes`
(Optional) Die maximale Größe einer MQTT-Nachricht. Wenn eine Nachricht diese Größe überschreitet, lehnt der Greengrass-Kern die Nachricht mit einem Fehler ab.
Diese Funktion ist für Version 2.1.0 und höher dieser Komponente verfügbar.
Standard: `131072` (128 KB)
Gültiger Bereich: Maximalwert von `2621440` (2,5 MB)
`maxPublishRetry`
(Optional) Gibt an, wie oft eine Nachricht, deren Veröffentlichung fehlschlägt, maximal wiederholt werden soll. Sie können angeben, dass der `-1` Wiederholungsversuch unbegrenzt oft erfolgen soll.
Diese Funktion ist für Version 2.1.0 und höher dieser Komponente verfügbar.
Standard: `100`
`spooler`
(Optional) Die MQTT-Spooler-Konfiguration für das Greengrass-Core-Gerät. Dieses Objekt enthält die folgenden Informationen:
`storageType`
Der Speichertyp zum Speichern von Nachrichten. Wenn auf eingestellt `storageType` ist`Disk`, `pluginName` kann der konfiguriert werden. Sie können entweder `Memory` oder `Disk` angeben.
Diese Funktion ist für Version 2.11.0 und höher der [Greengrass](#greengrass-nucleus-component) Nucleus-Komponente verfügbar.
Wenn der MQTT-Spooler auf eingestellt `storageType` ist `Disk` und Sie Greengrass Nucleus von Version 2.11.x auf eine frühere Version downgraden möchten, müssen Sie die Konfiguration wieder auf ändern. `Memory` Die einzige Konfiguration dafür`storageType`, die in den Greengrass Nucleus-Versionen 2.10.x und früher unterstützt wird, ist. `Memory` Die Nichtbeachtung dieser Anleitung kann dazu führen, dass der Spooler kaputt geht. Dies würde dazu führen, dass Ihr Greengrass-Core-Gerät keine MQTT-Nachrichten an den senden kann. AWS Cloud
Standard: `Memory`
`pluginName`
(Optional) Der Name der Plugin-Komponente. Diese Komponente wird nur verwendet, wenn sie auf gesetzt `storageType` ist`Disk`. Diese Option ist standardmäßig auf die von [Festplattenspooler](disk-spooler-component.md) Greengrass bereitgestellte Version eingestellt `aws.greengrass.DiskSpooler` und verwendet diese.
Diese Funktion ist für Version 2.11.0 und höher der [Greengrass](#greengrass-nucleus-component) Nucleus-Komponente verfügbar.
Standard: `"aws.greengrass.DiskSpooler"`
`maxSizeInBytes`
(Optional) Die maximale Größe des Caches, in dem das Kerngerät unverarbeitete MQTT-Nachrichten im Speicher speichert. Wenn der Cache voll ist, werden neue Nachrichten zurückgewiesen.
Standard: `2621440` (2,5 MB)
`keepQos0WhenOffline`
(Optional) Sie können MQTT QoS 0-Nachrichten spoolen, die das Kerngerät empfängt, während es offline ist. Wenn Sie diese Option auf setzen`true`, spoolt das Kerngerät QoS 0-Nachrichten, die es nicht senden kann, während es offline ist. Wenn Sie diese Option auf setzen`false`, verwirft das Kerngerät diese Nachrichten. Das Core-Gerät spoolt immer QoS-1-Nachrichten, sofern der Spool nicht voll ist.
Standard: `false`
`version`
(Optional) Die Version von MQTT. Sie können entweder `mqtt3` oder `mqtt5` angeben.
Diese Funktion ist für Version 2.10.0 und höher der [Greengrass](#greengrass-nucleus-component) Nucleus-Komponente verfügbar.
Standard: `mqtt5`
`receiveMaximum`
(Optional) Die maximale Anzahl unbestätigter QoS1-Pakete, die der Broker senden kann.
Diese Funktion ist für Version 2.10.0 und höher der [Greengrass](#greengrass-nucleus-component) Nucleus-Komponente verfügbar.
Standard: `100`
`sessionExpirySeconds`
(Optional) Die Dauer in Sekunden, die Sie für die Dauer einer Sitzung bei IoT Core anfordern können. Die Standardeinstellung ist die maximale Zeit, die von unterstützt wird AWS IoT Core.
Diese Funktion ist für Version 2.10.0 und höher der [Greengrass](#greengrass-nucleus-component) Nucleus-Komponente verfügbar.
Standard: `604800 (7 days)`
`minimumReconnectDelaySeconds`
(Optional) Eine Option für das Verhalten bei der Wiederverbindung. Die Mindestzeit in Sekunden, die MQTT benötigt, um die Verbindung wiederherzustellen.
Diese Funktion ist für Version 2.10.0 und höher der [Greengrass](#greengrass-nucleus-component) Nucleus-Komponente verfügbar.
Standard: `1`
`maximumReconnectDelaySeconds`
(Optional) Eine Option für das Verhalten bei der Wiederverbindung. Die maximale Zeit in Sekunden, für die MQTT die Verbindung wiederherstellt.
Diese Funktion ist für Version 2.10.0 und höher der [Greengrass](#greengrass-nucleus-component) Nucleus-Komponente verfügbar.
Standard: `120`
`minimumConnectedTimeBeforeRetryResetSeconds`
(Optional) Eine Option für das Verhalten bei der Wiederverbindung. Die Zeitspanne in Sekunden, die eine Verbindung aktiv sein muss, bevor die Wiederholungsverzögerung auf das Minimum zurückgesetzt wird.
Diese Funktion ist für Version 2.10.0 und höher der [Greengrass](#greengrass-nucleus-component) Nucleus-Komponente verfügbar.
Standard: `30`
`jvmOptions`
(Optional) Die JVM-Optionen, die zur Ausführung der Core-Software verwendet werden sollen. AWS IoT Greengrass Informationen zu den empfohlenen JVM-Optionen für die Ausführung der AWS IoT Greengrass Core-Software finden Sie unter. [Steuern Sie die Speicherzuweisung mit JVM-Optionen](configure-greengrass-core-v2.md#jvm-tuning)
Wenn Sie eine Änderung an diesem Konfigurationsparameter bereitstellen, wird die AWS IoT Greengrass Core-Software neu gestartet, damit die Änderung wirksam wird.
`iotDataEndpoint`
Der AWS IoT Datenendpunkt für Ihren AWS-Konto.
Wenn Sie die AWS IoT Greengrass Core-Software mit der `--provision true` Option ausführen, ruft die Software Ihre Daten und Anmeldeinformationen von den Endpunkten ab AWS IoT und legt sie in der Nucleus-Komponente fest.
`iotCredEndpoint`
Der Endpunkt für Ihre AWS IoT AWS-Konto Anmeldeinformationen.
Wenn Sie die AWS IoT Greengrass Core-Software mit der `--provision true` Option ausführen, ruft die Software Ihre Daten und Anmeldeinformationen von den Endpunkten ab AWS IoT und legt sie in der Nucleus-Komponente fest.
`greengrassDataPlaneEndpoint`
Diese Funktion ist in Version 2.7.0 und höher dieser Komponente verfügbar.
Weitere Informationen finden Sie unter [Verwenden Sie ein Gerätezertifikat, das von einer privaten Zertifizierungsstelle signiert wurde](configure-greengrass-core-v2.md#configure-nucleus-private-ca).
`greengrassDataPlanePort`
Diese Funktion ist in Version 2.0.4 und höher dieser Komponente verfügbar.
(Optional) Der Port, der für Datenebenenverbindungen verwendet werden soll. Weitere Informationen finden Sie unter [Verbindungsherstellung auf Port 443 oder über einen Netzwerk-Proxy](configure-greengrass-core-v2.md#configure-alpn-network-proxy).
Sie müssen einen Port angeben, über den das Gerät ausgehende Verbindungen herstellen kann. Wenn Sie einen Port angeben, der gesperrt ist, kann das Gerät keine Verbindung herstellen, um Bereitstellungen AWS IoT Greengrass zu empfangen.
Wählen Sie aus den folgenden Optionen aus:
+ `443`
+ `8443`
Standard: `8443`
`awsRegion`
Der AWS-Region zu verwendende.
`runWithDefault`
Der Systembenutzer, der zum Ausführen von Komponenten verwendet werden soll.
Wenn Sie eine Änderung an diesem Konfigurationsparameter vornehmen, wird die AWS IoT Greengrass Core-Software neu gestartet, damit die Änderung wirksam wird.
Dieses Objekt enthält die folgenden Informationen:
`posixUser`
Der Name oder die ID des Systembenutzers und optional der Systemgruppe, die das Kerngerät verwendet, um generische Komponenten und Lambda-Komponenten auszuführen. Geben Sie den Benutzer und die Gruppe durch einen Doppelpunkt (`:`) getrennt im folgenden Format an: `user:group`. Die Gruppe ist optional. Wenn Sie keine Gruppe angeben, verwendet die AWS IoT Greengrass Core-Software die primäre Gruppe für den Benutzer. Sie können beispielsweise `ggc_user` oder `ggc_user:ggc_group` angeben. Weitere Informationen finden Sie unter [Konfigurieren Sie den Benutzer, der die Komponenten ausführt](configure-greengrass-core-v2.md#configure-component-user).
Wenn Sie das AWS IoT Greengrass Core-Softwareinstallationsprogramm mit der `--component-default-user ggc_user:ggc_group` Option ausführen, legt die Software diesen Parameter in der Nucleus-Komponente fest.
`windowsUser`
Diese Funktion ist in Version 2.5.0 und höher dieser Komponente verfügbar.
Der Name des Windows-Benutzers, der für die Ausführung dieser Komponente auf Windows Core-Geräten verwendet werden soll. Der Benutzer muss auf jedem Windows Core-Gerät vorhanden sein, und sein Name und Passwort müssen in der Credentials Manager-Instanz des LocalSystem Kontos gespeichert sein. Weitere Informationen finden Sie unter [Konfigurieren Sie den Benutzer, der die Komponenten ausführt](configure-greengrass-core-v2.md#configure-component-user).
Wenn Sie das AWS IoT Greengrass Core-Softwareinstallationsprogramm mit der `--component-default-user ggc_user` Option ausführen, legt die Software diesen Parameter in der Nucleus-Komponente fest.
`systemResourceLimits`
Diese Funktion ist in Version 2.4.0 und höher dieser Komponente verfügbar. AWS IoT Greengrass unterstützt diese Funktion derzeit nicht auf Windows Core-Geräten.
Die Systemressourcenlimits, die standardmäßig für generische und nicht containerisierte Lambda-Komponentenprozesse gelten sollen. Sie können die Systemressourcenlimits für einzelne Komponenten überschreiben, wenn Sie eine Bereitstellung erstellen. Weitere Informationen finden Sie unter [Konfigurieren Sie die Systemressourcenlimits für Komponenten](configure-greengrass-core-v2.md#configure-component-system-resource-limits).
Dieses Objekt enthält die folgenden Informationen:
`cpus`
Die maximale Menge an CPU-Zeit, die die Prozesse der einzelnen Komponenten auf dem Kerngerät verwenden können. Die gesamte CPU-Zeit eines Core-Geräts entspricht der Anzahl der CPU-Kerne des Geräts. Auf einem Core-Gerät mit 4 CPU-Kernen können Sie diesen Wert beispielsweise auf festlegen, `2` um die Prozesse jeder Komponente auf 50 Prozent der Auslastung jedes CPU-Kerns zu beschränken. Auf einem Gerät mit einem CPU-Kern können Sie diesen Wert auf festlegen, `0.25` um die Prozesse jeder Komponente auf 25 Prozent der CPU-Auslastung zu beschränken. Wenn Sie diesen Wert auf eine Zahl festlegen, die größer als die Anzahl der CPU-Kerne ist, begrenzt die AWS IoT Greengrass Core-Software die CPU-Auslastung der Komponenten nicht.
`memory`
Die maximale Menge an RAM (in Kilobyte), die die Prozesse jeder Komponente auf dem Kerngerät verwenden können.
`s3EndpointType`
(Optional) Der S3-Endpunkttyp. Dieser Parameter gilt nur für die Region USA Ost (Nord-Virginia) (`us-east-1`). Die Einstellung dieses Parameters aus einer anderen Region wird ignoriert. Wählen Sie aus den folgenden Optionen aus:
+ `REGIONAL`— Der S3-Client und die vorsignierte URL verwenden den regionalen Endpunkt.
+ `GLOBAL`— Der S3-Client und die vorsignierte URL verwenden den Legacy-Endpunkt.
+ `DUALSTACK`— Die vorsignierte S3-URL verwendet den Dual-Stack-Endpunkt.
Standard: `GLOBAL`
`fipsMode`
(Optional) Veranlasst Greengrass, FIPS-Endpunkte zu verwenden. [Weitere Informationen zur Aktivierung von FIPS-Endpunkten finden Sie unter FIPS-Endpunkte.](FIPS.html)
Wählen Sie aus den folgenden Optionen aus:
+ `true`Wenn die Einstellung auf true gesetzt ist, verwenden die Endgeräte den FIPS-Endpunkt.
+ `false`Wenn der Wert falsch ist, verwenden die Endpunkte keinen FIPS-Endpunkt.
Standard: `false`
`logging`
(Optional) Die Protokollierungskonfiguration für das Kerngerät. Weitere Informationen zur Konfiguration und Verwendung von Greengrass-Protokollen finden Sie unter[AWS IoT Greengrass Protokolle überwachen](monitor-logs.md).
Dieses Objekt enthält die folgenden Informationen:
`level`
(Optional) Die Mindestanzahl der auszugebenden Protokollmeldungen.
Wählen Sie aus den folgenden Protokollebenen, die hier in der Reihenfolge der Stufen aufgeführt sind:
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Standard: `INFO`
`format`
(Optional) Das Datenformat der Protokolle. Wählen Sie aus den folgenden Optionen aus:
+ `TEXT`— Wählen Sie diese Option, wenn Sie Protokolle in Textform anzeigen möchten.
+ `JSON`— Wählen Sie diese Option, wenn Sie Protokolle mit dem [Greengrass-CLI-Befehl logs](gg-cli-logs.md) anzeigen oder programmgesteuert mit Protokollen interagieren möchten.
Standard: `TEXT`
`outputType`
(Optional) Der Ausgabetyp für Protokolle. Wählen Sie aus den folgenden Optionen aus:
+ `FILE`— Die AWS IoT Greengrass Core-Software gibt Protokolle in Dateien in dem Verzeichnis aus, das Sie angeben`outputDirectory`.
+ `CONSOLE`— Die AWS IoT Greengrass Core-Software druckt Protokolle in`stdout`. Wählen Sie diese Option, um Protokolle anzuzeigen, während das Core-Gerät sie druckt.
Standard: `FILE`
`fileSizeKB`
(Optional) Die maximale Größe jeder Protokolldatei (in Kilobyte). Wenn eine Protokolldatei diese maximale Dateigröße überschreitet, erstellt die AWS IoT Greengrass Core-Software eine neue Protokolldatei.
Dieser Parameter gilt nur, wenn Sie `FILE` für angeben`outputType`.
Standard: `1024`
`totalLogsSizeKB`
(Optional) Die maximale Gesamtgröße der Protokolldateien (in Kilobyte) für jede Komponente, einschließlich des Greengrass-Kerns. Die Protokolldateien von Greengrass Nucleus enthalten auch Protokolle von [Plugin-Komponenten](develop-greengrass-components.md#component-types). Wenn die Gesamtgröße der Protokolldateien einer Komponente diese maximale Größe überschreitet, löscht die AWS IoT Greengrass Core-Software die ältesten Protokolldateien dieser Komponente.
Dieser Parameter entspricht dem Parameter für die [Speicherplatzbeschränkung](log-manager-component.md#log-manager-component-configuration) (`diskSpaceLimit`) der [Log Manager-Komponente](log-manager-component.md), den Sie für den Greengrass-Kern (System) und jede Komponente angeben können. Die AWS IoT Greengrass Core-Software verwendet das Minimum der beiden Werte als maximale Gesamtprotokollgröße für den Greengrass-Kern und jede Komponente.
Dieser Parameter gilt nur, wenn Sie `FILE` für `outputType` angeben.
Standard: `10240`
`outputDirectory`
(Optional) Das Ausgabeverzeichnis für Protokolldateien.
Dieser Parameter gilt nur, wenn Sie `FILE` für angeben`outputType`.
Standard:`/greengrass/v2/logs`, wo `/greengrass/v2` ist der AWS IoT Greengrass Stammordner.
`fleetstatus`
Dieser Parameter ist in Version 2.1.0 und höher dieser Komponente verfügbar.
(Optional) Die Flottenstatuskonfiguration für das Kerngerät.
Dieses Objekt enthält die folgenden Informationen:
`periodicStatusPublishIntervalSeconds`
(Optional) Der Zeitraum (in Sekunden), zwischen dem das Kerngerät den Gerätestatus an den veröffentlicht AWS Cloud.
Minimum: `86400` (24 Stunden)
Standard: `86400` (24 Stunden)
`telemetry`
(Optional) Die Konfiguration der Systemintegritäts-Telemetrie für das Kerngerät. Weitere Informationen zu Telemetriemetriken und dazu, wie Sie mit Telemetriedaten umgehen können, finden Sie unter. [Erfassung von Telemetriedaten zur Systemintegrität von AWS IoT Greengrass Kerngeräten](telemetry.md)
Dieses Objekt enthält die folgenden Informationen:
`enabled`
(Optional) Sie können Telemetrie aktivieren oder deaktivieren.
Standard: `true`
`periodicAggregateMetricsIntervalSeconds`
(Optional) Das Intervall (in Sekunden), über das das Kerngerät Metriken aggregiert.
Wenn Sie diesen Wert unter den unterstützten Mindestwert setzen, verwendet der Nucleus stattdessen den Standardwert.
Minimum: `3600`
Standard: `3600`
`periodicPublishMetricsIntervalSeconds`
(Optional) Der Zeitraum (in Sekunden), zwischen dem das Kerngerät Telemetriedaten an den AWS Cloud veröffentlicht.
Wenn Sie diesen Wert unter den unterstützten Mindestwert einstellen, verwendet der Nucleus stattdessen den Standardwert.
Minimum: `86400`
Standard: `86400`
`deploymentPollingFrequencySeconds`
(Optional) Der Zeitraum in Sekunden, für den Bereitstellungsbenachrichtigungen abgefragt werden sollen.
Standard: `15`
`componentStoreMaxSizeBytes`
(Optional) Die maximale Größe des Komponentenspeichers auf der Festplatte, der Komponentenrezepte und Artefakte umfasst.
Standard: `10000000000` (10 GB)
`platformOverride`
(Optional) Ein Wörterbuch mit Attributen, die die Plattform des Kerngeräts identifizieren. Verwenden Sie dies, um benutzerdefinierte Plattformattribute zu definieren, anhand derer Komponentenrezepte den richtigen Lebenszyklus und die richtigen Artefakte für die Komponente identifizieren können. Sie können beispielsweise ein Hardwarefähigkeitsattribut definieren, um nur die minimale Menge an Artefakten bereitzustellen, die für die Ausführung einer Komponente erforderlich sind. Weitere Informationen finden Sie unter dem [Plattformparameter Manifest](component-recipe-reference.md#component-platform-definition) im Komponentenrezept.
Sie können diesen Parameter auch verwenden, um die `os` und die `architecture` Plattformattribute des Kerngeräts zu überschreiben.
`httpClient`
Dieser Parameter ist in Version 2.5.0 und höher dieser Komponente verfügbar.
(Optional) Die HTTP-Client-Konfiguration für das Kerngerät. Diese Konfigurationsoptionen gelten für alle HTTP-Anfragen, die von dieser Komponente gestellt werden. Wenn ein Core-Gerät in einem langsameren Netzwerk läuft, können Sie diese Timeout-Dauern erhöhen, um zu verhindern, dass bei HTTP-Anfragen ein Timeout auftritt.
Dieses Objekt enthält die folgenden Informationen:
`connectionTimeoutMs`
(Optional) Die Zeitspanne (in Millisekunden), die auf das Öffnen einer Verbindung gewartet werden soll, bevor bei der Verbindungsanforderung ein Timeout eintritt.
Standard: `2000` (2 Sekunden)
`socketTimeoutMs`
(Optional) Die Zeitspanne (in Millisekunden), die auf die Übertragung von Daten über eine offene Verbindung gewartet werden soll, bevor bei der Verbindung ein Timeout eintritt.
Standard: `30000` (30 Sekunden)
`deploymentConfigurationTimeSource`
Dieser Parameter ist in Version 2.15.0 und höher dieser Komponente verfügbar.
(Optional) Der Zeitstempel, der bei der Verarbeitung einer Bereitstellung verwendet werden soll. Die Standardeinstellung ist der`deploymentCreationTime`.
Dieses Objekt enthält die folgenden Werte:
`deploymentCreationTime`
Der Standardwert von`deploymentConfigurationTimeSource`. Das Gerät verwendet den Zeitstempel für die Erstellung der Bereitstellung, um Konflikte mit den Konfigurationsschlüsseln während der Verarbeitung zu lösen. Wenn dieses Verhalten ausgewählt ist, hat die lokale Gerätekonfiguration, die im Nucleus gespeichert ist, möglicherweise einen längeren Zeitstempel als der der eingehenden Bereitstellung und lehnt eingehende Konfigurationsänderungen ab, die jetzt als veraltet gelten.
`deploymentProcessingTime`
Das Gerät verwendet seinen lokalen Zeitstempel, um Konflikte mit den Konfigurationsschlüsseln während der Bereitstellung zu lösen. Bei der Verarbeitung aktualisiert das Gerät die Konfigurationen anhand des Verarbeitungszeitstempels und nicht anhand des Zeitstempels für die Erstellung der Bereitstellung. Dieses Verhalten setzt voraus, dass die Uhr des Geräts ordnungsgemäß kalibriert ist.
Konfigurieren Sie diese Nucleus-Einstellung in Ihrem ersten Geräte-Image oder Ihrer ersten Installation und nicht im Rahmen einer Bereitstellung, wenn Sie möchten, dass neue Geräte dieses Verhalten bei der ersten Verbindung verwenden. Verwenden Sie für diese Konfiguration die [https://docs.aws.amazon.com/greengrass/v2/developerguide/configure-installer.html](https://docs.aws.amazon.com/greengrass/v2/developerguide/configure-installer.html)Option des Nucleus Classic-Installationsprogramms.
Diese Erstkonfiguration ist wichtig, da Geräte mehrere Bereitstellungen in beliebiger Reihenfolge verarbeiten. Ohne eine korrekte Erstkonfiguration verarbeitet ein Gerät möglicherweise Bereitstellungen mit dem `deploymentCreationTime` Standardverhalten, bevor es die Bereitstellung empfängt, die die Nucleus-Konfiguration auf festlegt. `deploymentProcessingTime`
**Example Beispiel: Aktualisierung der Zusammenführung von Konfigurationen**
```
{
"iotRoleAlias": "GreengrassCoreTokenExchangeRoleAlias",
"networkProxy": {
"noProxyAddresses": "http://192.168.0.1,www.example.com",
"proxy": {
"url": "http://my-proxy-server:1100",
"username": "Mary_Major",
"password": "pass@word1357"
}
},
"mqtt": {
"port": 443
},
"greengrassDataPlanePort": 443,
"jvmOptions": "-Xmx64m",
"runWithDefault": {
"posixUser": "ggc_user:ggc_group"
}
}
```
## Lokale Protokolldatei
Diese Komponente verwendet die folgende Protokolldatei.
------
#### [ Linux ]
```
/greengrass/v2/logs/greengrass.log
```
------
#### [ Windows ]
```
C:\greengrass\v2\logs\greengrass.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:\$1greengrass\$1v2* durch den Pfad zum AWS IoT Greengrass Stammordner.
------
#### [ Linux ]
```
sudo tail -f /greengrass/v2/logs/greengrass.log
```
------
#### [ Windows (PowerShell) ]
```
Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
```
------
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| **Version** | **Änderungen** |
| --- | --- |
| 2.16.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.16.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.15.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.15.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.14.3 | Fehlerkorrekturen und Verbesserungen [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.14.2 | Fehlerkorrekturen und Verbesserungen [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.14.1 | Fehlerkorrekturen und Verbesserungen [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.14.0 | Diese Version ist nicht mehr verfügbar. Die Verbesserungen in dieser Version sind in späteren Versionen dieser Komponente verfügbar. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.13.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.12.6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.12.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.12.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.12.3 | Diese Version ist nicht mehr verfügbar. Die Verbesserungen in dieser Version sind in späteren Versionen dieser Komponente verfügbar. Fehlerkorrekturen und Verbesserungen [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.12.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.12.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.12.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.11.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.11.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.11.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.11.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.10.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.10.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.10.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.10.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.9.6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.9.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.9.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.9.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.9.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.9.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.9.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.8.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.8.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.7.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.6.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.5.6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.5.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.5.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.5.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.5.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.5.1 | Diese Version ist nicht mehr verfügbar. Die Verbesserungen in dieser Version sind in späteren Versionen dieser Komponente verfügbar. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.5.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.4.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.3.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.2.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.0.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.0.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-component.html) |
| 2.0.3 | Erste Version |
# Greengrass Nucleus Lite
Der Greengrass Nucleus Lite (`aws.greengrass.NucleusLite`) ist eine Gerätelaufzeit für Geräte mit eingeschränktem Netzwerkrand, die für minimalen Speicherbedarf optimiert ist (verwendet weniger als 5 MB RAM). Es wurde mit AWS IoT Greengrass Version 2.14.0 eingeführt und ist abwärtskompatibel mit AWS IoT Greengrass generischen Komponenten, der Greengrass V2-API und dem SDK.
Der Greengrass Nucleus lite wird als Alternative zum herkömmlichen [Greengrass Nucleus (`aws.greengrass.Nucleus`)](https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-nucleus-component.html) angeboten und kann in heterogenen Flotten von Greengrass-Geräten eingesetzt werden.
**Topics**
+ [Versionen](#greengrass-nucleus-lite-component-versions)
+ [Betriebssystem](#greengrass-nucleus-lite-component-os-support)
+ [Voraussetzungen](#greengrass-nucleus-lite-component-requirements)
+ [Kompatibilität](#greengrass-nucleus-lite-component-compatibility)
+ [Herunterladen und Installation](#greengrass-nucleus-lite-component-install)
+ [Konfiguration](#greengrass-nucleus-lite-component-configuration)
+ [Lokale Protokolldatei](#greengrass-nucleus-lite-component-log-file)
+ [Änderungsprotokoll](#greengrass-nucleus-lite-component-changelog)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 2.3.x
+ 2.2.x
+ 2.1.x
+ 2.0.x
## Betriebssystem
Diese Komponente kann auf Kerngeräten installiert werden, auf denen die folgenden Betriebssysteme ausgeführt werden:
+ Linux (Distributionen mit Systemd)
Weitere Informationen finden Sie unter [Greengrass Nucleus](https://docs.aws.amazon.com/greengrass/v2/developerguide/operating-system-feature-support-matrix.html).
## Voraussetzungen
Geräte müssen bestimmte Anforderungen erfüllen, um AWS IoT Greengrass Nucleus Lite und die AWS IoT Greengrass Core-Software installieren und ausführen zu können. Weitere Informationen finden Sie in der [Einrichtungsanleitung](https://github.com/aws-greengrass/aws-greengrass-lite/blob/main/docs/SETUP.md#setting-up-greengrass-nucleus-lite).
+ 5 MB RAM-Speicherplatz für die Nucleus-Laufzeit.
+ 5 MB Speicher (Festplatte/Flash).
[Zusätzliche Systemabhängigkeiten sind im Setup-Handbuch dokumentiert.](https://github.com/aws-greengrass/aws-greengrass-lite/blob/main/docs/SETUP.md#dependencies)
Die Greengrass Nucleus-Komponente wird für die Ausführung in einer VPC unterstützt. Um diese Komponente in einer VPC bereitzustellen, ist Folgendes erforderlich:
+ Der Greengrass-Kern muss über Konnektivität zu AWS IoT Daten, AWS IoT Anmeldeinformationen und Amazon S3 verfügen.
## Kompatibilität
Der AWS IoT Greengrass Nucleus Lite ist mit der AWS IoT Greengrass v2-API (Teilmenge von) kompatibel und wird unterstützt. SDKs Es hängt nicht von einer bestimmten Sprache ab, runtimes/VMs aber Komponenten, die zu einer Bereitstellung hinzugefügt werden, können das Vorhandensein bestimmter Laufzeiten erfordern (z. B.: Java JVM, Python). Weitere Informationen darüber, welche Funktionen von Greengrass Nucleus Lite unterstützt werden, finden Sie unter[Kompatibilität der Greengrass-Funktionen](operating-system-feature-support-matrix.md).
## Herunterladen und Installation
Sie können ein APT-Paket herunterladen, [aus dem Quellcode bauen](https://github.com/aws-greengrass/aws-greengrass-lite/blob/main/README.md#getting-started), [eine Yocto-Ebene verwenden](https://github.com/aws4embeddedlinux/meta-aws) oder ein [vorgefertigtes Yocto-Image für ein kompatibles Gerät herunterladen](https://github.com/aws4embeddedlinux/meta-aws-demos) (z. B.). RaspberryPi Von der [AWS IoT Core Konsole](https://console.aws.amazon.com/iot/home) aus können Sie ein **Verbindungskit** herunterladen, das alle Anmeldeinformationen und die Erstkonfiguration für Ihr Gerät enthält. Anweisungen zur Installation sind in jeder spezifischen Verteilungsmethode enthalten.
Sie können auch einem Tutorial folgen, um AWS IoT Greengrass Nucleus Lite zu installieren und sich mit der Entwicklung von Greengrass-Komponenten vertraut zu machen. Weitere Informationen finden Sie unter [Tutorial: Erste Schritte mit AWS IoT Greengrass V2](getting-started.md).
## Konfiguration
Der Nucleus bietet die folgenden [Konfigurationsparameter](https://github.com/aws-greengrass/aws-greengrass-lite/blob/main/docs/SETUP.md#configuring-greengrass). Einige Parameter setzen voraus, dass die AWS IoT Greengrass Core-Software neu gestartet wird, um wirksam zu werden.
`iotRoleAlias`
Der AWS IoT Rollenalias, der auf eine Token-Exchange-IAM-Rolle verweist. Der Anbieter AWS IoT für Anmeldeinformationen übernimmt diese Rolle, damit das Greengrass-Core-Gerät mit AWS Diensten interagieren kann. Weitere Informationen finden Sie unter [Autorisieren von Kerngeräten für die Interaktion mit AWS Diensten](https://docs.aws.amazon.com/greengrass/v2/developerguide/device-service-role.html).
`iotDataEndpoint`
Der AWS IoT Datenendpunkt für Ihren AWS-Konto.
`iotCredEndpoint`
Der Endpunkt der AWS IoT Anmeldeinformationen für Ihren AWS-Konto.
`greengrassDataPlanePort`
Der Port, der für Datenebenenverbindungen verwendet werden soll. Weitere Informationen finden Sie unter [Connect über Port 443 oder über einen Netzwerk-Proxy](https://docs.aws.amazon.com/greengrass/v2/developerguide/configure-greengrass-core-v2.html#configure-alpn-network-proxy) herstellen.
Sie müssen einen Port angeben, über den das Gerät ausgehende Verbindungen herstellen kann. Wenn Sie einen Port angeben, der gesperrt ist, kann das Gerät keine Verbindung herstellen, um Bereitstellungen AWS IoT Greengrass zu empfangen. Wählen Sie aus den folgenden Optionen aus:
+ `443`
+ `8443`
+ Standard: `8443`
`awsRegion`
Der AWS-Region zu verwendende.
`runWithDefault`
Der Systembenutzer, der zum Ausführen von Komponenten verwendet werden soll.
Wenn Sie eine Änderung an diesem Konfigurationsparameter vornehmen, wird die AWS IoT Greengrass Core-Software neu gestartet, damit die Änderung wirksam wird.
Dieses Objekt enthält die folgenden Informationen:
`posixUser`
Der Name oder die ID des Systembenutzers und optional der Systemgruppe, die das Kerngerät zur Ausführung generischer Komponenten verwendet. Geben Sie den Benutzer und die Gruppe durch einen Doppelpunkt (`:`) getrennt im folgenden Format an: `user:group`. Die Gruppe ist optional. Wenn Sie keine Gruppe angeben, verwendet die AWS IoT Greengrass Core-Software die primäre Gruppe für den Benutzer. Sie können beispielsweise `ggc_user` oder `ggc_user:ggc_group` angeben. Weitere Informationen finden Sie unter [Konfigurieren Sie den Benutzer, der die Komponenten ausführt](configure-greengrass-core-v2.md#configure-component-user).
`networkProxy`
(Optional) Der Netzwerk-Proxy, der für alle Verbindungen verwendet werden soll. Weitere Informationen finden Sie unter [Verbindungsherstellung auf Port 443 oder über einen Netzwerk-Proxy](configure-greengrass-core-v2.md#configure-alpn-network-proxy).
Wenn Sie eine Änderung an diesem Konfigurationsparameter vornehmen, wird die Änderung nach dem nächsten Neustart der AWS IoT Greengrass Core-Software wirksam.
Dieses Objekt enthält die folgenden Informationen:
`noProxyAddresses`
(Optional) Eine durch Kommas getrennte Liste von IP-Adressen oder Hostnamen, die vom Proxy ausgenommen sind.
`proxy`
Der Proxy, zu dem eine Verbindung hergestellt werden soll. Dieses Objekt enthält die folgenden Informationen:
`url`
Die URL des Proxyservers im Format`http://host:port`.
+ `scheme`— Das Schema, das sein muss`http`.
+ `host`— Der Hostname oder die IP-Adresse des Proxyservers.
+ `port`— (Optional) Die Portnummer. Wenn Sie den Port nicht angeben, verwendet das Greengrass-Core-Gerät den folgenden Standardwert:
+ `http`— 80
## Lokale Protokolldatei
Nachrichten werden in der Standardausgabe protokolliert und die Protokolldateien werden von Systemd verarbeitet.
**Um die Protokolle dieser Komponente einzusehen**
+ Dient `journalctl` zum Anzeigen von Protokollen.
## Änderungsprotokoll
| **Version** | **Änderungen** |
| --- | --- |
| 2.3.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html) |
| 2.3.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html) |
| 2.3.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html) |
| 2.2.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html) |
| 2.2.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html) |
| 2.2.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html) |
| 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html) |
| 2.0.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html) |
| 2.0.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html) |
| 2.0.0 | Erste Version |
# Authentifizierung auf Client-Geräten
Die Authentifizierungskomponente für Clientgeräte (`aws.greengrass.clientdevices.Auth`) authentifiziert Client-Geräte und autorisiert Aktionen auf Client-Geräten.
**Anmerkung**
Client-Geräte sind lokale IoT-Geräte, die eine Verbindung zu einem Greengrass-Core-Gerät herstellen, um MQTT-Nachrichten und Daten zur Verarbeitung zu senden. Weitere Informationen finden Sie unter [Interagieren Sie mit lokalen IoT-Geräten](interact-with-local-iot-devices.md).
**Topics**
+ [Versionen](#client-device-auth-component-versions)
+ [Typ](#client-device-auth-component-type)
+ [Betriebssystem](#client-device-auth-component-os-support)
+ [Voraussetzungen](#client-device-auth-component-requirements)
+ [Abhängigkeiten](#client-device-auth-component-dependencies)
+ [Konfiguration](#client-device-auth-component-configuration)
+ [Lokale Protokolldatei](#client-device-auth-component-log-file)
+ [Änderungsprotokoll](#client-device-auth-component-changelog)
## Versionen
**Anmerkung**
Version 2.3.0 für die Client-Geräteauthentifizierung wurde eingestellt. Es wird dringend empfohlen, auf Version 2.3.1 oder höher für die Client-Geräteauthentifizierung zu aktualisieren.
Diese Komponente hat die folgenden Versionen:
+ 2.5.x
+ 2.4.x
+ 2.3.x
+ 2.2.x
+ 2.1.x
+ 2.0.x
## Typ
Diese Komponente ist eine Plugin-Komponente (`aws.greengrass.plugin`). Der [Greengrass-Kern führt diese Komponente in derselben Java Virtual Machine (JVM) wie der Nucleus](greengrass-nucleus-component.md) aus. Der Nucleus wird neu gestartet, wenn Sie die Version dieser Komponente auf dem Kerngerät ändern.
Diese Komponente verwendet dieselbe Protokolldatei wie der Greengrass-Kern. Weitere Informationen finden Sie unter [AWS IoT Greengrass Protokolle überwachen](monitor-logs.md).
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## 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 [Greengrass-Servicerolle](greengrass-service-role.md) muss Ihrer zugeordnet sein AWS-Konto und die `iot:DescribeCertificate` Genehmigung zulassen.
+ Die AWS IoT Richtlinie des Kerngeräts muss die folgenden Berechtigungen zulassen:
+ `greengrass:GetConnectivityInfo`, wobei die Ressourcen den ARN des Kerngeräts enthalten, auf dem diese Komponente ausgeführt wird
+ `greengrass:VerifyClientDeviceIoTCertificateAssociation`, wobei die Ressourcen den Amazon-Ressourcennamen (ARN) jedes Client-Geräts enthalten, das eine Verbindung zum Kerngerät herstellt
+ `greengrass:VerifyClientDeviceIdentity`
+ `greengrass:PutCertificateAuthorities`
+ `iot:Publish`, wobei die Ressourcen den ARN des folgenden MQTT-Themas beinhalten:
+ `$aws/things/coreDeviceThingName*-gci/shadow/get`
+ `iot:Subscribe`, wobei die Ressourcen die folgenden MQTT-Themenfilter enthalten: ARNs
+ `$aws/things/coreDeviceThingName*-gci/shadow/update/delta`
+ `$aws/things/coreDeviceThingName*-gci/shadow/get/accepted`
+ `iot:Receive`, wobei die Ressourcen die folgenden MQTT-Themen beinhalten: ARNs
+ `$aws/things/coreDeviceThingName*-gci/shadow/update/delta`
+ `$aws/things/coreDeviceThingName*-gci/shadow/get/accepted`
Weitere Informationen erhalten Sie unter [AWS IoT Richtlinien für den Betrieb auf Datenebene](device-auth.md#iot-policies) und [Minimale AWS IoT Richtlinie zur Unterstützung von Client-Geräten](device-auth.md#client-device-support-minimal-iot-policy).
+ (Optional) Um die Offline-Authentifizierung zu verwenden, muss die vom AWS IoT Greengrass Dienst verwendete AWS Identity and Access Management (IAM-) Rolle die folgende Berechtigung enthalten:
+ `greengrass:ListClientDevicesAssociatedWithCoreDevice`um es dem Kerngerät zu ermöglichen, Clients für die Offline-Authentifizierung aufzulisten.
+ Die Authentifizierungskomponente für Clientgeräte wird für die Ausführung in einer VPC unterstützt. Um diese Komponente in einer VPC bereitzustellen, ist Folgendes erforderlich.
+ Die Authentifizierungskomponente für das Client-Gerät muss über Konnektivität zu AWS IoT data, AWS IoT Anmeldeinformationen und Amazon S3 verfügen.
### 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](allow-device-traffic.md).
| Endpoint | Port | Erforderlich | Description |
| --- | --- | --- | --- |
| `iot.region.amazonaws.com` | 443 | Ja | Wird verwendet, um Informationen über AWS IoT Ding-Zertifikate abzurufen. |
## Abhängigkeiten
Wenn Sie eine Komponente bereitstellen, stellt sie 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](#client-device-auth-component-changelog) 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](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.
------
#### [ 2.5.5 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.5.5 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,6,0 <2,17,0 | Weich |
------
#### [ 2.5.4 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.5.4 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.6.0 <2.16.0 | Weich |
------
#### [ 2.5.2 – 2.5.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.5.2 und 2.5.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.6.0 <2.15.0 | Weich |
------
#### [ 2.5.1 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.5.1 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.6.0 <2.14.0 | Weich |
------
#### [ 2.4.4 - 2.5.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.4.4 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.6.0 <2.13.0 | Weich |
------
#### [ 2.4.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.4.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.6.0 <2.12.0 | Weich |
------
#### [ 2.4.1 and 2.4.2 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.4.1 und 2.4.2 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.6.0 <2.11.0 | Weich |
------
#### [ 2.3.0 – 2.4.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.3.0 bis 2.4.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.6.0 <2.10.0 | Weich |
------
#### [ 2.3.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.3.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.6.0 <2.10.0 | Weich |
------
#### [ 2.2.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.2.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,6,0 <=2,9,0 | Weich |
------
#### [ 2.2.2 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.2.2 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,6,0 <=2,8,0 | Weich |
------
#### [ 2.2.1 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.2.1 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,6,0 <2,8,0 | Weich |
------
#### [ 2.2.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.2.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.6.0 <2.7.0 | Weich |
------
#### [ 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](greengrass-nucleus-component.md) | >=2.2.0 <2.7.0 | Weich |
------
#### [ 2.0.4 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.4 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.2.0 <2.6.0 | Weich |
------
#### [ 2.0.2 and 2.0.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.0.2 und 2.0.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.2.0 <2.5.0 | Weich |
------
#### [ 2.0.1 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.1 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.2.0 <2.4.0 | Weich |
------
#### [ 2.0.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.2.0 <2.3.0 | Weich |
------
[Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den Komponentenrezepten.](component-recipe-reference.md#recipe-reference-component-dependencies)
## Konfiguration
Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.
**Anmerkung**
Die Abonnementberechtigung wird während einer Client-Abonnementanfrage an den lokalen MQTT-Broker ausgewertet. Wenn die bestehende Abonnementberechtigung des Kunden widerrufen wird, kann der Client ein Thema nicht mehr abonnieren. Er wird jedoch weiterhin Nachrichten zu Themen empfangen, die zuvor abonniert wurden. Um dieses Verhalten zu verhindern, sollte der lokale MQTT-Broker nach dem Widerruf der Abonnementberechtigung neu gestartet werden, um die erneute Autorisierung von Clients zu erzwingen.
Aktualisieren Sie für die Komponente MQTT 5-Broker (EMQX) die `restartIdentifier` Konfiguration, um den MQTT 5-Broker neu zu starten.
Für die Komponente MQTT 3.1.1 Broker (Moquette) wird sie standardmäßig wöchentlich neu gestartet, wenn sich das Serverzertifikat ändert und die Clients gezwungen sind, sich erneut zu autorisieren. Sie können einen Neustart erzwingen, indem Sie entweder die Konnektivitätsinformationen (IP-Adressen) des Kerngeräts ändern oder indem Sie eine Einrichtung vornehmen, um die Broker-Komponente zu entfernen und sie später erneut bereitzustellen.
------
#### [ v2.5.0 – 2.5.4 ]
`deviceGroups`
Gerätegruppen sind Gruppen von Clientgeräten, die berechtigt sind, eine Verbindung zu einem Kerngerät herzustellen und mit diesem zu kommunizieren. Verwenden Sie Auswahlregeln, um Gruppen von Client-Geräten zu identifizieren, und definieren Sie *Autorisierungsrichtlinien für Client-Geräte*, die die Berechtigungen für jede Gerätegruppe spezifizieren.
Dieses Objekt enthält die folgenden Informationen:
`formatVersion`
Die Formatversion für dieses Konfigurationsobjekt.
Wählen Sie aus den folgenden Optionen aus:
+ `2021-03-05`
`definitions`
Die Gerätegruppen für dieses Kerngerät. Jede Definition gibt eine *Auswahlregel an*, mit der bewertet wird, ob ein Client-Gerät Mitglied der Gruppe ist. Jede Definition gibt auch die Berechtigungsrichtlinie an, die auf Client-Geräte angewendet werden soll, die der Auswahlregel entsprechen. Wenn ein Client-Gerät Mitglied mehrerer Gerätegruppen ist, setzen sich die Berechtigungen des Geräts aus den Berechtigungsrichtlinien der einzelnen Gruppen zusammen.
Dieses Objekt enthält die folgenden Informationen:
`groupNameKey`
Der Name dieser Gerätegruppe. *groupNameKey*Ersetzen Sie ihn durch einen Namen, der Ihnen hilft, diese Gerätegruppe zu identifizieren.
Dieses Objekt enthält die folgenden Informationen:
`selectionRule`
Die Abfrage, die angibt, welche Client-Geräte Mitglieder dieser Gerätegruppe sind. Wenn ein Client-Gerät eine Verbindung herstellt, wertet das Core-Gerät diese Auswahlregel aus, um festzustellen, ob das Client-Gerät Mitglied dieser Gerätegruppe ist. Wenn das Client-Gerät Mitglied ist, verwendet das Kerngerät die Richtlinie dieser Gerätegruppe, um die Aktionen des Client-Geräts zu autorisieren.
Jede Auswahlregel umfasst mindestens eine *Auswahlregelklausel, bei der* es sich um eine Abfrage mit einem einzelnen Ausdruck handelt, die auf Client-Geräte zutreffen kann. Auswahlregeln verwenden dieselbe Abfragesyntax wie die AWS IoT Flottenindizierung. Weitere Informationen zur Syntax von Auswahlregeln finden Sie unter [Abfragesyntax für die AWS IoT Flottenindizierung](https://docs.aws.amazon.com/iot/latest/developerguide/query-syntax.html) im *AWS IoT Core Entwicklerhandbuch*.
Verwenden Sie den `*` Platzhalter, um mehreren Client-Geräten eine Auswahlregelklausel zuzuordnen. Sie können diesen Platzhalter am Anfang und Ende des Dingnamens verwenden, um nach Client-Geräten zu suchen, deren Namen mit der von Ihnen angegebenen Zeichenfolge beginnen oder enden. Sie können diesen Platzhalter auch verwenden, um alle Client-Geräte abzugleichen.
Um einen Wert auszuwählen, der einen Doppelpunkt (`:`) enthält, maskieren Sie den Doppelpunkt mit einem umgekehrten Schrägstrich (). `\` In Formaten wie JSON müssen Sie umgekehrte Schrägstriche maskieren, sodass Sie vor dem Doppelpunkt zwei umgekehrte Schrägstriche eingeben. Geben Sie beispielsweise an, dass Sie ein Ding auswählen `thingName: MyTeam\\:ClientDevice1` möchten, dessen Name lautet. `MyTeam:ClientDevice1`
Sie können den folgenden Selektor angeben:
+ `thingName`— Der Name des Dings eines Client-Geräts. AWS IoT
**Example Beispiel für eine Auswahlregel**
Die folgende Auswahlregel entspricht Client-Geräten mit dem Namen `MyClientDevice1` oder`MyClientDevice2`.
```
thingName: MyClientDevice1 OR thingName: MyClientDevice2
```
**Example Beispiel für eine Auswahlregel (verwenden Sie Platzhalter)**
Die folgende Auswahlregel entspricht Client-Geräten, deren Namen mit `MyClientDevice` beginnen.
```
thingName: MyClientDevice*
```
**Example Beispiel für eine Auswahlregel (verwenden Sie Platzhalter)**
Die folgende Auswahlregel entspricht Client-Geräten, deren Namen auf enden`MyClientDevice`.
```
thingName: *MyClientDevice
```
**Example Beispiel für eine Auswahlregel (trifft auf alle Geräte zu)**
Die folgende Auswahlregel gilt für alle Client-Geräte.
```
thingName: *
```
`policyName`
Die Berechtigungsrichtlinie, die für Client-Geräte in dieser Gerätegruppe gilt. Geben Sie den Namen einer Richtlinie an, die Sie im `policies` Objekt definieren.
`policies`
Die Autorisierungsrichtlinien für Client-Geräte für Client-Geräte, die eine Verbindung zum Kerngerät herstellen. Jede Autorisierungsrichtlinie spezifiziert eine Reihe von Aktionen und die Ressourcen, über die ein Client-Gerät diese Aktionen ausführen kann.
Dieses Objekt enthält die folgenden Informationen:
`policyNameKey`
Der Name dieser Autorisierungsrichtlinie. *policyNameKey*Ersetzen Sie ihn durch einen Namen, anhand dessen Sie diese Autorisierungsrichtlinie leichter identifizieren können. Sie verwenden diesen Richtliniennamen, um zu definieren, welche Richtlinie für eine Gerätegruppe gilt.
Dieses Objekt enthält die folgenden Informationen:
`statementNameKey`
Der Name dieser Richtlinienerklärung. *statementNameKey*Ersetzen Sie ihn durch einen Namen, anhand dessen Sie diese Grundsatzerklärung leichter identifizieren können.
Dieses Objekt enthält die folgenden Informationen:
`operations`
Die Liste der Vorgänge, bei denen die Ressourcen in dieser Richtlinie berücksichtigt werden sollen.
Sie können jede der folgenden Operationen einbeziehen:
+ `mqtt:connect`— Erteilt die Erlaubnis, eine Verbindung zum Kerngerät herzustellen. Client-Geräte müssen über diese Berechtigung verfügen, um eine Verbindung zu einem Kerngerät herzustellen.
Dieser Vorgang unterstützt die folgenden Ressourcen:
+ `mqtt:clientId:deviceClientId`— Beschränken Sie den Zugriff auf der Grundlage der Client-ID, die ein Client-Gerät verwendet, um eine Verbindung zum MQTT-Broker des Kerngeräts herzustellen. *deviceClientId*Ersetzen Sie es durch die zu verwendende Client-ID.
+ `mqtt:publish`— Erteilt die Erlaubnis, MQTT-Nachrichten zu Themen zu veröffentlichen.
Dieser Vorgang unterstützt die folgenden Ressourcen:
+ `mqtt:topic:mqttTopic`— Beschränken Sie den Zugriff auf der Grundlage des MQTT-Themas, in dem ein Client-Gerät eine Nachricht veröffentlicht. Ersetzen Sie es *mqttTopic* durch das zu verwendende Thema.
Diese Ressource unterstützt keine Platzhalter für MQTT-Themen.
+ `mqtt:subscribe`— Erteilt die Erlaubnis, MQTT-Themenfilter zum Empfangen von Nachrichten zu abonnieren.
Dieser Vorgang unterstützt die folgenden Ressourcen:
+ `mqtt:topicfilter:mqttTopicFilter`— Beschränken Sie den Zugriff auf der Grundlage der MQTT-Themen, bei denen ein Client-Gerät Nachrichten abonnieren kann. *mqttTopicFilter*Ersetzen Sie es durch den zu verwendenden Themenfilter.
Diese Ressource unterstützt keine Platzhalter für MQTT-Themen.
`resources`
Die Liste der Ressourcen, die für die Operationen in dieser Richtlinie zugelassen werden sollen. Geben Sie Ressourcen an, die den Vorgängen in dieser Richtlinie entsprechen. Sie könnten beispielsweise eine Liste von MQTT-Themenressourcen (`mqtt:topic:mqttTopic`) in einer Richtlinie angeben, die den `mqtt:publish` Vorgang spezifiziert.
Sie können den `*` Platzhalter an einer beliebigen Stelle in der Ressourcenvariablen angeben, um den Zugriff auf alle Ressourcen zu ermöglichen. Sie können beispielsweise angeben**mqtt:topic:my\$1**, dass der Zugriff auf Ressourcen zulässig ist, die dieser Eingabe entsprechen.
Die folgende Ressourcenvariable wird unterstützt:
+ `mqtt:topic:${iot:Connection.Thing.ThingName}`
Dies ergibt den Namen der Sache in der AWS IoT Core Registrierung, für die die Richtlinie ausgewertet wird. AWS IoT Core verwendet das Zertifikat, das das Gerät bei der Authentifizierung vorlegt, um zu ermitteln, welches Objekt zur Überprüfung der Verbindung verwendet werden soll. Diese Richtlinienvariable ist nur verfügbar, wenn ein Gerät eine Verbindung über MQTT oder MQTT über das Protokoll herstellt. WebSocket
`statementDescription`
(Optional) Eine Beschreibung für diese Richtlinienerklärung.
`certificates`
(Optional) Die Zertifikatkonfigurationsoptionen für dieses Kerngerät. Dieses Objekt enthält die folgenden Informationen:
`serverCertificateValiditySeconds`
(Optional) Die Zeitspanne (in Sekunden), nach der das lokale MQTT-Serverzertifikat abläuft. Sie können diese Option konfigurieren, um festzulegen, wie oft Client-Geräte die Verbindung zum Kerngerät trennen und wieder herstellen.
Diese Komponente rotiert das lokale MQTT-Serverzertifikat 24 Stunden vor seinem Ablauf. Der MQTT-Broker, wie die [Moquette MQTT-Broker-Komponente](mqtt-broker-moquette-component.md), generiert ein neues Zertifikat und startet neu. In diesem Fall werden alle mit diesem Kerngerät verbundenen Client-Geräte getrennt. Client-Geräte können nach kurzer Zeit wieder eine Verbindung zum Kerngerät herstellen.
Standard: `604800` (7 Tage)
Mindestwert: `172800` (2 Tage)
Höchstwert: `864000` (10 Tage)
`performance`
(Optional) Die Leistungskonfigurationsoptionen für dieses Kerngerät. Dieses Objekt enthält die folgenden Informationen:
`maxActiveAuthTokens`
(Optional) Die maximale Anzahl aktiver Autorisierungstoken für Client-Geräte. Sie können diese Anzahl erhöhen, damit eine größere Anzahl von Client-Geräten eine Verbindung zu einem Single-Core-Gerät herstellen kann, ohne sie erneut authentifizieren zu müssen.
Standard: `2500`
`cloudRequestQueueSize`
(Optional) Die maximale Anzahl von AWS Cloud Anfragen, die in die Warteschlange gestellt werden müssen, bevor diese Komponente Anfragen ablehnt.
Standard: `100`
`maxConcurrentCloudRequests`
(Optional) Die maximale Anzahl gleichzeitiger Anfragen, die an die gesendet werden sollen. AWS Cloud Sie können diese Zahl erhöhen, um die Authentifizierungsleistung auf Kerngeräten zu verbessern, auf denen Sie eine große Anzahl von Client-Geräten verbinden.
Standard: `1`
`certificateAuthority`
(Optional) Konfigurationsoptionen für Zertifizierungsstellen, um die zwischengeschaltete Zertifizierungsstelle des Kerngeräts durch Ihre eigene Zwischenzertifizierungsstelle zu ersetzen.
Wenn Sie Ihr Greengrass-Core-Gerät mit einer benutzerdefinierten Zertifizierungsstelle (CA) konfigurieren und dieselbe Zertifizierungsstelle verwenden, um Client-Gerätezertifikate auszustellen, umgeht Greengrass Autorisierungsrichtlinienprüfungen für MQTT-Operationen auf Client-Geräten. Die Authentifizierungskomponente für das Client-Gerät vertraut voll und ganz auf Clients, die Zertifikate verwenden, die von der Zertifizierungsstelle signiert wurden, für deren Verwendung sie konfiguriert ist.
Um dieses Verhalten bei der Verwendung einer benutzerdefinierten Zertifizierungsstelle einzuschränken, erstellen und signieren Sie Client-Geräte, die eine andere Zertifizierungsstelle oder Zwischenzertifizierungsstelle verwenden, und passen Sie dann die `certificateChainUri` Felder `certificateUri` und so an, dass sie auf die richtige Zwischenzertifizierungsstelle verweisen.
Dieses Objekt enthält die folgenden Informationen.
Uri des Zertifikats
Der Speicherort des Zertifikats. Dabei kann es sich um einen Dateisystem-URI oder einen URI handeln, der auf ein Zertifikat verweist, das in einem Hardware-Sicherheitsmodul gespeichert ist.
`certificateChainUri`
Der Speicherort der Zertifikatskette für die CA des Kerngeräts. Dies sollte die komplette Zertifikatskette bis zu Ihrer Stammzertifizierungsstelle sein. Dabei kann es sich um einen Dateisystem-URI oder einen URI handeln, der auf eine Zertifikatskette verweist, die in einem Hardware-Sicherheitsmodul gespeichert ist.
`privateKeyUri`
Der Speicherort des privaten Schlüssels des Kerngeräts. Dies kann ein Dateisystem-URI oder ein URI sein, der auf einen privaten Schlüssel eines Zertifikats verweist, der in einem Hardware-Sicherheitsmodul gespeichert ist.
`security`
(Optional) Sicherheitskonfigurationsoptionen für dieses Kerngerät. Dieses Objekt enthält die folgenden Informationen.
`clientDeviceTrustDurationMinutes`
Die Dauer in Minuten, während der die Authentifizierungsinformationen eines Client-Geräts als vertrauenswürdig eingestuft werden können, bevor eine erneute Authentifizierung beim Kerngerät erforderlich ist. Der Standardwert ist 1.
`metrics`
(Optional) Die Metrikoptionen für dieses Kerngerät. Fehlermetriken werden nur angezeigt, wenn bei der Authentifizierung des Client-Geräts ein Fehler auftritt. Dieses Objekt enthält die folgenden Informationen:
`disableMetrics`
Wenn das `disableMetrics` Feld auf gesetzt ist`true`, erfasst die Authentifizierung auf dem Client-Gerät keine Metriken.
Standard: `false`
`aggregatePeriodSeconds`
Der Aggregationszeitraum in Sekunden, der bestimmt, wie oft die Authentifizierung auf dem Client-Gerät Messwerte aggregiert und an den Telemetrieagenten sendet. Dies ändert nichts daran, wie oft Metriken veröffentlicht werden, da der Telemetrieagent sie immer noch einmal täglich veröffentlicht.
Standard: `3600`
startupTimeoutSeconds
(Optional) Die maximale Zeit in Sekunden, die die Komponente zum Starten benötigt. Der Status der Komponente ändert sich auf, `ERRORED` wenn dieser Timeout überschritten wird.
Standard: `120`
**Example Beispiel: Aktualisierung der Zusammenführung von Konfigurationen (unter Verwendung einer restriktiven Richtlinie)**
In der folgenden Beispielkonfiguration wird angegeben, dass Client-Geräte, deren Namen mit beginnen, eine Verbindung herstellen dürfen`MyClientDevice`, und publish/subscribe zwar zu allen Themen.
```
{
"deviceGroups": {
"formatVersion": "2021-03-05",
"definitions": {
"MyDeviceGroup": {
"selectionRule": "thingName: MyClientDevice*",
"policyName": "MyRestrictivePolicy"
}
},
"policies": {
"MyRestrictivePolicy": {
"AllowConnect": {
"statementDescription": "Allow client devices to connect.",
"operations": [
"mqtt:connect"
],
"resources": [
"*"
]
},
"AllowPublish": {
"statementDescription": "Allow client devices to publish on test/topic.",
"operations": [
"mqtt:publish"
],
"resources": [
"mqtt:topic:test/topic"
]
},
"AllowSubscribe": {
"statementDescription": "Allow client devices to subscribe to test/topic/response.",
"operations": [
"mqtt:subscribe"
],
"resources": [
"mqtt:topicfilter:test/topic/response"
]
}
}
}
}
}
```
**Example Beispiel: Update zur Zusammenführung von Konfigurationen (unter Verwendung einer permissiven Richtlinie)**
Die folgende Beispielkonfiguration gibt an, dass alle Client-Geräte eine Verbindung herstellen können, und zwar zu allen publish/subscribe Themen.
```
{
"deviceGroups": {
"formatVersion": "2021-03-05",
"definitions": {
"MyPermissiveDeviceGroup": {
"selectionRule": "thingName: *",
"policyName": "MyPermissivePolicy"
}
},
"policies": {
"MyPermissivePolicy": {
"AllowAll": {
"statementDescription": "Allow client devices to perform all actions.",
"operations": [
"*"
],
"resources": [
"*"
]
}
}
}
}
}
```
**Example Beispiel: Aktualisierung zur Zusammenführung von Konfigurationen (unter Verwendung einer Richtlinie für einen Dingnamen)**
Die folgende Beispielkonfiguration ermöglicht es Client-Geräten, Beiträge zu Themen zu veröffentlichen, die mit dem Ding-Namen des Client-Geräts beginnen und mit der Zeichenfolge enden`topic`.
```
{
"deviceGroups": {
"formatVersion": "2021-03-05",
"definitions": {
"myThing": {
"selectionRule": "thingName: *",
"policyName": "MyThingNamePolicy"
}
},
"policies": {
"MyThingNamePolicy": {
"policyStatement": {
"statementDescription": "mqtt publish",
"operations": [
"mqtt:publish"
],
"resources": [
"mqtt:topic:${iot:Connection.Thing.ThingName}/*/topic"
]
}
}
}
}
}
```
------
#### [ v2.4.5 ]
`deviceGroups`
Gerätegruppen sind Gruppen von Clientgeräten, die berechtigt sind, eine Verbindung zu einem Kerngerät herzustellen und mit diesem zu kommunizieren. Verwenden Sie Auswahlregeln, um Gruppen von Client-Geräten zu identifizieren, und definieren Sie *Autorisierungsrichtlinien für Client-Geräte*, die die Berechtigungen für jede Gerätegruppe spezifizieren.
Dieses Objekt enthält die folgenden Informationen:
`formatVersion`
Die Formatversion für dieses Konfigurationsobjekt.
Wählen Sie aus den folgenden Optionen aus:
+ `2021-03-05`
`definitions`
Die Gerätegruppen für dieses Kerngerät. Jede Definition gibt eine *Auswahlregel an*, mit der bewertet wird, ob ein Client-Gerät Mitglied der Gruppe ist. Jede Definition gibt auch die Berechtigungsrichtlinie an, die auf Client-Geräte angewendet werden soll, die der Auswahlregel entsprechen. Wenn ein Client-Gerät Mitglied mehrerer Gerätegruppen ist, setzen sich die Berechtigungen des Geräts aus den Berechtigungsrichtlinien der einzelnen Gruppen zusammen.
Dieses Objekt enthält die folgenden Informationen:
`groupNameKey`
Der Name dieser Gerätegruppe. *groupNameKey*Ersetzen Sie ihn durch einen Namen, der Ihnen hilft, diese Gerätegruppe zu identifizieren.
Dieses Objekt enthält die folgenden Informationen:
`selectionRule`
Die Abfrage, die angibt, welche Client-Geräte Mitglieder dieser Gerätegruppe sind. Wenn ein Client-Gerät eine Verbindung herstellt, wertet das Core-Gerät diese Auswahlregel aus, um festzustellen, ob das Client-Gerät Mitglied dieser Gerätegruppe ist. Wenn das Client-Gerät Mitglied ist, verwendet das Kerngerät die Richtlinie dieser Gerätegruppe, um die Aktionen des Client-Geräts zu autorisieren.
Jede Auswahlregel umfasst mindestens eine *Auswahlregelklausel, bei der* es sich um eine Abfrage mit einem einzelnen Ausdruck handelt, die auf Client-Geräte zutreffen kann. Auswahlregeln verwenden dieselbe Abfragesyntax wie die AWS IoT Flottenindizierung. Weitere Informationen zur Syntax von Auswahlregeln finden Sie unter [Abfragesyntax für die AWS IoT Flottenindizierung](https://docs.aws.amazon.com/iot/latest/developerguide/query-syntax.html) im *AWS IoT Core Entwicklerhandbuch*.
Verwenden Sie den `*` Platzhalter, um mehreren Client-Geräten eine Auswahlregelklausel zuzuordnen. Sie können diesen Platzhalter am Anfang und Ende des Dingnamens verwenden, um nach Client-Geräten zu suchen, deren Namen mit der von Ihnen angegebenen Zeichenfolge beginnen oder enden. Sie können diesen Platzhalter auch verwenden, um alle Client-Geräte abzugleichen.
Um einen Wert auszuwählen, der einen Doppelpunkt (`:`) enthält, maskieren Sie den Doppelpunkt mit einem umgekehrten Schrägstrich (). `\` In Formaten wie JSON müssen Sie umgekehrte Schrägstriche maskieren, sodass Sie vor dem Doppelpunkt zwei umgekehrte Schrägstriche eingeben. Geben Sie beispielsweise an, dass Sie ein Ding auswählen `thingName: MyTeam\\:ClientDevice1` möchten, dessen Name lautet. `MyTeam:ClientDevice1`
Sie können den folgenden Selektor angeben:
+ `thingName`— Der Name des Dings eines Client-Geräts. AWS IoT
**Example Beispiel für eine Auswahlregel**
Die folgende Auswahlregel entspricht Client-Geräten mit dem Namen `MyClientDevice1` oder`MyClientDevice2`.
```
thingName: MyClientDevice1 OR thingName: MyClientDevice2
```
**Example Beispiel für eine Auswahlregel (verwenden Sie Platzhalter)**
Die folgende Auswahlregel entspricht Client-Geräten, deren Namen mit `MyClientDevice` beginnen.
```
thingName: MyClientDevice*
```
**Example Beispiel für eine Auswahlregel (verwenden Sie Platzhalter)**
Die folgende Auswahlregel entspricht Client-Geräten, deren Namen auf enden`MyClientDevice`.
```
thingName: *MyClientDevice
```
**Example Beispiel für eine Auswahlregel (trifft auf alle Geräte zu)**
Die folgende Auswahlregel gilt für alle Client-Geräte.
```
thingName: *
```
`policyName`
Die Berechtigungsrichtlinie, die für Client-Geräte in dieser Gerätegruppe gilt. Geben Sie den Namen einer Richtlinie an, die Sie im `policies` Objekt definieren.
`policies`
Die Autorisierungsrichtlinien für Client-Geräte für Client-Geräte, die eine Verbindung zum Kerngerät herstellen. Jede Autorisierungsrichtlinie spezifiziert eine Reihe von Aktionen und die Ressourcen, über die ein Client-Gerät diese Aktionen ausführen kann.
Dieses Objekt enthält die folgenden Informationen:
`policyNameKey`
Der Name dieser Autorisierungsrichtlinie. *policyNameKey*Ersetzen Sie ihn durch einen Namen, anhand dessen Sie diese Autorisierungsrichtlinie leichter identifizieren können. Sie verwenden diesen Richtliniennamen, um zu definieren, welche Richtlinie für eine Gerätegruppe gilt.
Dieses Objekt enthält die folgenden Informationen:
`statementNameKey`
Der Name dieser Richtlinienerklärung. *statementNameKey*Ersetzen Sie ihn durch einen Namen, anhand dessen Sie diese Grundsatzerklärung leichter identifizieren können.
Dieses Objekt enthält die folgenden Informationen:
`operations`
Die Liste der Vorgänge, bei denen die Ressourcen in dieser Richtlinie berücksichtigt werden sollen.
Sie können jede der folgenden Operationen einbeziehen:
+ `mqtt:connect`— Erteilt die Erlaubnis, eine Verbindung zum Kerngerät herzustellen. Client-Geräte müssen über diese Berechtigung verfügen, um eine Verbindung zu einem Kerngerät herzustellen.
Dieser Vorgang unterstützt die folgenden Ressourcen:
+ `mqtt:clientId:deviceClientId`— Beschränken Sie den Zugriff auf der Grundlage der Client-ID, die ein Client-Gerät verwendet, um eine Verbindung zum MQTT-Broker des Kerngeräts herzustellen. *deviceClientId*Ersetzen Sie es durch die zu verwendende Client-ID.
+ `mqtt:publish`— Erteilt die Erlaubnis, MQTT-Nachrichten zu Themen zu veröffentlichen.
Dieser Vorgang unterstützt die folgenden Ressourcen:
+ `mqtt:topic:mqttTopic`— Beschränken Sie den Zugriff auf der Grundlage des MQTT-Themas, in dem ein Client-Gerät eine Nachricht veröffentlicht. Ersetzen Sie es *mqttTopic* durch das zu verwendende Thema.
Diese Ressource unterstützt keine Platzhalter für MQTT-Themen.
+ `mqtt:subscribe`— Erteilt die Erlaubnis, MQTT-Themenfilter zum Empfangen von Nachrichten zu abonnieren.
Dieser Vorgang unterstützt die folgenden Ressourcen:
+ `mqtt:topicfilter:mqttTopicFilter`— Beschränken Sie den Zugriff auf der Grundlage der MQTT-Themen, bei denen ein Client-Gerät Nachrichten abonnieren kann. *mqttTopicFilter*Ersetzen Sie es durch den zu verwendenden Themenfilter.
Diese Ressource unterstützt die Platzhalter `+` und `#` MQTT-Themen-Platzhalter. *Weitere Informationen finden Sie unter [MQTT-Themen im Developer](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) Guide.AWS IoT Core *
Das Client-Gerät kann genau die Themenfilter abonnieren, die Sie zulassen. Wenn Sie dem Client-Gerät beispielsweise erlauben, die `mqtt:topicfilter:client/+/status` Ressource zu abonnieren, kann das Client-Gerät `client/+/status` zwar abonnieren, aber nicht`client/client1/status`.
Sie können den `*` Platzhalter angeben, um den Zugriff auf alle Aktionen zu ermöglichen.
`resources`
Die Liste der Ressourcen, die für die Operationen in dieser Richtlinie zugelassen werden sollen. Geben Sie Ressourcen an, die den Vorgängen in dieser Richtlinie entsprechen. Sie könnten beispielsweise eine Liste von MQTT-Themenressourcen (`mqtt:topic:mqttTopic`) in einer Richtlinie angeben, die den `mqtt:publish` Vorgang spezifiziert.
Sie können den `*` Platzhalter angeben, um den Zugriff auf alle Ressourcen zu ermöglichen. Sie können den `*` Platzhalter nicht verwenden, um unvollständige Ressourcen-IDs abzugleichen. Sie können beispielsweise angeben**"resources": "\$1"**, aber Sie können nicht angeben. **"resources": "mqtt:clientId:\$1"**
`statementDescription`
(Optional) Eine Beschreibung für diese Richtlinienerklärung.
`certificates`
(Optional) Die Zertifikatkonfigurationsoptionen für dieses Kerngerät. Dieses Objekt enthält die folgenden Informationen:
`serverCertificateValiditySeconds`
(Optional) Die Zeitspanne (in Sekunden), nach der das lokale MQTT-Serverzertifikat abläuft. Sie können diese Option konfigurieren, um festzulegen, wie oft Client-Geräte die Verbindung zum Kerngerät trennen und wieder herstellen.
Diese Komponente rotiert das lokale MQTT-Serverzertifikat 24 Stunden vor seinem Ablauf. Der MQTT-Broker, wie die [Moquette MQTT-Broker-Komponente](mqtt-broker-moquette-component.md), generiert ein neues Zertifikat und startet neu. In diesem Fall werden alle mit diesem Kerngerät verbundenen Client-Geräte getrennt. Client-Geräte können nach kurzer Zeit wieder eine Verbindung zum Kerngerät herstellen.
Standard: `604800` (7 Tage)
Mindestwert: `172800` (2 Tage)
Höchstwert: `864000` (10 Tage)
`performance`
(Optional) Die Leistungskonfigurationsoptionen für dieses Kerngerät. Dieses Objekt enthält die folgenden Informationen:
`maxActiveAuthTokens`
(Optional) Die maximale Anzahl aktiver Autorisierungstoken für Client-Geräte. Sie können diese Anzahl erhöhen, damit eine größere Anzahl von Client-Geräten eine Verbindung zu einem Single-Core-Gerät herstellen kann, ohne sie erneut authentifizieren zu müssen.
Standard: `2500`
`cloudRequestQueueSize`
(Optional) Die maximale Anzahl von AWS Cloud Anfragen, die in die Warteschlange gestellt werden müssen, bevor diese Komponente Anfragen ablehnt.
Standard: `100`
`maxConcurrentCloudRequests`
(Optional) Die maximale Anzahl gleichzeitiger Anfragen, die an die gesendet werden sollen. AWS Cloud Sie können diese Zahl erhöhen, um die Authentifizierungsleistung auf Kerngeräten zu verbessern, auf denen Sie eine große Anzahl von Client-Geräten verbinden.
Standard: `1`
`certificateAuthority`
(Optional) Konfigurationsoptionen für Zertifizierungsstellen, um die zwischengeschaltete Zertifizierungsstelle des Kerngeräts durch Ihre eigene Zwischenzertifizierungsstelle zu ersetzen.
Wenn Sie Ihr Greengrass-Core-Gerät mit einer benutzerdefinierten Zertifizierungsstelle (CA) konfigurieren und dieselbe Zertifizierungsstelle verwenden, um Client-Gerätezertifikate auszustellen, umgeht Greengrass Autorisierungsrichtlinienprüfungen für MQTT-Operationen auf Client-Geräten. Die Authentifizierungskomponente für das Client-Gerät vertraut voll und ganz auf Clients, die Zertifikate verwenden, die von der Zertifizierungsstelle signiert wurden, für deren Verwendung sie konfiguriert ist.
Um dieses Verhalten bei der Verwendung einer benutzerdefinierten Zertifizierungsstelle einzuschränken, erstellen und signieren Sie Client-Geräte, die eine andere Zertifizierungsstelle oder Zwischenzertifizierungsstelle verwenden, und passen Sie dann die `certificateChainUri` Felder `certificateUri` und so an, dass sie auf die richtige Zwischenzertifizierungsstelle verweisen.
Dieses Objekt enthält die folgenden Informationen.
Uri des Zertifikats
Der Speicherort des Zertifikats. Dabei kann es sich um einen Dateisystem-URI oder einen URI handeln, der auf ein Zertifikat verweist, das in einem Hardware-Sicherheitsmodul gespeichert ist.
`certificateChainUri`
Der Speicherort der Zertifikatskette für die CA des Kerngeräts. Dies sollte die komplette Zertifikatskette bis zu Ihrer Stammzertifizierungsstelle sein. Dabei kann es sich um einen Dateisystem-URI oder einen URI handeln, der auf eine Zertifikatskette verweist, die in einem Hardware-Sicherheitsmodul gespeichert ist.
`privateKeyUri`
Der Speicherort des privaten Schlüssels des Kerngeräts. Dies kann ein Dateisystem-URI oder ein URI sein, der auf einen privaten Schlüssel eines Zertifikats verweist, der in einem Hardware-Sicherheitsmodul gespeichert ist.
`security`
(Optional) Sicherheitskonfigurationsoptionen für dieses Kerngerät. Dieses Objekt enthält die folgenden Informationen.
`clientDeviceTrustDurationMinutes`
Die Dauer in Minuten, während der die Authentifizierungsinformationen eines Client-Geräts als vertrauenswürdig eingestuft werden können, bevor eine erneute Authentifizierung beim Kerngerät erforderlich ist. Der Standardwert ist 1.
`metrics`
(Optional) Die Metrikoptionen für dieses Kerngerät. Fehlermetriken werden nur angezeigt, wenn bei der Authentifizierung des Client-Geräts ein Fehler auftritt. Dieses Objekt enthält die folgenden Informationen:
`disableMetrics`
Wenn das `disableMetrics` Feld auf gesetzt ist`true`, erfasst die Authentifizierung auf dem Client-Gerät keine Metriken.
Standard: `false`
`aggregatePeriodSeconds`
Der Aggregationszeitraum in Sekunden, der bestimmt, wie oft die Authentifizierung auf dem Client-Gerät Messwerte aggregiert und an den Telemetrieagenten sendet. Dies ändert nichts daran, wie oft Metriken veröffentlicht werden, da der Telemetrieagent sie immer noch einmal täglich veröffentlicht.
Standard: `3600`
startupTimeoutSeconds
(Optional) Die maximale Zeit in Sekunden, die die Komponente zum Starten benötigt. Der Status der Komponente ändert sich auf, `ERRORED` wenn dieser Timeout überschritten wird.
Standard: `120`
**Example Beispiel: Aktualisierung der Zusammenführung von Konfigurationen (unter Verwendung einer restriktiven Richtlinie)**
In der folgenden Beispielkonfiguration wird angegeben, dass Client-Geräte, deren Namen mit beginnen, eine Verbindung herstellen dürfen`MyClientDevice`, und publish/subscribe zwar zu allen Themen.
```
{
"deviceGroups": {
"formatVersion": "2021-03-05",
"definitions": {
"MyDeviceGroup": {
"selectionRule": "thingName: MyClientDevice*",
"policyName": "MyRestrictivePolicy"
}
},
"policies": {
"MyRestrictivePolicy": {
"AllowConnect": {
"statementDescription": "Allow client devices to connect.",
"operations": [
"mqtt:connect"
],
"resources": [
"*"
]
},
"AllowPublish": {
"statementDescription": "Allow client devices to publish on test/topic.",
"operations": [
"mqtt:publish"
],
"resources": [
"mqtt:topic:test/topic"
]
},
"AllowSubscribe": {
"statementDescription": "Allow client devices to subscribe to test/topic/response.",
"operations": [
"mqtt:subscribe"
],
"resources": [
"mqtt:topicfilter:test/topic/response"
]
}
}
}
}
}
```
**Example Beispiel: Update zur Zusammenführung von Konfigurationen (unter Verwendung einer permissiven Richtlinie)**
Die folgende Beispielkonfiguration gibt an, dass alle Client-Geräte eine Verbindung herstellen können, und zwar zu allen publish/subscribe Themen.
```
{
"deviceGroups": {
"formatVersion": "2021-03-05",
"definitions": {
"MyPermissiveDeviceGroup": {
"selectionRule": "thingName: *",
"policyName": "MyPermissivePolicy"
}
},
"policies": {
"MyPermissivePolicy": {
"AllowAll": {
"statementDescription": "Allow client devices to perform all actions.",
"operations": [
"*"
],
"resources": [
"*"
]
}
}
}
}
}
```
------
#### [ v2.4.2 - v2.4.4 ]
`deviceGroups`
Gerätegruppen sind Gruppen von Client-Geräten, die berechtigt sind, eine Verbindung zu einem Kerngerät herzustellen und mit diesem zu kommunizieren. Verwenden Sie Auswahlregeln, um Gruppen von Client-Geräten zu identifizieren, und definieren Sie *Autorisierungsrichtlinien für Client-Geräte*, die die Berechtigungen für jede Gerätegruppe spezifizieren.
Dieses Objekt enthält die folgenden Informationen:
`formatVersion`
Die Formatversion für dieses Konfigurationsobjekt.
Wählen Sie aus den folgenden Optionen aus:
+ `2021-03-05`
`definitions`
Die Gerätegruppen für dieses Kerngerät. Jede Definition gibt eine *Auswahlregel an*, mit der bewertet wird, ob ein Client-Gerät Mitglied der Gruppe ist. Jede Definition gibt auch die Berechtigungsrichtlinie an, die auf Client-Geräte angewendet werden soll, die der Auswahlregel entsprechen. Wenn ein Client-Gerät Mitglied mehrerer Gerätegruppen ist, setzen sich die Berechtigungen des Geräts aus den Berechtigungsrichtlinien der einzelnen Gruppen zusammen.
Dieses Objekt enthält die folgenden Informationen:
`groupNameKey`
Der Name dieser Gerätegruppe. *groupNameKey*Ersetzen Sie ihn durch einen Namen, der Ihnen hilft, diese Gerätegruppe zu identifizieren.
Dieses Objekt enthält die folgenden Informationen:
`selectionRule`
Die Abfrage, die angibt, welche Client-Geräte Mitglieder dieser Gerätegruppe sind. Wenn ein Client-Gerät eine Verbindung herstellt, wertet das Core-Gerät diese Auswahlregel aus, um festzustellen, ob das Client-Gerät Mitglied dieser Gerätegruppe ist. Wenn das Client-Gerät Mitglied ist, verwendet das Kerngerät die Richtlinie dieser Gerätegruppe, um die Aktionen des Client-Geräts zu autorisieren.
Jede Auswahlregel umfasst mindestens eine *Auswahlregelklausel, bei der* es sich um eine Abfrage mit einem einzelnen Ausdruck handelt, die auf Client-Geräte zutreffen kann. Auswahlregeln verwenden dieselbe Abfragesyntax wie die AWS IoT Flottenindizierung. Weitere Informationen zur Syntax von Auswahlregeln finden Sie unter [Abfragesyntax für die AWS IoT Flottenindizierung](https://docs.aws.amazon.com/iot/latest/developerguide/query-syntax.html) im *AWS IoT Core Entwicklerhandbuch*.
Verwenden Sie den `*` Platzhalter, um mehreren Client-Geräten eine Auswahlregelklausel zuzuordnen. Sie können diesen Platzhalter am Ende des Dingnamens verwenden, um nach Client-Geräten zu suchen, deren Namen mit einer von Ihnen angegebenen Zeichenfolge beginnen. Sie können diesen Platzhalter auch verwenden, um alle Client-Geräte abzugleichen.
Um einen Wert auszuwählen, der einen Doppelpunkt (`:`) enthält, maskieren Sie den Doppelpunkt mit einem umgekehrten Schrägstrich (). `\\` In Formaten wie JSON müssen Sie umgekehrte Schrägstriche maskieren, sodass Sie vor dem Doppelpunkt zwei umgekehrte Schrägstriche eingeben. Geben Sie beispielsweise an, dass Sie ein Ding auswählen `thingName: MyTeam\\\\:ClientDevice1` möchten, dessen Name lautet. `MyTeam:ClientDevice1`
Sie können den folgenden Selektor angeben:
+ `thingName`— Der Name des Dings eines Client-Geräts. AWS IoT
**Example Beispiel für eine Auswahlregel**
Die folgende Auswahlregel entspricht Client-Geräten mit dem Namen `MyClientDevice1` oder`MyClientDevice2`.
```
thingName: MyClientDevice1 OR thingName: MyClientDevice2
```
**Example Beispiel für eine Auswahlregel (verwenden Sie Platzhalter)**
Die folgende Auswahlregel entspricht Client-Geräten, deren Namen mit `MyClientDevice` beginnen.
```
thingName: MyClientDevice*
```
**Example Beispiel für eine Auswahlregel (trifft auf alle Geräte zu)**
Die folgende Auswahlregel gilt für alle Client-Geräte.
```
thingName: *
```
`policyName`
Die Berechtigungsrichtlinie, die für Client-Geräte in dieser Gerätegruppe gilt. Geben Sie den Namen einer Richtlinie an, die Sie im `policies` Objekt definieren.
`policies`
Die Autorisierungsrichtlinien für Client-Geräte für Client-Geräte, die eine Verbindung zum Kerngerät herstellen. Jede Autorisierungsrichtlinie spezifiziert eine Reihe von Aktionen und die Ressourcen, über die ein Client-Gerät diese Aktionen ausführen kann.
Dieses Objekt enthält die folgenden Informationen:
`policyNameKey`
Der Name dieser Autorisierungsrichtlinie. *policyNameKey*Ersetzen Sie ihn durch einen Namen, anhand dessen Sie diese Autorisierungsrichtlinie leichter identifizieren können. Sie verwenden diesen Richtliniennamen, um zu definieren, welche Richtlinie für eine Gerätegruppe gilt.
Dieses Objekt enthält die folgenden Informationen:
`statementNameKey`
Der Name dieser Richtlinienerklärung. *statementNameKey*Ersetzen Sie ihn durch einen Namen, anhand dessen Sie diese Grundsatzerklärung leichter identifizieren können.
Dieses Objekt enthält die folgenden Informationen:
`operations`
Die Liste der Vorgänge, bei denen die Ressourcen in dieser Richtlinie berücksichtigt werden sollen.
Sie können jede der folgenden Operationen einbeziehen:
+ `mqtt:connect`— Erteilt die Erlaubnis, eine Verbindung zum Kerngerät herzustellen. Client-Geräte müssen über diese Berechtigung verfügen, um eine Verbindung zu einem Kerngerät herzustellen.
Dieser Vorgang unterstützt die folgenden Ressourcen:
+ `mqtt:clientId:deviceClientId`— Beschränken Sie den Zugriff auf der Grundlage der Client-ID, die ein Client-Gerät verwendet, um eine Verbindung zum MQTT-Broker des Kerngeräts herzustellen. *deviceClientId*Ersetzen Sie es durch die zu verwendende Client-ID.
+ `mqtt:publish`— Erteilt die Erlaubnis, MQTT-Nachrichten zu Themen zu veröffentlichen.
Dieser Vorgang unterstützt die folgenden Ressourcen:
+ `mqtt:topic:mqttTopic`— Beschränken Sie den Zugriff auf der Grundlage des MQTT-Themas, in dem ein Client-Gerät eine Nachricht veröffentlicht. Ersetzen Sie es *mqttTopic* durch das zu verwendende Thema.
Diese Ressource unterstützt keine Platzhalter für MQTT-Themen.
+ `mqtt:subscribe`— Erteilt die Erlaubnis, MQTT-Themenfilter zum Empfangen von Nachrichten zu abonnieren.
Dieser Vorgang unterstützt die folgenden Ressourcen:
+ `mqtt:topicfilter:mqttTopicFilter`— Beschränken Sie den Zugriff auf der Grundlage der MQTT-Themen, bei denen ein Client-Gerät Nachrichten abonnieren kann. *mqttTopicFilter*Ersetzen Sie es durch den zu verwendenden Themenfilter.
Diese Ressource unterstützt die Platzhalter `+` und `#` MQTT-Themen-Platzhalter. *Weitere Informationen finden Sie unter [MQTT-Themen im Developer](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) Guide.AWS IoT Core *
Das Client-Gerät kann genau die Themenfilter abonnieren, die Sie zulassen. Wenn Sie dem Client-Gerät beispielsweise erlauben, die `mqtt:topicfilter:client/+/status` Ressource zu abonnieren, kann das Client-Gerät `client/+/status` zwar abonnieren, aber nicht`client/client1/status`.
Sie können den `*` Platzhalter angeben, um den Zugriff auf alle Aktionen zu ermöglichen.
`resources`
Die Liste der Ressourcen, die für die Operationen in dieser Richtlinie zugelassen werden sollen. Geben Sie Ressourcen an, die den Vorgängen in dieser Richtlinie entsprechen. Sie könnten beispielsweise eine Liste von MQTT-Themenressourcen (`mqtt:topic:mqttTopic`) in einer Richtlinie angeben, die den `mqtt:publish` Vorgang spezifiziert.
Sie können den `*` Platzhalter angeben, um den Zugriff auf alle Ressourcen zu ermöglichen. Sie können den `*` Platzhalter nicht verwenden, um unvollständige Ressourcen-IDs abzugleichen. Sie können beispielsweise angeben**"resources": "\$1"**, aber Sie können nicht angeben. **"resources": "mqtt:clientId:\$1"**
`statementDescription`
(Optional) Eine Beschreibung für diese Richtlinienerklärung.
`certificates`
(Optional) Die Zertifikatkonfigurationsoptionen für dieses Kerngerät. Dieses Objekt enthält die folgenden Informationen:
`serverCertificateValiditySeconds`
(Optional) Die Zeitspanne (in Sekunden), nach der das lokale MQTT-Serverzertifikat abläuft. Sie können diese Option konfigurieren, um festzulegen, wie oft Client-Geräte die Verbindung zum Kerngerät trennen und wieder herstellen.
Diese Komponente rotiert das lokale MQTT-Serverzertifikat 24 Stunden vor seinem Ablauf. Der MQTT-Broker, wie die [Moquette MQTT-Broker-Komponente](mqtt-broker-moquette-component.md), generiert ein neues Zertifikat und startet neu. In diesem Fall werden alle mit diesem Kerngerät verbundenen Client-Geräte getrennt. Client-Geräte können nach kurzer Zeit wieder eine Verbindung zum Kerngerät herstellen.
Standard: `604800` (7 Tage)
Mindestwert: `172800` (2 Tage)
Höchstwert: `864000` (10 Tage)
`performance`
(Optional) Die Leistungskonfigurationsoptionen für dieses Kerngerät. Dieses Objekt enthält die folgenden Informationen:
`maxActiveAuthTokens`
(Optional) Die maximale Anzahl aktiver Autorisierungstoken für Client-Geräte. Sie können diese Anzahl erhöhen, damit eine größere Anzahl von Client-Geräten eine Verbindung zu einem Single-Core-Gerät herstellen kann, ohne sie erneut authentifizieren zu müssen.
Standard: `2500`
`cloudRequestQueueSize`
(Optional) Die maximale Anzahl von AWS Cloud Anfragen, die in die Warteschlange gestellt werden müssen, bevor diese Komponente Anfragen ablehnt.
Standard: `100`
`maxConcurrentCloudRequests`
(Optional) Die maximale Anzahl gleichzeitiger Anfragen, die an die gesendet werden sollen. AWS Cloud Sie können diese Zahl erhöhen, um die Authentifizierungsleistung auf Kerngeräten zu verbessern, auf denen Sie eine große Anzahl von Client-Geräten verbinden.
Standard: `1`
`certificateAuthority`
(Optional) Konfigurationsoptionen für Zertifizierungsstellen, um die zwischengeschaltete Zertifizierungsstelle des Kerngeräts durch Ihre eigene Zwischenzertifizierungsstelle zu ersetzen.
Wenn Sie Ihr Greengrass-Core-Gerät mit einer benutzerdefinierten Zertifizierungsstelle (CA) konfigurieren und dieselbe Zertifizierungsstelle verwenden, um Client-Gerätezertifikate auszustellen, umgeht Greengrass Autorisierungsrichtlinienprüfungen für MQTT-Operationen auf Client-Geräten. Die Authentifizierungskomponente für das Client-Gerät vertraut voll und ganz auf Clients, die Zertifikate verwenden, die von der Zertifizierungsstelle signiert wurden, für deren Verwendung sie konfiguriert ist.
Um dieses Verhalten bei der Verwendung einer benutzerdefinierten Zertifizierungsstelle einzuschränken, erstellen und signieren Sie Client-Geräte, die eine andere Zertifizierungsstelle oder Zwischenzertifizierungsstelle verwenden, und passen Sie dann die `certificateChainUri` Felder `certificateUri` und so an, dass sie auf die richtige Zwischenzertifizierungsstelle verweisen.
Dieses Objekt enthält die folgenden Informationen.
Uri des Zertifikats
Der Speicherort des Zertifikats. Dabei kann es sich um einen Dateisystem-URI oder einen URI handeln, der auf ein Zertifikat verweist, das in einem Hardware-Sicherheitsmodul gespeichert ist.
`certificateChainUri`
Der Speicherort der Zertifikatskette für die CA des Kerngeräts. Dies sollte die komplette Zertifikatskette bis zu Ihrer Stammzertifizierungsstelle sein. Dabei kann es sich um einen Dateisystem-URI oder einen URI handeln, der auf eine Zertifikatskette verweist, die in einem Hardware-Sicherheitsmodul gespeichert ist.
`privateKeyUri`
Der Speicherort des privaten Schlüssels des Kerngeräts. Dies kann ein Dateisystem-URI oder ein URI sein, der auf einen privaten Schlüssel eines Zertifikats verweist, der in einem Hardware-Sicherheitsmodul gespeichert ist.
`security`
(Optional) Sicherheitskonfigurationsoptionen für dieses Kerngerät. Dieses Objekt enthält die folgenden Informationen.
`clientDeviceTrustDurationMinutes`
Die Dauer in Minuten, während der die Authentifizierungsinformationen eines Client-Geräts als vertrauenswürdig eingestuft werden können, bevor eine erneute Authentifizierung beim Kerngerät erforderlich ist. Der Standardwert ist 1.
`metrics`
(Optional) Die Metrikoptionen für dieses Kerngerät. Fehlermetriken werden nur angezeigt, wenn bei der Authentifizierung des Client-Geräts ein Fehler auftritt. Dieses Objekt enthält die folgenden Informationen:
`disableMetrics`
Wenn das `disableMetrics` Feld auf gesetzt ist`true`, erfasst die Authentifizierung auf dem Client-Gerät keine Metriken.
Standard: `false`
`aggregatePeriodSeconds`
Der Aggregationszeitraum in Sekunden, der bestimmt, wie oft die Authentifizierung auf dem Client-Gerät Messwerte aggregiert und an den Telemetrieagenten sendet. Dies ändert nichts daran, wie oft Metriken veröffentlicht werden, da der Telemetrieagent sie immer noch einmal täglich veröffentlicht.
Standard: `3600`
startupTimeoutSeconds
(Optional) Die maximale Zeit in Sekunden, die die Komponente zum Starten benötigt. Der Status der Komponente ändert sich auf, `ERRORED` wenn dieser Timeout überschritten wird.
Standard: `120`
**Example Beispiel: Aktualisierung der Zusammenführung von Konfigurationen (unter Verwendung einer restriktiven Richtlinie)**
In der folgenden Beispielkonfiguration wird angegeben, dass Client-Geräte, deren Namen mit beginnen, eine Verbindung herstellen dürfen`MyClientDevice`, und publish/subscribe zwar zu allen Themen.
```
{
"deviceGroups": {
"formatVersion": "2021-03-05",
"definitions": {
"MyDeviceGroup": {
"selectionRule": "thingName: MyClientDevice*",
"policyName": "MyRestrictivePolicy"
}
},
"policies": {
"MyRestrictivePolicy": {
"AllowConnect": {
"statementDescription": "Allow client devices to connect.",
"operations": [
"mqtt:connect"
],
"resources": [
"*"
]
},
"AllowPublish": {
"statementDescription": "Allow client devices to publish on test/topic.",
"operations": [
"mqtt:publish"
],
"resources": [
"mqtt:topic:test/topic"
]
},
"AllowSubscribe": {
"statementDescription": "Allow client devices to subscribe to test/topic/response.",
"operations": [
"mqtt:subscribe"
],
"resources": [
"mqtt:topicfilter:test/topic/response"
]
}
}
}
}
}
```
**Example Beispiel: Update zur Zusammenführung von Konfigurationen (unter Verwendung einer permissiven Richtlinie)**
Die folgende Beispielkonfiguration gibt an, dass alle Client-Geräte eine Verbindung herstellen können, und zwar zu allen publish/subscribe Themen.
```
{
"deviceGroups": {
"formatVersion": "2021-03-05",
"definitions": {
"MyPermissiveDeviceGroup": {
"selectionRule": "thingName: *",
"policyName": "MyPermissivePolicy"
}
},
"policies": {
"MyPermissivePolicy": {
"AllowAll": {
"statementDescription": "Allow client devices to perform all actions.",
"operations": [
"*"
],
"resources": [
"*"
]
}
}
}
}
}
```
------
#### [ v2.4.0 - v2.4.1 ]
`deviceGroups`
Gerätegruppen sind Gruppen von Client-Geräten, die berechtigt sind, eine Verbindung zu einem Kerngerät herzustellen und mit diesem zu kommunizieren. Verwenden Sie Auswahlregeln, um Gruppen von Client-Geräten zu identifizieren, und definieren Sie *Autorisierungsrichtlinien für Client-Geräte*, die die Berechtigungen für jede Gerätegruppe spezifizieren.
Dieses Objekt enthält die folgenden Informationen:
`formatVersion`
Die Formatversion für dieses Konfigurationsobjekt.
Wählen Sie aus den folgenden Optionen aus:
+ `2021-03-05`
`definitions`
Die Gerätegruppen für dieses Kerngerät. Jede Definition gibt eine *Auswahlregel an*, mit der bewertet wird, ob ein Client-Gerät Mitglied der Gruppe ist. Jede Definition gibt auch die Berechtigungsrichtlinie an, die auf Client-Geräte angewendet werden soll, die der Auswahlregel entsprechen. Wenn ein Client-Gerät Mitglied mehrerer Gerätegruppen ist, setzen sich die Berechtigungen des Geräts aus den Berechtigungsrichtlinien der einzelnen Gruppen zusammen.
Dieses Objekt enthält die folgenden Informationen:
`groupNameKey`
Der Name dieser Gerätegruppe. *groupNameKey*Ersetzen Sie ihn durch einen Namen, der Ihnen hilft, diese Gerätegruppe zu identifizieren.
Dieses Objekt enthält die folgenden Informationen:
`selectionRule`
Die Abfrage, die angibt, welche Client-Geräte Mitglieder dieser Gerätegruppe sind. Wenn ein Client-Gerät eine Verbindung herstellt, wertet das Core-Gerät diese Auswahlregel aus, um festzustellen, ob das Client-Gerät Mitglied dieser Gerätegruppe ist. Wenn das Client-Gerät Mitglied ist, verwendet das Kerngerät die Richtlinie dieser Gerätegruppe, um die Aktionen des Client-Geräts zu autorisieren.
Jede Auswahlregel umfasst mindestens eine *Auswahlregelklausel, bei der* es sich um eine Abfrage mit einem einzelnen Ausdruck handelt, die auf Client-Geräte zutreffen kann. Auswahlregeln verwenden dieselbe Abfragesyntax wie die AWS IoT Flottenindizierung. Weitere Informationen zur Syntax von Auswahlregeln finden Sie unter [Abfragesyntax für die AWS IoT Flottenindizierung](https://docs.aws.amazon.com/iot/latest/developerguide/query-syntax.html) im *AWS IoT Core Entwicklerhandbuch*.
Verwenden Sie den `*` Platzhalter, um mehreren Client-Geräten eine Auswahlregelklausel zuzuordnen. Sie können diesen Platzhalter am Ende des Dingnamens verwenden, um nach Client-Geräten zu suchen, deren Namen mit einer von Ihnen angegebenen Zeichenfolge beginnen. Sie können diesen Platzhalter auch verwenden, um alle Client-Geräte abzugleichen.
Um einen Wert auszuwählen, der einen Doppelpunkt (`:`) enthält, maskieren Sie den Doppelpunkt mit einem umgekehrten Schrägstrich (). `\\` In Formaten wie JSON müssen Sie umgekehrte Schrägstriche maskieren, sodass Sie vor dem Doppelpunkt zwei umgekehrte Schrägstriche eingeben. Geben Sie beispielsweise an, dass Sie ein Ding auswählen `thingName: MyTeam\\\\:ClientDevice1` möchten, dessen Name lautet. `MyTeam:ClientDevice1`
Sie können den folgenden Selektor angeben:
+ `thingName`— Der Name des Dings eines Client-Geräts. AWS IoT
**Example Beispiel für eine Auswahlregel**
Die folgende Auswahlregel entspricht Client-Geräten mit dem Namen `MyClientDevice1` oder`MyClientDevice2`.
```
thingName: MyClientDevice1 OR thingName: MyClientDevice2
```
**Example Beispiel für eine Auswahlregel (verwenden Sie Platzhalter)**
Die folgende Auswahlregel entspricht Client-Geräten, deren Namen mit `MyClientDevice` beginnen.
```
thingName: MyClientDevice*
```
**Example Beispiel für eine Auswahlregel (trifft auf alle Geräte zu)**
Die folgende Auswahlregel gilt für alle Client-Geräte.
```
thingName: *
```
`policyName`
Die Berechtigungsrichtlinie, die für Client-Geräte in dieser Gerätegruppe gilt. Geben Sie den Namen einer Richtlinie an, die Sie im `policies` Objekt definieren.
`policies`
Die Autorisierungsrichtlinien für Client-Geräte für Client-Geräte, die eine Verbindung zum Kerngerät herstellen. Jede Autorisierungsrichtlinie spezifiziert eine Reihe von Aktionen und die Ressourcen, über die ein Client-Gerät diese Aktionen ausführen kann.
Dieses Objekt enthält die folgenden Informationen:
`policyNameKey`
Der Name dieser Autorisierungsrichtlinie. *policyNameKey*Ersetzen Sie ihn durch einen Namen, anhand dessen Sie diese Autorisierungsrichtlinie leichter identifizieren können. Sie verwenden diesen Richtliniennamen, um zu definieren, welche Richtlinie für eine Gerätegruppe gilt.
Dieses Objekt enthält die folgenden Informationen:
`statementNameKey`
Der Name dieser Richtlinienerklärung. *statementNameKey*Ersetzen Sie ihn durch einen Namen, anhand dessen Sie diese Grundsatzerklärung leichter identifizieren können.
Dieses Objekt enthält die folgenden Informationen:
`operations`
Die Liste der Vorgänge, bei denen die Ressourcen in dieser Richtlinie berücksichtigt werden sollen.
Sie können jede der folgenden Operationen einbeziehen:
+ `mqtt:connect`— Erteilt die Erlaubnis, eine Verbindung zum Kerngerät herzustellen. Client-Geräte müssen über diese Berechtigung verfügen, um eine Verbindung zu einem Kerngerät herzustellen.
Dieser Vorgang unterstützt die folgenden Ressourcen:
+ `mqtt:clientId:deviceClientId`— Beschränken Sie den Zugriff auf der Grundlage der Client-ID, die ein Client-Gerät verwendet, um eine Verbindung zum MQTT-Broker des Kerngeräts herzustellen. *deviceClientId*Ersetzen Sie es durch die zu verwendende Client-ID.
+ `mqtt:publish`— Erteilt die Erlaubnis, MQTT-Nachrichten zu Themen zu veröffentlichen.
Dieser Vorgang unterstützt die folgenden Ressourcen:
+ `mqtt:topic:mqttTopic`— Beschränken Sie den Zugriff auf der Grundlage des MQTT-Themas, in dem ein Client-Gerät eine Nachricht veröffentlicht. Ersetzen Sie es *mqttTopic* durch das zu verwendende Thema.
Diese Ressource unterstützt keine Platzhalter für MQTT-Themen.
+ `mqtt:subscribe`— Erteilt die Erlaubnis, MQTT-Themenfilter zum Empfangen von Nachrichten zu abonnieren.
Dieser Vorgang unterstützt die folgenden Ressourcen:
+ `mqtt:topicfilter:mqttTopicFilter`— Beschränken Sie den Zugriff auf der Grundlage der MQTT-Themen, bei denen ein Client-Gerät Nachrichten abonnieren kann. *mqttTopicFilter*Ersetzen Sie es durch den zu verwendenden Themenfilter.
Diese Ressource unterstützt die Platzhalter `+` und `#` MQTT-Themen-Platzhalter. *Weitere Informationen finden Sie unter [MQTT-Themen im Developer](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) Guide.AWS IoT Core *
Das Client-Gerät kann genau die Themenfilter abonnieren, die Sie zulassen. Wenn Sie dem Client-Gerät beispielsweise erlauben, die `mqtt:topicfilter:client/+/status` Ressource zu abonnieren, kann das Client-Gerät `client/+/status` zwar abonnieren, aber nicht`client/client1/status`.
Sie können den `*` Platzhalter angeben, um den Zugriff auf alle Aktionen zu ermöglichen.
`resources`
Die Liste der Ressourcen, die für die Operationen in dieser Richtlinie zugelassen werden sollen. Geben Sie Ressourcen an, die den Vorgängen in dieser Richtlinie entsprechen. Sie könnten beispielsweise eine Liste von MQTT-Themenressourcen (`mqtt:topic:mqttTopic`) in einer Richtlinie angeben, die den `mqtt:publish` Vorgang spezifiziert.
Sie können den `*` Platzhalter angeben, um den Zugriff auf alle Ressourcen zu ermöglichen. Sie können den `*` Platzhalter nicht verwenden, um unvollständige Ressourcen-IDs abzugleichen. Sie können beispielsweise angeben**"resources": "\$1"**, aber Sie können nicht angeben. **"resources": "mqtt:clientId:\$1"**
`statementDescription`
(Optional) Eine Beschreibung für diese Richtlinienerklärung.
`certificates`
(Optional) Die Zertifikatkonfigurationsoptionen für dieses Kerngerät. Dieses Objekt enthält die folgenden Informationen:
`serverCertificateValiditySeconds`
(Optional) Die Zeitspanne (in Sekunden), nach der das lokale MQTT-Serverzertifikat abläuft. Sie können diese Option konfigurieren, um festzulegen, wie oft Client-Geräte die Verbindung zum Kerngerät trennen und wieder herstellen.
Diese Komponente rotiert das lokale MQTT-Serverzertifikat 24 Stunden vor seinem Ablauf. Der MQTT-Broker, wie die [Moquette MQTT-Broker-Komponente](mqtt-broker-moquette-component.md), generiert ein neues Zertifikat und startet neu. In diesem Fall werden alle mit diesem Kerngerät verbundenen Client-Geräte getrennt. Client-Geräte können nach kurzer Zeit wieder eine Verbindung zum Kerngerät herstellen.
Standard: `604800` (7 Tage)
Mindestwert: `172800` (2 Tage)
Höchstwert: `864000` (10 Tage)
`performance`
(Optional) Die Leistungskonfigurationsoptionen für dieses Kerngerät. Dieses Objekt enthält die folgenden Informationen:
`maxActiveAuthTokens`
(Optional) Die maximale Anzahl aktiver Autorisierungstoken für Client-Geräte. Sie können diese Anzahl erhöhen, damit eine größere Anzahl von Client-Geräten eine Verbindung zu einem Single-Core-Gerät herstellen kann, ohne sie erneut authentifizieren zu müssen.
Standard: `2500`
`cloudRequestQueueSize`
(Optional) Die maximale Anzahl von AWS Cloud Anfragen, die in die Warteschlange gestellt werden müssen, bevor diese Komponente Anfragen ablehnt.
Standard: `100`
`maxConcurrentCloudRequests`
(Optional) Die maximale Anzahl gleichzeitiger Anfragen, die an die gesendet werden sollen. AWS Cloud Sie können diese Zahl erhöhen, um die Authentifizierungsleistung auf Kerngeräten zu verbessern, auf denen Sie eine große Anzahl von Client-Geräten verbinden.
Standard: `1`
`certificateAuthority`
(Optional) Konfigurationsoptionen für Zertifizierungsstellen, um die zwischengeschaltete Zertifizierungsstelle des Kerngeräts durch Ihre eigene Zwischenzertifizierungsstelle zu ersetzen. Dieses Objekt enthält die folgenden Informationen.
Dieses Objekt enthält die folgenden Informationen:
Uri des Zertifikats
Der Speicherort des Zertifikats. Dabei kann es sich um einen Dateisystem-URI oder einen URI handeln, der auf ein Zertifikat verweist, das in einem Hardware-Sicherheitsmodul gespeichert ist.
`certificateChainUri`
Der Speicherort der Zertifikatskette für die CA des Kerngeräts. Dies sollte die komplette Zertifikatskette bis zu Ihrer Stammzertifizierungsstelle sein. Dabei kann es sich um einen Dateisystem-URI oder einen URI handeln, der auf eine Zertifikatskette verweist, die in einem Hardware-Sicherheitsmodul gespeichert ist.
`privateKeyUri`
Der Speicherort des privaten Schlüssels des Kerngeräts. Dies kann ein Dateisystem-URI oder ein URI sein, der auf einen privaten Schlüssel eines Zertifikats verweist, der in einem Hardware-Sicherheitsmodul gespeichert ist.
`security`
(Optional) Sicherheitskonfigurationsoptionen für dieses Kerngerät. Dieses Objekt enthält die folgenden Informationen.
`clientDeviceTrustDurationMinutes`
Die Dauer in Minuten, während der die Authentifizierungsinformationen eines Client-Geräts als vertrauenswürdig eingestuft werden können, bevor eine erneute Authentifizierung beim Kerngerät erforderlich ist. Der Standardwert ist 1.
`metrics`
(Optional) Die Metrikoptionen für dieses Kerngerät. Fehlermetriken werden nur angezeigt, wenn bei der Authentifizierung des Client-Geräts ein Fehler auftritt. Dieses Objekt enthält die folgenden Informationen:
`disableMetrics`
Wenn das `disableMetrics` Feld auf gesetzt ist`true`, erfasst die Authentifizierung auf dem Client-Gerät keine Metriken.
Standard: `false`
`aggregatePeriodSeconds`
Der Aggregationszeitraum in Sekunden, der bestimmt, wie oft die Authentifizierung auf dem Client-Gerät Messwerte aggregiert und an den Telemetrieagenten sendet. Dies ändert nichts daran, wie oft Metriken veröffentlicht werden, da der Telemetrieagent sie immer noch einmal täglich veröffentlicht.
Standard: `3600`
**Example Beispiel: Update zur Zusammenführung von Konfigurationen (unter Verwendung einer restriktiven Richtlinie)**
In der folgenden Beispielkonfiguration wird angegeben, dass Client-Geräte, deren Namen mit beginnen, eine Verbindung herstellen dürfen`MyClientDevice`, und publish/subscribe zwar zu allen Themen.
```
{
"deviceGroups": {
"formatVersion": "2021-03-05",
"definitions": {
"MyDeviceGroup": {
"selectionRule": "thingName: MyClientDevice*",
"policyName": "MyRestrictivePolicy"
}
},
"policies": {
"MyRestrictivePolicy": {
"AllowConnect": {
"statementDescription": "Allow client devices to connect.",
"operations": [
"mqtt:connect"
],
"resources": [
"*"
]
},
"AllowPublish": {
"statementDescription": "Allow client devices to publish on test/topic.",
"operations": [
"mqtt:publish"
],
"resources": [
"mqtt:topic:test/topic"
]
},
"AllowSubscribe": {
"statementDescription": "Allow client devices to subscribe to test/topic/response.",
"operations": [
"mqtt:subscribe"
],
"resources": [
"mqtt:topicfilter:test/topic/response"
]
}
}
}
}
}
```
**Example Beispiel: Update zur Zusammenführung von Konfigurationen (unter Verwendung einer permissiven Richtlinie)**
Die folgende Beispielkonfiguration gibt an, dass alle Client-Geräte eine Verbindung herstellen können, und zwar zu allen publish/subscribe Themen.
```
{
"deviceGroups": {
"formatVersion": "2021-03-05",
"definitions": {
"MyPermissiveDeviceGroup": {
"selectionRule": "thingName: *",
"policyName": "MyPermissivePolicy"
}
},
"policies": {
"MyPermissivePolicy": {
"AllowAll": {
"statementDescription": "Allow client devices to perform all actions.",
"operations": [
"*"
],
"resources": [
"*"
]
}
}
}
}
}
```
------
#### [ v2.3.x ]
`deviceGroups`
Gerätegruppen sind Gruppen von Client-Geräten, die berechtigt sind, eine Verbindung zu einem Kerngerät herzustellen und mit diesem zu kommunizieren. Verwenden Sie Auswahlregeln, um Gruppen von Client-Geräten zu identifizieren, und definieren Sie *Autorisierungsrichtlinien für Client-Geräte*, die die Berechtigungen für jede Gerätegruppe spezifizieren.
Dieses Objekt enthält die folgenden Informationen:
`formatVersion`
Die Formatversion für dieses Konfigurationsobjekt.
Wählen Sie aus den folgenden Optionen aus:
+ `2021-03-05`
`definitions`
Die Gerätegruppen für dieses Kerngerät. Jede Definition gibt eine *Auswahlregel an*, mit der bewertet wird, ob ein Client-Gerät Mitglied der Gruppe ist. Jede Definition gibt auch die Berechtigungsrichtlinie an, die auf Client-Geräte angewendet werden soll, die der Auswahlregel entsprechen. Wenn ein Client-Gerät Mitglied mehrerer Gerätegruppen ist, setzen sich die Berechtigungen des Geräts aus den Berechtigungsrichtlinien der einzelnen Gruppen zusammen.
Dieses Objekt enthält die folgenden Informationen:
`groupNameKey`
Der Name dieser Gerätegruppe. *groupNameKey*Ersetzen Sie ihn durch einen Namen, der Ihnen hilft, diese Gerätegruppe zu identifizieren.
Dieses Objekt enthält die folgenden Informationen:
`selectionRule`
Die Abfrage, die angibt, welche Client-Geräte Mitglieder dieser Gerätegruppe sind. Wenn ein Client-Gerät eine Verbindung herstellt, wertet das Core-Gerät diese Auswahlregel aus, um festzustellen, ob das Client-Gerät Mitglied dieser Gerätegruppe ist. Wenn das Client-Gerät Mitglied ist, verwendet das Kerngerät die Richtlinie dieser Gerätegruppe, um die Aktionen des Client-Geräts zu autorisieren.
Jede Auswahlregel umfasst mindestens eine *Auswahlregelklausel, bei der* es sich um eine Abfrage mit einem einzelnen Ausdruck handelt, die auf Client-Geräte zutreffen kann. Auswahlregeln verwenden dieselbe Abfragesyntax wie die AWS IoT Flottenindizierung. Weitere Informationen zur Syntax von Auswahlregeln finden Sie unter [Abfragesyntax für die AWS IoT Flottenindizierung](https://docs.aws.amazon.com/iot/latest/developerguide/query-syntax.html) im *AWS IoT Core Entwicklerhandbuch*.
Verwenden Sie den `*` Platzhalter, um mehreren Client-Geräten eine Auswahlregelklausel zuzuordnen. Sie können diesen Platzhalter am Ende des Dingnamens verwenden, um nach Client-Geräten zu suchen, deren Namen mit einer von Ihnen angegebenen Zeichenfolge beginnen. Sie können diesen Platzhalter auch verwenden, um alle Client-Geräte abzugleichen.
Um einen Wert auszuwählen, der einen Doppelpunkt (`:`) enthält, maskieren Sie den Doppelpunkt mit einem umgekehrten Schrägstrich (). `\\` In Formaten wie JSON müssen Sie umgekehrte Schrägstriche maskieren, sodass Sie vor dem Doppelpunkt zwei umgekehrte Schrägstriche eingeben. Geben Sie beispielsweise an, dass Sie ein Ding auswählen `thingName: MyTeam\\\\:ClientDevice1` möchten, dessen Name lautet. `MyTeam:ClientDevice1`
Sie können den folgenden Selektor angeben:
+ `thingName`— Der Name des Dings eines Client-Geräts. AWS IoT
**Example Beispiel für eine Auswahlregel**
Die folgende Auswahlregel entspricht Client-Geräten mit dem Namen `MyClientDevice1` oder`MyClientDevice2`.
```
thingName: MyClientDevice1 OR thingName: MyClientDevice2
```
**Example Beispiel für eine Auswahlregel (verwenden Sie Platzhalter)**
Die folgende Auswahlregel entspricht Client-Geräten, deren Namen mit `MyClientDevice` beginnen.
```
thingName: MyClientDevice*
```
**Example Beispiel für eine Auswahlregel (trifft auf alle Geräte zu)**
Die folgende Auswahlregel gilt für alle Client-Geräte.
```
thingName: *
```
`policyName`
Die Berechtigungsrichtlinie, die für Client-Geräte in dieser Gerätegruppe gilt. Geben Sie den Namen einer Richtlinie an, die Sie im `policies` Objekt definieren.
`policies`
Die Autorisierungsrichtlinien für Client-Geräte für Client-Geräte, die eine Verbindung zum Kerngerät herstellen. Jede Autorisierungsrichtlinie spezifiziert eine Reihe von Aktionen und die Ressourcen, über die ein Client-Gerät diese Aktionen ausführen kann.
Dieses Objekt enthält die folgenden Informationen:
`policyNameKey`
Der Name dieser Autorisierungsrichtlinie. *policyNameKey*Ersetzen Sie ihn durch einen Namen, anhand dessen Sie diese Autorisierungsrichtlinie leichter identifizieren können. Sie verwenden diesen Richtliniennamen, um zu definieren, welche Richtlinie für eine Gerätegruppe gilt.
Dieses Objekt enthält die folgenden Informationen:
`statementNameKey`
Der Name dieser Richtlinienerklärung. *statementNameKey*Ersetzen Sie ihn durch einen Namen, anhand dessen Sie diese Grundsatzerklärung leichter identifizieren können.
Dieses Objekt enthält die folgenden Informationen:
`operations`
Die Liste der Vorgänge, bei denen die Ressourcen in dieser Richtlinie berücksichtigt werden sollen.
Sie können jede der folgenden Operationen einbeziehen:
+ `mqtt:connect`— Erteilt die Erlaubnis, eine Verbindung zum Kerngerät herzustellen. Client-Geräte müssen über diese Berechtigung verfügen, um eine Verbindung zu einem Kerngerät herzustellen.
Dieser Vorgang unterstützt die folgenden Ressourcen:
+ `mqtt:clientId:deviceClientId`— Beschränken Sie den Zugriff auf der Grundlage der Client-ID, die ein Client-Gerät verwendet, um eine Verbindung zum MQTT-Broker des Kerngeräts herzustellen. *deviceClientId*Ersetzen Sie es durch die zu verwendende Client-ID.
+ `mqtt:publish`— Erteilt die Erlaubnis, MQTT-Nachrichten zu Themen zu veröffentlichen.
Dieser Vorgang unterstützt die folgenden Ressourcen:
+ `mqtt:topic:mqttTopic`— Beschränken Sie den Zugriff auf der Grundlage des MQTT-Themas, in dem ein Client-Gerät eine Nachricht veröffentlicht. Ersetzen Sie es *mqttTopic* durch das zu verwendende Thema.
Diese Ressource unterstützt keine Platzhalter für MQTT-Themen.
+ `mqtt:subscribe`— Erteilt die Erlaubnis, MQTT-Themenfilter zum Empfangen von Nachrichten zu abonnieren.
Dieser Vorgang unterstützt die folgenden Ressourcen:
+ `mqtt:topicfilter:mqttTopicFilter`— Beschränken Sie den Zugriff auf der Grundlage der MQTT-Themen, bei denen ein Client-Gerät Nachrichten abonnieren kann. *mqttTopicFilter*Ersetzen Sie es durch den zu verwendenden Themenfilter.
Diese Ressource unterstützt die Platzhalter `+` und `#` MQTT-Themen-Platzhalter. *Weitere Informationen finden Sie unter [MQTT-Themen im Developer](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) Guide.AWS IoT Core *
Das Client-Gerät kann genau die Themenfilter abonnieren, die Sie zulassen. Wenn Sie dem Client-Gerät beispielsweise erlauben, die `mqtt:topicfilter:client/+/status` Ressource zu abonnieren, kann das Client-Gerät `client/+/status` zwar abonnieren, aber nicht`client/client1/status`.
Sie können den `*` Platzhalter angeben, um den Zugriff auf alle Aktionen zu ermöglichen.
`resources`
Die Liste der Ressourcen, die für die Operationen in dieser Richtlinie zugelassen werden sollen. Geben Sie Ressourcen an, die den Vorgängen in dieser Richtlinie entsprechen. Sie könnten beispielsweise eine Liste von MQTT-Themenressourcen (`mqtt:topic:mqttTopic`) in einer Richtlinie angeben, die den `mqtt:publish` Vorgang spezifiziert.
Sie können den `*` Platzhalter angeben, um den Zugriff auf alle Ressourcen zu ermöglichen. Sie können den `*` Platzhalter nicht verwenden, um unvollständige Ressourcen-IDs abzugleichen. Sie können beispielsweise angeben**"resources": "\$1"**, aber Sie können nicht angeben. **"resources": "mqtt:clientId:\$1"**
`statementDescription`
(Optional) Eine Beschreibung für diese Richtlinienerklärung.
`certificates`
(Optional) Die Zertifikatkonfigurationsoptionen für dieses Kerngerät. Dieses Objekt enthält die folgenden Informationen:
`serverCertificateValiditySeconds`
(Optional) Die Zeitspanne (in Sekunden), nach der das lokale MQTT-Serverzertifikat abläuft. Sie können diese Option konfigurieren, um festzulegen, wie oft Client-Geräte die Verbindung zum Kerngerät trennen und wieder herstellen.
Diese Komponente rotiert das lokale MQTT-Serverzertifikat 24 Stunden vor seinem Ablauf. Der MQTT-Broker, wie die [Moquette MQTT-Broker-Komponente](mqtt-broker-moquette-component.md), generiert ein neues Zertifikat und startet neu. In diesem Fall werden alle mit diesem Kerngerät verbundenen Client-Geräte getrennt. Client-Geräte können nach kurzer Zeit wieder eine Verbindung zum Kerngerät herstellen.
Standard: `604800` (7 Tage)
Mindestwert: `172800` (2 Tage)
Höchstwert: `864000` (10 Tage)
`performance`
(Optional) Die Leistungskonfigurationsoptionen für dieses Kerngerät. Dieses Objekt enthält die folgenden Informationen:
`maxActiveAuthTokens`
(Optional) Die maximale Anzahl aktiver Autorisierungstoken für Client-Geräte. Sie können diese Anzahl erhöhen, damit eine größere Anzahl von Client-Geräten eine Verbindung zu einem Single-Core-Gerät herstellen kann, ohne sie erneut authentifizieren zu müssen.
Standard: `2500`
`cloudRequestQueueSize`
(Optional) Die maximale Anzahl von AWS Cloud Anfragen, die in die Warteschlange gestellt werden müssen, bevor diese Komponente Anfragen ablehnt.
Standard: `100`
`maxConcurrentCloudRequests`
(Optional) Die maximale Anzahl gleichzeitiger Anfragen, die an die gesendet werden sollen. AWS Cloud Sie können diese Zahl erhöhen, um die Authentifizierungsleistung auf Kerngeräten zu verbessern, auf denen Sie eine große Anzahl von Client-Geräten verbinden.
Standard: `1`
`certificateAuthority`
(Optional) Konfigurationsoptionen für Zertifizierungsstellen, um die zwischengeschaltete Zertifizierungsstelle des Kerngeräts durch Ihre eigene Zwischenzertifizierungsstelle zu ersetzen. Dieses Objekt enthält die folgenden Informationen.
Uri des Zertifikats
Der Speicherort des Zertifikats. Dabei kann es sich um einen Dateisystem-URI oder einen URI handeln, der auf ein Zertifikat verweist, das in einem Hardware-Sicherheitsmodul gespeichert ist.
`certificateChainUri`
Der Speicherort der Zertifikatskette für die CA des Kerngeräts. Dies sollte die komplette Zertifikatskette bis zu Ihrer Stammzertifizierungsstelle sein. Dabei kann es sich um einen Dateisystem-URI oder einen URI handeln, der auf eine Zertifikatskette verweist, die in einem Hardware-Sicherheitsmodul gespeichert ist.
`privateKeyUri`
Der Speicherort des privaten Schlüssels des Kerngeräts. Dies kann ein Dateisystem-URI oder ein URI sein, der auf einen privaten Schlüssel eines Zertifikats verweist, der in einem Hardware-Sicherheitsmodul gespeichert ist.
`security`
(Optional) Sicherheitskonfigurationsoptionen für dieses Kerngerät. Dieses Objekt enthält die folgenden Informationen.
`clientDeviceTrustDurationMinutes`
Die Dauer in Minuten, während der die Authentifizierungsinformationen eines Client-Geräts als vertrauenswürdig eingestuft werden können, bevor eine erneute Authentifizierung beim Kerngerät erforderlich ist. Der Standardwert ist 1.
**Example Beispiel: Update zur Zusammenführung von Konfigurationen (unter Verwendung einer restriktiven Richtlinie)**
In der folgenden Beispielkonfiguration wird angegeben, dass Client-Geräte, deren Namen mit beginnen, eine Verbindung herstellen dürfen`MyClientDevice`, und publish/subscribe zwar zu allen Themen.
```
{
"deviceGroups": {
"formatVersion": "2021-03-05",
"definitions": {
"MyDeviceGroup": {
"selectionRule": "thingName: MyClientDevice*",
"policyName": "MyRestrictivePolicy"
}
},
"policies": {
"MyRestrictivePolicy": {
"AllowConnect": {
"statementDescription": "Allow client devices to connect.",
"operations": [
"mqtt:connect"
],
"resources": [
"*"
]
},
"AllowPublish": {
"statementDescription": "Allow client devices to publish on test/topic.",
"operations": [
"mqtt:publish"
],
"resources": [
"mqtt:topic:test/topic"
]
},
"AllowSubscribe": {
"statementDescription": "Allow client devices to subscribe to test/topic/response.",
"operations": [
"mqtt:subscribe"
],
"resources": [
"mqtt:topicfilter:test/topic/response"
]
}
}
}
}
}
```
**Example Beispiel: Update zur Zusammenführung von Konfigurationen (unter Verwendung einer permissiven Richtlinie)**
Die folgende Beispielkonfiguration gibt an, dass alle Client-Geräte eine Verbindung herstellen können, und zwar zu allen publish/subscribe Themen.
```
{
"deviceGroups": {
"formatVersion": "2021-03-05",
"definitions": {
"MyPermissiveDeviceGroup": {
"selectionRule": "thingName: *",
"policyName": "MyPermissivePolicy"
}
},
"policies": {
"MyPermissivePolicy": {
"AllowAll": {
"statementDescription": "Allow client devices to perform all actions.",
"operations": [
"*"
],
"resources": [
"*"
]
}
}
}
}
}
```
------
#### [ v2.2.x ]
`deviceGroups`
Gerätegruppen sind Gruppen von Client-Geräten, die berechtigt sind, eine Verbindung zu einem Kerngerät herzustellen und mit diesem zu kommunizieren. Verwenden Sie Auswahlregeln, um Gruppen von Client-Geräten zu identifizieren, und definieren Sie *Autorisierungsrichtlinien für Client-Geräte*, die die Berechtigungen für jede Gerätegruppe spezifizieren.
Dieses Objekt enthält die folgenden Informationen:
`formatVersion`
Die Formatversion für dieses Konfigurationsobjekt.
Wählen Sie aus den folgenden Optionen aus:
+ `2021-03-05`
`definitions`
Die Gerätegruppen für dieses Kerngerät. Jede Definition gibt eine *Auswahlregel an*, mit der bewertet wird, ob ein Client-Gerät Mitglied der Gruppe ist. Jede Definition gibt auch die Berechtigungsrichtlinie an, die auf Client-Geräte angewendet werden soll, die der Auswahlregel entsprechen. Wenn ein Client-Gerät Mitglied mehrerer Gerätegruppen ist, setzen sich die Berechtigungen des Geräts aus den Berechtigungsrichtlinien der einzelnen Gruppen zusammen.
Dieses Objekt enthält die folgenden Informationen:
`groupNameKey`
Der Name dieser Gerätegruppe. *groupNameKey*Ersetzen Sie ihn durch einen Namen, der Ihnen hilft, diese Gerätegruppe zu identifizieren.
Dieses Objekt enthält die folgenden Informationen:
`selectionRule`
Die Abfrage, die angibt, welche Client-Geräte Mitglieder dieser Gerätegruppe sind. Wenn ein Client-Gerät eine Verbindung herstellt, wertet das Core-Gerät diese Auswahlregel aus, um festzustellen, ob das Client-Gerät Mitglied dieser Gerätegruppe ist. Wenn das Client-Gerät Mitglied ist, verwendet das Kerngerät die Richtlinie dieser Gerätegruppe, um die Aktionen des Client-Geräts zu autorisieren.
Jede Auswahlregel umfasst mindestens eine *Auswahlregelklausel, bei der* es sich um eine Abfrage mit einem einzelnen Ausdruck handelt, die auf Client-Geräte zutreffen kann. Auswahlregeln verwenden dieselbe Abfragesyntax wie die AWS IoT Flottenindizierung. Weitere Informationen zur Syntax von Auswahlregeln finden Sie unter [Abfragesyntax für die AWS IoT Flottenindizierung](https://docs.aws.amazon.com/iot/latest/developerguide/query-syntax.html) im *AWS IoT Core Entwicklerhandbuch*.
Verwenden Sie den `*` Platzhalter, um mehreren Client-Geräten eine Auswahlregelklausel zuzuordnen. Sie können diesen Platzhalter am Ende des Dingnamens verwenden, um nach Client-Geräten zu suchen, deren Namen mit einer von Ihnen angegebenen Zeichenfolge beginnen. Sie können diesen Platzhalter auch verwenden, um alle Client-Geräte abzugleichen.
Um einen Wert auszuwählen, der einen Doppelpunkt (`:`) enthält, maskieren Sie den Doppelpunkt mit einem umgekehrten Schrägstrich (). `\\` In Formaten wie JSON müssen Sie umgekehrte Schrägstriche maskieren, sodass Sie vor dem Doppelpunkt zwei umgekehrte Schrägstriche eingeben. Geben Sie beispielsweise an, dass Sie ein Ding auswählen `thingName: MyTeam\\\\:ClientDevice1` möchten, dessen Name lautet. `MyTeam:ClientDevice1`
Sie können den folgenden Selektor angeben:
+ `thingName`— Der Name des Dings eines Client-Geräts. AWS IoT
**Example Beispiel für eine Auswahlregel**
Die folgende Auswahlregel entspricht Client-Geräten mit dem Namen `MyClientDevice1` oder`MyClientDevice2`.
```
thingName: MyClientDevice1 OR thingName: MyClientDevice2
```
**Example Beispiel für eine Auswahlregel (verwenden Sie Platzhalter)**
Die folgende Auswahlregel entspricht Client-Geräten, deren Namen mit `MyClientDevice` beginnen.
```
thingName: MyClientDevice*
```
**Example Beispiel für eine Auswahlregel (trifft auf alle Geräte zu)**
Die folgende Auswahlregel gilt für alle Client-Geräte.
```
thingName: *
```
`policyName`
Die Berechtigungsrichtlinie, die für Client-Geräte in dieser Gerätegruppe gilt. Geben Sie den Namen einer Richtlinie an, die Sie im `policies` Objekt definieren.
`policies`
Die Autorisierungsrichtlinien für Client-Geräte für Client-Geräte, die eine Verbindung zum Kerngerät herstellen. Jede Autorisierungsrichtlinie spezifiziert eine Reihe von Aktionen und die Ressourcen, über die ein Client-Gerät diese Aktionen ausführen kann.
Dieses Objekt enthält die folgenden Informationen:
`policyNameKey`
Der Name dieser Autorisierungsrichtlinie. *policyNameKey*Ersetzen Sie ihn durch einen Namen, anhand dessen Sie diese Autorisierungsrichtlinie leichter identifizieren können. Sie verwenden diesen Richtliniennamen, um zu definieren, welche Richtlinie für eine Gerätegruppe gilt.
Dieses Objekt enthält die folgenden Informationen:
`statementNameKey`
Der Name dieser Richtlinienerklärung. *statementNameKey*Ersetzen Sie ihn durch einen Namen, anhand dessen Sie diese Grundsatzerklärung leichter identifizieren können.
Dieses Objekt enthält die folgenden Informationen:
`operations`
Die Liste der Vorgänge, bei denen die Ressourcen in dieser Richtlinie berücksichtigt werden sollen.
Sie können jede der folgenden Operationen einbeziehen:
+ `mqtt:connect`— Erteilt die Erlaubnis, eine Verbindung zum Kerngerät herzustellen. Client-Geräte müssen über diese Berechtigung verfügen, um eine Verbindung zu einem Kerngerät herzustellen.
Dieser Vorgang unterstützt die folgenden Ressourcen:
+ `mqtt:clientId:deviceClientId`— Beschränken Sie den Zugriff auf der Grundlage der Client-ID, die ein Client-Gerät verwendet, um eine Verbindung zum MQTT-Broker des Kerngeräts herzustellen. *deviceClientId*Ersetzen Sie es durch die zu verwendende Client-ID.
+ `mqtt:publish`— Erteilt die Erlaubnis, MQTT-Nachrichten zu Themen zu veröffentlichen.
Dieser Vorgang unterstützt die folgenden Ressourcen:
+ `mqtt:topic:mqttTopic`— Beschränken Sie den Zugriff auf der Grundlage des MQTT-Themas, in dem ein Client-Gerät eine Nachricht veröffentlicht. Ersetzen Sie es *mqttTopic* durch das zu verwendende Thema.
Diese Ressource unterstützt keine Platzhalter für MQTT-Themen.
+ `mqtt:subscribe`— Erteilt die Erlaubnis, MQTT-Themenfilter zum Empfangen von Nachrichten zu abonnieren.
Dieser Vorgang unterstützt die folgenden Ressourcen:
+ `mqtt:topicfilter:mqttTopicFilter`— Beschränken Sie den Zugriff auf der Grundlage der MQTT-Themen, bei denen ein Client-Gerät Nachrichten abonnieren kann. *mqttTopicFilter*Ersetzen Sie es durch den zu verwendenden Themenfilter.
Diese Ressource unterstützt die Platzhalter `+` und `#` MQTT-Themen-Platzhalter. *Weitere Informationen finden Sie unter [MQTT-Themen im Developer](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) Guide.AWS IoT Core *
Das Client-Gerät kann genau die Themenfilter abonnieren, die Sie zulassen. Wenn Sie dem Client-Gerät beispielsweise erlauben, die `mqtt:topicfilter:client/+/status` Ressource zu abonnieren, kann das Client-Gerät `client/+/status` zwar abonnieren, aber nicht`client/client1/status`.
Sie können den `*` Platzhalter angeben, um den Zugriff auf alle Aktionen zu ermöglichen.
`resources`
Die Liste der Ressourcen, die für die Operationen in dieser Richtlinie zugelassen werden sollen. Geben Sie Ressourcen an, die den Vorgängen in dieser Richtlinie entsprechen. Sie könnten beispielsweise eine Liste von MQTT-Themenressourcen (`mqtt:topic:mqttTopic`) in einer Richtlinie angeben, die den `mqtt:publish` Vorgang spezifiziert.
Sie können den `*` Platzhalter angeben, um den Zugriff auf alle Ressourcen zu ermöglichen. Sie können den `*` Platzhalter nicht verwenden, um unvollständige Ressourcen-IDs abzugleichen. Sie können beispielsweise angeben**"resources": "\$1"**, aber Sie können nicht angeben. **"resources": "mqtt:clientId:\$1"**
`statementDescription`
(Optional) Eine Beschreibung für diese Richtlinienerklärung.
`certificates`
(Optional) Die Zertifikatkonfigurationsoptionen für dieses Kerngerät. Dieses Objekt enthält die folgenden Informationen:
`serverCertificateValiditySeconds`
(Optional) Die Zeitspanne (in Sekunden), nach der das lokale MQTT-Serverzertifikat abläuft. Sie können diese Option konfigurieren, um festzulegen, wie oft Client-Geräte die Verbindung zum Kerngerät trennen und wieder herstellen.
Diese Komponente rotiert das lokale MQTT-Serverzertifikat 24 Stunden vor seinem Ablauf. Der MQTT-Broker, wie die [Moquette MQTT-Broker-Komponente](mqtt-broker-moquette-component.md), generiert ein neues Zertifikat und startet neu. In diesem Fall werden alle mit diesem Kerngerät verbundenen Client-Geräte getrennt. Client-Geräte können nach kurzer Zeit wieder eine Verbindung zum Kerngerät herstellen.
Standard: `604800` (7 Tage)
Mindestwert: `172800` (2 Tage)
Höchstwert: `864000` (10 Tage)
`performance`
(Optional) Die Leistungskonfigurationsoptionen für dieses Kerngerät. Dieses Objekt enthält die folgenden Informationen:
`maxActiveAuthTokens`
(Optional) Die maximale Anzahl aktiver Autorisierungstoken für Client-Geräte. Sie können diese Anzahl erhöhen, damit eine größere Anzahl von Client-Geräten eine Verbindung zu einem Single-Core-Gerät herstellen kann, ohne sie erneut authentifizieren zu müssen.
Standard: `2500`
`cloudRequestQueueSize`
(Optional) Die maximale Anzahl von AWS Cloud Anfragen, die in die Warteschlange gestellt werden müssen, bevor diese Komponente Anfragen ablehnt.
Standard: `100`
`maxConcurrentCloudRequests`
(Optional) Die maximale Anzahl gleichzeitiger Anfragen, die an die gesendet werden sollen. AWS Cloud Sie können diese Zahl erhöhen, um die Authentifizierungsleistung auf Kerngeräten zu verbessern, auf denen Sie eine große Anzahl von Client-Geräten verbinden.
Standard: `1`
**Example Beispiel: Update zur Zusammenführung von Konfigurationen (unter Verwendung einer restriktiven Richtlinie)**
In der folgenden Beispielkonfiguration wird angegeben, dass Client-Geräte, deren Namen mit beginnen, eine Verbindung herstellen dürfen`MyClientDevice`, und publish/subscribe zwar zu allen Themen.
```
{
"deviceGroups": {
"formatVersion": "2021-03-05",
"definitions": {
"MyDeviceGroup": {
"selectionRule": "thingName: MyClientDevice*",
"policyName": "MyRestrictivePolicy"
}
},
"policies": {
"MyRestrictivePolicy": {
"AllowConnect": {
"statementDescription": "Allow client devices to connect.",
"operations": [
"mqtt:connect"
],
"resources": [
"*"
]
},
"AllowPublish": {
"statementDescription": "Allow client devices to publish on test/topic.",
"operations": [
"mqtt:publish"
],
"resources": [
"mqtt:topic:test/topic"
]
},
"AllowSubscribe": {
"statementDescription": "Allow client devices to subscribe to test/topic/response.",
"operations": [
"mqtt:subscribe"
],
"resources": [
"mqtt:topicfilter:test/topic/response"
]
}
}
}
}
}
```
**Example Beispiel: Update zur Zusammenführung von Konfigurationen (unter Verwendung einer permissiven Richtlinie)**
Die folgende Beispielkonfiguration gibt an, dass alle Client-Geräte eine Verbindung herstellen können, und zwar zu allen publish/subscribe Themen.
```
{
"deviceGroups": {
"formatVersion": "2021-03-05",
"definitions": {
"MyPermissiveDeviceGroup": {
"selectionRule": "thingName: *",
"policyName": "MyPermissivePolicy"
}
},
"policies": {
"MyPermissivePolicy": {
"AllowAll": {
"statementDescription": "Allow client devices to perform all actions.",
"operations": [
"*"
],
"resources": [
"*"
]
}
}
}
}
}
```
------
#### [ v2.1.x ]
`deviceGroups`
Gerätegruppen sind Gruppen von Client-Geräten, die berechtigt sind, eine Verbindung zu einem Kerngerät herzustellen und mit diesem zu kommunizieren. Verwenden Sie Auswahlregeln, um Gruppen von Client-Geräten zu identifizieren, und definieren Sie *Autorisierungsrichtlinien für Client-Geräte*, die die Berechtigungen für jede Gerätegruppe spezifizieren.
Dieses Objekt enthält die folgenden Informationen:
`formatVersion`
Die Formatversion für dieses Konfigurationsobjekt.
Wählen Sie aus den folgenden Optionen aus:
+ `2021-03-05`
`definitions`
Die Gerätegruppen für dieses Kerngerät. Jede Definition gibt eine *Auswahlregel an*, mit der bewertet wird, ob ein Client-Gerät Mitglied der Gruppe ist. Jede Definition gibt auch die Berechtigungsrichtlinie an, die auf Client-Geräte angewendet werden soll, die der Auswahlregel entsprechen. Wenn ein Client-Gerät Mitglied mehrerer Gerätegruppen ist, setzen sich die Berechtigungen des Geräts aus den Berechtigungsrichtlinien der einzelnen Gruppen zusammen.
Dieses Objekt enthält die folgenden Informationen:
`groupNameKey`
Der Name dieser Gerätegruppe. *groupNameKey*Ersetzen Sie ihn durch einen Namen, der Ihnen hilft, diese Gerätegruppe zu identifizieren.
Dieses Objekt enthält die folgenden Informationen:
`selectionRule`
Die Abfrage, die angibt, welche Client-Geräte Mitglieder dieser Gerätegruppe sind. Wenn ein Client-Gerät eine Verbindung herstellt, wertet das Core-Gerät diese Auswahlregel aus, um festzustellen, ob das Client-Gerät Mitglied dieser Gerätegruppe ist. Wenn das Client-Gerät Mitglied ist, verwendet das Kerngerät die Richtlinie dieser Gerätegruppe, um die Aktionen des Client-Geräts zu autorisieren.
Jede Auswahlregel umfasst mindestens eine *Auswahlregelklausel, bei der* es sich um eine Abfrage mit einem einzelnen Ausdruck handelt, die auf Client-Geräte zutreffen kann. Auswahlregeln verwenden dieselbe Abfragesyntax wie die AWS IoT Flottenindizierung. Weitere Informationen zur Syntax von Auswahlregeln finden Sie unter [Abfragesyntax für die AWS IoT Flottenindizierung](https://docs.aws.amazon.com/iot/latest/developerguide/query-syntax.html) im *AWS IoT Core Entwicklerhandbuch*.
Verwenden Sie den `*` Platzhalter, um mehreren Client-Geräten eine Auswahlregelklausel zuzuordnen. Sie können diesen Platzhalter am Ende des Dingnamens verwenden, um nach Client-Geräten zu suchen, deren Namen mit einer von Ihnen angegebenen Zeichenfolge beginnen. Sie können diesen Platzhalter auch verwenden, um alle Client-Geräte abzugleichen.
Um einen Wert auszuwählen, der einen Doppelpunkt (`:`) enthält, maskieren Sie den Doppelpunkt mit einem umgekehrten Schrägstrich (). `\\` In Formaten wie JSON müssen Sie umgekehrte Schrägstriche maskieren, sodass Sie vor dem Doppelpunkt zwei umgekehrte Schrägstriche eingeben. Geben Sie beispielsweise an, dass Sie ein Ding auswählen `thingName: MyTeam\\\\:ClientDevice1` möchten, dessen Name lautet. `MyTeam:ClientDevice1`
Sie können den folgenden Selektor angeben:
+ `thingName`— Der Name des Dings eines Client-Geräts. AWS IoT
**Example Beispiel für eine Auswahlregel**
Die folgende Auswahlregel entspricht Client-Geräten mit dem Namen `MyClientDevice1` oder`MyClientDevice2`.
```
thingName: MyClientDevice1 OR thingName: MyClientDevice2
```
**Example Beispiel für eine Auswahlregel (verwenden Sie Platzhalter)**
Die folgende Auswahlregel entspricht Client-Geräten, deren Namen mit `MyClientDevice` beginnen.
```
thingName: MyClientDevice*
```
**Example Beispiel für eine Auswahlregel (trifft auf alle Geräte zu)**
Die folgende Auswahlregel gilt für alle Client-Geräte.
```
thingName: *
```
`policyName`
Die Berechtigungsrichtlinie, die für Client-Geräte in dieser Gerätegruppe gilt. Geben Sie den Namen einer Richtlinie an, die Sie im `policies` Objekt definieren.
`policies`
Die Autorisierungsrichtlinien für Client-Geräte für Client-Geräte, die eine Verbindung zum Kerngerät herstellen. Jede Autorisierungsrichtlinie spezifiziert eine Reihe von Aktionen und die Ressourcen, über die ein Client-Gerät diese Aktionen ausführen kann.
Dieses Objekt enthält die folgenden Informationen:
`policyNameKey`
Der Name dieser Autorisierungsrichtlinie. *policyNameKey*Ersetzen Sie ihn durch einen Namen, anhand dessen Sie diese Autorisierungsrichtlinie leichter identifizieren können. Sie verwenden diesen Richtliniennamen, um zu definieren, welche Richtlinie für eine Gerätegruppe gilt.
Dieses Objekt enthält die folgenden Informationen:
`statementNameKey`
Der Name dieser Richtlinienerklärung. *statementNameKey*Ersetzen Sie ihn durch einen Namen, anhand dessen Sie diese Grundsatzerklärung leichter identifizieren können.
Dieses Objekt enthält die folgenden Informationen:
`operations`
Die Liste der Vorgänge, bei denen die Ressourcen in dieser Richtlinie berücksichtigt werden sollen.
Sie können jede der folgenden Operationen einbeziehen:
+ `mqtt:connect`— Erteilt die Erlaubnis, eine Verbindung zum Kerngerät herzustellen. Client-Geräte müssen über diese Berechtigung verfügen, um eine Verbindung zu einem Kerngerät herzustellen.
Dieser Vorgang unterstützt die folgenden Ressourcen:
+ `mqtt:clientId:deviceClientId`— Beschränken Sie den Zugriff auf der Grundlage der Client-ID, die ein Client-Gerät verwendet, um eine Verbindung zum MQTT-Broker des Kerngeräts herzustellen. *deviceClientId*Ersetzen Sie es durch die zu verwendende Client-ID.
+ `mqtt:publish`— Erteilt die Erlaubnis, MQTT-Nachrichten zu Themen zu veröffentlichen.
Dieser Vorgang unterstützt die folgenden Ressourcen:
+ `mqtt:topic:mqttTopic`— Beschränken Sie den Zugriff auf der Grundlage des MQTT-Themas, in dem ein Client-Gerät eine Nachricht veröffentlicht. Ersetzen Sie es *mqttTopic* durch das zu verwendende Thema.
Diese Ressource unterstützt keine Platzhalter für MQTT-Themen.
+ `mqtt:subscribe`— Erteilt die Erlaubnis, MQTT-Themenfilter zum Empfangen von Nachrichten zu abonnieren.
Dieser Vorgang unterstützt die folgenden Ressourcen:
+ `mqtt:topicfilter:mqttTopicFilter`— Beschränken Sie den Zugriff auf der Grundlage der MQTT-Themen, bei denen ein Client-Gerät Nachrichten abonnieren kann. *mqttTopicFilter*Ersetzen Sie es durch den zu verwendenden Themenfilter.
Diese Ressource unterstützt die Platzhalter `+` und `#` MQTT-Themen-Platzhalter. *Weitere Informationen finden Sie unter [MQTT-Themen im Developer](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) Guide.AWS IoT Core *
Das Client-Gerät kann genau die Themenfilter abonnieren, die Sie zulassen. Wenn Sie dem Client-Gerät beispielsweise erlauben, die `mqtt:topicfilter:client/+/status` Ressource zu abonnieren, kann das Client-Gerät `client/+/status` zwar abonnieren, aber nicht`client/client1/status`.
Sie können den `*` Platzhalter angeben, um den Zugriff auf alle Aktionen zu ermöglichen.
`resources`
Die Liste der Ressourcen, die für die Operationen in dieser Richtlinie zugelassen werden sollen. Geben Sie Ressourcen an, die den Vorgängen in dieser Richtlinie entsprechen. Sie könnten beispielsweise eine Liste von MQTT-Themenressourcen (`mqtt:topic:mqttTopic`) in einer Richtlinie angeben, die den `mqtt:publish` Vorgang spezifiziert.
Sie können den `*` Platzhalter angeben, um den Zugriff auf alle Ressourcen zu ermöglichen. Sie können den `*` Platzhalter nicht verwenden, um unvollständige Ressourcen-IDs abzugleichen. Sie können beispielsweise angeben**"resources": "\$1"**, aber Sie können nicht angeben. **"resources": "mqtt:clientId:\$1"**
`statementDescription`
(Optional) Eine Beschreibung für diese Richtlinienerklärung.
`certificates`
(Optional) Die Zertifikatkonfigurationsoptionen für dieses Kerngerät. Dieses Objekt enthält die folgenden Informationen:
`serverCertificateValiditySeconds`
(Optional) Die Zeitspanne (in Sekunden), nach der das lokale MQTT-Serverzertifikat abläuft. Sie können diese Option konfigurieren, um festzulegen, wie oft Client-Geräte die Verbindung zum Kerngerät trennen und wieder herstellen.
Diese Komponente rotiert das lokale MQTT-Serverzertifikat 24 Stunden vor seinem Ablauf. Der MQTT-Broker, wie die [Moquette MQTT-Broker-Komponente](mqtt-broker-moquette-component.md), generiert ein neues Zertifikat und startet neu. In diesem Fall werden alle mit diesem Kerngerät verbundenen Client-Geräte getrennt. Client-Geräte können nach kurzer Zeit wieder eine Verbindung zum Kerngerät herstellen.
Standard: `604800` (7 Tage)
Mindestwert: `172800` (2 Tage)
Höchstwert: `864000` (10 Tage)
**Example Beispiel: Update zur Zusammenführung von Konfigurationen (unter Verwendung einer restriktiven Richtlinie)**
In der folgenden Beispielkonfiguration wird angegeben, dass Client-Geräte, deren Namen mit beginnen, eine Verbindung herstellen dürfen`MyClientDevice`, und publish/subscribe zwar zu allen Themen.
```
{
"deviceGroups": {
"formatVersion": "2021-03-05",
"definitions": {
"MyDeviceGroup": {
"selectionRule": "thingName: MyClientDevice*",
"policyName": "MyRestrictivePolicy"
}
},
"policies": {
"MyRestrictivePolicy": {
"AllowConnect": {
"statementDescription": "Allow client devices to connect.",
"operations": [
"mqtt:connect"
],
"resources": [
"*"
]
},
"AllowPublish": {
"statementDescription": "Allow client devices to publish on test/topic.",
"operations": [
"mqtt:publish"
],
"resources": [
"mqtt:topic:test/topic"
]
},
"AllowSubscribe": {
"statementDescription": "Allow client devices to subscribe to test/topic/response.",
"operations": [
"mqtt:subscribe"
],
"resources": [
"mqtt:topicfilter:test/topic/response"
]
}
}
}
}
}
```
**Example Beispiel: Update zur Zusammenführung von Konfigurationen (unter Verwendung einer permissiven Richtlinie)**
Die folgende Beispielkonfiguration gibt an, dass alle Client-Geräte eine Verbindung herstellen können, und zwar zu allen publish/subscribe Themen.
```
{
"deviceGroups": {
"formatVersion": "2021-03-05",
"definitions": {
"MyPermissiveDeviceGroup": {
"selectionRule": "thingName: *",
"policyName": "MyPermissivePolicy"
}
},
"policies": {
"MyPermissivePolicy": {
"AllowAll": {
"statementDescription": "Allow client devices to perform all actions.",
"operations": [
"*"
],
"resources": [
"*"
]
}
}
}
}
}
```
------
#### [ v2.0.x ]
`deviceGroups`
Gerätegruppen sind Gruppen von Client-Geräten, die berechtigt sind, eine Verbindung zu einem Kerngerät herzustellen und mit diesem zu kommunizieren. Verwenden Sie Auswahlregeln, um Gruppen von Client-Geräten zu identifizieren, und definieren Sie *Autorisierungsrichtlinien für Client-Geräte*, die die Berechtigungen für jede Gerätegruppe spezifizieren.
Dieses Objekt enthält die folgenden Informationen:
`formatVersion`
Die Formatversion für dieses Konfigurationsobjekt.
Wählen Sie aus den folgenden Optionen aus:
+ `2021-03-05`
`definitions`
Die Gerätegruppen für dieses Kerngerät. Jede Definition gibt eine *Auswahlregel an*, mit der bewertet wird, ob ein Client-Gerät Mitglied der Gruppe ist. Jede Definition gibt auch die Berechtigungsrichtlinie an, die auf Client-Geräte angewendet werden soll, die der Auswahlregel entsprechen. Wenn ein Client-Gerät Mitglied mehrerer Gerätegruppen ist, setzen sich die Berechtigungen des Geräts aus den Berechtigungsrichtlinien der einzelnen Gruppen zusammen.
Dieses Objekt enthält die folgenden Informationen:
`groupNameKey`
Der Name dieser Gerätegruppe. *groupNameKey*Ersetzen Sie ihn durch einen Namen, der Ihnen hilft, diese Gerätegruppe zu identifizieren.
Dieses Objekt enthält die folgenden Informationen:
`selectionRule`
Die Abfrage, die angibt, welche Client-Geräte Mitglieder dieser Gerätegruppe sind. Wenn ein Client-Gerät eine Verbindung herstellt, wertet das Core-Gerät diese Auswahlregel aus, um festzustellen, ob das Client-Gerät Mitglied dieser Gerätegruppe ist. Wenn das Client-Gerät Mitglied ist, verwendet das Kerngerät die Richtlinie dieser Gerätegruppe, um die Aktionen des Client-Geräts zu autorisieren.
Jede Auswahlregel umfasst mindestens eine *Auswahlregelklausel, bei der* es sich um eine Abfrage mit einem einzelnen Ausdruck handelt, die auf Client-Geräte zutreffen kann. Auswahlregeln verwenden dieselbe Abfragesyntax wie die AWS IoT Flottenindizierung. Weitere Informationen zur Syntax von Auswahlregeln finden Sie unter [Abfragesyntax für die AWS IoT Flottenindizierung](https://docs.aws.amazon.com/iot/latest/developerguide/query-syntax.html) im *AWS IoT Core Entwicklerhandbuch*.
Verwenden Sie den `*` Platzhalter, um mehreren Client-Geräten eine Auswahlregelklausel zuzuordnen. Sie können diesen Platzhalter am Ende des Dingnamens verwenden, um nach Client-Geräten zu suchen, deren Namen mit einer von Ihnen angegebenen Zeichenfolge beginnen. Sie können diesen Platzhalter auch verwenden, um alle Client-Geräte abzugleichen.
Um einen Wert auszuwählen, der einen Doppelpunkt (`:`) enthält, maskieren Sie den Doppelpunkt mit einem umgekehrten Schrägstrich (). `\\` In Formaten wie JSON müssen Sie umgekehrte Schrägstriche maskieren, sodass Sie vor dem Doppelpunkt zwei umgekehrte Schrägstriche eingeben. Geben Sie beispielsweise an, dass Sie ein Ding auswählen `thingName: MyTeam\\\\:ClientDevice1` möchten, dessen Name lautet. `MyTeam:ClientDevice1`
Sie können den folgenden Selektor angeben:
+ `thingName`— Der Name des Dings eines Client-Geräts. AWS IoT
**Example Beispiel für eine Auswahlregel**
Die folgende Auswahlregel entspricht Client-Geräten mit dem Namen `MyClientDevice1` oder`MyClientDevice2`.
```
thingName: MyClientDevice1 OR thingName: MyClientDevice2
```
**Example Beispiel für eine Auswahlregel (verwenden Sie Platzhalter)**
Die folgende Auswahlregel entspricht Client-Geräten, deren Namen mit `MyClientDevice` beginnen.
```
thingName: MyClientDevice*
```
**Example Beispiel für eine Auswahlregel (trifft auf alle Geräte zu)**
Die folgende Auswahlregel gilt für alle Client-Geräte.
```
thingName: *
```
`policyName`
Die Berechtigungsrichtlinie, die für Client-Geräte in dieser Gerätegruppe gilt. Geben Sie den Namen einer Richtlinie an, die Sie im `policies` Objekt definieren.
`policies`
Die Autorisierungsrichtlinien für Client-Geräte für Client-Geräte, die eine Verbindung zum Kerngerät herstellen. Jede Autorisierungsrichtlinie spezifiziert eine Reihe von Aktionen und die Ressourcen, über die ein Client-Gerät diese Aktionen ausführen kann.
Dieses Objekt enthält die folgenden Informationen:
`policyNameKey`
Der Name dieser Autorisierungsrichtlinie. *policyNameKey*Ersetzen Sie ihn durch einen Namen, anhand dessen Sie diese Autorisierungsrichtlinie leichter identifizieren können. Sie verwenden diesen Richtliniennamen, um zu definieren, welche Richtlinie für eine Gerätegruppe gilt.
Dieses Objekt enthält die folgenden Informationen:
`statementNameKey`
Der Name dieser Richtlinienerklärung. *statementNameKey*Ersetzen Sie ihn durch einen Namen, anhand dessen Sie diese Grundsatzerklärung leichter identifizieren können.
Dieses Objekt enthält die folgenden Informationen:
`operations`
Die Liste der Vorgänge, bei denen die Ressourcen in dieser Richtlinie berücksichtigt werden sollen.
Sie können jede der folgenden Operationen einbeziehen:
+ `mqtt:connect`— Erteilt die Erlaubnis, eine Verbindung zum Kerngerät herzustellen. Client-Geräte müssen über diese Berechtigung verfügen, um eine Verbindung zu einem Kerngerät herzustellen.
Dieser Vorgang unterstützt die folgenden Ressourcen:
+ `mqtt:clientId:deviceClientId`— Beschränken Sie den Zugriff auf der Grundlage der Client-ID, die ein Client-Gerät verwendet, um eine Verbindung zum MQTT-Broker des Kerngeräts herzustellen. *deviceClientId*Ersetzen Sie es durch die zu verwendende Client-ID.
+ `mqtt:publish`— Erteilt die Erlaubnis, MQTT-Nachrichten zu Themen zu veröffentlichen.
Dieser Vorgang unterstützt die folgenden Ressourcen:
+ `mqtt:topic:mqttTopic`— Beschränken Sie den Zugriff auf der Grundlage des MQTT-Themas, in dem ein Client-Gerät eine Nachricht veröffentlicht. Ersetzen Sie es *mqttTopic* durch das zu verwendende Thema.
Diese Ressource unterstützt keine Platzhalter für MQTT-Themen.
+ `mqtt:subscribe`— Erteilt die Erlaubnis, MQTT-Themenfilter zum Empfangen von Nachrichten zu abonnieren.
Dieser Vorgang unterstützt die folgenden Ressourcen:
+ `mqtt:topicfilter:mqttTopicFilter`— Beschränken Sie den Zugriff auf der Grundlage der MQTT-Themen, bei denen ein Client-Gerät Nachrichten abonnieren kann. *mqttTopicFilter*Ersetzen Sie es durch den zu verwendenden Themenfilter.
Diese Ressource unterstützt die Platzhalter `+` und `#` MQTT-Themen-Platzhalter. *Weitere Informationen finden Sie unter [MQTT-Themen im Developer](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) Guide.AWS IoT Core *
Das Client-Gerät kann genau die Themenfilter abonnieren, die Sie zulassen. Wenn Sie dem Client-Gerät beispielsweise erlauben, die `mqtt:topicfilter:client/+/status` Ressource zu abonnieren, kann das Client-Gerät `client/+/status` zwar abonnieren, aber nicht`client/client1/status`.
Sie können den `*` Platzhalter angeben, um den Zugriff auf alle Aktionen zu ermöglichen.
`resources`
Die Liste der Ressourcen, die für die Operationen in dieser Richtlinie zugelassen werden sollen. Geben Sie Ressourcen an, die den Vorgängen in dieser Richtlinie entsprechen. Sie könnten beispielsweise eine Liste von MQTT-Themenressourcen (`mqtt:topic:mqttTopic`) in einer Richtlinie angeben, die den `mqtt:publish` Vorgang spezifiziert.
Sie können den `*` Platzhalter angeben, um den Zugriff auf alle Ressourcen zu ermöglichen. Sie können den `*` Platzhalter nicht verwenden, um unvollständige Ressourcen-IDs abzugleichen. Sie können beispielsweise angeben**"resources": "\$1"**, aber Sie können nicht angeben. **"resources": "mqtt:clientId:\$1"**
`statementDescription`
(Optional) Eine Beschreibung für diese Richtlinienerklärung.
**Example Beispiel: Update zur Zusammenführung von Konfigurationen (unter Verwendung einer restriktiven Richtlinie)**
In der folgenden Beispielkonfiguration wird angegeben, dass Client-Geräte, deren Namen mit beginnen, eine Verbindung herstellen dürfen`MyClientDevice`, und publish/subscribe zwar zu allen Themen.
```
{
"deviceGroups": {
"formatVersion": "2021-03-05",
"definitions": {
"MyDeviceGroup": {
"selectionRule": "thingName: MyClientDevice*",
"policyName": "MyRestrictivePolicy"
}
},
"policies": {
"MyRestrictivePolicy": {
"AllowConnect": {
"statementDescription": "Allow client devices to connect.",
"operations": [
"mqtt:connect"
],
"resources": [
"*"
]
},
"AllowPublish": {
"statementDescription": "Allow client devices to publish on test/topic.",
"operations": [
"mqtt:publish"
],
"resources": [
"mqtt:topic:test/topic"
]
},
"AllowSubscribe": {
"statementDescription": "Allow client devices to subscribe to test/topic/response.",
"operations": [
"mqtt:subscribe"
],
"resources": [
"mqtt:topicfilter:test/topic/response"
]
}
}
}
}
}
```
**Example Beispiel: Update zur Zusammenführung von Konfigurationen (unter Verwendung einer permissiven Richtlinie)**
Die folgende Beispielkonfiguration gibt an, dass alle Client-Geräte eine Verbindung herstellen können, und zwar zu allen publish/subscribe Themen.
```
{
"deviceGroups": {
"formatVersion": "2021-03-05",
"definitions": {
"MyPermissiveDeviceGroup": {
"selectionRule": "thingName: *",
"policyName": "MyPermissivePolicy"
}
},
"policies": {
"MyPermissivePolicy": {
"AllowAll": {
"statementDescription": "Allow client devices to perform all actions.",
"operations": [
"*"
],
"resources": [
"*"
]
}
}
}
}
}
```
------
## Lokale Protokolldatei
Diese Komponente verwendet dieselbe Protokolldatei wie die [Greengrass Nucleus-Komponente](greengrass-nucleus-component.md).
------
#### [ Linux ]
```
/greengrass/v2/logs/greengrass.log
```
------
#### [ Windows ]
```
C:\greengrass\v2\logs\greengrass.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:\$1greengrass\$1v2* durch den Pfad zum AWS IoT Greengrass Stammordner.
------
#### [ Linux ]
```
sudo tail -f /greengrass/v2/logs/greengrass.log
```
------
#### [ Windows (PowerShell) ]
```
Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
```
------
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| **Version** | **Änderungen** |
| --- | --- |
| 2.5.5 | Die Version wurde für die Version 2.16.0 von Greengrass Nucleus aktualisiert. |
| 2.5.4 | Die Version wurde für die Version 2.15.0 von Greengrass Nucleus aktualisiert. |
| 2.5.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/client-device-auth-component.html) |
| 2.5.2 | Die Version wurde für die Version 2.14.0 von Greengrass Nucleus aktualisiert. |
| 2.5.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/client-device-auth-component.html) |
| 2.5.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/client-device-auth-component.html) |
| 2.4.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/client-device-auth-component.html) |
| 2.4.4 | Die Version wurde für die Version 2.12.0 von Greengrass Nucleus aktualisiert. |
| 2.4.3 | Die Version wurde für die Version 2.11.0 von Greengrass Nucleus aktualisiert. |
| 2.4.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/client-device-auth-component.html) |
| 2.4.1 | Die Version wurde für die Version 2.10.0 von Greengrass Nucleus aktualisiert. |
| 2.4.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/client-device-auth-component.html) |
| 2.3.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/client-device-auth-component.html) |
| 2.3.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/client-device-auth-component.html) |
| 2.3.0 | Diese Version ist nicht mehr verfügbar. Die Verbesserungen in dieser Version sind in späteren Versionen dieser Komponente verfügbar. Neue Features [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/client-device-auth-component.html) |
| 2.2.3 | Die Version wurde für die Version 2.8.0 von Greengrass Nucleus aktualisiert. |
| 2.2.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/client-device-auth-component.html) |
| 2.2.1 | Die Version wurde für die Version 2.7.0 von Greengrass Nucleus aktualisiert. |
| 2.2.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/client-device-auth-component.html) |
| 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/client-device-auth-component.html) |
| 2.0.4 | Die Version wurde für die Version 2.5.0 von Greengrass Nucleus aktualisiert. |
| 2.0.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/client-device-auth-component.html) |
| 2.0.2 | Die Version wurde für die Version 2.4.0 von Greengrass Nucleus aktualisiert. |
| 2.0.1 | Die Version wurde für die Version 2.3.0 von Greengrass Nucleus aktualisiert. |
| 2.0.0 | Erste Version |
# CloudWatch Metriken
Die CloudWatch Amazon-Metrikenkomponente (`aws.greengrass.Cloudwatch`) veröffentlicht benutzerdefinierte Metriken von Greengrass-Kerngeräten für Amazon CloudWatch. Die Komponente ermöglicht es den Komponenten, CloudWatch Metriken zu veröffentlichen, mit denen Sie die Umgebung des Greengrass-Core-Geräts überwachen und analysieren können. Weitere Informationen finden Sie unter [Verwenden von CloudWatch Amazon-Metriken](https://docs.aws.amazon.com//AmazonCloudWatch/latest/monitoring/working_with_metrics.html) im * CloudWatch Amazon-Benutzerhandbuch*.
Um eine CloudWatch Metrik mit dieser Komponente zu veröffentlichen, veröffentlichen Sie eine Nachricht zu einem Thema, das diese Komponente abonniert. Standardmäßig abonniert diese Komponente das `cloudwatch/metric/put` [lokale Thema „Veröffentlichen/Abonnieren](ipc-publish-subscribe.md)“. Sie können andere Themen angeben, einschließlich AWS IoT Core MQTT-Themen, wenn Sie diese Komponente bereitstellen.
Diese Komponente stapelt Metriken, die sich im selben Namespace befinden, und veröffentlicht sie in regelmäßigen CloudWatch Abständen.
**Anmerkung**
Diese Komponente bietet ähnliche Funktionen wie der CloudWatch Metrik-Konnektor in AWS IoT Greengrass V1. Weitere Informationen finden Sie unter [CloudWatch Metrik-Konnektor](https://docs.aws.amazon.com/greengrass/latest/developerguide/cloudwatch-metrics-connector.html) im *AWS IoT Greengrass V1-Entwicklerhandbuch*.
**Topics**
+ [Versionen](#cloudwatch-metrics-component-versions)
+ [Typ](#cloudwatch-metrics-component-type)
+ [Betriebssystem](#cloudwatch-metrics-component-os-support)
+ [Voraussetzungen](#cloudwatch-metrics-component-requirements)
+ [Abhängigkeiten](#cloudwatch-metrics-component-dependencies)
+ [Konfiguration](#cloudwatch-metrics-component-configuration)
+ [Eingabedaten](#cloudwatch-metrics-component-input-data)
+ [Ausgabedaten](#cloudwatch-metrics-component-output-data)
+ [Lizenzen](#cloudwatch-metrics-component-licenses)
+ [Lokale Protokolldatei](#cloudwatch-metrics-component-log-file)
+ [Änderungsprotokoll](#cloudwatch-metrics-component-changelog)
+ [Weitere Informationen finden Sie auch unter](#cloudwatch-metrics-component-see-also)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 3.2.x
+ 3.1.x
+ 3.0.x
+ 2.1.x
+ 2.0.x
Informationen zu den Änderungen in den einzelnen Versionen der Komponente finden Sie im [Changelog](#cloudwatch-metrics-component-changelog).
## Typ
------
#### [ v3.x ]
Diese Komponente ist eine generische Komponente (`aws.greengrass.generic`). Der [Greengrass-Kern](greengrass-nucleus-component.md) führt die Lebenszyklusskripte der Komponente aus.
------
#### [ v2.x ]
Diese Komponente ist eine Lambda-Komponente (`aws.greengrass.lambda`). [Der [Greengrass-Kern führt die](greengrass-nucleus-component.md) Lambda-Funktion dieser Komponente mithilfe der Lambda-Launcher-Komponente aus.](lambda-launcher-component.md)
------
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## Betriebssystem
------
#### [ v3.x ]
Diese Komponente kann auf Kerngeräten installiert werden, auf denen die folgenden Betriebssysteme ausgeführt werden:
+ Linux
+ Windows
------
#### [ v2.x ]
Diese Komponente kann nur auf Linux-Kerngeräten installiert werden.
------
## Voraussetzungen
Für diese Komponente gelten die folgenden Anforderungen:
------
#### [ 3.x ]
+ [Python-Version](https://www.python.org/) 3.7 wurde auf dem Core-Gerät installiert und zur Umgebungsvariablen PATH hinzugefügt.
+ Die [Greengrass-Geräterolle](device-service-role.md) muss die `cloudwatch:PutMetricData` Aktion zulassen, wie in der folgenden Beispiel-IAM-Richtlinie gezeigt.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"cloudwatch:PutMetricData"
],
"Effect": "Allow",
"Resource": "*"
}
]
}
```
------
Weitere Informationen finden Sie in der [ CloudWatchAmazon-Berechtigungsreferenz](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/permissions-reference-cw.html) im * CloudWatch Amazon-Benutzerhandbuch*.
------
#### [ 2.x ]
+ Ihr Kerngerät muss die Anforderungen für die Ausführung von Lambda-Funktionen erfüllen. Wenn Sie möchten, dass das Kerngerät containerisierte Lambda-Funktionen ausführt, muss das Gerät die entsprechenden Anforderungen erfüllen. Weitere Informationen finden Sie unter [Anforderungen an die Lambda-Funktion](setting-up.md#greengrass-v2-lambda-requirements).
+ [Python-Version](https://www.python.org/) 3.7 wurde auf dem Core-Gerät installiert und zur Umgebungsvariablen PATH hinzugefügt.
+ Die [Greengrass-Geräterolle](device-service-role.md) muss die `cloudwatch:PutMetricData` Aktion zulassen, wie in der folgenden Beispiel-IAM-Richtlinie gezeigt.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"cloudwatch:PutMetricData"
],
"Effect": "Allow",
"Resource": "*"
}
]
}
```
------
Weitere Informationen finden Sie in der [ CloudWatchAmazon-Berechtigungsreferenz](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/permissions-reference-cw.html) im * CloudWatch Amazon-Benutzerhandbuch*.
+ Um Ausgabedaten von dieser Komponente zu erhalten, müssen Sie das folgende Konfigurationsupdate für die [ältere Abonnement-Router-Komponente](legacy-subscription-router-component.md) (`aws.greengrass.LegacySubscriptionRouter`) zusammenführen, wenn Sie diese Komponente bereitstellen. Diese Konfiguration gibt das Thema an, zu dem diese Komponente Antworten veröffentlicht.
------
#### [ Legacy subscription router v2.1.x ]
```
{
"subscriptions": {
"aws-greengrass-cloudwatch": {
"id": "aws-greengrass-cloudwatch",
"source": "component:aws.greengrass.Cloudwatch",
"subject": "cloudwatch/metric/put/status",
"target": "cloud"
}
}
}
```
------
#### [ Legacy subscription router v2.0.x ]
```
{
"subscriptions": {
"aws-greengrass-cloudwatch": {
"id": "aws-greengrass-cloudwatch",
"source": "arn:aws:lambda:region:aws:function:aws-greengrass-cloudwatch:version",
"subject": "cloudwatch/metric/put/status",
"target": "cloud"
}
}
}
```
+ *region*Ersetzen Sie es durch AWS-Region das, was Sie verwenden.
+ *version*Ersetzen Sie durch die Version der Lambda-Funktion, die diese Komponente ausführt. Um die Version der Lambda-Funktion zu finden, müssen Sie sich das Rezept für die Version dieser Komponente ansehen, die Sie bereitstellen möchten. Öffnen Sie die Detailseite dieser Komponente in der [AWS IoT Greengrass Konsole](https://console.aws.amazon.com//greengrass) und suchen Sie nach dem **Schlüssel-Wert-Paar der Lambda-Funktion**. Dieses Schlüssel-Wert-Paar enthält den Namen und die Version der Lambda-Funktion.
**Wichtig**
Sie müssen die Lambda-Funktionsversion auf dem älteren Abonnement-Router jedes Mal aktualisieren, wenn Sie diese Komponente bereitstellen. Dadurch wird sichergestellt, dass Sie die richtige Lambda-Funktionsversion für die Komponentenversion verwenden, die Sie bereitstellen.
------
Weitere Informationen finden Sie unter [Erstellen von Bereitstellungen](create-deployments.md).
------
### 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](allow-device-traffic.md).
| Endpoint | Port | Erforderlich | Description |
| --- | --- | --- | --- |
| `monitoring.region.amazonaws.com` | 443 | Ja | Metriken hochladen. CloudWatch |
## Abhängigkeiten
Wenn Sie eine Komponente bereitstellen, stellt sie 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](#cloudwatch-metrics-component-changelog) 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](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.
------
#### [ 3.2.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 3.2.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <3.0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | >=0.0.0 | Hart |
------
#### [ 3.0.0 - 3.1.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 3.0.0 bis 3.1.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <3.0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | >=0.0.0 | Hart |
------
#### [ 2.1.4 - 2.1.9 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.1.4 bis 2.1.9 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <3.0.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.1.4 - 2.1.8 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.1.4 und 2.1.8 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <3.0.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.1.2 - 2.1.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.1.2 und 2.1.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.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](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.0.8 - 2.1.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.0.8 bis 2.1.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.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](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.0.6 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.6 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.0.5 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.5 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.0.4 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.4 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.0.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.3 <2.1.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | >=1.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | >=1,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | >=1.0.0 | Hart |
------
Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den [Komponentenrezepten](component-recipe-reference.md#recipe-reference-component-dependencies).
## Konfiguration
Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.
------
#### [ v3.x ]
`PublishInterval`
(Optional) Die maximale Wartezeit in Sekunden, bis die Komponente gebündelte Metriken für einen bestimmten Namespace veröffentlicht. Um die Komponente so zu konfigurieren, dass sie Metriken so veröffentlicht, wie sie sie empfängt, d. h. ohne Batchverarbeitung, geben Sie Folgendes an. `0`
Die Komponente veröffentlicht CloudWatch erst, nachdem sie 20 Metriken im selben Namespace empfangen hat, oder nach dem von Ihnen angegebenen Intervall.
Die Komponente gibt nicht die Reihenfolge an, in der Ereignisse veröffentlicht werden.
Dieser Wert kann maximal 900 Sekunden betragen.
Standard: 10 Sekunden
`MaxMetricsToRetain`
(Optional) Die maximale Anzahl von Metriken in allen Namespaces, die im Speicher gespeichert werden sollen, bevor die Komponente sie durch neuere Metriken ersetzt.
Dieses Limit gilt, wenn das Kerngerät keine Verbindung zum Internet hat, sodass die Komponente die Metriken zwischenspeichert, um sie später zu veröffentlichen. Wenn der Puffer voll ist, ersetzt die Komponente die ältesten Metriken durch neuere. Metriken in einem bestimmten Namespace ersetzen nur Metriken im selben Namespace.
Wenn der Host-Prozess für die Komponente unterbrochen wird, speichert die Komponente keine Metriken. Dies kann beispielsweise während einer Bereitstellung oder beim Neustart des Kerngeräts passieren.
Dieser Wert muss mindestens 2.000 Metriken umfassen.
Standard: 5.000 Metriken
`InputTopic`
(Optional) Das Thema, das die Komponente abonniert, um Nachrichten zu empfangen. Wenn Sie `true` for angeben`PubSubToIoTCore`, können Sie in diesem Thema MQTT-Platzhalter (\$1 und \$1) verwenden.
Standard: `cloudwatch/metric/put`
`OutputTopic`
(Optional) Das Thema, zu dem die Komponente Statusantworten veröffentlicht.
Standard: `cloudwatch/metric/put/status`
`PubSubToIoTCore`
(Optional) Zeichenkettenwert, der definiert, ob AWS IoT Core MQTT-Themen veröffentlicht und abonniert werden sollen. Unterstützte Werte sind `true` und `false`.
Standard: `false`
`LogLevel`
(Optional) Die Protokollierungsebene für die Komponente. Wählen Sie aus den folgenden Protokollebenen, die hier in der Reihenfolge der Stufen aufgeführt sind:
+ `DEBUG`
+ `INFO`
+ `WARNING`
+ `ERROR`
+ `CRITICAL`
Standard: `INFO`
`UseInstaller`
(Optional) Boolescher Wert, der definiert, ob das Installationsskript in dieser Komponente verwendet werden soll, um die SDK-Abhängigkeiten dieser Komponente zu installieren.
Setzen Sie diesen Wert auf, `false` wenn Sie ein benutzerdefiniertes Skript zum Installieren von Abhängigkeiten verwenden möchten oder wenn Sie Laufzeitabhängigkeiten in ein vorgefertigtes Linux-Image aufnehmen möchten. Um diese Komponente verwenden zu können, müssen Sie die folgenden Bibliotheken, einschließlich aller Abhängigkeiten, installieren und sie dem standardmäßigen Greengrass-Systembenutzer zur Verfügung stellen.
+ [AWS IoT Device SDK v2 für Python](https://github.com/aws/aws-iot-device-sdk-python-v2)
+ [AWS SDK für Python (Boto3)](http://boto.readthedocs.org/en/latest/ref/)
Standard: `true`
`PublishRegion`
(Optional) Der Ort AWS-Region , an dem CloudWatch Metriken veröffentlicht werden sollen. Dieser Wert überschreibt die Standardregion für das Core-Gerät. Dieser Parameter ist nur für regionsübergreifende Metriken erforderlich.
`accessControl`
(Optional) Das Objekt, das die [Autorisierungsrichtlinie](interprocess-communication.md#ipc-authorization-policies) enthält, die es der Komponente ermöglicht, die angegebenen Themen zu veröffentlichen und zu abonnieren. Wenn Sie benutzerdefinierte Werte für `InputTopic` und angeben`OutputTopic`, müssen Sie die Ressourcenwerte in diesem Objekt aktualisieren.
Standard:
```
{
"aws.greengrass.ipc.pubsub": {
"aws.greengrass.Cloudwatch:pubsub:1": {
"policyDescription": "Allows access to subscribe to input topics.",
"operations": [
"aws.greengrass#SubscribeToTopic"
],
"resources": [
"cloudwatch/metric/put"
]
},
"aws.greengrass.Cloudwatch:pubsub:2": {
"policyDescription": "Allows access to publish to output topics.",
"operations": [
"aws.greengrass#PublishToTopic"
],
"resources": [
"cloudwatch/metric/put/status"
]
}
},
"aws.greengrass.ipc.mqttproxy": {
"aws.greengrass.Cloudwatch:mqttproxy:1": {
"policyDescription": "Allows access to subscribe to input topics.",
"operations": [
"aws.greengrass#SubscribeToIoTCore"
],
"resources": [
"cloudwatch/metric/put"
]
},
"aws.greengrass.Cloudwatch:mqttproxy:2": {
"policyDescription": "Allows access to publish to output topics.",
"operations": [
"aws.greengrass#PublishToIoTCore"
],
"resources": [
"cloudwatch/metric/put/status"
]
}
}
}
```
**Example Beispiel: Aktualisierung der Konfigurationszusammenführung**
```
{
"PublishInterval": 0,
"PubSubToIoTCore": true
}
```
------
#### [ v2.x ]
**Anmerkung**
Die Standardkonfiguration dieser Komponente umfasst Lambda-Funktionsparameter. Wir empfehlen, dass Sie nur die folgenden Parameter bearbeiten, um diese Komponente auf Ihren Geräten zu konfigurieren.
`lambdaParams`
Ein Objekt, das die Parameter für die Lambda-Funktion dieser Komponente enthält. Dieses Objekt enthält die folgenden Informationen:
`EnvironmentVariables`
Ein Objekt, das die Parameter der Lambda-Funktion enthält. Dieses Objekt enthält die folgenden Informationen:
`PUBLISH_INTERVAL`
(Optional) Die maximale Wartezeit in Sekunden, bis die Komponente gebündelte Metriken für einen bestimmten Namespace veröffentlicht. Um die Komponente so zu konfigurieren, dass sie Metriken so veröffentlicht, wie sie sie empfängt, d. h. ohne Batchverarbeitung, geben Sie Folgendes an. `0`
Die Komponente veröffentlicht CloudWatch erst, nachdem sie 20 Metriken im selben Namespace empfangen hat, oder nach dem von Ihnen angegebenen Intervall.
Die Komponente garantiert nicht die Reihenfolge, in der Ereignisse veröffentlicht werden.
Dieser Wert kann höchstens 900 Sekunden betragen.
Standard: 10 Sekunden
`MAX_METRICS_TO_RETAIN`
(Optional) Die maximale Anzahl von Metriken in allen Namespaces, die im Speicher gespeichert werden sollen, bevor die Komponente sie durch neuere Metriken ersetzt.
Dieses Limit gilt, wenn das Kerngerät keine Verbindung zum Internet hat, sodass die Komponente die Metriken zwischenspeichert, um sie später zu veröffentlichen. Wenn der Puffer voll ist, ersetzt die Komponente die ältesten Metriken durch neuere. Metriken in einem bestimmten Namespace ersetzen nur Metriken im selben Namespace.
Wenn der Host-Prozess für die Komponente unterbrochen wird, speichert die Komponente keine Metriken. Dies kann beispielsweise während einer Bereitstellung oder beim Neustart des Kerngeräts passieren.
Dieser Wert muss mindestens 2.000 Metriken umfassen.
Standard: 5.000 Metriken
`PUBLISH_REGION`
(Optional) Der Ort AWS-Region , für den die CloudWatch Metriken veröffentlicht werden sollen. Dieser Wert überschreibt die Standardregion für das Core-Gerät. Dieser Parameter ist nur für regionsübergreifende Metriken erforderlich.
`containerMode`
(Optional) Der Containerisierungsmodus für diese Komponente. Wählen Sie aus den folgenden Optionen aus:
+ `NoContainer`— Die Komponente wird nicht in einer isolierten Laufzeitumgebung ausgeführt.
+ `GreengrassContainer`— Die Komponente läuft in einer isolierten Laufzeitumgebung innerhalb des AWS IoT Greengrass Containers.
Standard: `GreengrassContainer`
`containerParams`
(Optional) Ein Objekt, das die Container-Parameter für diese Komponente enthält. Die Komponente verwendet diese Parameter, wenn Sie `GreengrassContainer` für angeben`containerMode`.
Dieses Objekt enthält die folgenden Informationen:
`memorySize`
(Optional) Die Speichermenge (in Kilobyte), die der Komponente zugewiesen werden soll.
Der Standardwert ist 64 MB (65.535 KB).
`pubsubTopics`
(Optional) Ein Objekt, das die Themen enthält, in denen die Komponente den Empfang von Nachrichten abonniert. Sie können jedes Thema angeben und angeben, ob die Komponente MQTT-Themen von AWS IoT Core oder lokale Themen abonniert. publish/subscribe
Dieses Objekt enthält die folgenden Informationen:
`0`— Dies ist ein Array-Index als Zeichenfolge.
Ein Objekt, das die folgenden Informationen enthält:
`type`
(Optional) Der publish/subscribe Messaging-Typ, den diese Komponente verwendet, um Nachrichten zu abonnieren. Wählen Sie aus den folgenden Optionen aus:
+ `PUB_SUB` — Abonnieren Sie lokale Veröffentlichen/Abonnement-Nachrichten. Wenn Sie diese Option wählen, darf das Thema keine MQTT-Platzhalter enthalten. Weitere Informationen zum Senden von Nachrichten von einer benutzerdefinierten Komponente aus, wenn Sie diese Option angeben, finden Sie unter. [Lokale Nachrichten veröffentlichen/abonnieren](ipc-publish-subscribe.md)
+ `IOT_CORE`— Abonnieren Sie AWS IoT Core MQTT-Nachrichten. Wenn Sie diese Option wählen, kann das Thema MQTT-Platzhalter enthalten. Weitere Informationen zum Senden von Nachrichten aus benutzerdefinierten Komponenten, wenn Sie diese Option angeben, finden Sie unter. [MQTT-Nachrichten veröffentlichen/abonnieren AWS IoT Core](ipc-iot-core-mqtt.md)
Standard: `PUB_SUB`
`topic`
(Optional) Das Thema, das die Komponente abonniert, um Nachrichten zu empfangen. Wenn Sie `IotCore` für angeben`type`, können Sie in diesem Thema MQTT-Platzhalter (`+`und`#`) verwenden.
**Example Beispiel: Aktualisierung der Konfigurationszusammenführung (Container-Modus)**
```
{
"containerMode": "GreengrassContainer"
}
```
**Example Beispiel: Aktualisierung der Konfigurationszusammenführung (kein Container-Modus)**
```
{
"containerMode": "NoContainer"
}
```
------
## Eingabedaten
Diese Komponente akzeptiert Metriken zum folgenden Thema und veröffentlicht die Metriken unter CloudWatch. Standardmäßig abonniert diese Komponente lokale publish/subscribe Nachrichten. Weitere Informationen zum Veröffentlichen von Nachrichten aus Ihren benutzerdefinierten Komponenten in dieser Komponente finden Sie unter[Lokale Nachrichten veröffentlichen/abonnieren](ipc-publish-subscribe.md).
Ab der Komponentenversion v3.0.0 können Sie diese Komponente optional so konfigurieren, dass sie ein MQTT-Thema abonniert, indem Sie den `PubSubToIoTCore` Konfigurationsparameter auf setzen. `true` Weitere Informationen zum Veröffentlichen von Nachrichten zu einem MQTT-Thema in Ihren benutzerdefinierten Komponenten finden Sie unter. [MQTT-Nachrichten veröffentlichen/abonnieren AWS IoT Core](ipc-iot-core-mqtt.md)
**Standardthema:** `cloudwatch/metric/put`
Die Nachricht akzeptiert die folgenden Eigenschaften. Eingabenachrichten müssen im JSON-Format vorliegen.
`request`
Die Metrik in dieser Nachricht.
Das Anforderungsobjekt enthält die metrischen Daten, die an CloudWatch veröffentlicht werden sollen. Die Metrikwerte müssen den Spezifikationen des [https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html)Vorgangs entsprechen.
Typ: `object` der die folgenden Informationen enthält:
`namespace`
Der benutzerdefinierte Namespace für die Metrikdaten in dieser Anfrage. CloudWatch verwendet Namespaces als Container für metrische Datenpunkte.
Sie können keinen Namespace angeben, der mit der reservierten Zeichenfolge beginnt. `AWS/`
Typ: `string`
Gültiges Muster: `[^:].*`
`metricData`
Die Daten für die Metrik.
Typ: `object` der die folgenden Informationen enthält:
`metricName`
Name der Metrik.
Typ: `string`
`value`
Der Wert für die Metrik.
CloudWatch lehnt zu kleine oder zu große Werte ab. Der Wert muss zwischen `8.515920e-109` und `1.174271e+108` (Basis 10) oder `2e-360` und `2e360` (Basis 2) liegen. CloudWatch unterstützt keine speziellen Werte wie `NaN``+Infinity`, und`-Infinity`.
Typ: `double`
`dimensions`
(Optional) Die Dimensionen für die Metrik. Dimensionen liefern zusätzliche Informationen über die Metrik und ihre Daten. Eine Metrik kann bis zu 10 Dimensionen definieren.
Diese Komponente enthält automatisch eine Dimension mit dem Namen`coreName`, wobei der Wert dem Namen des Kerngeräts entspricht.
Typ: `array` von Objekten, die jeweils die folgenden Informationen enthalten:
`name`
(Optional) Der Name der Dimension.
Typ: `string`
`value`
(Optional) Der Dimensionswert.
Typ: `string`
`timestamp`
(Optional) Die Zeit, zu der die metrischen Daten empfangen wurden, ausgedrückt in Sekunden in Unix-Epochenzeit.
Standardmäßig wird der Zeitpunkt verwendet, zu dem die Komponente die Nachricht empfängt.
Typ: `double`
Wenn Sie diese Komponente zwischen den Versionen 2.0.3 und 2.0.7 verwenden, empfehlen wir, den Zeitstempel für jede Metrik separat abzurufen, wenn Sie mehrere Metriken aus einer einzigen Quelle senden. Verwenden Sie keine Variable, um den Zeitstempel zu speichern.
`unit`
(Optional) Die Einheit der Metrik.
Typ: `string`
Gültige Werte: `Seconds``Microseconds`,`Milliseconds`,`Bytes`,`Kilobytes`,`Megabytes`,`Gigabytes`,`Terabytes`,`Bits`,`Kilobits`,`Megabits`,,`Gigabits`,`Terabits`,`Percent`,`Count`,`Bytes/Second`,`Kilobytes/Second`,`Megabytes/Second`,`Gigabytes/Second`,`Terabytes/Second`,`Bits/Second`,`Kilobits/Second`,`Megabits/Second`,`Gigabits/Second`,`Terabits/Second`,`Count/Second`, `None`
Standardeinstellung: `None`.
**Anmerkung**
Alle Kontingente, die für die CloudWatch `PutMetricData` API gelten, gelten für Metriken, die Sie mit dieser Komponente veröffentlichen. Die folgenden Kontingente sind besonders wichtig:
40 KB Limit für die API-Nutzlast
20 Metriken pro API-Anforderung
150 Transaktionen pro Sekunde (TPS) für die `PutMetricData`-API
Weitere Informationen finden Sie unter [CloudWatch Servicekontingenten](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_limits.html) im *CloudWatch Benutzerhandbuch*.
**Example Beispieleingabe**
```
{
"request": {
"namespace": "Greengrass",
"metricData": {
"metricName": "latency",
"dimensions": [
{
"name": "hostname",
"value": "test_hostname"
}
],
"timestamp": 1539027324,
"value": 123.0,
"unit": "Seconds"
}
}
}
```
## Ausgabedaten
Diese Komponente veröffentlicht Antworten standardmäßig als Ausgabedaten zum folgenden lokalen publish/subscribe Thema. Weitere Informationen zum Abonnieren von Nachrichten zu diesem Thema in Ihren benutzerdefinierten Komponenten finden Sie unter[Lokale Nachrichten veröffentlichen/abonnieren](ipc-publish-subscribe.md).
Sie können diese Komponente optional so konfigurieren, dass sie in einem MQTT-Thema veröffentlicht wird, indem Sie den `PubSubToIoTCore` Konfigurationsparameter auf `true` setzen. Weitere Informationen zum Abonnieren von Nachrichten zu einem MQTT-Thema in Ihren benutzerdefinierten Komponenten finden Sie unter. [MQTT-Nachrichten veröffentlichen/abonnieren AWS IoT Core](ipc-iot-core-mqtt.md)
**Anmerkung**
Die Komponentenversionen 2.0.x veröffentlichen Antworten standardmäßig als Ausgabedaten zu einem MQTT-Thema. Sie müssen das Thema `subject` in der Konfiguration für die [ältere Abonnement-Router-Komponente](legacy-subscription-router-component.md) als das angeben.
**Standardthema:** `cloudwatch/metric/put/status`
**Example Beispielausgabe: Erfolg**
Die Antwort umfasst den Namespace der Metrikdaten und das `RequestId` Feld aus der CloudWatch Antwort.
```
{
"response": {
"cloudwatch_rid": "70573243-d723-11e8-b095-75ff2EXAMPLE",
"namespace": "Greengrass",
"status": "success"
}
}
```
**Example Beispielausgabe: Fehler**
```
{
"response" : {
"namespace": "Greengrass",
"error": "InvalidInputException",
"error_message": "cw metric is invalid",
"status": "fail"
}
}
```
**Anmerkung**
Wenn die Komponente einen Fehler erkennt, der erneut versucht werden kann, z. B. einen Verbindungsfehler, versucht sie erneut, im nächsten Batch zu veröffentlichen.
## Lizenzen
Diese Komponente umfasst die folgende Software/Lizenzierung von Drittanbietern:
+ [AWS SDK für Python (Boto3)](https://pypi.org/project/boto3/)/Apache-Lizenz 2.0
+ [botocore](https://pypi.org/project/botocore/)/Apache-Lizenz 2.0
+ [dateutil](https://pypi.org/project/python-dateutil/1.4/)/PSF-Lizenz
+ [docutils](https://pypi.org/project/docutils/)/BSD-Lizenz, GNU General Public License (GPL), Python Software Foundation License, Public Domain
+ [jmespath](https://pypi.org/project/jmespath/)/MIT-Lizenz
+ [s3transfer](https://pypi.org/project/s3transfer/)/Apache-Lizenz 2.0
+ [urllib3](https://pypi.org/project/urllib3/)/MIT-Lizenz
Diese Komponente wird im Rahmen der [Greengrass Core Software-Lizenzvereinbarung](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf) veröffentlicht.
## Lokale Protokolldatei
Diese Komponente verwendet die folgende Protokolldatei.
------
#### [ Linux ]
```
/greengrass/v2/logs/aws.greengrass.Cloudwatch.log
```
------
#### [ Windows ]
```
C:\greengrass\v2\logs\aws.greengrass.Cloudwatch.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:\$1greengrass\$1v2* durch den Pfad zum AWS IoT Greengrass Stammordner.
------
#### [ Linux ]
```
sudo tail -f /greengrass/v2/logs/aws.greengrass.Cloudwatch.log
```
------
#### [ Windows (PowerShell) ]
```
Get-Content C:\greengrass\v2\logs\aws.greengrass.Cloudwatch.log -Tail 10 -Wait
```
------
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
------
#### [ v3.x ]
| **Version** | **Änderungen** |
| --- | --- |
| 3.2.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/cloudwatch-metrics-component.html) |
| 3.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/cloudwatch-metrics-component.html) |
| 3.0.0 | Diese Version der CloudWatch Metrikkomponente erwartet andere Konfigurationsparameter als Version 2.x. Wenn Sie eine nicht standardmäßige Konfiguration für Version 2.x verwenden und ein Upgrade von Version 2.x auf Version 3.x durchführen möchten, müssen Sie die Konfiguration der Komponente aktualisieren. [Weitere Informationen finden Sie unter Konfiguration der Metrikkomponenten. CloudWatch](#cloudwatch-metrics-component-configuration) [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/cloudwatch-metrics-component.html) |
------
#### [ v2.x ]
| **Version** | **Änderungen** |
| --- | --- |
| 2.1.8 | Die Version wurde für die Version 2.13.0 von Greengrass Nucleus aktualisiert. |
| 2.1.3 | Die Version wurde für die Version 2.11.0 von Greengrass Nucleus aktualisiert. |
| 2.1.2 | Die Version wurde für die Version 2.7.0 von Greengrass Nucleus aktualisiert. |
| 2.1.1 | Die Version wurde für die Version 2.6.0 von Greengrass Nucleus aktualisiert. |
| 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/cloudwatch-metrics-component.html) |
| 2.0.8 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/cloudwatch-metrics-component.html) |
| 2.0.7 | Die Version wurde für die Version 2.4.0 von Greengrass Nucleus aktualisiert. |
| 2.0.6 | Die Version wurde für die Version 2.3.0 von Greengrass Nucleus aktualisiert. |
| 2.0.5 | Die Version wurde für die Version 2.2.0 von Greengrass Nucleus aktualisiert. |
| 2.0.4 | Die Version wurde für die Version 2.1.0 von Greengrass Nucleus aktualisiert. |
| 2.0.3 | Erste Version |
------
## Weitere Informationen finden Sie auch unter
+ [Verwendung von CloudWatch Amazon-Metriken](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html) im * CloudWatch Amazon-Benutzerhandbuch*
+ [PutMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html)in der *Amazon CloudWatch API-Referenz*
# AWS IoT Device Defender
Die AWS IoT Device Defender Komponente (`aws.greengrass.DeviceDefender`) benachrichtigt Administratoren über Änderungen im Status der Greengrass-Core-Geräte. Dies kann helfen, ungewöhnliches Verhalten zu erkennen, das auf ein gefährdetes Gerät hinweisen könnte. Weitere Informationen finden Sie unter [AWS IoT Device Defender](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender.html) im *AWS IoT Core -Entwicklerhandbuch*.
Diese Komponente liest Systemmetriken auf dem Kerngerät. Anschließend veröffentlicht sie die Metriken auf AWS IoT Device Defender. Weitere Informationen zum Lesen und Interpretieren der von dieser Komponente gemeldeten Metriken finden Sie im *AWS IoT Core Entwicklerhandbuch* [unter Spezifikation der Gerätemetriken](https://docs.aws.amazon.com/iot/latest/developerguide/detect-device-side-metrics.html#DetectMetricsMessagesSpec).
**Anmerkung**
Diese Komponente bietet ähnliche Funktionen wie der Device Defender-Connector in AWS IoT Greengrass V1. Weitere Informationen finden Sie unter [Device Defender-Connector](https://docs.aws.amazon.com/greengrass/latest/developerguide/device-defender-connector.html) im *AWS IoT Greengrass V1 Entwicklerhandbuch*.
**Topics**
+ [Versionen](#device-defender-component-versions)
+ [Typ](#device-defender-component-type)
+ [Betriebssystem](#device-defender-component-os-support)
+ [Voraussetzungen](#device-defender-component-requirements)
+ [Abhängigkeiten](#device-defender-component-dependencies)
+ [Konfiguration](#device-defender-component-configuration)
+ [Eingabedaten](#device-defender-component-input-data)
+ [Ausgabedaten](#device-defender-component-output-data)
+ [Lokale Protokolldatei](#device-defender-component-log-file)
+ [Lizenzen](#device-defender-component-licenses)
+ [Änderungsprotokoll](#device-defender-component-changelog)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 3.1.x
+ 3.0.x
+ 2.0.x
Informationen zu den Änderungen in den einzelnen Versionen der Komponente finden Sie im [Changelog](#device-defender-component-changelog).
## Typ
------
#### [ v3.x ]
Diese Komponente ist eine generische Komponente (`aws.greengrass.generic`). Der [Greengrass-Kern](greengrass-nucleus-component.md) führt die Lebenszyklusskripte der Komponente aus.
------
#### [ v2.x ]
Diese Komponente ist eine Lambda-Komponente (`aws.greengrass.lambda`). [Der [Greengrass-Kern führt die](greengrass-nucleus-component.md) Lambda-Funktion dieser Komponente mithilfe der Lambda-Launcher-Komponente aus.](lambda-launcher-component.md)
------
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## Betriebssystem
------
#### [ v3.x ]
Diese Komponente kann auf Kerngeräten installiert werden, auf denen die folgenden Betriebssysteme ausgeführt werden:
+ Linux
+ Windows
------
#### [ v2.x ]
Diese Komponente kann nur auf Linux-Kerngeräten installiert werden.
------
## Voraussetzungen
Für diese Komponente gelten die folgenden Anforderungen:
------
#### [ v3.x ]
+ [Python-Version](https://www.python.org/) 3.7 wurde auf dem Core-Gerät installiert und zur Umgebungsvariablen PATH hinzugefügt.
+ AWS IoT Device Defender konfiguriert, um die Erkennungsfunktion zur Überwachung von Verstößen zu verwenden. Weitere Informationen finden Sie unter [Detect](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender-detect.html) im *AWS IoT Core Entwicklerhandbuch*.
------
#### [ v2.x ]
+ Ihr Kerngerät muss die Anforderungen für die Ausführung von Lambda-Funktionen erfüllen. Wenn Sie möchten, dass das Kerngerät containerisierte Lambda-Funktionen ausführt, muss das Gerät die entsprechenden Anforderungen erfüllen. Weitere Informationen finden Sie unter [Anforderungen an die Lambda-Funktion](setting-up.md#greengrass-v2-lambda-requirements).
+ [Python-Version](https://www.python.org/) 3.7 wurde auf dem Core-Gerät installiert und zur Umgebungsvariablen PATH hinzugefügt.
+ AWS IoT Device Defender konfiguriert, um die Erkennungsfunktion zur Überwachung von Verstößen zu verwenden. Weitere Informationen finden Sie unter [Detect](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender-detect.html) im *AWS IoT Core Entwicklerhandbuch*.
+ Die [Psutil-Bibliothek](https://pypi.org/project/psutil/) ist auf dem Core-Gerät installiert. Version 5.7.0 ist die neueste Version, von der bestätigt wurde, dass sie mit der Komponente funktioniert.
+ Die [auf](https://pypi.org/project/cbor/) dem Kerngerät installierte CBOR-Bibliothek. Version 1.0.0 ist die neueste Version, von der bestätigt wurde, dass sie mit der Komponente funktioniert.
+ Um Ausgabedaten von dieser Komponente zu erhalten, müssen Sie bei der Bereitstellung dieser Komponente das folgende Konfigurationsupdate für die [ältere Abonnement-Router-Komponente](legacy-subscription-router-component.md) (`aws.greengrass.LegacySubscriptionRouter`) zusammenführen. Diese Konfiguration gibt das Thema an, zu dem diese Komponente Antworten veröffentlicht.
------
#### [ Legacy subscription router v2.1.x ]
```
{
"subscriptions": {
"aws-greengrass-device-defender": {
"id": "aws-greengrass-device-defender",
"source": "component:aws.greengrass.DeviceDefender",
"subject": "$aws/things/+/defender/metrics/json",
"target": "cloud"
}
}
}
```
------
#### [ Legacy subscription router v2.0.x ]
```
{
"subscriptions": {
"aws-greengrass-device-defender": {
"id": "aws-greengrass-device-defender",
"source": "arn:aws:lambda:region:aws:function:aws-greengrass-device-defender:version",
"subject": "$aws/things/+/defender/metrics/json",
"target": "cloud"
}
}
}
```
+ *region*Ersetzen Sie es durch AWS-Region das, was Sie verwenden.
+ *version*Ersetzen Sie durch die Version der Lambda-Funktion, die diese Komponente ausführt. Um die Version der Lambda-Funktion zu finden, müssen Sie sich das Rezept für die Version dieser Komponente ansehen, die Sie bereitstellen möchten. Öffnen Sie die Detailseite dieser Komponente in der [AWS IoT Greengrass Konsole](https://console.aws.amazon.com//greengrass) und suchen Sie nach dem **Schlüssel-Wert-Paar der Lambda-Funktion**. Dieses Schlüssel-Wert-Paar enthält den Namen und die Version der Lambda-Funktion.
**Wichtig**
Sie müssen die Lambda-Funktionsversion auf dem älteren Abonnement-Router jedes Mal aktualisieren, wenn Sie diese Komponente bereitstellen. Dadurch wird sichergestellt, dass Sie die richtige Lambda-Funktionsversion für die Komponentenversion verwenden, die Sie bereitstellen.
------
Weitere Informationen finden Sie unter [Erstellen von Bereitstellungen](create-deployments.md).
------
## Abhängigkeiten
Wenn Sie eine Komponente bereitstellen, stellt sie 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](#device-defender-component-changelog) 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](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.
------
#### [ 3.1.1 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 3.1.1 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <3.0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | >=0.0.0 | Hart |
------
#### [ 3.0.0 - 3.0.2 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 3.0.0 bis 3.0.2 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <3.0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | >=0.0.0 | Hart |
------
#### [ 2.0.12 - 2.0.17 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.0.12 bis 2.0.17 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <3.0.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.0.12 - 2.0.16 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.16 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <3.0.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.0.10 - 2.0.11 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.0.10 und 2.0.11 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.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](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.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](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.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](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.0.6 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.6 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.0.5 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.5 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.0.4 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.4 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.0.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.3 <2.1.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | >=1.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | >=1,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | >=1.0.0 | Hart |
------
Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den [Komponentenrezepten](component-recipe-reference.md#recipe-reference-component-dependencies).
## Konfiguration
Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.
------
#### [ v3.x ]
`PublishRetryCount`
Gibt an, wie oft die Veröffentlichung wiederholt wird. Diese Funktion ist in Version 3.1.1 verfügbar.
Das Minimum ist 0.
Das Maximum ist 72.
Standard: 5
`SampleIntervalSeconds`
(Optional) Die Zeitspanne in Sekunden zwischen den einzelnen Zyklen, in denen die Komponente Messwerte sammelt und meldet.
Die Mindestwert beträgt 300 Sekunden (5 Minuten).
Standard: 300 Sekunden
`UseInstaller`
(Optional) Boolescher Wert, der definiert, ob das Installationsskript in dieser Komponente verwendet werden soll, um die Abhängigkeiten dieser Komponente zu installieren.
Setzen Sie diesen Wert auf, `false` wenn Sie ein benutzerdefiniertes Skript verwenden möchten, um Abhängigkeiten zu installieren, oder wenn Sie Laufzeitabhängigkeiten in ein vorgefertigtes Linux-Image aufnehmen möchten. Um diese Komponente verwenden zu können, müssen Sie die folgenden Bibliotheken, einschließlich aller Abhängigkeiten, installieren und sie dem standardmäßigen Greengrass-Systembenutzer zur Verfügung stellen.
+ [AWS IoT Device SDK v2 für Python](https://github.com/aws/aws-iot-device-sdk-python-v2)
+ [CBOR-Bibliothek](https://pypi.org/project/cbor/). Version 1.0.0 ist die neueste Version, von der bestätigt wurde, dass sie mit der Komponente funktioniert.
+ [Psutil-Bibliothek](https://pypi.org/project/psutil/). Version 5.7.0 ist die neueste Version, von der bestätigt wurde, dass sie mit der Komponente funktioniert.
Wenn Sie Version 3.0.0 oder 3.0.1 dieser Komponente auf Kerngeräten verwenden, die Sie für die Verwendung eines HTTPS-Proxys konfigurieren, müssen Sie diesen Wert auf setzen. `false` Das Installationsskript unterstützt in diesen Versionen dieser Komponente keinen Betrieb hinter einem HTTPS-Proxy.
Standard: `true`
------
#### [ v2.x ]
**Anmerkung**
Die Standardkonfiguration dieser Komponente umfasst Lambda-Funktionsparameter. Wir empfehlen, dass Sie nur die folgenden Parameter bearbeiten, um diese Komponente auf Ihren Geräten zu konfigurieren.
`lambdaParams`
Ein Objekt, das die Parameter für die Lambda-Funktion dieser Komponente enthält. Dieses Objekt enthält die folgenden Informationen:
`EnvironmentVariables`
Ein Objekt, das die Parameter der Lambda-Funktion enthält. Dieses Objekt enthält die folgenden Informationen:
`PROCFS_PATH`
(Optional) Der Pfad zum `/proc` Ordner.
+ Um diese Komponente in einem Container auszuführen, verwenden Sie den Standardwert`/host-proc`. Die Komponente wird standardmäßig in einem Container ausgeführt.
+ Um diese Komponente ohne Container-Modus auszuführen, geben Sie `/proc` für diesen Parameter Folgendes an.
Standard: `/host-proc`. Dies ist der Standardpfad, in dem diese Komponente den `/proc` Ordner im Container mountet.
Diese Komponente hat nur Lesezugriff auf diesen Ordner.
`SAMPLE_INTERVAL_SECONDS`
(Optional) Die Zeitspanne in Sekunden zwischen den einzelnen Zyklen, in denen die Komponente Messwerte sammelt und meldet.
Die Mindestwert beträgt 300 Sekunden (5 Minuten).
Standard: 300 Sekunden
`containerMode`
(Optional) Der Containerisierungsmodus für diese Komponente. Wählen Sie aus den folgenden Optionen aus:
+ `GreengrassContainer`— Die Komponente wird in einer isolierten Laufzeitumgebung innerhalb des AWS IoT Greengrass Containers ausgeführt.
+ `NoContainer`— Die Komponente läuft nicht in einer isolierten Laufzeitumgebung.
Wenn Sie diese Option angeben, müssen Sie sie `/proc` für die `PROCFS_PATH` Umgebungsvariable angeben.
Standard: `GreengrassContainer`
`containerParams`
(Optional) Ein Objekt, das die Containerparameter für diese Komponente enthält. Die Komponente verwendet diese Parameter, wenn Sie `GreengrassContainer` für angeben`containerMode`.
Dieses Objekt enthält die folgenden Informationen:
`memorySize`
(Optional) Die Speichermenge (in Kilobyte), die der Komponente zugewiesen werden soll.
Der Standardwert ist 50.000 KB.
`pubsubTopics`
(Optional) Ein Objekt, das die Themen enthält, in denen die Komponente den Empfang von Nachrichten abonniert. Sie können jedes Thema angeben und angeben, ob die Komponente MQTT-Themen von AWS IoT Core oder lokale Themen abonniert. publish/subscribe
Dieses Objekt enthält die folgenden Informationen:
`0`— Dies ist ein Array-Index als Zeichenfolge.
Ein Objekt, das die folgenden Informationen enthält:
`type`
(Optional) Der publish/subscribe Messaging-Typ, den diese Komponente verwendet, um Nachrichten zu abonnieren. Wählen Sie aus den folgenden Optionen aus:
+ `PUB_SUB` — Abonnieren Sie lokale Veröffentlichen/Abonnement-Nachrichten. Wenn Sie diese Option wählen, darf das Thema keine MQTT-Platzhalter enthalten. Weitere Informationen zum Senden von Nachrichten von einer benutzerdefinierten Komponente aus, wenn Sie diese Option angeben, finden Sie unter. [Lokale Nachrichten veröffentlichen/abonnieren](ipc-publish-subscribe.md)
+ `IOT_CORE`— Abonnieren Sie AWS IoT Core MQTT-Nachrichten. Wenn Sie diese Option wählen, kann das Thema MQTT-Platzhalter enthalten. Weitere Informationen zum Senden von Nachrichten aus benutzerdefinierten Komponenten, wenn Sie diese Option angeben, finden Sie unter. [MQTT-Nachrichten veröffentlichen/abonnieren AWS IoT Core](ipc-iot-core-mqtt.md)
Standard: `PUB_SUB`
`topic`
(Optional) Das Thema, das die Komponente abonniert, um Nachrichten zu empfangen. Wenn Sie `IotCore` für angeben`type`, können Sie in diesem Thema MQTT-Platzhalter (`+`und`#`) verwenden.
**Example Beispiel: Aktualisierung der Konfigurationszusammenführung (Container-Modus)**
```
{
"lambdaExecutionParameters": {
"EnvironmentVariables": {
"PROCFS_PATH": "/host_proc"
}
},
"containerMode": "GreengrassContainer"
}
```
**Example Beispiel: Aktualisierung der Konfigurationszusammenführung (kein Container-Modus)**
```
{
"lambdaExecutionParameters": {
"EnvironmentVariables": {
"PROCFS_PATH": "/proc"
}
},
"containerMode": "NoContainer"
}
```
------
## Eingabedaten
Diese Komponente akzeptiert keine Nachrichten als Eingabedaten.
## Ausgabedaten
Diese Komponente veröffentlicht Sicherheitsmetriken zu dem folgenden reservierten Thema für AWS IoT Device Defender. Diese Komponente wird *coreDeviceName* bei der Veröffentlichung der Messwerte durch den Namen des Kerngeräts ersetzt.
**Thema (AWS IoT Core MQTT):** `$aws/things/coreDeviceName/defender/metrics/json`
**Example Beispielausgabe**
```
{
"header": {
"report_id": 1529963534,
"version": "1.0"
},
"metrics": {
"listening_tcp_ports": {
"ports": [
{
"interface": "eth0",
"port": 24800
},
{
"interface": "eth0",
"port": 22
},
{
"interface": "eth0",
"port": 53
}
],
"total": 3
},
"listening_udp_ports": {
"ports": [
{
"interface": "eth0",
"port": 5353
},
{
"interface": "eth0",
"port": 67
}
],
"total": 2
},
"network_stats": {
"bytes_in": 1157864729406,
"bytes_out": 1170821865,
"packets_in": 693092175031,
"packets_out": 738917180
},
"tcp_connections": {
"established_connections":{
"connections": [
{
"local_interface": "eth0",
"local_port": 80,
"remote_addr": "192.168.0.1:8000"
},
{
"local_interface": "eth0",
"local_port": 80,
"remote_addr": "192.168.0.1:8000"
}
],
"total": 2
}
}
}
}
```
Weitere Informationen zu den Metriken, die diese Komponente meldet, finden Sie in der [Dokumentspezifikation für Gerätemetriken](https://docs.aws.amazon.com/iot/latest/developerguide/detect-device-side-metrics.html#DetectMetricsMessagesSpec) im *AWS IoT Core Entwicklerhandbuch*.
## Lokale Protokolldatei
Diese Komponente verwendet die folgende Protokolldatei.
------
#### [ Linux ]
```
/greengrass/v2/logs/aws.greengrass.DeviceDefender.log
```
------
#### [ Windows ]
```
C:\greengrass\v2\logs\aws.greengrass.DeviceDefender.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:\$1greengrass\$1v2* durch den Pfad zum AWS IoT Greengrass Stammordner.
------
#### [ Linux ]
```
sudo tail -f /greengrass/v2/logs/aws.greengrass.DeviceDefender.log
```
------
#### [ Windows (PowerShell) ]
```
Get-Content C:\greengrass\v2\logs\aws.greengrass.DeviceDefender.log -Tail 10 -Wait
```
------
## Lizenzen
Diese Komponente wird im Rahmen der [Greengrass Core Software-Lizenzvereinbarung](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf) veröffentlicht.
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
------
#### [ v3.x ]
| **Version** | **Änderungen** |
| --- | --- |
| 3.1.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/device-defender-component.html) |
| 3.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/device-defender-component.html) |
| 3.0.1 | Behebt ein Problem mit der Berechnung von Deltawerten für Metriken durch die Komponente. |
| 3.0.0 | Diese Version ist nicht mehr verfügbar. Die Verbesserungen in dieser Version sind in späteren Versionen dieser Komponente verfügbar. Erste Version |
------
#### [ v2.x ]
| **Version** | **Änderungen** |
| --- | --- |
| 2.0.17 | Die Version wurde für die Version 2.14.0 von Greengrass Nucleus aktualisiert. |
| 2.0.16 | Die Version wurde für die Version 2.13.0 von Greengrass Nucleus aktualisiert. |
| 2.0.11 | Die Version wurde für die Version 2.11.0 von Greengrass Nucleus aktualisiert. |
| 2.0.10 | Die Version wurde für die Version 2.7.0 von Greengrass Nucleus aktualisiert. |
| 2.0.9 | Die Version wurde für die Version 2.6.0 von Greengrass Nucleus aktualisiert. |
| 2.0.8 | Die Version wurde für die Version 2.5.0 von Greengrass Nucleus aktualisiert. |
| 2.0.7 | Die Version wurde für die Version 2.4.0 von Greengrass Nucleus aktualisiert. |
| 2.0.6 | Die Version wurde für die Version 2.3.0 von Greengrass Nucleus aktualisiert. |
| 2.0.5 | Die Version wurde für die Version 2.2.0 von Greengrass Nucleus aktualisiert. |
| 2.0.4 | Die Version wurde für die Version 2.1.0 von Greengrass Nucleus aktualisiert. |
| 2.0.3 | Erste Version |
------
# Festplattenspooler
Die Festplatten-Spooler-Komponente (`aws.greengrass.DiskSpooler`) bietet eine persistente Speicheroption für Nachrichten, auf die von Greengrass-Kerngeräten gespoolt wird. AWS IoT Core Diese Komponente speichert diese ausgehenden Nachrichten auf der Festplatte.
**Topics**
+ [Versionen](#disk-spooler-component-versions)
+ [Typ](#disk-spooler-component-type)
+ [Betriebssystem](#disk-spooler-component-os-support)
+ [Voraussetzungen](#disk-spooler-component-requirements)
+ [Abhängigkeiten](#disk-spooler-component-dependencies)
+ [Usage](#disk-spooler-component-usage)
+ [Lokale Protokolldatei](#disk-spooler-component-log-file)
+ [Änderungsprotokoll](#disk-spooler-component-changelog)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 1.0.x
## Typ
Diese Komponente ist eine Plugin-Komponente (`aws.greengrass.plugin`). Der [Greengrass-Kern führt diese Komponente in derselben Java Virtual Machine (JVM) wie der Nucleus](greengrass-nucleus-component.md) aus. Der Nucleus wird neu gestartet, wenn Sie die Version dieser Komponente auf dem Core-Gerät ändern.
Diese Komponente verwendet dieselbe Protokolldatei wie der Greengrass-Kern. Weitere Informationen finden Sie unter [AWS IoT Greengrass Protokolle überwachen](monitor-logs.md).
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## 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:
+ `storageType`sollte so eingestellt sein, dass `Disk` diese Komponente verwendet werden soll. Sie können dies in der [Greengrass-Nukleus-Konfiguration](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration) einstellen.
+ `maxSizeInBytes`darf nicht so konfiguriert sein, dass es den verfügbaren Speicherplatz auf dem Gerät übersteigt. Sie können dies in der [Greengrass-Nukleus-Konfiguration](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration) einstellen.
+ Die Festplattenspooler-Komponente wird für die Ausführung in einer VPC unterstützt.
## Abhängigkeiten
Wenn Sie eine Komponente bereitstellen, stellt sie 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](#disk-spooler-component-changelog) 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](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.
------
#### [ 1.0.7 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.7 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.11.0 <2.17.0 | Hart |
------
#### [ 1.0. ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.6 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.11.0 <2.16.0 | Hart |
------
#### [ 1.0.5 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.5 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.11.0 <2.15.0 | Hart |
------
#### [ 1.0.4 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.4 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.11.0 <2.14.0 | Hart |
------
#### [ 1.0.1 – 1.0.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 1.0.1 bis 1.0.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.11.0 <2.13.0 | Hart |
------
#### [ 1.0.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.11.0 <2.12.0 | Hart |
------
[Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den Komponentenrezepten.](component-recipe-reference.md#recipe-reference-component-dependencies)
## Usage
Um die Disk-Spooler-Komponente verwenden zu können, `aws.greengrass.DiskSpooler` muss diese bereitgestellt werden.
Um diese Komponente zu konfigurieren und zu verwenden, müssen Sie den `pluginName` Wert auf setzen. `aws.greengrass.DiskSpooler`
## Lokale Protokolldatei
Diese Komponente verwendet dieselbe Protokolldatei wie die [Greengrass Nucleus-Komponente](greengrass-nucleus-component.md).
------
#### [ Linux ]
```
/greengrass/v2/logs/greengrass.log
```
------
#### [ Windows ]
```
C:\greengrass\v2\logs\greengrass.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:\$1greengrass\$1v2* durch den Pfad zum AWS IoT Greengrass Stammordner.
------
#### [ Linux ]
```
sudo tail -f /greengrass/v2/logs/greengrass.log
```
------
#### [ Windows (PowerShell) ]
```
Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
```
------
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| **Version** | **Änderungen** |
| --- | --- |
| 1.0.7 | Die Version wurde für die Version 2.16.0 von Greengrass Nucleus aktualisiert. |
| 1.0.6 | Die Version wurde für die Version 2.15.0 von Greengrass Nucleus aktualisiert. |
| 1.0.5 | Die Version wurde für die Version 2.14.0 von Greengrass Nucleus aktualisiert. |
| 1.0.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/disk-spooler-component.html) |
| 1.0.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/disk-spooler-component.html) |
| 1.0.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/disk-spooler-component.html) |
| 1.0.1 | Die Version wurde für die Version 2.12.0 von Greengrass Nucleus aktualisiert. |
| 1.0.0 | Erste Version |
# Docker-Anwendungsmanager
Die Docker-Anwendungsmanager-Komponente (`aws.greengrass.DockerApplicationManager`) ermöglicht AWS IoT Greengrass das Herunterladen von Docker-Images aus öffentlichen Image-Registern und privaten Registern, die auf Amazon Elastic Container Registry (Amazon ECR) gehostet werden. Es ermöglicht auch AWS IoT Greengrass die automatische Verwaltung von Anmeldeinformationen, um Bilder sicher aus privaten Repositorys in Amazon ECR herunterzuladen.
Wenn Sie eine benutzerdefinierte Komponente entwickeln, die einen Docker-Container ausführt, fügen Sie den Docker-Anwendungsmanager als Abhängigkeit hinzu, um die Docker-Images herunterzuladen, die in Ihrer Komponente als Artefakte angegeben sind. Weitere Informationen finden Sie unter [Führen Sie einen Docker-Container aus](run-docker-container.md).
**Topics**
+ [Versionen](#docker-application-manager-component-versions)
+ [Typ](#docker-application-manager-component-type)
+ [Betriebssystem](#docker-application-manager-component-os-support)
+ [Voraussetzungen](#docker-application-manager-component-requirements)
+ [Abhängigkeiten](#docker-application-manager-component-dependencies)
+ [Konfiguration](#docker-application-manager-component-configuration)
+ [Lokale Protokolldatei](#docker-application-manager-component-log-file)
+ [Änderungsprotokoll](#docker-application-manager-component-changelog)
+ [Weitere Informationen finden Sie auch unter](#docker-application-manager-component-see-also)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 2.0.x
## Typ
Diese Komponente ist eine generische Komponente (`aws.greengrass.generic`). Der [Greengrass-Kern](greengrass-nucleus-component.md) führt die Lebenszyklusskripte der Komponente aus.
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## 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:
+ [Docker Engine](https://docs.docker.com/engine/) 1.9.1 oder höher ist auf dem Greengrass-Core-Gerät installiert. Version 20.10 ist die neueste Version, für die verifiziert wurde, dass sie mit der Core-Software funktioniert. AWS IoT Greengrass Sie müssen Docker direkt auf dem Kerngerät installieren, bevor Sie Komponenten bereitstellen, auf denen Docker-Container ausgeführt werden.
+ Der Docker-Daemon wurde auf dem Kerngerät gestartet und ausgeführt, bevor Sie diese Komponente bereitstellen.
+ Docker-Images, die in einer der folgenden unterstützten Bildquellen gespeichert sind:
+ Öffentliche und private Image-Repositorys in Amazon Elastic Container Registry (Amazon ECR)
+ Öffentliches Docker Hub-Repository
+ Vertrauenswürdiges öffentliches Docker-Register
+ Docker-Images, die als Artefakte in Ihren benutzerdefinierten Docker-Container-Komponenten enthalten sind. Verwenden Sie die folgenden URI-Formate, um Ihre Docker-Images zu spezifizieren:
+ Privates Amazon ECR-Bild: `docker:account-id.dkr.ecr.region.amazonaws.com/repository/image[:tag|@digest]`
+ Öffentliches Amazon ECR-Bild: `docker:public.ecr.aws/repository/image[:tag|@digest]`
+ Öffentliches Docker Hub-Bild: `docker:name[:tag|@digest]`
Weitere Informationen finden Sie unter [Führen Sie einen Docker-Container aus](run-docker-container.md).
**Anmerkung**
Wenn Sie das Image-Tag oder den Image-Digest nicht in der Artefakt-URI für ein Image angeben, ruft der Docker-Anwendungsmanager die neueste verfügbare Version dieses Images ab, wenn Sie Ihre benutzerdefinierte Docker-Container-Komponente bereitstellen. Um sicherzustellen, dass auf allen Ihren Kerngeräten dieselbe Version eines Images ausgeführt wird, empfehlen wir Ihnen, das Image-Tag oder den Image-Digest in die Artefakt-URI aufzunehmen.
+ Der Systembenutzer, der eine Docker-Container-Komponente ausführt, muss über Root- oder Administratorrechte verfügen, oder Sie müssen Docker so konfigurieren, dass es als Benutzer ohne Root- oder Administratorrechte ausgeführt wird.
+ Auf Linux-Geräten können Sie der Gruppe einen Benutzer hinzufügen, um Befehle ohne Befehle `docker` aufzurufen. `docker` `sudo`
+ Auf Windows-Geräten können Sie der `docker-users` Gruppe einen Benutzer hinzufügen, um `docker` Befehle ohne Administratorrechte aufzurufen.
------
#### [ Linux or Unix ]
Führen Sie den folgenden Befehl aus`ggc_user`, um der `docker` Gruppe einen Nicht-Root-Benutzer, den Sie zum Ausführen von Docker-Container-Komponenten verwenden, hinzuzufügen.
```
sudo usermod -aG docker ggc_user
```
Weitere Informationen finden Sie unter [Docker als Nicht-Root-Benutzer verwalten](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user).
------
#### [ Windows Command Prompt (CMD) ]
Um der `docker-users` Gruppe den Benutzer`ggc_user`, den Sie zum Ausführen von Docker-Container-Komponenten verwenden, hinzuzufügen, führen Sie den folgenden Befehl als Administrator aus.
```
net localgroup docker-users ggc_user /add
```
------
#### [ Windows PowerShell ]
Um der `docker-users` Gruppe den Benutzer`ggc_user`, den Sie zum Ausführen von Docker-Container-Komponenten verwenden, hinzuzufügen, führen Sie den folgenden Befehl als Administrator aus.
```
Add-LocalGroupMember -Group docker-users -Member ggc_user
```
------
+ Wenn Sie [die AWS IoT Greengrass Core-Software für die Verwendung eines Netzwerk-Proxys](configure-greengrass-core-v2.md#configure-alpn-network-proxy) [konfigurieren, müssen Sie Docker für die Verwendung desselben Proxyservers](https://docs.docker.com/network/proxy/) konfigurieren.
+ Wenn Ihre Docker-Images in einer privaten Amazon ECR-Registry gespeichert sind, müssen Sie die Token-Exchange-Servicekomponente als Abhängigkeit in die Docker-Container-Komponente aufnehmen. Außerdem muss die [Greengrass-Geräterolle](device-service-role.md) die `ecr:GetDownloadUrlForLayer` Aktionen `ecr:GetAuthorizationToken``ecr:BatchGetImage`, und zulassen, wie in der folgenden IAM-Beispielrichtlinie gezeigt.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"ecr:GetAuthorizationToken",
"ecr:BatchGetImage",
"ecr:GetDownloadUrlForLayer"
],
"Resource": [
"*"
],
"Effect": "Allow"
}
]
}
```
------
```
```
+ Die Docker-Anwendungsmanager-Komponente wird für die Ausführung in einer VPC unterstützt. Um diese Komponente in einer VPC bereitzustellen, ist Folgendes erforderlich.
+ Die Docker-Anwendungsmanager-Komponente muss über Konnektivität zum Herunterladen von Bildern verfügen. Wenn Sie beispielsweise ECR verwenden, müssen Sie über Konnektivität zu den folgenden Endpunkten verfügen.
+ `*.dkr.ecr.region.amazonaws.com`(VPC-Endpunkt`com.amazonaws.region.ecr.dkr`)
+ `api.ecr.region.amazonaws.com`(VPC-Endpunkt`com.amazonaws.region.ecr.api`)
### 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](allow-device-traffic.md).
| Endpoint | Port | Erforderlich | Description |
| --- | --- | --- | --- |
| `ecr.region.amazonaws.com` | 443 | Nein | Erforderlich, wenn Sie Docker-Images von Amazon ECR herunterladen. |
| `hub.docker.com` `registry.hub.docker.com/v1` | 443 | Nein | Erforderlich, wenn Sie Docker-Images von Docker Hub herunterladen. |
## 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](#docker-application-manager-component-changelog) 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](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.
------
#### [ 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](greengrass-nucleus-component.md) | >=2.1.0 <2.17.0 | Weich |
------
#### [ 2.0.14 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.14 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.1.0 <2.16.0 | Weich |
------
#### [ 2.0.13 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.13 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.1.0 <2.15.0 | Weich |
------
#### [ 2.0.12 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.12 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.1.0 <2.14.0 | Weich |
------
#### [ 2.0.11 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.11 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.1.0 <2.13.0 | Weich |
------
#### [ 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](greengrass-nucleus-component.md) | >=2.1.0 <2.12.0 | Weich |
------
#### [ 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](greengrass-nucleus-component.md) | >=2.1.0 <2.11.0 | Weich |
------
#### [ 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](greengrass-nucleus-component.md) | >=2.1.0 <2.10.0 | Weich |
------
#### [ 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](greengrass-nucleus-component.md) | >=2.1.0 <2.9.0 | Weich |
------
#### [ 2.0.6 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.6 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.1.0 <2.8.0 | Weich |
------
#### [ 2.0.5 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.5 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.1.0 <2.7.0 | Weich |
------
#### [ 2.0.4 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.4 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.1.0 <2.6.0 | Weich |
------
#### [ 2.0.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.1.0 <2.5.0 | Weich |
------
#### [ 2.0.2 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.2 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.1.0 <2.4.0 | Weich |
------
#### [ 2.0.1 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.1 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.1.0 <2.3.0 | Weich |
------
#### [ 2.0.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.1.0 <2.2.0 | Weich |
------
[Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den Komponentenrezepten.](component-recipe-reference.md#recipe-reference-component-dependencies)
## Konfiguration
Diese Komponente hat keine Konfigurationsparameter.
## Lokale Protokolldatei
Diese Komponente verwendet dieselbe Protokolldatei wie die [Greengrass Nucleus-Komponente](greengrass-nucleus-component.md).
------
#### [ Linux ]
```
/greengrass/v2/logs/greengrass.log
```
------
#### [ Windows ]
```
C:\greengrass\v2\logs\greengrass.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:\$1greengrass\$1v2* durch den Pfad zum AWS IoT Greengrass Stammordner.
------
#### [ Linux ]
```
sudo tail -f /greengrass/v2/logs/greengrass.log
```
------
#### [ Windows (PowerShell) ]
```
Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
```
------
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| **Version** | **Änderungen** |
| --- | --- |
| 2.0.15 | Die Version wurde für die Version 2.16.0 von Greengrass Nucleus aktualisiert. |
| 2.0.14 | Die Version wurde für die Version 2.15.0 von Greengrass Nucleus aktualisiert. |
| 2.0.13 | Die Version wurde für die Version 2.14.0 von Greengrass Nucleus aktualisiert. |
| 2.0.12 | Die Version wurde für die Version 2.13.0 von Greengrass Nucleus aktualisiert. |
| 2.0.11 | Die Version wurde für die Version 2.12.0 von Greengrass Nucleus aktualisiert. |
| 2.0.10 | Die Version wurde für die Version 2.11.0 von Greengrass Nucleus aktualisiert. |
| 2.0.9 | Die Version wurde für die Version 2.10.0 von Greengrass Nucleus aktualisiert. |
| 2.0.8 | Die Version wurde für die Version 2.9.0 von Greengrass Nucleus aktualisiert. |
| 2.0.7 | Die Version wurde für die Version 2.8.0 von Greengrass Nucleus aktualisiert. |
| 2.0.6 | Die Version wurde für die Version 2.7.0 von Greengrass Nucleus aktualisiert. |
| 2.0.5 | Die Version wurde für die Version 2.6.0 von Greengrass Nucleus aktualisiert. |
| 2.0.4 | Die Version wurde für die Version 2.5.0 von Greengrass Nucleus aktualisiert. |
| 2.0.3 | Die Version wurde für die Version 2.4.0 von Greengrass Nucleus aktualisiert. |
| 2.0.2 | Die Version wurde für die Version 2.3.0 von Greengrass Nucleus aktualisiert. |
| 2.0.1 | Die Version wurde für die Version 2.2.0 von Greengrass Nucleus aktualisiert. |
| 2.0.0 | Erste Version |
## Weitere Informationen finden Sie auch unter
+ [Führen Sie einen Docker-Container aus](run-docker-container.md)
# Edge-Anschluss für Kinesis Video Streams
Der Edge-Connector für die Kinesis Video Streams-Komponente (`aws.iot.EdgeConnectorForKVS`) liest Video-Feeds von lokalen Kameras und veröffentlicht die Streams in Kinesis Video Streams. Sie können diese Komponente so konfigurieren, dass sie Video-Feeds von IP-Kameras (Internet Protocol) liest, die das Real Time Streaming Protocol (RTSP) verwenden. Anschließend können Sie Dashboards in [Amazon Managed Grafana](https://docs.aws.amazon.com/grafana/latest/userguide/what-is-Amazon-Managed-Service-Grafana.html) oder lokalen Grafana-Servern einrichten, um die Videostreams zu überwachen und mit ihnen zu interagieren.
Sie können diese Komponente integrieren AWS IoT TwinMaker , um Videostreams in Grafana-Dashboards anzuzeigen und zu steuern. AWS IoT TwinMaker ist ein AWS Service, mit dem Sie betriebsbereite digitale Zwillinge physischer Systeme erstellen können. Sie können AWS IoT TwinMaker damit Daten von Sensoren, Kameras und Unternehmensanwendungen visualisieren, sodass Sie Ihre physischen Fabriken, Gebäude oder Industrieanlagen verfolgen können. Sie können diese Daten auch verwenden, um Abläufe zu überwachen, Fehler zu diagnostizieren und Fehler zu reparieren. Weitere Informationen finden Sie unter [Was ist AWS IoT TwinMaker?](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/what-is-twinmaker.html) im *AWS IoT TwinMaker Benutzerhandbuch*.
Diese Komponente speichert ihre Konfiguration in AWS IoT SiteWise. Dabei handelt es sich um einen AWS Dienst, der Industriedaten modelliert und speichert. AWS IoT SiteWise In stehen *Anlagen* für Objekte wie Geräte, Ausrüstung oder Gruppen anderer Objekte. Um diese Komponente zu konfigurieren und zu verwenden, erstellen Sie ein AWS IoT SiteWise Asset für jedes Greengrass-Core-Gerät und für jede IP-Kamera, die mit jedem Core-Gerät verbunden ist. Jedes Asset verfügt über Eigenschaften, die Sie konfigurieren, um Funktionen wie Live-Streaming, On-Demand-Upload und lokales Caching zu steuern. Um die URL für jede Kamera anzugeben, erstellen Sie ein Geheimnis AWS Secrets Manager , das die URL der Kamera enthält. Wenn für die Kamera eine Authentifizierung erforderlich ist, geben Sie in der URL auch einen Benutzernamen und ein Passwort an. Anschließend geben Sie dieses Geheimnis in einer Asset-Eigenschaft für die IP-Kamera an.
Diese Komponente lädt den Videostream jeder Kamera in einen Kinesis-Videostream hoch. Sie geben den Namen des Kinesis-Zielvideostreams in der AWS IoT SiteWise Asset-Konfiguration für jede Kamera an. Wenn der Kinesis-Videostream nicht existiert, erstellt diese Komponente ihn für Sie.
AWS IoT TwinMaker stellt ein Skript bereit, das Sie ausführen können, um diese AWS IoT SiteWise Assets und Secrets Manager zu erstellen. Weitere Informationen zur Erstellung dieser Ressourcen und zur Installation, Konfiguration und Verwendung dieser Komponente finden Sie unter [AWS IoT TwinMaker Videointegration](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html) im *AWS IoT TwinMaker Benutzerhandbuch*.
**Anmerkung**
Die Komponente Edge-Connector für Kinesis Video Streams ist nur in den folgenden AWS-Regionen Fällen verfügbar:
USA Ost (Nord-Virginia)
USA West (Oregon)
Europe (Frankfurt)
Europa (Irland)
Asien-Pazifik (Singapur)
Asien-Pazifik (Tokio)
Asien-Pazifik (Seoul)
Asien-Pazifik (Sydney)
Asien-Pazifik (Mumbai)
China (Peking)
**Topics**
+ [Versionen](#kvs-edge-connector-component-versions)
+ [Typ](#kvs-edge-connector-component-type)
+ [Betriebssystem](#kvs-edge-connector-component-os-support)
+ [Voraussetzungen](#kvs-edge-connector-component-requirements)
+ [Abhängigkeiten](#kvs-edge-connector-component-dependencies)
+ [Konfiguration](#kvs-edge-connector-component-configuration)
+ [Lizenzen](#kvs-edge-connector-component-licenses)
+ [Usage](#kvs-edge-connector-component-usage)
+ [Lokale Protokolldatei](#kvs-edge-connector-component-log-file)
+ [Änderungsprotokoll](#kvs-edge-connector-component-changelog)
+ [Weitere Informationen finden Sie auch unter](#kvs-edge-connector-component-see-also)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 1.0.x
## Typ
Diese Komponente ist eine generische Komponente (`aws.greengrass.generic`). Der [Greengrass-Kern](greengrass-nucleus-component.md) führt die Lebenszyklusskripte der Komponente aus.
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## Betriebssystem
Diese Komponente kann nur auf Linux-Core-Geräten installiert werden.
## Voraussetzungen
Für diese Komponente gelten die folgenden Anforderungen:
+ Sie können diese Komponente nur auf Single-Core-Geräten bereitstellen, da die Komponentenkonfiguration für jedes Core-Gerät eindeutig sein muss. Sie können diese Komponente nicht für Gruppen von Kerngeräten bereitstellen.
+ [GStreamer](https://gstreamer.freedesktop.org)Version 1.18.4 oder höher ist auf dem Kerngerät installiert. [Weitere Informationen finden Sie unter Installation. GStreamer](https://gstreamer.freedesktop.org/documentation/installing/index.html?gi-language=c)
Auf einem Gerät mit `apt` können Sie die folgenden Befehle zur Installation ausführen GStreamer.
```
sudo apt install -y libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev gstreamer1.0-plugins-base-apps
sudo apt install -y gstreamer1.0-libav
sudo apt install -y gstreamer1.0-plugins-bad gstreamer1.0-plugins-good gstreamer1.0-plugins-ugly gstreamer1.0-tools
```
+ Ein AWS IoT SiteWise Asset für jedes Kerngerät. Dieses AWS IoT SiteWise Asset stellt das Kerngerät dar. Weitere Informationen zur Erstellung dieses Assets finden Sie im *AWS IoT TwinMaker Benutzerhandbuch* unter [AWS IoT TwinMaker Videointegration](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html).
+ Ein AWS IoT SiteWise Asset für jede IP-Kamera, die Sie mit jedem Kerngerät verbinden. Diese AWS IoT SiteWise Ressourcen stellen die Kameras dar, die Videos auf jedes Kerngerät streamen. Das Asset jeder Kamera muss dem Asset für das Kerngerät zugeordnet werden, das mit der Kamera verbunden ist. Kamera-Assets verfügen über Eigenschaften, die Sie konfigurieren können, um einen Kinesis-Videostream, ein Authentifizierungsgeheimnis und Videostreaming-Parameter anzugeben. Weitere Informationen zum Erstellen und Konfigurieren von Kameraobjekten finden Sie im *AWS IoT TwinMaker Benutzerhandbuch* unter [AWS IoT TwinMaker Videointegration](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html).
+ Ein AWS Secrets Manager Geheimnis für jede IP-Kamera. Dieses Geheimnis muss ein Schlüssel-Wert-Paar definieren, wobei der Schlüssel und der Wert die URL für die Kamera ist. `RTSPStreamUrl` Wenn für die Kamera eine Authentifizierung erforderlich ist, geben Sie den Benutzernamen und das Passwort in diese URL ein. Sie können ein Skript verwenden, um ein Geheimnis zu erstellen, wenn Sie die Ressourcen erstellen, die diese Komponente benötigt. Weitere Informationen finden Sie im *AWS IoT TwinMaker Benutzerhandbuch* unter [AWS IoT TwinMaker Videointegration](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html).
Sie können auch die Secrets Manager Manager-Konsole und die API verwenden, um zusätzliche Geheimnisse zu erstellen. Weitere Informationen finden Sie im *AWS Secrets Manager Benutzerhandbuch* unter [Create a Secret](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_create-basic-secret.html).
+ Die [Greengrass-Token-Austauschrolle](device-service-role.md) muss die folgenden AWS Secrets Manager AWS IoT SiteWise, und Kinesis Video Streams Streams-Aktionen zulassen, wie in der folgenden IAM-Beispielrichtlinie gezeigt.
**Anmerkung**
Diese Beispielrichtlinie ermöglicht es dem Gerät, den Wert von Geheimnissen mit dem Namen und abzurufen. **IPCamera1Url** **IPCamera2Url** Wenn Sie jede IP-Kamera konfigurieren, geben Sie ein Geheimnis an, das die URL für diese Kamera enthält. Wenn für die Kamera eine Authentifizierung erforderlich ist, geben Sie in der URL auch einen Benutzernamen und ein Passwort an. Die Token-Austauschfunktion des Kerngeräts muss den Zugriff auf das Geheimnis ermöglichen, damit jede IP-Kamera eine Verbindung herstellen kann.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"secretsmanager:GetSecretValue"
],
"Effect": "Allow",
"Resource": [
"arn:aws:secretsmanager:us-east-1:123456789012:secret:IPCamera1Url",
"arn:aws:secretsmanager:us-east-1:123456789012:secret:IPCamera2Url"
]
},
{
"Action": [
"iotsitewise:BatchPutAssetPropertyValue",
"iotsitewise:DescribeAsset",
"iotsitewise:DescribeAssetModel",
"iotsitewise:DescribeAssetProperty",
"iotsitewise:GetAssetPropertyValue",
"iotsitewise:ListAssetRelationships",
"iotsitewise:ListAssets",
"iotsitewise:ListAssociatedAssets",
"kinesisvideo:CreateStream",
"kinesisvideo:DescribeStream",
"kinesisvideo:GetDataEndpoint",
"kinesisvideo:PutMedia",
"kinesisvideo:TagStream"
],
"Effect": "Allow",
"Resource": [
"*"
]
}
]
}
```
------
**Anmerkung**
Wenn Sie einen vom Kunden verwalteten AWS Key Management Service Schlüssel zum Verschlüsseln von Geheimnissen verwenden, muss die Geräterolle die `kms:Decrypt` Aktion ebenfalls zulassen.
### 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](allow-device-traffic.md).
| Endpoint | Port | Erforderlich | Description |
| --- | --- | --- | --- |
| `kinesisvideo.region.amazonaws.com` | 443 | Ja | Laden Sie Daten in Kinesis Video Streams hoch. |
| `data.iotsitewise.region.amazonaws.com` | 443 | Ja | Veröffentlichen Sie Videostream-Metadaten auf AWS IoT SiteWise. |
| `secretsmanager.region.amazonaws.com` | 443 | Ja | Laden Sie die Geheimnisse der Kamera-URL auf das Kerngerät herunter. |
## 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](#kvs-edge-connector-component-changelog) 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](https://console.aws.amazon.com//greengrass) 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 1.0.0 bis 1.0.5 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Token-Austauschdienst](token-exchange-service-component.md) | >=2.0.3 | Hart |
| [Stream-Manager](stream-manager-component.md) | >=2.0.9 | Hart |
Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den [Komponentenrezepten](component-recipe-reference.md#recipe-reference-component-dependencies).
## Konfiguration
Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.
`SiteWiseAssetIdForHub`
Die ID des AWS IoT SiteWise Assets, das dieses Kerngerät darstellt. Weitere Informationen darüber, wie Sie dieses Asset erstellen und es für die Interaktion mit dieser Komponente verwenden, finden Sie im *AWS IoT TwinMaker Benutzerhandbuch* unter [AWS IoT TwinMaker Videointegration](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html).
**Example Beispiel: Aktualisierung der Zusammenführung von Konfigurationen**
```
{
"SiteWiseAssetIdForHub": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}
```
## Lizenzen
Diese Komponente umfasst die folgende Software/Lizenzierung von Drittanbietern:
+ [Quartz Job Scheduler](http://www.quartz-scheduler.org/)//Apache License 2.0
+ [Java-Bindungen für GStreamer 1.x](https://github.com/gstreamer-java/gst1-java-core)//GNU Lesser General Public License v3.0
## Usage
Um diese Komponente zu konfigurieren und mit ihr zu interagieren, können Sie Eigenschaften für die Komponenten festlegen, die das AWS IoT SiteWise Kerngerät und die IP-Kameras repräsentieren, mit denen es verbunden ist. Sie können auch Videostreams in Grafana-Dashboards visualisieren und mit ihnen interagieren. AWS IoT TwinMaker Weitere Informationen finden Sie unter [AWS IoT TwinMaker Videointegration](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html) im *AWS IoT TwinMaker Benutzerhandbuch*.
## Lokale Protokolldatei
Diese Komponente verwendet die folgende Protokolldatei.
```
/greengrass/v2/logs/aws.iot.EdgeConnectorForKVS.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. `/greengrass/v2`Ersetzen Sie durch den Pfad zum AWS IoT Greengrass Stammordner.
```
sudo tail -f /greengrass/v2/logs/aws.iot.EdgeConnectorForKVS.log
```
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| **Version** | **Änderungen** |
| --- | --- |
| 1.0.5 | Allgemeine Fehlerbehebungen und Verbesserungen. |
| 1.0.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/kvs-edge-connector-component.html) |
| 1.0.3 | Allgemeine Fehlerbehebungen und Verbesserungen. |
| 1.0.1 | Allgemeine Fehlerbehebungen und Verbesserungen. |
| 1.0.0 | Erste Version |
## Weitere Informationen finden Sie auch unter
+ [Was ist AWS IoT TwinMaker?](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/what-is-twinmaker.html) im *AWS IoT TwinMaker Benutzerhandbuch*
+ [AWS IoT TwinMaker Videointegration](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/video-integration.html) im *AWS IoT TwinMaker Benutzerhandbuch*
+ [Was ist AWS IoT SiteWise?](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/what-is-sitewise.html) im *AWS IoT SiteWise Benutzerhandbuch*
+ [Aktualisierung von Attributwerten](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/update-attribute-values.html) im *AWS IoT SiteWise Benutzerhandbuch*
+ [Was ist AWS Secrets Manager?](https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html) im *AWS Secrets Manager Benutzerhandbuch*
+ [Secrets im *AWS Secrets Manager Benutzerhandbuch* erstellen und verwalten](https://docs.aws.amazon.com/secretsmanager/latest/userguide/managing-secrets.html)
# Greengrass CLI
Die Greengrass-CLI-Komponente (`aws.greengrass.Cli`) bietet eine lokale Befehlszeilenschnittstelle, die Sie auf Kerngeräten verwenden können, um Komponenten lokal zu entwickeln und zu debuggen. Mit der Greengrass-CLI können Sie beispielsweise lokale Bereitstellungen erstellen und Komponenten auf dem Kerngerät neu starten.
Sie können diese Komponente bei der Installation der AWS IoT Greengrass Core-Software installieren. Weitere Informationen finden Sie unter [Tutorial: Erste Schritte mit AWS IoT Greengrass V2](getting-started.md).
**Wichtig**
Wir empfehlen, diese Komponente nur in Entwicklungsumgebungen und nicht in Produktionsumgebungen zu verwenden. Diese Komponente bietet Zugriff auf Informationen und Operationen, die Sie in einer Produktionsumgebung normalerweise nicht benötigen. Folgen Sie dem Prinzip der geringsten Rechte, indem Sie diese Komponente nur dort einsetzen, wo Sie sie benötigen.
Führen Sie nach der Installation dieser Komponente den folgenden Befehl aus, um die zugehörige Hilfedokumentation aufzurufen. Bei der Installation dieser Komponente wird dem `/greengrass/v2/bin` Ordner ein symbolischer Link hinzugefügt. `greengrass-cli` Sie können die Greengrass-CLI von diesem Pfad aus ausführen oder sie zu Ihrer `PATH` Umgebungsvariablen hinzufügen, um sie `greengrass-cli` ohne ihren absoluten Pfad auszuführen.
------
#### [ Linux or Unix ]
```
/greengrass/v2/bin/greengrass-cli help
```
------
#### [ Windows ]
```
C:\greengrass\v2\bin\greengrass-cli help
```
------
Mit dem folgenden Befehl wird beispielsweise eine Komponente mit dem Namen `com.example.HelloWorld` neu gestartet.
------
#### [ Linux or Unix ]
```
sudo /greengrass/v2/bin/greengrass-cli component restart --names "com.example.HelloWorld"
```
------
#### [ Windows ]
```
C:\greengrass\v2\bin\greengrass-cli component restart --names "com.example.HelloWorld"
```
------
Weitere Informationen finden Sie unter [Greengrass-Befehlszeilenschnittstelle](gg-cli.md).
**Topics**
+ [Versionen](#greengrass-cli-component-versions)
+ [Typ](#greengrass-cli-component-type)
+ [Betriebssystem](#greengrass-cli-component-os-support)
+ [Voraussetzungen](#greengrass-cli-component-requirements)
+ [Abhängigkeiten](#greengrass-cli-component-dependencies)
+ [Konfiguration](#greengrass-cli-component-configuration)
+ [Lokale Protokolldatei](#greengrass-cli-component-log-file)
+ [Änderungsprotokoll](#greengrass-cli-component-changelog)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 2.16.x
+ 2.15.x
+ 2.14.x
+ 2.13.x
+ 2.12.x
+ 2.11.x
+ 2.10.x
+ 2.9.x
+ 2.8.x
+ 2.7.x
+ 2.6.x
+ 2.5.x
+ 2.4.x
+ 2.3.x
+ 2.2.x
+ 2.1.x
+ 2.0.x
## Typ
Diese Komponente ist eine Plugin-Komponente (`aws.greengrass.plugin`). Der [Greengrass-Kern führt diese Komponente in derselben Java Virtual Machine (JVM) wie der Nucleus](greengrass-nucleus-component.md) aus. Der Nucleus wird neu gestartet, wenn Sie die Version dieser Komponente auf dem Core-Gerät ändern.
Diese Komponente verwendet dieselbe Protokolldatei wie der Greengrass-Kern. Weitere Informationen finden Sie unter [AWS IoT Greengrass Protokolle überwachen](monitor-logs.md).
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## 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:
+ Sie müssen autorisiert sein, die Greengrass-CLI zu verwenden, um mit der AWS IoT Greengrass Core-Software zu interagieren. Führen Sie einen der folgenden Schritte aus, um die Greengrass-CLI zu verwenden:
+ Verwenden Sie den Systembenutzer, der die AWS IoT Greengrass Core-Software ausführt.
+ Verwenden Sie einen Benutzer mit Root- oder Administratorrechten. Auf Linux-Core-Geräten können Sie diese Option verwenden, um `sudo` Root-Rechte zu erhalten.
+ Verwenden Sie einen Systembenutzer, der zu einer Gruppe gehört, die Sie bei der Bereitstellung der Komponente in den `AuthorizedWindowsGroups` Konfigurationsparametern `AuthorizedPosixGroups` oder angeben. Weitere Informationen finden Sie unter [Konfiguration der Greengrass-CLI-Komponente](#greengrass-cli-component-configuration).
+ Die Greengrass-CLI-Komponente wird für die Ausführung in einer VPC unterstützt.
## Abhängigkeiten
Wenn Sie eine Komponente bereitstellen, stellt sie 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](#greengrass-cli-component-changelog) 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](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.
------
#### [ 2.16.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.16.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.12.0 <2.17.0 | Weich |
------
#### [ 2.15.1 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.15.1 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.12.0 <2.16.0 | Weich |
------
#### [ 2.15.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.15.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.12.0 <2.16.0 | Weich |
------
#### [ 2.14.0 – 2.14.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.14.0 und 2.14.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.12.0 <2.15.0 | Weich |
------
#### [ 2.13.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.13.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.12.0 <2.14.0 | Weich |
------
#### [ 2.12.0 – 2.12.6 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.12.0 bis 2.12.6 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.12.0 <2.13.0 | Weich |
------
#### [ 2.11.0 – 2.11.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.11.0 bis 2.11.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.11.0 <2.12.0 | Weich |
------
#### [ 2.10.0 – 2.10.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.10.0 bis 2.10.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,5,0 <2,11,0 | Weich |
------
#### [ 2.9.0 – 2.9.6 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.9.0 bis 2.9.6 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.5.0 <2.10.0 | Weich |
------
#### [ 2.8.0 – 2.8.1 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.8.0 und 2.8.1 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,5,0 <2,9,0 | Weich |
------
#### [ 2.7.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.7.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,5,0 <2,8,0 | Weich |
------
#### [ 2.6.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.6.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,5,0 <2,7,0 | Weich |
------
#### [ 2.5.0 – 2.5.6 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.5.0 bis 2.5.6 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,5,0 <2,6,0 | Weich |
------
#### [ 2.4.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.4.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.1.0 <2.5.0 | Weich |
------
#### [ 2.3.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.3.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.1.0 <2.4.0 | Weich |
------
#### [ 2.2.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.2.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.1.0 <2.3.0 | Weich |
------
#### [ 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](greengrass-nucleus-component.md) | >=2.1.0 <2.2.0 | Weich |
------
#### [ 2.0.x ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.x dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.1.0 | Weich |
**Anmerkung**
Die minimale kompatible Version des Greengrass-Nukleus entspricht der Patch-Version der Greengrass-CLI-Komponente.
------
Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den [Komponentenrezepten](component-recipe-reference.md#recipe-reference-component-dependencies).
## Konfiguration
Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.
------
#### [ 2.5.x - 2.14.x ]
`AuthorizedPosixGroups`
(Optional) Eine Zeichenfolge, die eine durch Kommas getrennte Liste von Systemgruppen enthält. Sie autorisieren diese Systemgruppen, die Greengrass-CLI für die Interaktion mit der AWS IoT Greengrass Core-Software zu verwenden. Sie können Gruppennamen oder Gruppen angeben. IDs `group1,1002,group3`Autorisiert beispielsweise drei Systemgruppen (`group1`, und`group3`)`1002`, die Greengrass-CLI zu verwenden.
Wenn Sie keine zu autorisierenden Gruppen angeben, können Sie die Greengrass-CLI als Root-Benutzer (`sudo`) oder als Systembenutzer verwenden, der die AWS IoT Greengrass Core-Software ausführt.
`AuthorizedWindowsGroups`
(Optional) Eine Zeichenfolge, die eine durch Kommas getrennte Liste von Systemgruppen enthält. Sie autorisieren diese Systemgruppen, die Greengrass-CLI für die Interaktion mit der AWS IoT Greengrass Core-Software zu verwenden. Sie können Gruppennamen oder Gruppen angeben. IDs `group1,1002,group3`Autorisiert beispielsweise drei Systemgruppen (`group1`, und`group3`)`1002`, die Greengrass-CLI zu verwenden.
Wenn Sie keine zu autorisierenden Gruppen angeben, können Sie die Greengrass-CLI als Administrator oder als Systembenutzer verwenden, der die AWS IoT Greengrass Core-Software ausführt.
**Example Beispiel: Aktualisierung der Zusammenführung von Konfigurationen**
Die folgende Beispielkonfiguration legt fest, dass drei POSIX-Systemgruppen (`group1``1002`, und`group3`) und zwei Windows-Benutzergruppen (`Device Operators`und`QA Engineers`) zur Verwendung der Greengrass-CLI autorisiert werden sollen.
```
{
"AuthorizedPosixGroups": "group1,1002,group3",
"AuthorizedWindowsGroups": "Device Operators,QA Engineers"
}
```
------
#### [ 2.4.x - 2.0.x ]
`AuthorizedPosixGroups`
(Optional) Eine Zeichenfolge, die eine durch Kommas getrennte Liste von Systemgruppen enthält. Sie autorisieren diese Systemgruppen, die Greengrass-CLI für die Interaktion mit der AWS IoT Greengrass Core-Software zu verwenden. Sie können Gruppennamen oder Gruppen angeben. IDs `group1,1002,group3`Autorisiert beispielsweise drei Systemgruppen (`group1`, und`group3`)`1002`, die Greengrass-CLI zu verwenden.
Wenn Sie keine zu autorisierenden Gruppen angeben, können Sie die Greengrass-CLI als Root-Benutzer (`sudo`) oder als Systembenutzer verwenden, der die AWS IoT Greengrass Core-Software ausführt.
**Example Beispiel: Aktualisierung der Konfigurationszusammenführung**
Die folgende Beispielkonfiguration legt fest, dass drei Systemgruppen (`group1``1002`, und`group3`) zur Verwendung der Greengrass-CLI autorisiert werden sollen.
```
{
"AuthorizedPosixGroups": "group1,1002,group3"
}
```
------
## Lokale Protokolldatei
Diese Komponente verwendet dieselbe Protokolldatei wie die [Greengrass Nucleus-Komponente](greengrass-nucleus-component.md).
------
#### [ Linux ]
```
/greengrass/v2/logs/greengrass.log
```
------
#### [ Windows ]
```
C:\greengrass\v2\logs\greengrass.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:\$1greengrass\$1v2* durch den Pfad zum AWS IoT Greengrass Stammordner.
------
#### [ Linux ]
```
sudo tail -f /greengrass/v2/logs/greengrass.log
```
------
#### [ Windows (PowerShell) ]
```
Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
```
------
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| **Version** | **Änderungen** |
| --- | --- |
| 2.16.1 | Die Version wurde für die Version 2.16.1 von Greengrass Nucleus aktualisiert. |
| 2.16.0 | Die Version wurde für die Version 2.16.0 von Greengrass Nucleus aktualisiert. |
| 2.15.1 | Die Version wurde für die Version 2.15.1 von Greengrass Nucleus aktualisiert. |
| 2.15.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-cli-component.html) |
| 2.14.3 | Die Version wurde für die Version 2.14.3 von Greengrass Nucleus aktualisiert. |
| 2.14.2 | Die Version wurde für die Version 2.14.2 von Greengrass Nucleus aktualisiert. |
| 2.14.1 | Die Version wurde für die Version 2.14.1 von Greengrass Nucleus aktualisiert. |
| 2.14.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-cli-component.html) |
| 2.13.0 | Die Version wurde für die Version 2.13.0 von Greengrass Nucleus aktualisiert. |
| 2.12.6 | Die Version wurde für die Version 2.12.6 von Greengrass Nucleus aktualisiert. |
| 2.12.5 | Die Version wurde für die Version 2.12.5 von Greengrass Nucleus aktualisiert. |
| 2.12.4 | Die Version wurde für die Version 2.12.4 von Greengrass Nucleus aktualisiert. |
| 2.12.3 | Diese Version ist nicht mehr verfügbar. Die Verbesserungen in dieser Version sind in späteren Versionen dieser Komponente verfügbar. Die Version wurde für die Version 2.12.3 von Greengrass Nucleus aktualisiert. |
| 2.12.2 | Die Version wurde für die Version 2.12.2 von Greengrass Nucleus aktualisiert. |
| 2.12.1 | Die Version wurde für die Version 2.12.1 von Greengrass Nucleus aktualisiert. |
| 2.12.0 | Die Version wurde für die Version 2.12.0 von Greengrass Nucleus aktualisiert. |
| 2.11.3 | Die Version wurde für die Version 2.11.3 von Greengrass Nucleus aktualisiert. |
| 2.11.2 | Die Version wurde für die Version 2.11.2 von Greengrass Nucleus aktualisiert. |
| 2.11.1 | Die Version wurde für die Version 2.11.1 von Greengrass Nucleus aktualisiert. |
| 2.11.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-cli-component.html) |
| 2.10.3 | Die Version wurde für die Version 2.10.3 von Greengrass Nucleus aktualisiert. |
| 2.10.2 | Die Version wurde für die Version 2.10.2 von Greengrass Nucleus aktualisiert. |
| 2.10.1 | Die Version wurde für die Version 2.10.1 von Greengrass Nucleus aktualisiert. |
| 2.10.0 | Die Version wurde für die Version 2.10.0 von Greengrass Nucleus aktualisiert. |
| 2.9.6 | Die Version wurde für die Version 2.9.6 von Greengrass Nucleus aktualisiert. |
| 2.9.5 | Die Version wurde für die Version 2.9.5 von Greengrass Nucleus aktualisiert. |
| 2.9.4 | Die Version wurde für die Version 2.9.4 von Greengrass Nucleus aktualisiert. |
| 2.9.3 | Die Version wurde für die Version 2.9.3 von Greengrass Nucleus aktualisiert. |
| 2.9.2 | Die Version wurde für die Version 2.9.2 von Greengrass Nucleus aktualisiert. |
| 2.9.1 | Die Version wurde für die Version 2.9.1 von Greengrass Nucleus aktualisiert. |
| 2.9.0 | Die Version wurde für die Version 2.9.0 von Greengrass Nucleus aktualisiert. |
| 2.8.1 | Die Version wurde für die Version 2.8.1 von Greengrass Nucleus aktualisiert. |
| 2.8.0 | Die Version wurde für die Version 2.8.0 von Greengrass Nucleus aktualisiert. |
| 2.7.0 | Die Version wurde für die Version 2.7.0 von Greengrass Nucleus aktualisiert. |
| 2.6.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-cli-component.html) |
| 2.5.6 | Die Version wurde für die Version 2.5.6 von Greengrass Nucleus aktualisiert. |
| 2.5.5 | Die Version wurde für die Version 2.5.5 von Greengrass Nucleus aktualisiert. |
| 2.5.4 | Die Version wurde für die Version 2.5.4 von Greengrass Nucleus aktualisiert. |
| 2.5.3 | Die Version wurde für die Version 2.5.3 von Greengrass Nucleus aktualisiert. |
| 2.5.2 | Die Version wurde für die Version 2.5.2 von Greengrass Nucleus aktualisiert. |
| 2.5.1 | Die Version wurde für die Version 2.5.1 von Greengrass Nucleus aktualisiert. |
| 2.5.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-cli-component.html) |
| 2.4.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/greengrass-cli-component.html) |
| 2.3.0 | Die Version wurde für die Version 2.3.0 von Greengrass Nucleus aktualisiert. |
| 2.2.0 | Die Version wurde für die Version 2.2.0 von Greengrass Nucleus aktualisiert. |
| 2.1.0 | Die Version wurde für die Version 2.1.0 von Greengrass Nucleus aktualisiert. |
| 2.0.5 | Die Version wurde für die Version 2.0.5 von Greengrass Nucleus aktualisiert. |
| 2.0.4 | Die Version wurde für die Version 2.0.4 von Greengrass Nucleus aktualisiert. |
| 2.0.3 | Erste Version |
# IP-Detektor
Die IP-Detektorkomponente (`aws.greengrass.clientdevices.IPDetector`) macht Folgendes:
+ Überwacht die Netzwerkverbindungsinformationen des Greengrass-Core-Geräts. Zu diesen Informationen gehören die Netzwerkendpunkte des Kerngeräts und der Port, an dem ein MQTT-Broker betrieben wird.
+ Aktualisiert die Konnektivitätsinformationen des Kerngeräts im AWS IoT Greengrass Cloud-Dienst.
Client-Geräte können Greengrass Cloud Discovery verwenden, um die Verbindungsinformationen der zugehörigen Kerngeräte abzurufen. Anschließend können Client-Geräte versuchen, eine Verbindung zu jedem Kerngerät herzustellen, bis sie erfolgreich verbunden sind.
**Anmerkung**
Client-Geräte sind lokale IoT-Geräte, die eine Verbindung zu einem Greengrass-Core-Gerät herstellen, um MQTT-Nachrichten und Daten zur Verarbeitung zu senden. Weitere Informationen finden Sie unter [Interagieren Sie mit lokalen IoT-Geräten](interact-with-local-iot-devices.md).
Die IP-Detektorkomponente ersetzt die vorhandenen Konnektivitätsinformationen eines Kerngeräts durch die Informationen, die es erkennt. Da diese Komponente vorhandene Informationen entfernt, können Sie entweder die IP-Detektorkomponente verwenden oder die Verbindungsinformationen manuell verwalten.
**Topics**
+ [Versionen](#ip-detector-component-versions)
+ [Typ](#ip-detector-component-type)
+ [Betriebssystem](#ip-detector-component-os-support)
+ [Voraussetzungen](#ip-detector-component-requirements)
+ [Abhängigkeiten](#ip-detector-component-dependencies)
+ [Konfiguration](#ip-detector-component-configuration)
+ [Lokale Protokolldatei](#ip-detector-component-log-file)
+ [Änderungsprotokoll](#ip-detector-component-changelog)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 2.2.x
+ 2.1.x
+ 2.0.x
## Typ
Diese Komponente ist eine Plugin-Komponente (`aws.greengrass.plugin`). Der [Greengrass-Kern führt diese Komponente in derselben Java Virtual Machine (JVM) wie der Nucleus](greengrass-nucleus-component.md) aus. Der Nucleus wird neu gestartet, wenn Sie die Version dieser Komponente auf dem Core-Gerät ändern.
Diese Komponente verwendet dieselbe Protokolldatei wie der Greengrass-Kern. Weitere Informationen finden Sie unter [AWS IoT Greengrass Protokolle überwachen](monitor-logs.md).
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## 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 [Greengrass-Servicerolle](greengrass-service-role.md) muss mit Ihren Berechtigungen verknüpft sein AWS-Konto `iot:GetThingShadow` und die `iot:UpdateThingShadow` Berechtigungen zulassen.
+ Die AWS IoT Richtlinie des Kerngeräts muss die `greengrass:UpdateConnectivityInfo` Genehmigung zulassen. Weitere Informationen erhalten Sie unter [AWS IoT Richtlinien für den Betrieb auf Datenebene](device-auth.md#iot-policies) und [Minimale AWS IoT Richtlinie zur Unterstützung von Client-Geräten](device-auth.md#client-device-support-minimal-iot-policy).
+ Wenn Sie die MQTT-Broker-Komponente des Kerngeräts so konfigurieren, dass sie einen anderen Port als den Standardport 8883 verwendet, müssen Sie den IP-Detektor v2.1.0 oder höher verwenden. Konfigurieren Sie es so, dass der Port gemeldet wird, an dem der Broker arbeitet.
+ Wenn Sie ein komplexes Netzwerk-Setup haben, kann die IP-Detektorkomponente möglicherweise nicht die Endpunkte identifizieren, an denen Client-Geräte eine Verbindung zum Kerngerät herstellen können. Wenn die IP-Detektorkomponente die Endpunkte nicht verwalten kann, müssen Sie stattdessen die Endpunkte der Kerngeräte manuell verwalten. Wenn sich das Kerngerät beispielsweise hinter einem Router befindet, der den MQTT-Broker-Port an ihn weiterleitet, müssen Sie die IP-Adresse des Routers als Endpunkt für das Kerngerät angeben. Weitere Informationen finden Sie unter [Endpunkte von Kerngeräten verwalten](manage-core-device-endpoints.md).
+ Die IP-Detektorkomponente wird für die Ausführung in einer VPC unterstützt.
## Abhängigkeiten
Wenn Sie eine Komponente bereitstellen, stellt sie 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](#ip-detector-component-changelog) 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](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.
------
#### [ 2.2.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.2.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.2.0 <2.17.0 | Weich |
------
#### [ 2.2.2 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.2.2 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.2.0 <2.16.0 | Weich |
------
#### [ 2.2.1 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.2.1 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.2.0 <2.15.0 | Weich |
------
#### [ 2.2.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.2.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.2.0 <2.14.0 | Weich |
------
#### [ 2.1.8 – 2.1.9 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.1.8 und 2.1.9 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.2.0 <2.13.0 | Weich |
------
#### [ 2.1.7 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.7 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.2.0 <2.12.0 | Weich |
------
#### [ 2.1.6 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.6 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.2.0 <2.11.0 | Weich |
------
#### [ 2.1.5 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.5 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.2.0 <2.10.0 | Weich |
------
#### [ 2.1.4 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.4 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.2.0 <2.9.0 | Weich |
------
#### [ 2.1.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.2.0 <2.8.0 | Weich |
------
#### [ 2.1.2 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.2 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.2.0 <2.7.0 | Weich |
------
#### [ 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](greengrass-nucleus-component.md) | >=2.2.0 <2.6.0 | Weich |
------
#### [ 2.1.0 and 2.0.2 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.1.0 und 2.0.2 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.2.0 <2.5.0 | Weich |
------
#### [ 2.0.1 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.1 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.2.0 <2.4.0 | Weich |
------
#### [ 2.0.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.2.0 <2.3.0 | Weich |
------
[Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den Komponentenrezepten.](component-recipe-reference.md#recipe-reference-component-dependencies)
## Konfiguration
Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.
------
#### [ 2.2.x ]
`defaultPort`
(Optional) Der MQTT-Broker-Port, der gemeldet werden soll, wenn diese Komponente IP-Adressen erkennt. Sie müssen diesen Parameter angeben, wenn Sie den MQTT-Broker so konfigurieren, dass er einen anderen Port als den Standardport 8883 verwendet.
Standard: `8883`
`includeIPv4LoopbackAddrs`
(Optional) Sie können diese Option aktivieren, um IPv4 Loopback-Adressen zu erkennen und zu melden. Dies sind IP-Adressen, über die ein Gerät `localhost` beispielsweise mit sich selbst kommunizieren kann. Verwenden Sie diese Option in Testumgebungen, in denen das Kerngerät und das Client-Gerät auf demselben System ausgeführt werden.
Standard: `false`
`includeIPv4LinkLocalAddrs`
(Optional) Sie können diese Option aktivieren, um IPv4 [verknüpfungslokale](https://en.wikipedia.org/wiki/Link-local_address) Adressen zu erkennen und zu melden. Verwenden Sie diese Option, wenn das Netzwerk des Kerngeräts nicht über DHCP (Dynamic Host Configuration Protocol) oder statisch zugewiesene IP-Adressen verfügt.
Standard: `false`
`includeIPv6LoopbackAddrs`
(Optional) Sie können diese Option aktivieren, um IPv6 Loopback-Adressen zu erkennen und zu melden. Dies sind IP-Adressen, über die ein Gerät `localhost` beispielsweise mit sich selbst kommunizieren kann. Verwenden Sie diese Option in Testumgebungen, in denen das Kerngerät und das Client-Gerät auf demselben System ausgeführt werden. Sie müssen `includeIPv4Addrs` auf `false` und auf einstellen`includeIPv6Addrs`, `true` um diese Option verwenden zu können.
Standard: `false`
`includeIPv6LinkLocalAddrs`
(Optional) Sie können diese Option aktivieren, um IPv6 [verknüpfungslokale](https://en.wikipedia.org/wiki/Link-local_address) Adressen zu erkennen und zu melden. Verwenden Sie diese Option, wenn das Netzwerk des Kerngeräts nicht über DHCP (Dynamic Host Configuration Protocol) oder statisch zugewiesene IP-Adressen verfügt. Sie müssen `includeIPv4Addrs` auf `false` und auf einstellen, `includeIPv6Addrs` um diese Option verwenden `true` zu können.
Standard: `false`
`includeIPv4Addrs`
(Optional) Die Standardeinstellung ist auf eingestellt`true`. Sie können diese Option aktivieren, um IPv4 Adressen zu veröffentlichen, die auf dem Core-Gerät gefunden wurden.
Standard: `true`
`includeIPv6Addrs`
(Optional) Sie können diese Option aktivieren, um IPv6 Adressen zu veröffentlichen, die auf dem Kerngerät gefunden wurden. Stellen Sie `includeIPv4Addrs` auf `false` ein, um diese Option zu verwenden.
Standard: `false`
------
#### [ 2.1.x ]
`defaultPort`
(Optional) Der MQTT-Broker-Port, der gemeldet werden soll, wenn diese Komponente IP-Adressen erkennt. Sie müssen diesen Parameter angeben, wenn Sie den MQTT-Broker so konfigurieren, dass er einen anderen Port als den Standardport 8883 verwendet.
Standard: `8883`
`includeIPv4LoopbackAddrs`
(Optional) Sie können diese Option aktivieren, um IPv4 Loopback-Adressen zu erkennen und zu melden. Dies sind IP-Adressen, über die ein Gerät `localhost` beispielsweise mit sich selbst kommunizieren kann. Verwenden Sie diese Option in Testumgebungen, in denen das Kerngerät und das Client-Gerät auf demselben System ausgeführt werden.
Standard: `false`
`includeIPv4LinkLocalAddrs`
(Optional) Sie können diese Option aktivieren, um IPv4 [verknüpfungslokale](https://en.wikipedia.org/wiki/Link-local_address) Adressen zu erkennen und zu melden. Verwenden Sie diese Option, wenn das Netzwerk des Kerngeräts nicht über DHCP (Dynamic Host Configuration Protocol) oder statisch zugewiesene IP-Adressen verfügt.
Standard: `false`
------
#### [ 2.0.x ]
`includeIPv4LoopbackAddrs`
(Optional) Sie können diese Option aktivieren, um IPv4 Loopback-Adressen zu erkennen und zu melden. Dies sind IP-Adressen, über die ein Gerät `localhost` beispielsweise mit sich selbst kommunizieren kann. Verwenden Sie diese Option in Testumgebungen, in denen das Kerngerät und das Client-Gerät auf demselben System ausgeführt werden.
Standard: `false`
`includeIPv4LinkLocalAddrs`
(Optional) Sie können diese Option aktivieren, um IPv4 [verknüpfungslokale](https://en.wikipedia.org/wiki/Link-local_address) Adressen zu erkennen und zu melden. Verwenden Sie diese Option, wenn das Netzwerk des Kerngeräts nicht über DHCP (Dynamic Host Configuration Protocol) oder statisch zugewiesene IP-Adressen verfügt.
Standard: `false`
------
## Lokale Protokolldatei
Diese Komponente verwendet dieselbe Protokolldatei wie die [Greengrass Nucleus-Komponente](greengrass-nucleus-component.md).
------
#### [ Linux ]
```
/greengrass/v2/logs/greengrass.log
```
------
#### [ Windows ]
```
C:\greengrass\v2\logs\greengrass.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:\$1greengrass\$1v2* durch den Pfad zum AWS IoT Greengrass Stammordner.
------
#### [ Linux ]
```
sudo tail -f /greengrass/v2/logs/greengrass.log
```
------
#### [ Windows (PowerShell) ]
```
Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
```
------
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| **Version** | **Änderungen** |
| --- | --- |
| 2.2.3 | Die Version wurde für die Version 2.16.0 von Greengrass Nucleus aktualisiert. |
| 2.2.2 | Die Version wurde für die Version 2.15.0 von Greengrass Nucleus aktualisiert. |
| 2.2.1 | Die Version wurde für die Version 2.14.0 von Greengrass Nucleus aktualisiert. |
| 2.2.0 | Die Version wurde für die Version 2.13.0 von Greengrass Nucleus aktualisiert. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/ip-detector-component.html) |
| 2.1.9 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/ip-detector-component.html) |
| 2.1.8 | Die Version wurde für die Version 2.12.0 von Greengrass Nucleus aktualisiert. |
| 2.1.7 | Die Version wurde für die Version 2.11.0 von Greengrass Nucleus aktualisiert. |
| 2.1.6 | Die Version wurde für die Version 2.10.0 von Greengrass Nucleus aktualisiert. |
| 2.1.5 | Die Version wurde für die Version 2.9.0 von Greengrass Nucleus aktualisiert. |
| 2.1.4 | Die Version wurde für die Version 2.8.0 von Greengrass Nucleus aktualisiert. |
| 2.1.3 | Die Version wurde für die Version 2.7.0 von Greengrass Nucleus aktualisiert. |
| 2.1.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/ip-detector-component.html) |
| 2.1.1 | Die Version wurde für die Version 2.5.0 von Greengrass Nucleus aktualisiert. |
| 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/ip-detector-component.html) |
| 2.0.2 | Die Version wurde für die Version 2.4.0 von Greengrass Nucleus aktualisiert. |
| 2.0.1 | Die Version wurde für die Version 2.3.0 von Greengrass Nucleus aktualisiert. |
| 2.0.0 | Erste Version |
# Firehose
Die Firehose-Komponente (`aws.greengrass.KinesisFirehose`) veröffentlicht Daten über Amazon Data Firehose-Lieferdatenströme an Ziele wie Amazon S3, Amazon Redshift und Amazon Service. OpenSearch Weitere Informationen finden Sie unter [Was ist Amazon Data Firehose](https://docs.aws.amazon.com/firehose/latest/dev/what-is-this-service.html)? im *Amazon Data Firehose Developer Guide*.
Um mit dieser Komponente in einem Kinesis-Lieferstream zu veröffentlichen, veröffentlichen Sie eine Nachricht zu einem Thema, das diese Komponente abonniert. Standardmäßig abonniert diese Komponente die Themen „Publizieren/Abonnieren“ `kinesisfirehose/message` und „`kinesisfirehose/message/binary/#`[Lokales](ipc-publish-subscribe.md) Veröffentlichen“. Sie können andere Themen angeben, einschließlich AWS IoT Core MQTT-Themen, wenn Sie diese Komponente bereitstellen.
**Anmerkung**
Diese Komponente bietet ähnliche Funktionen wie der Firehose-Anschluss in AWS IoT Greengrass V1. Weitere Informationen finden Sie unter [Firehose-Anschluss](https://docs.aws.amazon.com/greengrass/latest/developerguide/kinesis-firehose-connector.html) im *AWS IoT Greengrass V1-Entwicklerhandbuch*.
**Topics**
+ [Versionen](#kinesis-firehose-component-versions)
+ [Typ](#kinesis-firehose-component-type)
+ [Betriebssystem](#kinesis-firehose-component-os-support)
+ [Voraussetzungen](#kinesis-firehose-component-requirements)
+ [Abhängigkeiten](#kinesis-firehose-component-dependencies)
+ [Konfiguration](#kinesis-firehose-component-configuration)
+ [Eingabedaten](#kinesis-firehose-component-input-data)
+ [Ausgabedaten](#kinesis-firehose-component-output-data)
+ [Lokale Protokolldatei](#kinesis-firehose-component-log-file)
+ [Lizenzen](#kinesis-firehose-component-licenses)
+ [Änderungsprotokoll](#kinesis-firehose-component-changelog)
+ [Weitere Informationen finden Sie auch unter](#kinesis-firehose-component-see-also)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 2.1.x
+ 2.0.x
## Typ
Diese Komponente ist eine Lambda-Komponente (`aws.greengrass.lambda`). [Der [Greengrass-Kern führt die](greengrass-nucleus-component.md) Lambda-Funktion dieser Komponente mithilfe der Lambda-Launcher-Komponente aus.](lambda-launcher-component.md)
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## Betriebssystem
Diese Komponente kann nur auf Linux-Kerngeräten installiert werden.
## Voraussetzungen
Für diese Komponente gelten die folgenden Anforderungen:
+ Ihr Kerngerät muss die Anforderungen für die Ausführung von Lambda-Funktionen erfüllen. Wenn Sie möchten, dass das Kerngerät containerisierte Lambda-Funktionen ausführt, muss das Gerät die entsprechenden Anforderungen erfüllen. Weitere Informationen finden Sie unter [Anforderungen an die Lambda-Funktion](setting-up.md#greengrass-v2-lambda-requirements).
+ [Python-Version](https://www.python.org/) 3.7 wurde auf dem Core-Gerät installiert und zur Umgebungsvariablen PATH hinzugefügt.
+ Die [Greengrass-Geräterolle](device-service-role.md) muss die `firehose:PutRecordBatch` Aktionen `firehose:PutRecord` und zulassen, wie in der folgenden IAM-Beispielrichtlinie gezeigt.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"firehose:PutRecord",
"firehose:PutRecordBatch"
],
"Effect": "Allow",
"Resource": [
"arn:aws:firehose:us-east-1:123456789012:deliverystream/stream-name"
]
}
]
}
```
------
Sie können den Standardzustellungsstream in der Nutzlast der Eingabenachricht für diese Komponente dynamisch überschreiben. Wenn Ihre Anwendung diese Funktion verwendet, muss die IAM-Richtlinie alle Zielstreams als Ressourcen enthalten. Sie können Ressourcen granularen oder bedingten Zugriff gewähren (etwa mit einem Benennungsschema mit Platzhaltern `*`).
+ Um Ausgabedaten von dieser Komponente zu erhalten, müssen Sie bei der Bereitstellung dieser Komponente das folgende Konfigurationsupdate für die [ältere Abonnement-Router-Komponente](legacy-subscription-router-component.md) (`aws.greengrass.LegacySubscriptionRouter`) zusammenführen. Diese Konfiguration gibt das Thema an, zu dem diese Komponente Antworten veröffentlicht.
------
#### [ Legacy subscription router v2.1.x ]
```
{
"subscriptions": {
"aws-greengrass-kinesisfirehose": {
"id": "aws-greengrass-kinesisfirehose",
"source": "component:aws.greengrass.KinesisFirehose",
"subject": "kinesisfirehose/message/status",
"target": "cloud"
}
}
}
```
------
#### [ Legacy subscription router v2.0.x ]
```
{
"subscriptions": {
"aws-greengrass-kinesisfirehose": {
"id": "aws-greengrass-kinesisfirehose",
"source": "arn:aws:lambda:region:aws:function:aws-greengrass-kinesisfirehose:version",
"subject": "kinesisfirehose/message/status",
"target": "cloud"
}
}
}
```
+ *region*Ersetzen Sie es durch AWS-Region das, was Sie verwenden.
+ *version*Ersetzen Sie durch die Version der Lambda-Funktion, die diese Komponente ausführt. Um die Version der Lambda-Funktion zu finden, müssen Sie sich das Rezept für die Version dieser Komponente ansehen, die Sie bereitstellen möchten. Öffnen Sie die Detailseite dieser Komponente in der [AWS IoT Greengrass Konsole](https://console.aws.amazon.com//greengrass) und suchen Sie nach dem **Schlüssel-Wert-Paar der Lambda-Funktion**. Dieses Schlüssel-Wert-Paar enthält den Namen und die Version der Lambda-Funktion.
**Wichtig**
Sie müssen die Lambda-Funktionsversion auf dem älteren Abonnement-Router jedes Mal aktualisieren, wenn Sie diese Komponente bereitstellen. Dadurch wird sichergestellt, dass Sie die richtige Lambda-Funktionsversion für die Komponentenversion verwenden, die Sie bereitstellen.
------
Weitere Informationen finden Sie unter [Erstellen von Bereitstellungen](create-deployments.md).
+ Die Firehose-Komponente wird für die Ausführung in einer VPC unterstützt. Um diese Komponente in einer VPC bereitzustellen, ist Folgendes erforderlich.
+ Die Firehose-Komponente muss über eine Konnektivität verfügen`firehose.region.amazonaws.com`, zu der der VPC-Endpunkt ist. `com.amazonaws.region.kinesis-firehose`
### 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](allow-device-traffic.md).
| Endpoint | Port | Erforderlich | Description |
| --- | --- | --- | --- |
| `firehose.region.amazonaws.com` | 443 | Ja | Laden Sie Daten auf Firehose hoch. |
## Abhängigkeiten
Wenn Sie eine Komponente bereitstellen, stellt sie 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](#kinesis-firehose-component-changelog) 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](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.
------
#### [ 2.1.10 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.10 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.16.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.1.9 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.9 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.15.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.1.8 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.8 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.14.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.1.7 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.7 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.1.6 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.6 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.1.5 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.5 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.1.4 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.4 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.1.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.1.2 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.2 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.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](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.0.8 - 2.1.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.0.8 und 2.1.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.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](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.0.6 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.6 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.0.5 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.5 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.0.4 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.4 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.0.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.3 <2.1.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | >=1.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | >=1,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | >=1.0.0 | Hart |
------
Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den [Komponentenrezepten](component-recipe-reference.md#recipe-reference-component-dependencies).
## Konfiguration
Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.
**Anmerkung**
Die Standardkonfiguration dieser Komponente umfasst Lambda-Funktionsparameter. Wir empfehlen, dass Sie nur die folgenden Parameter bearbeiten, um diese Komponente auf Ihren Geräten zu konfigurieren.
`lambdaParams`
Ein Objekt, das die Parameter für die Lambda-Funktion dieser Komponente enthält. Dieses Objekt enthält die folgenden Informationen:
`EnvironmentVariables`
Ein Objekt, das die Parameter der Lambda-Funktion enthält. Dieses Objekt enthält die folgenden Informationen:
`DEFAULT_DELIVERY_STREAM_ARN`
Der ARN des Standard-Firehose-Lieferstreams, in den die Komponente Daten sendet. Sie können den Zielstream mit der `delivery_stream_arn` Eigenschaft in der Nutzlast der Eingabenachricht überschreiben.
Die zentrale Geräterolle muss die erforderlichen Aktionen für alle Zielzustellungsstreams zulassen. Weitere Informationen finden Sie unter [Voraussetzungen](#kinesis-firehose-component-requirements).
`PUBLISH_INTERVAL`
(Optional) Die maximale Anzahl von Sekunden, die gewartet werden soll, bevor die Komponente Batchdaten in Firehose veröffentlicht. Um die Komponente so zu konfigurieren, dass sie Metriken so veröffentlicht, wie sie sie empfängt, d. h. ohne Batchverarbeitung, geben Sie Folgendes an. `0`
Dieser Wert kann maximal 900 Sekunden betragen.
Standard: 10 Sekunden
`DELIVERY_STREAM_QUEUE_SIZE`
(Optional) Die maximale Anzahl von Datensätzen, die im Speicher aufbewahrt werden sollen, bevor die Komponente neue Datensätze für denselben Lieferstream zurückweist.
Dieser Wert muss mindestens 2.000 Datensätze betragen.
Standard: 5.000 Datensätze
`containerMode`
(Optional) Der Containerisierungsmodus für diese Komponente. Wählen Sie aus den folgenden Optionen aus:
+ `NoContainer`— Die Komponente wird nicht in einer isolierten Laufzeitumgebung ausgeführt.
+ `GreengrassContainer`— Die Komponente läuft in einer isolierten Laufzeitumgebung innerhalb des AWS IoT Greengrass Containers.
Standard: `GreengrassContainer`
`containerParams`
(Optional) Ein Objekt, das die Container-Parameter für diese Komponente enthält. Die Komponente verwendet diese Parameter, wenn Sie `GreengrassContainer` für angeben`containerMode`.
Dieses Objekt enthält die folgenden Informationen:
`memorySize`
(Optional) Die Speichermenge (in Kilobyte), die der Komponente zugewiesen werden soll.
Der Standardwert ist 64 MB (65.535 KB).
`pubsubTopics`
(Optional) Ein Objekt, das die Themen enthält, in denen die Komponente den Empfang von Nachrichten abonniert. Sie können jedes Thema angeben und angeben, ob die Komponente MQTT-Themen von AWS IoT Core oder lokale Themen abonniert. publish/subscribe
Dieses Objekt enthält die folgenden Informationen:
`0`— Dies ist ein Array-Index als Zeichenfolge.
Ein Objekt, das die folgenden Informationen enthält:
`type`
(Optional) Der publish/subscribe Messaging-Typ, den diese Komponente verwendet, um Nachrichten zu abonnieren. Wählen Sie aus den folgenden Optionen aus:
+ `PUB_SUB` — Abonnieren Sie lokale Veröffentlichen/Abonnement-Nachrichten. Wenn Sie diese Option wählen, darf das Thema keine MQTT-Platzhalter enthalten. Weitere Informationen zum Senden von Nachrichten von einer benutzerdefinierten Komponente aus, wenn Sie diese Option angeben, finden Sie unter. [Lokale Nachrichten veröffentlichen/abonnieren](ipc-publish-subscribe.md)
+ `IOT_CORE`— Abonnieren Sie AWS IoT Core MQTT-Nachrichten. Wenn Sie diese Option wählen, kann das Thema MQTT-Platzhalter enthalten. Weitere Informationen zum Senden von Nachrichten aus benutzerdefinierten Komponenten, wenn Sie diese Option angeben, finden Sie unter. [MQTT-Nachrichten veröffentlichen/abonnieren AWS IoT Core](ipc-iot-core-mqtt.md)
Standard: `PUB_SUB`
`topic`
(Optional) Das Thema, das die Komponente abonniert, um Nachrichten zu empfangen. Wenn Sie `IotCore` für angeben`type`, können Sie in diesem Thema MQTT-Platzhalter (`+`und`#`) verwenden.
**Example Beispiel: Aktualisierung der Konfigurationszusammenführung (Container-Modus)**
```
{
"lambdaExecutionParameters": {
"EnvironmentVariables": {
"DEFAULT_DELIVERY_STREAM_ARN": "arn:aws:firehose:us-west-2:123456789012:deliverystream/mystream"
}
},
"containerMode": "GreengrassContainer"
}
```
**Example Beispiel: Aktualisierung der Konfigurationszusammenführung (kein Container-Modus)**
```
{
"lambdaExecutionParameters": {
"EnvironmentVariables": {
"DEFAULT_DELIVERY_STREAM_ARN": "arn:aws:firehose:us-west-2:123456789012:deliverystream/mystream"
}
},
"containerMode": "NoContainer"
}
```
## Eingabedaten
Diese Komponente akzeptiert Stream-Inhalte zu den folgenden Themen und sendet die Inhalte an den Ziel-Lieferstream. Die Komponente akzeptiert zwei Arten von Eingabedaten:
+ JSON-Daten zum `kinesisfirehose/message`-Thema.
+ Binäre Daten zum `kinesisfirehose/message/binary/#`-Thema.
**Standardthema für JSON-Daten (lokales Veröffentlichen/Abonnieren):** `kinesisfirehose/message`
Die Nachricht akzeptiert die folgenden Eigenschaften. Eingabenachrichten müssen im JSON-Format vorliegen.
`request`
Die zu sendenden Daten an den Lieferstrom und den Ziel-Lieferstrom, falls sie sich vom Standard-Stream unterscheiden.
Typ: `object` der die folgenden Informationen enthält:
`data`
Die Daten, die an den Lieferstrom gesendet werden sollen.
Typ: `string`
`delivery_stream_arn`
(Optional) Der ARN des Firehose-Ziel-Lieferstreams. Geben Sie diese Eigenschaft an, um den Standard-Lieferstream zu überschreiben.
Typ: `string`
`id`
Eine willkürliche ID für die Anforderung. Verwenden Sie diese Eigenschaft, um eine Eingabeanforderung einer Ausgabeantwort zuzuordnen. Wenn Sie diese Eigenschaft angeben, setzt die Komponente die `id` Eigenschaft im Antwortobjekt auf diesen Wert.
Typ: `string`
**Example Beispieleingabe**
```
{
"request": {
"delivery_stream_arn": "arn:aws:firehose:region:account-id:deliverystream/stream2-name",
"data": "Data to send to the delivery stream."
},
"id": "request123"
}
```
**Standardthema für Binärdaten (lokales Veröffentlichen/Abonnieren):** `kinesisfirehose/message/binary/#`
Verwenden Sie dieses Thema, um eine Nachricht zu senden, die binäre Daten enthält. Die Komponente analysiert keine Binärdaten. Die Komponente streamt die Daten unverändert.
Um die Eingabeaufforderung einer Ausgabeaufgabe zuzuordnen, ersetzen Sie den Platzhalter `#` im Meldungsthema durch eine beliebige Anforderungs-ID. Wenn Sie beispielsweise eine Nachricht an `kinesisfirehose/message/binary/request123` veröffentlichen, wird die Eigenschaft `id` im Antwortobjekt auf `request123` gesetzt.
Wenn Sie eine Anfrage nicht auf eine Antwort abbilden möchten, können Sie Ihre Nachrichten unter `kinesisfirehose/message/binary/` veröffentlichen. Achten Sie darauf, den abschließenden Schrägstrich () `/` einzufügen.
## Ausgabedaten
Diese Komponente veröffentlicht standardmäßig Antworten als Ausgabedaten zum folgenden MQTT-Thema. Sie müssen dieses Thema `subject` in der Konfiguration für die [ältere Abonnement-Router-Komponente](legacy-subscription-router-component.md) angeben. Weitere Informationen zum Abonnieren von Nachrichten zu diesem Thema in Ihren benutzerdefinierten Komponenten finden Sie unter[MQTT-Nachrichten veröffentlichen/abonnieren AWS IoT Core](ipc-iot-core-mqtt.md).
**Standardthema (AWS IoT Core MQTT):** `kinesisfirehose/message/status`
**Example Beispielausgabe**
Die Antwort enthält den Status jedes im Stapel gesendeten Datensatzes.
```
{
"response": [
{
"ErrorCode": "error",
"ErrorMessage": "test error",
"id": "request123",
"status": "fail"
},
{
"firehose_record_id": "xyz2",
"id": "request456",
"status": "success"
},
{
"firehose_record_id": "xyz3",
"id": "request890",
"status": "success"
}
]
}
```
**Anmerkung**
Wenn die Komponente einen Fehler erkennt, der erneut versucht werden kann, z. B. einen Verbindungsfehler, versucht sie erneut, im nächsten Batch zu veröffentlichen.
## Lokale Protokolldatei
Diese Komponente verwendet die folgende Protokolldatei.
```
/greengrass/v2/logs/aws.greengrass.KinesisFirehose.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. `/greengrass/v2`Ersetzen Sie durch den Pfad zum AWS IoT Greengrass Stammordner.
```
sudo tail -f /greengrass/v2/logs/aws.greengrass.KinesisFirehose.log
```
## Lizenzen
Diese Komponente umfasst die folgende Software/Lizenzierung von Drittanbietern:
+ [AWS SDK für Python (Boto3)](https://pypi.org/project/boto3/)/Apache-Lizenz 2.0
+ [botocore](https://pypi.org/project/botocore/)/Apache-Lizenz 2.0
+ [dateutil](https://pypi.org/project/python-dateutil/1.4/)/PSF-Lizenz
+ [docutils](https://pypi.org/project/docutils/)/BSD-Lizenz, GNU General Public License (GPL), Python Software Foundation License, Public Domain
+ [jmespath](https://pypi.org/project/jmespath/)/MIT-Lizenz
+ [s3transfer](https://pypi.org/project/s3transfer/)/Apache-Lizenz 2.0
+ [urllib3](https://pypi.org/project/urllib3/)/MIT-Lizenz
Diese Komponente wird im Rahmen der [Greengrass Core Software-Lizenzvereinbarung](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf) veröffentlicht.
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| **Version** | **Änderungen** |
| --- | --- |
| 2.1.10 | Die Version wurde für die Version 2.15.0 von Greengrass Nucleus aktualisiert. |
| 2.1.9 | Die Version wurde für die Version 2.14.0 von Greengrass Nucleus aktualisiert. |
| 2.1.8 | Die Version wurde für die Version 2.13.0 von Greengrass Nucleus aktualisiert. |
| 2.1.7 | Die Version wurde für die Version 2.12.0 von Greengrass Nucleus aktualisiert. |
| 2.1.6 | Die Version wurde für die Version 2.11.0 von Greengrass Nucleus aktualisiert. |
| 2.1.5 | Die Version wurde für die Version 2.10.0 von Greengrass Nucleus aktualisiert. |
| 2.1.4 | Die Version wurde für die Version 2.9.0 von Greengrass Nucleus aktualisiert. |
| 2.1.3 | Die Version wurde für die Version 2.8.0 von Greengrass Nucleus aktualisiert. |
| 2.1.2 | Die Version wurde für die Version 2.7.0 von Greengrass Nucleus aktualisiert. |
| 2.1.1 | Die Version wurde für die Version 2.6.0 von Greengrass Nucleus aktualisiert. |
| 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/kinesis-firehose-component.html) |
| 2.0.8 | Die Version wurde für die Version 2.5.0 von Greengrass Nucleus aktualisiert. |
| 2.0.7 | Die Version wurde für die Version 2.4.0 von Greengrass Nucleus aktualisiert. |
| 2.0.6 | Die Version wurde für die Version 2.3.0 von Greengrass Nucleus aktualisiert. |
| 2.0.5 | Die Version wurde für die Version 2.2.0 von Greengrass Nucleus aktualisiert. |
| 2.0.4 | Die Version wurde für die Version 2.1.0 von Greengrass Nucleus aktualisiert. |
| 2.0.3 | Erste Version |
## Weitere Informationen finden Sie auch unter
+ [Was ist Amazon Data Firehose?](https://docs.aws.amazon.com/firehose/latest/dev/what-is-this-service.html) im *Amazon Data Firehose Developer Guide*
# Lambda-Launcher
Die Lambda-Launcher-Komponente (`aws.greengrass.LambdaLauncher`) startet und stoppt AWS Lambda Funktionen auf AWS IoT Greengrass Kerngeräten. Diese Komponente richtet auch jegliche Containerisierung ein und führt Prozesse unter den von Ihnen angegebenen Benutzern aus.
**Anmerkung**
Wenn Sie eine Lambda-Funktionskomponente auf einem Kerngerät bereitstellen, umfasst die Bereitstellung auch diese Komponente. Weitere Informationen finden Sie unter [AWS Lambda Funktionen ausführen](run-lambda-functions.md).
**Topics**
+ [Versionen](#lambda-launcher-component-versions)
+ [Typ](#lambda-launcher-component-type)
+ [Betriebssystem](#lambda-launcher-component-os-support)
+ [Voraussetzungen](#lambda-launcher-component-requirements)
+ [Abhängigkeiten](#lambda-launcher-component-dependencies)
+ [Konfiguration](#lambda-launcher-component-configuration)
+ [Lokale Protokolldatei](#lambda-launcher-component-log-file)
+ [Änderungsprotokoll](#lambda-launcher-component-changelog)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 2.0.x
## Typ
Diese Komponente ist eine generische Komponente (`aws.greengrass.generic`). Der [Greengrass-Kern](greengrass-nucleus-component.md) führt die Lebenszyklusskripte der Komponente aus.
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## Betriebssystem
Diese Komponente kann nur auf Linux-Core-Geräten installiert werden.
## Voraussetzungen
Für diese Komponente gelten die folgenden Anforderungen:
+ Ihr Kerngerät muss die Anforderungen für die Ausführung von Lambda-Funktionen erfüllen. Wenn Sie möchten, dass das Kerngerät containerisierte Lambda-Funktionen ausführt, muss das Gerät die entsprechenden Anforderungen erfüllen. Weitere Informationen finden Sie unter [Anforderungen an die Lambda-Funktion](setting-up.md#greengrass-v2-lambda-requirements).
+ Die Lambda-Launcher-Komponente wird für die Ausführung in einer VPC unterstützt.
## Abhängigkeiten
Wenn Sie eine Komponente bereitstellen, stellt sie 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](#lambda-launcher-component-changelog) 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](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.
------
#### [ 2.0.11 – 2.0.13 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.0.11 bis 2.0.13 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Lambda-Manager](lambda-manager-component.md) | >=2.0.0 <2.4.0 | Hart |
------
#### [ 2.0.9 – 2.0.10 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.0.9 bis 2.0.10 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Lambda-Manager](lambda-manager-component.md) | >=2.0.0 <2.3.0 | Hart |
------
#### [ 2.0.4 - 2.0.8 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.0.4 bis 2.0.8 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Lambda-Manager](lambda-manager-component.md) | >=2.0.0 <2.2.0 | Hart |
------
#### [ 2.0.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Lambda-Manager](lambda-manager-component.md) | >=2.0.3 <2.1.0 | Hart |
------
[Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den Komponentenrezepten.](component-recipe-reference.md#recipe-reference-component-dependencies)
## Konfiguration
Diese Komponente hat keine Konfigurationsparameter.
## Lokale Protokolldatei
Diese Komponente verwendet die folgende Protokolldatei.
```
/greengrass/v2/logs/lambdaFunctionComponentName.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. `/greengrass/v2`Ersetzen Sie durch den Pfad zum AWS IoT Greengrass Stammordner und *lambdaFunctionComponentName* durch den Namen der Lambda-Funktionskomponente, die diese Komponente startet.
```
sudo tail -f /greengrass/v2/logs/lambdaFunctionComponentName.log
```
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| **Version** | **Änderungen** |
| --- | --- |
| 2.0.13 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/lambda-launcher-component.html) |
| 2.0.12 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/lambda-launcher-component.html) |
| 2.0.11 | Support für Lambda Manager 2.3.0. |
| 2.0.10 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/lambda-launcher-component.html) |
| 2.0.9 | Die Version wurde für die Version 2.5.0 von Greengrass Nucleus aktualisiert. |
| 2.0.8 | Die Version wurde für die Version 2.4.0 von Greengrass Nucleus aktualisiert. |
| 2.0.7 | Die Version wurde für die Version 2.3.0 von Greengrass Nucleus aktualisiert. |
| 2.0.6 | Allgemeine Leistungssteigerungen und Bugfixes. |
| 2.0.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/lambda-launcher-component.html) |
| 2.0.3 | Erste Version |
# Lambda-Manager
Die Lambda-Manager-Komponente (`aws.greengrass.LambdaManager`) verwaltet Arbeitselemente und die Interprozesskommunikation für AWS Lambda Funktionen, die auf dem Greengrass-Core-Gerät ausgeführt werden.
**Anmerkung**
Wenn Sie eine Lambda-Funktionskomponente auf einem Kerngerät bereitstellen, umfasst die Bereitstellung auch diese Komponente. Weitere Informationen finden Sie unter [AWS Lambda Funktionen ausführen](run-lambda-functions.md).
**Topics**
+ [Versionen](#lambda-manager-component-versions)
+ [Betriebssystem](#lambda-manager-component-os-support)
+ [Typ](#lambda-manager-component-type)
+ [Voraussetzungen](#lambda-manager-component-requirements)
+ [Abhängigkeiten](#lambda-manager-component-dependencies)
+ [Konfiguration](#lambda-manager-component-configuration)
+ [Lokale Protokolldatei](#lambda-manager-component-log-file)
+ [Änderungsprotokoll](#lambda-manager-component-changelog)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 2.3.x
+ 2.2.x
+ 2.1.x
+ 2.0.x
## Betriebssystem
Diese Komponente kann nur auf Linux-Core-Geräten installiert werden.
## Typ
Diese Komponente ist eine Plugin-Komponente (`aws.greengrass.plugin`). Der [Greengrass-Kern führt diese Komponente in derselben Java Virtual Machine (JVM) wie der Nucleus](greengrass-nucleus-component.md) aus. Der Nucleus wird neu gestartet, wenn Sie die Version dieser Komponente auf dem Core-Gerät ändern.
Diese Komponente verwendet dieselbe Protokolldatei wie der Greengrass-Kern. Weitere Informationen finden Sie unter [AWS IoT Greengrass Protokolle überwachen](monitor-logs.md).
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## Voraussetzungen
Für diese Komponente gelten die folgenden Anforderungen:
+ Ihr Kerngerät muss die Anforderungen für die Ausführung von Lambda-Funktionen erfüllen. Wenn Sie möchten, dass das Kerngerät containerisierte Lambda-Funktionen ausführt, muss das Gerät die entsprechenden Anforderungen erfüllen. Weitere Informationen finden Sie unter [Anforderungen an die Lambda-Funktion](setting-up.md#greengrass-v2-lambda-requirements).
+ Die Lambda-Manager-Komponente wird für die Ausführung in einer VPC unterstützt.
## Abhängigkeiten
Wenn Sie eine Komponente bereitstellen, stellt sie 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](#lambda-manager-component-changelog) 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](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.
------
#### [ 2.3.7 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.3.7 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.17.0 | Weich |
------
#### [ 2.3.6 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.3.6 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.16.0 | Weich |
------
#### [ 2.3.5 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.3.5 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.15.0 | Weich |
------
#### [ 2.3.4 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.3.4 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.14.0 | Weich |
------
#### [ 2.3.2 and 2.3.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.3.2 und 2.3.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Weich |
------
#### [ 2.2.10 and 2.3.1 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.2.10 und 2.3.1 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Weich |
------
#### [ 2.2.8 and 2.2.9 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.2.8 und 2.2.9 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Weich |
------
#### [ 2.2.7 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.2.7 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Weich |
------
#### [ 2.2.6 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.2.6 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Weich |
------
#### [ 2.2.5 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.2.5 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Weich |
------
#### [ 2.2.4 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.2.4 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Weich |
------
#### [ 2.2.1 - 2.2.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.2.1 bis 2.2.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Weich |
------
#### [ 2.2.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.2.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,5,0 <2,6,0 | Weich |
------
#### [ 2.1.3 and 2.1.4 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.1.3 und 2.1.4 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Weich |
------
#### [ 2.1.2 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.2 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Weich |
------
#### [ 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](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Weich |
------
#### [ 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](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Weich |
------
#### [ 2.0.x ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.x dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.3 <2.1.0 | Weich |
------
[Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den Komponentenrezepten.](component-recipe-reference.md#recipe-reference-component-dependencies)
## Konfiguration
Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.
`logHandlerMode`
Nur für Lambda Manager-Versionen 2.3.0 und höher
Wird verwendet, um die zu verwendende Implementierung des Lambda-Log-Managers auszuwählen. Setzen Sie den Wert auf, `optimized` um weniger Threads zum Lesen von Lambda-Logs zu verwenden.
`getResultTimeoutInSecond`
(Optional) Die maximale Zeit in Sekunden, die Lambda-Funktionen ausgeführt werden können, bevor ihr Timeout eintritt.
Standard: `60`
## Lokale Protokolldatei
Diese Komponente verwendet dieselbe Protokolldatei wie die [Greengrass Nucleus-Komponente](greengrass-nucleus-component.md).
```
/greengrass/v2/logs/greengrass.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. `/greengrass/v2`Ersetzen Sie durch den Pfad zum AWS IoT Greengrass Stammordner.
```
sudo tail -f /greengrass/v2/logs/greengrass.log
```
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| **Version** | **Änderungen** |
| --- | --- |
| 2.3.7 | Die Version wurde für die Version 2.16.0 von Greengrass Nucleus aktualisiert. |
| 2.3.6 | Die Version wurde für die Version 2.15.0 von Greengrass Nucleus aktualisiert. |
| 2.3.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/lambda-manager-component.html) |
| 2.3.4 | Die Version wurde für die Version 2.13.0 von Greengrass Nucleus aktualisiert. |
| 2.3.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/lambda-manager-component.html) |
| 2.3.2 | Die Version wurde für die Version 2.12.0 von Greengrass Nucleus aktualisiert. |
| 2.3.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/lambda-manager-component.html) |
| 2.3.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/lambda-manager-component.html) |
| 2.2.11 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/lambda-manager-component.html) |
| 2.2.10 | Die Version wurde für die Version 2.11.0 von Greengrass Nucleus aktualisiert. |
| 2.2.9 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/lambda-manager-component.html) |
| 2.2.8 | Die Version wurde für die Version 2.10.0 von Greengrass Nucleus aktualisiert. |
| 2.2.7 | Die Version wurde für die Version 2.9.0 von Greengrass Nucleus aktualisiert. |
| 2.2.6 | Die Version wurde für die Version 2.8.0 von Greengrass Nucleus aktualisiert. |
| 2.2.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/lambda-manager-component.html) |
| 2.2.4 | Die Version wurde für die Version 2.6.0 von Greengrass Nucleus aktualisiert. |
| 2.2.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/lambda-manager-component.html) |
| 2.2.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/lambda-manager-component.html) |
| 2.2.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/lambda-manager-component.html) |
| 2.2.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/lambda-manager-component.html) |
| 2.1.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/lambda-manager-component.html) |
| 2.1.3 | Die Version wurde für die Version 2.4.0 von Greengrass Nucleus aktualisiert. |
| 2.1.2 | Die Version wurde für die Version 2.3.0 von Greengrass Nucleus aktualisiert. |
| 2.1.1 | Die Version wurde für die Version 2.2.0 von Greengrass Nucleus aktualisiert. |
| 2.1.0 | Die Version wurde für die Version 2.1.0 von Greengrass Nucleus aktualisiert. |
| 2.0.3 | Erste Version |
# Lambda-Laufzeiten
Die Lambda-Laufzeitkomponente (`aws.greengrass.LambdaRuntimes`) stellt die Laufzeiten bereit, die Greengrass-Kerngeräte zum Ausführen von Funktionen verwenden. AWS Lambda
**Anmerkung**
Wenn Sie eine Lambda-Funktionskomponente auf einem Kerngerät bereitstellen, umfasst die Bereitstellung auch diese Komponente. Weitere Informationen finden Sie unter [AWS Lambda Funktionen ausführen](run-lambda-functions.md).
**Topics**
+ [Versionen](#lambda-runtimes-component-versions)
+ [Typ](#lambda-runtimes-component-type)
+ [Betriebssystem](#lambda-runtimes-component-os-support)
+ [Voraussetzungen](#lambda-runtimes-component-requirements)
+ [Abhängigkeiten](#lambda-runtimes-component-dependencies)
+ [Konfiguration](#lambda-runtimes-component-configuration)
+ [Lokale Protokolldatei](#lambda-runtimes-component-log-file)
+ [Änderungsprotokoll](#lambda-runtimes-component-changelog)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 2.0.x
## Typ
Diese Komponente ist eine generische Komponente (`aws.greengrass.generic`). Der [Greengrass-Kern](greengrass-nucleus-component.md) führt die Lebenszyklusskripte der Komponente aus.
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## Betriebssystem
Diese Komponente kann nur auf Linux-Core-Geräten installiert werden.
## Voraussetzungen
Für diese Komponente gelten die folgenden Anforderungen:
+ Ihr Kerngerät muss die Anforderungen für die Ausführung von Lambda-Funktionen erfüllen. Wenn Sie möchten, dass das Kerngerät containerisierte Lambda-Funktionen ausführt, muss das Gerät die entsprechenden Anforderungen erfüllen. Weitere Informationen finden Sie unter [Anforderungen an die Lambda-Funktion](setting-up.md#greengrass-v2-lambda-requirements).
+ Die Lambda-Laufzeitkomponente wird für die Ausführung in einer VPC unterstützt.
## Abhängigkeiten
Diese Komponente hat keine Abhängigkeiten.
## Konfiguration
Diese Komponente hat keine Konfigurationsparameter.
## Lokale Protokolldatei
Diese Komponente gibt keine Protokolle aus.
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| **Version** | **Änderungen** |
| --- | --- |
| 2.0.9 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/lambda-runtimes-component.html) |
| 2.0.8 | Die Version wurde für die Version 2.5.0 von Greengrass Nucleus aktualisiert. |
| 2.0.7 | Die Version wurde für die Version 2.4.0 von Greengrass Nucleus aktualisiert. |
| 2.0.6 | Die Version wurde für die Version 2.3.0 von Greengrass Nucleus aktualisiert. |
| 2.0.5 | Die Version wurde für die Version 2.2.0 von Greengrass Nucleus aktualisiert. |
| 2.0.4 | Die Version wurde für die Version 2.1.0 von Greengrass Nucleus aktualisiert. |
| 2.0.3 | Erste Version |
# Legacy-Abonnement-Router
Der ältere Abonnement-Router (`aws.greengrass.LegacySubscriptionRouter`) verwaltet Abonnements auf dem Greengrass-Core-Gerät. Abonnements sind eine Funktion von AWS IoT Greengrass V1, die die Themen definiert, die Lambda-Funktionen für MQTT-Messaging auf einem Kerngerät verwenden können. Weitere Informationen finden Sie unter [Verwaltete Abonnements im MQTT-Messaging-Workflow](https://docs.aws.amazon.com/greengrass/v1/developerguide/gg-sec.html#gg-msg-workflow) im *AWS IoT Greengrass V1-Entwicklerhandbuch*.
Sie können diese Komponente verwenden, um Abonnements für Connector-Komponenten und Lambda-Funktionskomponenten zu aktivieren, die das AWS IoT Greengrass Core SDK verwenden.
**Anmerkung**
Die ältere Abonnement-Router-Komponente ist nur erforderlich, wenn Ihre Lambda-Funktion die `publish()` Funktion im AWS IoT Greengrass Core SDK verwendet. Wenn Sie Ihren Lambda-Funktionscode aktualisieren, um die IPC-Schnittstelle (Interprocess Communication) in AWS IoT Device SDK V2 zu verwenden, müssen Sie die ältere Abonnement-Router-Komponente nicht bereitstellen. Weitere Informationen finden Sie in den folgenden [Interprozesskommunikationsdiensten](interprocess-communication.md):
[Lokale Nachrichten veröffentlichen/abonnieren](ipc-publish-subscribe.md)
[MQTT-Nachrichten veröffentlichen/abonnieren AWS IoT Core](ipc-iot-core-mqtt.md)
**Topics**
+ [Versionen](#legacy-subscription-router-component-versions)
+ [Typ](#legacy-subscription-router-component-type)
+ [Betriebssystem](#legacy-subscription-router-component-os-support)
+ [Voraussetzungen](#legacy-subscription-router-component-requirements)
+ [Abhängigkeiten](#legacy-subscription-router-component-dependencies)
+ [Konfiguration](#legacy-subscription-router-component-configuration)
+ [Lokale Protokolldatei](#legacy-subscription-router-component-log-file)
+ [Änderungsprotokoll](#legacy-subscription-router-component-changelog)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 2.1.x
+ 2.0.x
## Typ
Diese Komponente ist eine generische Komponente (`aws.greengrass.generic`). Der [Greengrass-Kern](greengrass-nucleus-component.md) führt die Lebenszyklusskripte der Komponente aus.
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## Betriebssystem
Diese Komponente kann nur auf Linux-Core-Geräten installiert werden.
## Voraussetzungen
Für diese Komponente gelten die folgenden Anforderungen:
+ Der ältere Abonnement-Router wird für die Ausführung in einer VPC unterstützt.
## Abhängigkeiten
Wenn Sie eine Komponente bereitstellen, stellt er 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](#legacy-subscription-router-component-changelog) 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](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.
------
#### [ 2.1.15 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.15 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.17.0 | Weich |
------
#### [ 2.1.14 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.14 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.16.0 | Weich |
------
#### [ 2.1.13 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.13 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.15.0 | Weich |
------
#### [ 2.1.12 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.12 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.14.0 | Weich |
------
#### [ 2.1.11 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.11 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Weich |
------
#### [ 2.1.10 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.10 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Weich |
------
#### [ 2.1.9 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.9 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Weich |
------
#### [ 2.1.8 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.8 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Weich |
------
#### [ 2.1.7 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.7 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Weich |
------
#### [ 2.1.6 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.6 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Weich |
------
#### [ 2.1.5 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.5 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Weich |
------
#### [ 2.1.4 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.4 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Weich |
------
#### [ 2.1.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Weich |
------
#### [ 2.1.2 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.2 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Weich |
------
#### [ 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](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Weich |
------
#### [ 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](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Weich |
------
#### [ 2.0.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.3 <2.1.0 | Weich |
------
[Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den Komponentenrezepten.](component-recipe-reference.md#recipe-reference-component-dependencies)
## Konfiguration
Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.
------
#### [ v2.1.x ]
`subscriptions`
(Optional) Die Abonnements, die auf dem Kerngerät aktiviert werden sollen. Dabei handelt es sich um ein Objekt, bei dem jeder Schlüssel eine eindeutige ID ist und jeder Wert ein Objekt ist, das das Abonnement für diesen Connector definiert. Sie müssen ein Abonnement konfigurieren, wenn Sie eine V1-Connectorkomponente oder eine Lambda-Funktion bereitstellen, die das AWS IoT Greengrass Core SDK verwendet.
Jedes Abonnementobjekt enthält die folgenden Informationen:
`id`
Die eindeutige ID dieses Abonnements. Diese ID muss mit dem Schlüssel für dieses Abonnementobjekt übereinstimmen.
`source`
Die Lambda-Funktion, die das AWS IoT Greengrass Core SDK verwendet, um MQTT-Nachrichten zu den Themen zu veröffentlichen, die Sie in angeben. `subject` Geben Sie eines der folgenden Elemente an:
+ Der Name einer Lambda-Funktionskomponente auf dem Kerngerät. Geben Sie den Komponentennamen mit dem `component:` Präfix an, z. B. **component:com.example.HelloWorldLambda**
+ Der Amazon-Ressourcenname (ARN) einer Lambda-Funktion auf dem Kerngerät.
**Wichtig**
Wenn sich die Version der Lambda-Funktion ändert, müssen Sie das Abonnement mit der neuen Version der Funktion konfigurieren. Andernfalls leitet diese Komponente die Nachrichten erst weiter, wenn die Version dem Abonnement entspricht.
Sie müssen einen Amazon-Ressourcennamen (ARN) angeben, der die Version der zu importierenden Funktion enthält. Sie können keine Versions-Aliase wie `$LATEST` verwenden.
Um ein Abonnement für eine V1-Connector-Komponente bereitzustellen, geben Sie den Namen der Komponente oder den ARN der Lambda-Funktion der Connector-Komponente an.
`subject`
Das MQTT-Thema oder der Themenfilter, auf dem Quelle und Ziel Nachrichten veröffentlichen und empfangen können. Dieser Wert unterstützt die Platzhalter `+` und `#` Topic.
`target`
Das Ziel, das die MQTT-Nachrichten zu den Themen empfängt, die Sie in angeben. `subject` Das Abonnement gibt an, dass die `source` Funktion MQTT-Nachrichten an AWS IoT Core oder an eine Lambda-Funktion auf dem Kerngerät veröffentlicht. Geben Sie eines der folgenden Elemente an:
+ `cloud`. Die `source` Funktion veröffentlicht MQTT-Nachrichten an AWS IoT Core.
+ Der Name einer Lambda-Funktionskomponente auf dem Kerngerät. Geben Sie den Komponentennamen mit dem `component:` Präfix an, z. B. **component:com.example.HelloWorldLambda**
+ Der Amazon-Ressourcenname (ARN) einer Lambda-Funktion auf dem Kerngerät.
**Wichtig**
Wenn sich die Version der Lambda-Funktion ändert, müssen Sie das Abonnement mit der neuen Version der Funktion konfigurieren. Andernfalls leitet diese Komponente die Nachrichten erst weiter, wenn die Version dem Abonnement entspricht.
Sie müssen einen Amazon-Ressourcennamen (ARN) angeben, der die Version der zu importierenden Funktion enthält. Sie können keine Versions-Aliase wie `$LATEST` verwenden.
Standard: Keine Abonnements
**Example Beispiel für ein Konfigurationsupdate (Definition eines Abonnements für AWS IoT Core)**
Das folgende Beispiel spezifiziert, dass die `com.example.HelloWorldLambda` Lambda-Funktionskomponente eine MQTT-Nachricht zu diesem AWS IoT Core Thema veröffentlicht. `hello/world`
```
{
"subscriptions": {
"Greengrass_HelloWorld_to_cloud": {
"id": "Greengrass_HelloWorld_to_cloud",
"source": "component:com.example.HelloWorldLambda",
"subject": "hello/world",
"target": "cloud"
}
}
}
```
**Example Beispiel für ein Konfigurationsupdate (Definition eines Abonnements für eine andere Lambda-Funktion)**
Das folgende Beispiel spezifiziert, dass die `com.example.HelloWorldLambda` Lambda-Funktionskomponente MQTT-Nachrichten zu diesem Thema an die `com.example.MessageRelay` Lambda-Funktionskomponente veröffentlicht. `hello/world`
```
{
"subscriptions": {
"Greengrass_HelloWorld_to_MessageRelay": {
"id": "Greengrass_HelloWorld_to_MessageRelay",
"source": "component:com.example.HelloWorldLambda",
"subject": "hello/world",
"target": "component:com.example.MessageRelay"
}
}
}
```
------
#### [ v2.0.x ]
`subscriptions`
(Optional) Die Abonnements, die auf dem Core-Gerät aktiviert werden sollen. Dabei handelt es sich um ein Objekt, bei dem jeder Schlüssel eine eindeutige ID ist und jeder Wert ein Objekt ist, das das Abonnement für diesen Connector definiert. Sie müssen ein Abonnement konfigurieren, wenn Sie eine V1-Connectorkomponente oder eine Lambda-Funktion bereitstellen, die das AWS IoT Greengrass Core SDK verwendet.
Jedes Abonnementobjekt enthält die folgenden Informationen:
`id`
Die eindeutige ID dieses Abonnements. Diese ID muss mit dem Schlüssel für dieses Abonnementobjekt übereinstimmen.
`source`
Die Lambda-Funktion, die das AWS IoT Greengrass Core SDK verwendet, um MQTT-Nachrichten zu den Themen zu veröffentlichen, die Sie in angeben. `subject` Machen Sie folgende Angaben:
+ Der Amazon-Ressourcenname (ARN) einer Lambda-Funktion auf dem Kerngerät.
**Wichtig**
Wenn sich die Version der Lambda-Funktion ändert, müssen Sie das Abonnement mit der neuen Version der Funktion konfigurieren. Andernfalls leitet diese Komponente die Nachrichten erst weiter, wenn die Version dem Abonnement entspricht.
Sie müssen einen Amazon-Ressourcennamen (ARN) angeben, der die Version der zu importierenden Funktion enthält. Sie können keine Versions-Aliase wie `$LATEST` verwenden.
Um ein Abonnement für eine V1-Connector-Komponente bereitzustellen, geben Sie den ARN der Lambda-Funktion der Connector-Komponente an.
`subject`
Das MQTT-Thema oder der Themenfilter, auf dem Quelle und Ziel Nachrichten veröffentlichen und empfangen können. Dieser Wert unterstützt die Platzhalter `+` und `#` Topic.
`target`
Das Ziel, das die MQTT-Nachrichten zu den Themen empfängt, die Sie in angeben. `subject` Das Abonnement gibt an, dass die `source` Funktion MQTT-Nachrichten an AWS IoT Core oder an eine Lambda-Funktion auf dem Kerngerät veröffentlicht. Geben Sie eines der folgenden Elemente an:
+ `cloud`. Die `source` Funktion veröffentlicht MQTT-Nachrichten an AWS IoT Core.
+ Der Amazon-Ressourcenname (ARN) einer Lambda-Funktion auf dem Kerngerät.
**Wichtig**
Wenn sich die Version der Lambda-Funktion ändert, müssen Sie das Abonnement mit der neuen Version der Funktion konfigurieren. Andernfalls leitet diese Komponente die Nachrichten erst weiter, wenn die Version dem Abonnement entspricht.
Sie müssen einen Amazon-Ressourcennamen (ARN) angeben, der die Version der zu importierenden Funktion enthält. Sie können keine Versions-Aliase wie `$LATEST` verwenden.
Standard: Keine Abonnements
**Example Beispiel für ein Konfigurationsupdate (Definition eines Abonnements für AWS IoT Core)**
Das folgende Beispiel gibt an, dass die `Greengrass_HelloWorld` Funktion eine MQTT-Nachricht zu AWS IoT Core `hello/world` diesem Thema veröffentlicht.
```
"subscriptions": {
"Greengrass_HelloWorld_to_cloud": {
"id": "Greengrass_HelloWorld_to_cloud",
"source": "arn:aws:lambda:us-west-2:123456789012:function:Greengrass_HelloWorld:5",
"subject": "hello/world",
"target": "cloud"
}
}
```
**Example Beispiel für ein Konfigurationsupdate (Definition eines Abonnements für eine andere Lambda-Funktion)**
Das folgende Beispiel spezifiziert, dass die `Greengrass_HelloWorld` Funktion MQTT-Nachrichten zu diesem Thema `Greengrass_MessageRelay` an die `hello/world` veröffentlicht.
```
"subscriptions": {
"Greengrass_HelloWorld_to_MessageRelay": {
"id": "Greengrass_HelloWorld_to_MessageRelay",
"source": "arn:aws:lambda:us-west-2:123456789012:function:Greengrass_HelloWorld:5",
"subject": "hello/world",
"target": "arn:aws:lambda:us-west-2:123456789012:function:Greengrass_MessageRelay:5"
}
}
```
------
## Lokale Protokolldatei
Diese Komponente gibt keine Protokolle aus.
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| Version | Änderungen |
| --- | --- |
| 2.1.15 | Die Version wurde für die Version 2.16.0 von Greengrass Nucleus aktualisiert. |
| 2.1.14 | Die Version wurde für die Version 2.15.0 von Greengrass Nucleus aktualisiert. |
| 2.1.13 | Die Version wurde für die Version 2.14.0 von Greengrass Nucleus aktualisiert. |
| 2.1.12 | Die Version wurde für die Version 2.13.0 von Greengrass Nucleus aktualisiert. |
| 2.1.11 | Die Version wurde für die Version 2.12.0 von Greengrass Nucleus aktualisiert. |
| 2.1.10 | Die Version wurde für die Version 2.11.0 von Greengrass Nucleus aktualisiert. |
| 2.1.9 | Die Version wurde für die Version 2.10.0 von Greengrass Nucleus aktualisiert. |
| 2.1.8 | Die Version wurde für die Version 2.9.0 von Greengrass Nucleus aktualisiert. |
| 2.1.7 | Die Version wurde für die Version 2.8.0 von Greengrass Nucleus aktualisiert. |
| 2.1.6 | Die Version wurde für die Version 2.7.0 von Greengrass Nucleus aktualisiert. |
| 2.1.5 | Die Version wurde für die Version 2.6.0 von Greengrass Nucleus aktualisiert. |
| 2.1.4 | Die Version wurde für die Version 2.5.0 von Greengrass Nucleus aktualisiert. |
| 2.1.3 | Die Version wurde für die Version 2.4.0 von Greengrass Nucleus aktualisiert. |
| 2.1.2 | Die Version wurde für die Version 2.3.0 von Greengrass Nucleus aktualisiert. |
| 2.1.1 | Die Version wurde für die Version 2.2.0 von Greengrass Nucleus aktualisiert. |
| 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/legacy-subscription-router-component.html) |
| 2.0.3 | Erste Version |
# Lokale Debug-Konsole
Die lokale Debug-Konsolenkomponente (`aws.greengrass.LocalDebugConsole`) bietet ein lokales Dashboard, das Informationen über Ihre AWS IoT Greengrass Kerngeräte und deren Komponenten anzeigt. Sie können dieses Dashboard verwenden, um Ihr Kerngerät zu debuggen und lokale Komponenten zu verwalten.
**Wichtig**
Wir empfehlen, diese Komponente nur in Entwicklungsumgebungen und nicht in Produktionsumgebungen zu verwenden. Diese Komponente bietet Zugriff auf Informationen und Operationen, die Sie in einer Produktionsumgebung normalerweise nicht benötigen. Folgen Sie dem Prinzip der geringsten Rechte, indem Sie diese Komponente nur dort einsetzen, wo Sie sie benötigen.
**Topics**
+ [Versionen](#local-debug-console-component-versions)
+ [Typ](#local-debug-console-component-type)
+ [Betriebssystem](#local-debug-console-component-os-support)
+ [Voraussetzungen](#local-debug-console-component-requirements)
+ [Abhängigkeiten](#local-debug-console-component-dependencies)
+ [Konfiguration](#local-debug-console-component-configuration)
+ [Usage](#local-debug-console-component-usage)
+ [Lokale Protokolldatei](#local-debug-console-component-log-file)
+ [Änderungsprotokoll](#local-debug-console-component-changelog)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 2.4.x
+ 2.3.x
+ 2.2.x
+ 2.1.x
+ 2.0.x
## Typ
Diese Komponente ist eine Plugin-Komponente (`aws.greengrass.plugin`). Der [Greengrass-Kern führt diese Komponente in derselben Java Virtual Machine (JVM) wie der Nucleus](greengrass-nucleus-component.md) aus. Der Nucleus wird neu gestartet, wenn Sie die Version dieser Komponente auf dem Core-Gerät ändern.
Diese Komponente verwendet dieselbe Protokolldatei wie der Greengrass-Kern. Weitere Informationen finden Sie unter [AWS IoT Greengrass Protokolle überwachen](monitor-logs.md).
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## 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:
+ Sie verwenden einen Benutzernamen und ein Passwort, um sich beim Dashboard anzumelden. Der Benutzername, der lautet`debug`, wird Ihnen zur Verfügung gestellt. Sie müssen die AWS IoT Greengrass CLI verwenden, um ein temporäres Passwort zu erstellen, das Sie beim Dashboard auf einem Core-Gerät authentifiziert. Sie müssen in der Lage sein, die AWS IoT Greengrass CLI zu verwenden, um die lokale Debug-Konsole zu verwenden. Weitere Informationen finden Sie in den [Greengrass-CLI-Anforderungen](greengrass-cli-component.md#greengrass-cli-component-requirements). Weitere Informationen zum Generieren des Kennworts und zur Anmeldung finden Sie unter Verwendung der [lokalen Debug-Konsolenkomponente](#local-debug-console-component-usage).
+ Die lokale Debug-Konsolenkomponente wird für die Ausführung in einer VPC unterstützt.
## Abhängigkeiten
Wenn Sie eine Komponente bereitstellen, stellt sie 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](#local-debug-console-component-changelog) 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](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.
------
#### [ 2.4.6 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.4.6 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.10.0 <2.17.0 | Hart |
| [Greengrass CLI](greengrass-cli-component.md) | >=2.10.0 <2.17.0 | Hart |
------
#### [ 2.4.5 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.4.5 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.10.0 <2.16.0 | Hart |
| [Greengrass CLI](greengrass-cli-component.md) | >=2.10.0 <2.16.0 | Hart |
------
#### [ 2.4.4 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.4.4 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.10.0 <2.15.0 | Hart |
| [Greengrass CLI](greengrass-cli-component.md) | >=2.10.0 <2.15.0 | Hart |
------
#### [ 2.4.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.4.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.10.0 <2.14.0 | Hart |
| [Greengrass CLI](greengrass-cli-component.md) | >=2.10.0 <2.14.0 | Hart |
------
#### [ 2.4.1 – 2.4.2 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.4.1 bis 2.4.2 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.10.0 <2.13.0 | Hart |
| [Greengrass CLI](greengrass-cli-component.md) | >=2.10.0 <2.13.0 | Hart |
------
#### [ 2.4.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.4.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.10.0 <2.12.0 | Hart |
| [Greengrass CLI](greengrass-cli-component.md) | >=2.10.0 <2.12.0 | Hart |
------
#### [ 2.3.0 and 2.3.1 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.3.0 und 2.3.1 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.10.0 <2.12.0 | Hart |
| [Greengrass CLI](greengrass-cli-component.md) | >=2.10.0 <2.12.0 | Hart |
------
#### [ 2.2.9 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.2.9 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.1.0 <2.12.0 | Hart |
| [Greengrass CLI](greengrass-cli-component.md) | >=2.1.0 <2.12.0 | Hart |
------
#### [ 2.2.8 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.2.8 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.1.0 <2.11.0 | Hart |
| [Greengrass CLI](greengrass-cli-component.md) | >=2.1.0 <2.11.0 | Hart |
------
#### [ 2.2.7 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.2.7 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.1.0 <2.10.0 | Hart |
| [Greengrass CLI](greengrass-cli-component.md) | >=2.1.0 <2.10.0 | Hart |
------
#### [ 2.2.6 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.2.6 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.1.0 <2.9.0 | Hart |
| [Greengrass CLI](greengrass-cli-component.md) | >=2.1.0 <2.9.0 | Hart |
------
#### [ 2.2.5 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.2.5 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.1.0 <2.8.0 | Hart |
| [Greengrass CLI](greengrass-cli-component.md) | >=2.1.0 <2.8.0 | Hart |
------
#### [ 2.2.4 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.2.4 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.1.0 <2.7.0 | Hart |
| [Greengrass CLI](greengrass-cli-component.md) | >=2.1.0 <2.7.0 | Hart |
------
#### [ 2.2.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.2.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.1.0 <2.6.0 | Hart |
| [Greengrass CLI](greengrass-cli-component.md) | >=2.1.0 <2.6.0 | Hart |
------
#### [ 2.2.2 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.2.2 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.1.0 <2.5.0 | Hart |
| [Greengrass CLI](greengrass-cli-component.md) | >=2.1.0 <2.5.0 | Hart |
------
#### [ 2.2.1 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.2.1 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.1.0 <2.4.0 | Hart |
| [Greengrass CLI](greengrass-cli-component.md) | >=2.1.0 <2.4.0 | Hart |
------
#### [ 2.2.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.2.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.1.0 <2.3.0 | Hart |
| [Greengrass CLI](greengrass-cli-component.md) | >=2.1.0 <2.3.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](greengrass-nucleus-component.md) | >=2.1.0 <2.2.0 | Hart |
| [Greengrass CLI](greengrass-cli-component.md) | >=2.1.0 <2.2.0 | Hart |
------
#### [ 2.0.x ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.x dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.3 <2.1.0 | Weich |
| [Greengrass CLI](greengrass-cli-component.md) | >=2.0.3 <2.1.0 | Weich |
------
[Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den Komponentenrezepten.](component-recipe-reference.md#recipe-reference-component-dependencies)
## Konfiguration
Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.
------
#### [ v2.1.x - v2.4.x ]
`httpsEnabled`
(Optional) Sie können die HTTPS-Kommunikation für die lokale Debug-Konsole aktivieren. Wenn Sie die HTTPS-Kommunikation aktivieren, erstellt die lokale Debug-Konsole ein selbstsigniertes Zertifikat. Webbrowser zeigen Sicherheitswarnungen für Websites an, die selbstsignierte Zertifikate verwenden. Sie müssen das Zertifikat daher manuell überprüfen. Dann können Sie die Warnung umgehen. Weitere Informationen finden Sie unter [Usage](#local-debug-console-component-usage).
Standard: `true`
`port`
(Optional) Der Port, an dem die lokale Debug-Konsole bereitgestellt werden soll.
Standard: `1441`
`websocketPort`
(Optional) Der Websocket-Port, der für die lokale Debug-Konsole verwendet werden soll.
Standard: `1442`
`bindHostname`
(Optional) Der Hostname, der für die lokale Debug-Konsole verwendet werden soll.
Wenn Sie [die AWS IoT Greengrass Core-Software in einem Docker-Container ausführen](run-greengrass-docker.md), setzen Sie diesen Parameter auf`0.0.0.0`, damit Sie die lokale Debug-Konsole außerhalb des Docker-Containers öffnen können.
Standard: `localhost`
**Example Beispiel: Update zur Zusammenführung von Konfigurationen**
Die folgende Beispielkonfiguration legt fest, dass die lokale Debug-Konsole an nicht standardmäßigen Ports geöffnet und HTTPS deaktiviert werden soll.
```
{
"httpsEnabled": false,
"port": "10441",
"websocketPort": "10442"
}
```
------
#### [ v2.0.x ]
`port`
(Optional) Der Port, an dem die lokale Debug-Konsole bereitgestellt werden soll.
Standard: `1441`
`websocketPort`
(Optional) Der Websocket-Port, der für die lokale Debug-Konsole verwendet werden soll.
Standard: `1442`
`bindHostname`
(Optional) Der Hostname, der für die lokale Debug-Konsole verwendet werden soll.
Wenn Sie [die AWS IoT Greengrass Core-Software in einem Docker-Container ausführen](run-greengrass-docker.md), setzen Sie diesen Parameter auf`0.0.0.0`, damit Sie die lokale Debug-Konsole außerhalb des Docker-Containers öffnen können.
Standard: `localhost`
**Example Beispiel: Update zur Zusammenführung von Konfigurationen**
Die folgende Beispielkonfiguration legt fest, dass die lokale Debug-Konsole auf nicht standardmäßigen Ports geöffnet werden soll.
```
{
"port": "10441",
"websocketPort": "10442"
}
```
------
## Usage
Um die lokale Debug-Konsole zu verwenden, erstellen Sie eine Sitzung über die Greengrass-CLI. Wenn Sie eine Sitzung erstellen, stellt die Greengrass-CLI einen Benutzernamen und ein temporäres Passwort bereit, mit denen Sie sich bei der lokalen Debug-Konsole anmelden können.
Folgen Sie diesen Anweisungen, um die lokale Debug-Konsole auf Ihrem Core-Gerät oder auf Ihrem Entwicklungscomputer zu öffnen.
------
#### [ v2.1.x - v2.4.x ]
In den Versionen 2.1.0 und höher verwendet die lokale Debug-Konsole standardmäßig HTTPS. Wenn HTTPS aktiviert ist, erstellt die lokale Debug-Konsole ein selbstsigniertes Zertifikat, um die Verbindung zu sichern. Ihr Webbrowser zeigt aufgrund dieses selbstsignierten Zertifikats eine Sicherheitswarnung an, wenn Sie die lokale Debug-Konsole öffnen. Wenn Sie eine Sitzung mit der Greengrass-CLI erstellen, enthält die Ausgabe die Fingerabdrücke des Zertifikats, sodass Sie überprüfen können, ob das Zertifikat legitim und die Verbindung sicher ist.
Sie können HTTPS deaktivieren. Weitere Informationen finden Sie unter [Konfiguration der lokalen Debug-Konsole](#local-debug-console-component-configuration).
**So öffnen Sie die lokale Debug-Konsole**
1. (Optional) Um die lokale Debug-Konsole auf Ihrem Entwicklungscomputer anzuzeigen, können Sie den Port der Konsole über SSH weiterleiten. Sie müssen die `AllowTcpForwarding` Option jedoch zuerst in der SSH-Konfigurationsdatei Ihres Kerngeräts aktivieren. Diese Option ist standardmäßig aktiviert. Führen Sie den folgenden Befehl auf Ihrem Entwicklungscomputer aus, um das Dashboard `localhost:1441` auf Ihrem Entwicklungscomputer anzuzeigen.
```
ssh -L 1441:localhost:1441 -L 1442:localhost:1442 username@core-device-ip-address
```
**Anmerkung**
Sie können die Standardports über `1441` und ändern`1442`. Weitere Informationen finden Sie unter [Konfiguration der lokalen Debug-Konsole](#local-debug-console-component-configuration).
1. Erstellen Sie eine Sitzung, um die lokale Debug-Konsole zu verwenden. Wenn Sie eine Sitzung erstellen, generieren Sie ein Passwort, das Sie zur Authentifizierung verwenden. Für die lokale Debug-Konsole ist aus Sicherheitsgründen ein Kennwort erforderlich, da Sie mit dieser Komponente wichtige Informationen anzeigen und Vorgänge auf dem Kerngerät ausführen können. Die lokale Debug-Konsole erstellt außerdem ein Zertifikat, um die Verbindung zu sichern, wenn Sie HTTPS in der Komponentenkonfiguration aktivieren. HTTPS ist standardmäßig aktiviert.
Verwenden Sie die AWS IoT Greengrass CLI, um die Sitzung zu erstellen. Dieser Befehl generiert ein zufälliges 43-stelliges Passwort, das nach 8 Stunden abläuft. Ersetzen Sie `/greengrass/v2` oder *C:\$1greengrass\$1v2* durch den Pfad zum AWS IoT Greengrass V2 Stammordner.
------
#### [ Linux or Unix ]
```
sudo /greengrass/v2/bin/greengrass-cli get-debug-password
```
------
#### [ Windows ]
```
C:\greengrass\v2\bin\greengrass-cli get-debug-password
```
------
Die Befehlsausgabe sieht wie das folgende Beispiel aus, wenn Sie die lokale Debug-Konsole für die Verwendung von HTTPS konfiguriert haben. Sie verwenden die Fingerabdrücke des Zertifikats, um zu überprüfen, ob die Verbindung sicher ist, wenn Sie die lokale Debug-Konsole öffnen.
```
Username: debug
Password: bEDp3MOHdj8ou2w5de_sCBI2XAaguy3a8XxREXAMPLE
Password expires at: 2021-04-01T17:01:43.921999931-07:00
The local debug console is configured to use TLS security. The certificate is self-signed so you will need to bypass your web browser's security warnings to open the console.
Before you bypass the security warning, verify that the certificate fingerprint matches the following fingerprints.
SHA-256: 15 0B 2C E2 54 8B 22 DE 08 46 54 8A B1 2B 25 DE FB 02 7D 01 4E 4A 56 67 96 DA A6 CC B1 D2 C4 1B
SHA-1: BC 3E 16 04 D3 80 70 DA E0 47 25 F9 90 FA D6 02 80 3E B5 C1
```
Die Debug-View-Komponente erstellt eine Sitzung, die 8 Stunden dauert. Danach müssen Sie ein neues Passwort generieren, um die lokale Debug-Konsole wieder aufrufen zu können.
1. Öffnen Sie das Dashboard und melden Sie sich dort an. Sehen Sie sich das Dashboard auf Ihrem Greengrass-Core-Gerät oder auf Ihrem Entwicklungscomputer an, wenn Sie den Port über SSH weiterleiten. Führen Sie eine der folgenden Aktionen aus:
+ Wenn Sie HTTPS in der lokalen Debug-Konsole aktiviert haben, was die Standardeinstellung ist, gehen Sie wie folgt vor:
1. Öffnen Sie `https://localhost:1441` auf Ihrem Core-Gerät oder auf Ihrem Entwicklungscomputer, wenn Sie den Port über SSH weitergeleitet haben.
Ihr Browser zeigt möglicherweise eine Sicherheitswarnung über ein ungültiges Sicherheitszertifikat an.
1. Wenn Ihr Browser eine Sicherheitswarnung anzeigt, überprüfen Sie, ob das Zertifikat legitim ist, und umgehen Sie die Sicherheitswarnung. Gehen Sie wie folgt vor:
1. Suchen Sie den SHA-256- oder SHA-1-Fingerabdruck für das Zertifikat und stellen Sie sicher, dass er mit dem SHA-256- oder SHA-1-Fingerabdruck übereinstimmt, den der Befehl zuvor gedruckt hat. `get-debug-password` Ihr Browser stellt möglicherweise einen oder beide Fingerabdrücke bereit. Schlagen Sie in der Dokumentation Ihres Browsers nach, um das Zertifikat und die zugehörigen Fingerabdrücke einzusehen. In einigen Browsern wird der Fingerabdruck des Zertifikats als Fingerabdruck bezeichnet.
**Anmerkung**
Wenn der Fingerabdruck des Zertifikats nicht übereinstimmt, gehen Sie [Step 2](#local-debug-console-component-create-session-step) zu Eine neue Sitzung erstellen. Wenn der Fingerabdruck des Zertifikats immer noch nicht übereinstimmt, ist Ihre Verbindung möglicherweise unsicher.
1. Wenn der Fingerabdruck des Zertifikats übereinstimmt, umgehen Sie die Sicherheitswarnung Ihres Browsers, um die lokale Debug-Konsole zu öffnen. Schlagen Sie in der Dokumentation Ihres Browsers nach, um die Sicherheitswarnung des Browsers zu umgehen.
1. Melden Sie sich auf der Website mit dem Benutzernamen und dem Passwort an, die der `get-debug-password` Befehl zuvor gedruckt hat.
Die lokale Debug-Konsole wird geöffnet.
1. Wenn die lokale Debug-Konsole einen Fehler anzeigt, der besagt, dass WebSocket aufgrund eines fehlgeschlagenen TLS-Handshakes keine Verbindung zur hergestellt werden kann, müssen Sie die selbstsignierte Sicherheitswarnung für die URL umgehen. WebSocket
![\[Der WebSocket TLS-Handshake-Fehler in der lokalen Debug-Konsole.\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/images/local-debug-console/websocket-tls-handshake-error.png)
Gehen Sie wie folgt vor:
1. Öffnen Sie `https://localhost:1442` in demselben Browser, in dem Sie die lokale Debug-Konsole geöffnet haben.
1. Überprüfen Sie das Zertifikat und umgehen Sie die Sicherheitswarnung.
Ihr Browser zeigt möglicherweise eine HTTP 404-Seite an, nachdem Sie die Warnung umgangen haben.
1. `https://localhost:1441`Erneut öffnen.
Die lokale Debug-Konsole zeigt Informationen über das Kerngerät an.
+ Wenn Sie HTTPS in der lokalen Debug-Konsole deaktiviert haben, gehen Sie wie folgt vor:
1. Öffnen Sie es `http://localhost:1441` auf Ihrem Core-Gerät oder öffnen Sie es auf Ihrem Entwicklungscomputer, wenn Sie den Port über SSH weitergeleitet haben.
1. Melden Sie sich auf der Website mit dem Benutzernamen und dem Passwort an, die der `get-debug-password` Befehl zuvor gedruckt hat.
Die lokale Debug-Konsole wird geöffnet.
------
#### [ v2.0.x ]
**Um die lokale Debug-Konsole zu öffnen**
1. (Optional) Um die lokale Debug-Konsole auf Ihrem Entwicklungscomputer anzuzeigen, können Sie den Port der Konsole über SSH weiterleiten. Sie müssen die `AllowTcpForwarding` Option jedoch zuerst in der SSH-Konfigurationsdatei Ihres Kerngeräts aktivieren. Diese Option ist standardmäßig aktiviert. Führen Sie den folgenden Befehl auf Ihrem Entwicklungscomputer aus, um das Dashboard `localhost:1441` auf Ihrem Entwicklungscomputer anzuzeigen.
```
ssh -L 1441:localhost:1441 -L 1442:localhost:1442 username@core-device-ip-address
```
**Anmerkung**
Sie können die Standardports über `1441` und ändern`1442`. Weitere Informationen finden Sie unter [Konfiguration der lokalen Debug-Konsole](#local-debug-console-component-configuration).
1. Erstellen Sie eine Sitzung, um die lokale Debug-Konsole zu verwenden. Wenn Sie eine Sitzung erstellen, generieren Sie ein Passwort, das Sie zur Authentifizierung verwenden. Für die lokale Debug-Konsole ist aus Sicherheitsgründen ein Kennwort erforderlich, da Sie mit dieser Komponente wichtige Informationen anzeigen und Vorgänge auf dem Kerngerät ausführen können.
Verwenden Sie die AWS IoT Greengrass CLI, um die Sitzung zu erstellen. Dieser Befehl generiert ein zufälliges 43-stelliges Passwort, das nach 8 Stunden abläuft. Ersetzen Sie `/greengrass/v2` oder *C:\$1greengrass\$1v2* durch den Pfad zum AWS IoT Greengrass V2 Stammordner.
------
#### [ Linux or Unix ]
```
sudo /greengrass/v2/bin/greengrass-cli get-debug-password
```
------
#### [ Windows ]
```
C:\greengrass\v2\bin\greengrass-cli get-debug-password
```
------
Die Befehlsausgabe sieht wie das folgende Beispiel aus.
```
Username: debug
Password: bEDp3MOHdj8ou2w5de_sCBI2XAaguy3a8XxREXAMPLE
Password will expire at: 2021-04-01T17:01:43.921999931-07:00
```
Die Debug-View-Komponente erstellt eine Sitzung, die 4 Stunden dauert. Anschließend müssen Sie ein neues Passwort generieren, um die lokale Debug-Konsole erneut aufrufen zu können.
1. Öffnen Sie es `http://localhost:1441` auf Ihrem Hauptgerät oder öffnen Sie es auf Ihrem Entwicklungscomputer, wenn Sie den Port über SSH weitergeleitet haben.
1. Melden Sie sich auf der Website mit dem Benutzernamen und dem Passwort an, die der `get-debug-password` Befehl zuvor gedruckt hat.
Die lokale Debug-Konsole wird geöffnet.
------
## Lokale Protokolldatei
Diese Komponente verwendet dieselbe Protokolldatei wie die [Greengrass Nucleus-Komponente](greengrass-nucleus-component.md).
------
#### [ Linux ]
```
/greengrass/v2/logs/greengrass.log
```
------
#### [ Windows ]
```
C:\greengrass\v2\logs\greengrass.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:\$1greengrass\$1v2* durch den Pfad zum AWS IoT Greengrass Stammordner.
------
#### [ Linux ]
```
sudo tail -f /greengrass/v2/logs/greengrass.log
```
------
#### [ Windows (PowerShell) ]
```
Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
```
------
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| **Version** | **Änderungen** |
| --- | --- |
| 2.4.6 | Die Version wurde für die Version 2.16.0 von Greengrass Nucleus aktualisiert. |
| 2.4.5 | Die Version wurde für die Version 2.15.0 von Greengrass Nucleus aktualisiert. |
| 2.4.4 | Die Version wurde für die Version 2.14.0 von Greengrass Nucleus aktualisiert. |
| 2.4.3 | Die Version wurde für die Version 2.13.0 von Greengrass Nucleus aktualisiert. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/local-debug-console-component.html) |
| 2.4.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/local-debug-console-component.html) |
| 2.4.1 | Die Version wurde für die Version 2.12.0 von Greengrass Nucleus aktualisiert. |
| 2.4.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/local-debug-console-component.html) |
| 2.3.1 | Die Version wurde für die Version 2.11.0 von Greengrass Nucleus aktualisiert. |
| 2.3.0 | Die Version wurde für die Version 2.10.0 von Greengrass Nucleus aktualisiert. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/local-debug-console-component.html) |
| 2.2.7 | Die Version wurde für die Version 2.9.0 von Greengrass Nucleus aktualisiert. |
| 2.2.6 | Die Version wurde für die Version 2.8.0 von Greengrass Nucleus aktualisiert. |
| 2.2.5 | Die Version wurde für die Version 2.7.0 von Greengrass Nucleus aktualisiert. |
| 2.2.4 | Die Version wurde für die Version 2.6.0 von Greengrass Nucleus aktualisiert. |
| 2.2.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/local-debug-console-component.html) |
| 2.2.2 | Die Version wurde für die Version 2.4.0 von Greengrass Nucleus aktualisiert. |
| 2.2.1 | Die Version wurde für die Version 2.3.0 von Greengrass Nucleus aktualisiert. |
| 2.2.0 | Die Version wurde für die Version 2.2.0 von Greengrass Nucleus aktualisiert. |
| 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/local-debug-console-component.html) |
| 2.0.3 | Erste Version |
# Protokollmanager
**Warnung**
Wir empfehlen ein Upgrade auf Log Manager v2.3.5 oder höher. Version 2.3.5 optimiert die Schreibvorgänge in der Log Manager-Konfiguration, reduziert I/O-Operationen und verbessert die Geschwindigkeit beim Hochladen von Protokollen, verbessert die Gesamtleistung des Geräts und verlängert möglicherweise die Lebensdauer des Geräts.
Die Log-Manager-Komponente (`aws.greengrass.LogManager`) lädt Protokolle von AWS IoT Greengrass Kerngeräten zu Amazon CloudWatch Logs hoch. Sie können Protokolle vom Greengrass-Nucleus, anderen Greengrass-Komponenten und anderen Anwendungen und Diensten hochladen, die keine Greengrass-Komponenten sind. Weitere Informationen zur Überwachung von Protokollen in CloudWatch Logs und im lokalen Dateisystem finden Sie unter. [AWS IoT Greengrass Protokolle überwachen](monitor-logs.md)
Die folgenden Überlegungen gelten, wenn Sie die Log-Manager-Komponente zum Schreiben in CloudWatch Logs verwenden:
+ **Verzögerungen protokollieren**
Die Log Manager-Komponente, Version 2.2.8 (und früher), verarbeitet und lädt Protokolle nur aus rotierten Protokolldateien hoch. Standardmäßig rotiert die AWS IoT Greengrass Core-Software die Protokolldateien jede Stunde oder nachdem sie 1.024 KB groß sind. Daher lädt die Log-Manager-Komponente Protokolle erst hoch, nachdem die AWS IoT Greengrass Core-Software oder eine Greengrass-Komponente Protokolle im Wert von über 1.024 KB geschrieben hat. Sie können eine niedrigere Größenbeschränkung für Protokolldateien konfigurieren, damit Protokolldateien häufiger rotieren. Dies führt dazu, dass die Log-Manager-Komponente Logs häufiger in CloudWatch Logs hochlädt.
Die Log Manager-Komponente Version 2.3.0 (und höher) verarbeitet und lädt alle Protokolle hoch. Wenn Sie ein neues Protokoll schreiben, verarbeitet Log Manager Version 2.3.0 (und höher) diese aktive Protokolldatei und lädt sie direkt hoch, anstatt darauf zu warten, dass sie rotiert wird. Das bedeutet, dass Sie das neue Protokoll in 5 Minuten oder weniger anzeigen können.
Die Log-Manager-Komponente lädt regelmäßig neue Protokolle hoch. Standardmäßig lädt die Log-Manager-Komponente alle 5 Minuten neue Protokolle hoch. Sie können ein niedrigeres Upload-Intervall konfigurieren, sodass die Log-Manager-Komponente Logs häufiger in Logs hochlädt, CloudWatch indem Sie den konfigurieren. `periodicUploadIntervalSec` Weitere Informationen zur Konfiguration dieses periodischen Intervalls finden Sie unter [Konfiguration](https://docs.aws.amazon.com/greengrass/v2/developerguide/log-manager-component.html#log-manager-component-configuration).
Protokolle können nahezu in Echtzeit aus demselben Greengrass-Dateisystem hochgeladen werden. Wenn Sie Protokolle in Echtzeit beobachten müssen, sollten Sie die Verwendung von [Dateisystemprotokollen](monitor-logs.md#access-local-logs) in Betracht ziehen.
**Anmerkung**
Wenn Sie unterschiedliche Dateisysteme zum Schreiben von Protokollen verwenden, kehrt der Log Manager zum Verhalten der Protokollmanager-Komponentenversionen 2.2.8 und früher zurück. Informationen zum Zugriff auf Dateisystemprotokolle finden Sie unter [Zugriff auf Dateisystemprotokolle](https://docs.aws.amazon.com/greengrass/v2/developerguide/monitor-logs.html#access-local-logs).
+ **Zeitversatz**
Die Log Manager-Komponente verwendet den Standard-Signaturprozess von Signature Version 4, um API-Anfragen an CloudWatch Logs zu erstellen. Wenn die Systemzeit auf einem Kerngerät um mehr als 15 Minuten nicht mehr synchron ist, lehnt CloudWatch Logs die Anfragen ab. Weitere Informationen finden Sie unter [Signaturprozess mit Signaturversion 4](https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html) in der*Allgemeine AWS-Referenz* .
Hinweise zu den Protokollgruppen und Protokollströmen, in die diese Komponente Protokolle hochlädt, finden Sie unter. [Usage](#log-manager-component-usage)
**Topics**
+ [Versionen](#log-manager-component-versions)
+ [Typ](#log-manager-component-type)
+ [Betriebssystem](#log-manager-component-os-support)
+ [Voraussetzungen](#log-manager-component-requirements)
+ [Abhängigkeiten](#log-manager-component-dependencies)
+ [Konfiguration](#log-manager-component-configuration)
+ [Usage](#log-manager-component-usage)
+ [Lokale Protokolldatei](#log-manager-component-log-file)
+ [Änderungsprotokoll](#log-manager-component-changelog)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 2.3.x
+ 2.2.x
+ 2.1.x
+ 2.0.x
## Typ
Diese Komponente ist eine Plugin-Komponente (`aws.greengrass.plugin`). Der [Greengrass-Kern führt diese Komponente in derselben Java Virtual Machine (JVM) wie der Nucleus](greengrass-nucleus-component.md) aus. Der Nucleus wird neu gestartet, wenn Sie die Version dieser Komponente auf dem Kerngerät ändern.
Diese Komponente verwendet dieselbe Protokolldatei wie der Greengrass-Kern. Weitere Informationen finden Sie unter [AWS IoT Greengrass Protokolle überwachen](monitor-logs.md).
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## 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 [Greengrass-Geräterolle](device-service-role.md) muss die `logs:DescribeLogStreams` Aktionen `logs:CreateLogGroup``logs:CreateLogStream`,`logs:PutLogEvents`, und zulassen, wie in der folgenden IAM-Beispielrichtlinie gezeigt.
```
{
"Version": "2012-10-17",
"Statement": [
{
"Action": [
"logs:CreateLogGroup",
"logs:CreateLogStream",
"logs:PutLogEvents",
"logs:DescribeLogStreams"
],
"Effect": "Allow",
"Resource": "arn:aws:logs:*:*:*"
}
]
}
```
**Anmerkung**
Die [Greengrass-Geräterolle](device-service-role.md), die Sie bei der Installation der AWS IoT Greengrass Core-Software erstellen, enthält standardmäßig die Berechtigungen in dieser Beispielrichtlinie.
Weitere Informationen finden Sie unter [Verwenden von identitätsbasierten Richtlinien (IAM-Richtlinien) für CloudWatch Protokolle](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/iam-identity-based-access-control-cwl.html) im *Amazon CloudWatch Logs-Benutzerhandbuch*.
+ Die Log Manager-Komponente wird für die Ausführung in einer VPC unterstützt. Um diese Komponente in einer VPC bereitzustellen, ist Folgendes erforderlich.
+ Die Log Manager-Komponente muss über Konnektivität verfügen`logs.region.amazonaws.com`, zu der der VPC-Endpunkt ist. `com.amazonaws.us-east-1.logs`
### 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](allow-device-traffic.md).
| Endpoint | Port | Erforderlich | Description |
| --- | --- | --- | --- |
| `logs.region.amazonaws.com` | 443 | Nein | Erforderlich, wenn Sie Protokolle in Logs schreiben. CloudWatch |
## 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](#log-manager-component-changelog) 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](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.
------
#### [ 2.3.11 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.3.11 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.1.0 <2.17.0 | Weich |
------
#### [ 2.3.10 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.3.10 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.1.0 <2.16.0 | Weich |
------
#### [ 2.3.9 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.3.9 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.1.0 <2.15.0 | Weich |
------
#### [ 2.3.8 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.3.8 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.1.0 <2.14.0 | Weich |
------
#### [ 2.3.7 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.3.7 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.1.0 <2.13.0 | Weich |
------
#### [ 2.3.5 and 2.3.6 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.3.5 und 2.3.6 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.1.0 <2.12.0 | Weich |
------
#### [ 2.3.3 – 2.3.4 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.3.3 bis 2.3.4 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.1.0 <2.11.0 | Weich |
------
#### [ 2.2.8 – 2.3.2 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.2.8 bis 2.3.2 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.1.0 <2.10.0 | Weich |
------
#### [ 2.2.7 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.2.7 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.1.0 <2.9.0 | Weich |
------
#### [ 2.2.6 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.2.6 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.1.0 <2.8.0 | Weich |
------
#### [ 2.2.5 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.2.5 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.1.0 <2.7.0 | Weich |
------
#### [ 2.2.1 - 2.2.4 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.2.1 - 2.2.4 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.1.0 <2.6.0 | Weich |
------
#### [ 2.1.3 and 2.2.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.1.3 und 2.2.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.1.0 <2.5.0 | Weich |
------
#### [ 2.1.2 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.2 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.1.0 <2.4.0 | Weich |
------
#### [ 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](greengrass-nucleus-component.md) | >=2.1.0 <2.3.0 | Weich |
------
#### [ 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](greengrass-nucleus-component.md) | >=2.1.0 <2.2.0 | Weich |
------
#### [ 2.0.x ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.x dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.3 <2.1.0 | Weich |
------
[Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den Komponentenrezepten.](component-recipe-reference.md#recipe-reference-component-dependencies)
## Konfiguration
Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.
------
#### [ v2.3.10 ]
`logsUploaderConfiguration`
(Optional) Die Konfiguration für Protokolle, die die Log Manager-Komponente hochlädt. Dieses Objekt enthält die folgenden Informationen:
`systemLogsConfiguration`
(Optional) Die Konfiguration für AWS IoT Greengrass Core-Softwaresystemprotokolle, die Protokolle der [Greengrass-Nukleus](greengrass-nucleus-component.md) - und [Plugin-Komponenten](develop-greengrass-components.md#component-types) enthalten. Geben Sie diese Konfiguration an, damit die Log-Manager-Komponente Systemprotokolle verwalten kann. Dieses Objekt enthält die folgenden Informationen:
`uploadToCloudWatch`
(Optional) Sie können Systemprotokolle in CloudWatch Logs hochladen.
Standard: `false`
`minimumLogLevel`
(Optional) Die Mindestanzahl an Protokollnachrichten, die hochgeladen werden sollen. Diese Mindeststufe gilt nur, wenn Sie die [Greengrass Nucleus-Komponente](greengrass-nucleus-component.md) für die Ausgabe von Protokollen im JSON-Format konfigurieren. Um Logs im JSON-Format zu aktivieren, geben Sie `JSON` für den [Logging-Formatparameter](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-logging-format) (`logging.format`) an.
Wählen Sie aus den folgenden Protokollebenen, die hier in der Reihenfolge der Stufen aufgeführt sind:
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Standard: `INFO`
`diskSpaceLimit`
(Optional) Die maximale Gesamtgröße der Greengrass-Systemprotokolldateien in der von Ihnen angegebenen Einheit. `diskSpaceLimitUnit` Wenn die Gesamtgröße der Greengrass-Systemprotokolldateien diese maximale Gesamtgröße überschreitet, löscht die AWS IoT Greengrass Core-Software die ältesten Greengrass-Systemprotokolldateien.
Dieser Parameter entspricht dem Parameter für die [Protokollgrößenbeschränkung](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) der [Greengrass-Kernkomponente](greengrass-nucleus-component.md). Die AWS IoT Greengrass Core-Software verwendet das Minimum der beiden Werte als maximale Gesamtgröße des Greengrass-Systemprotokolls.
`diskSpaceLimitUnit`
(Optional) Die Einheit für die`diskSpaceLimit`. Wählen Sie aus den folgenden Optionen aus:
+ `KB`— Kilobyte
+ `MB`— Megabyte
+ `GB`— Gigabyte
Standard: `KB`
`deleteLogFileAfterCloudUpload`
(Optional) Sie können eine Protokolldatei löschen, nachdem die Log-Manager-Komponente die Protokolle in Logs hochgeladen hat. CloudWatch
Standard: `false`
`componentLogsConfigurationMap`
(Optional) Eine Übersicht der Protokollkonfigurationen für Komponenten auf dem Kerngerät. Jedes `componentName` Objekt in dieser Zuordnung definiert die Protokollkonfiguration für die Komponente oder Anwendung. Die Log-Manager-Komponente lädt diese Komponentenprotokolle in Logs hoch. CloudWatch
Wir empfehlen dringend, einen einzigen Konfigurationsschlüssel pro Komponente zu verwenden. Sie sollten nur auf eine Gruppe von Dateien abzielen, die nur eine Protokolldatei haben, in die aktiv geschrieben wird, wenn Sie die verwenden`logFileRegex`. Die Nichtbeachtung dieser Empfehlung kann dazu führen, dass doppelte Protokolle hochgeladen werden CloudWatch. [Wenn Sie auf mehrere aktive Protokolldateien mit einem einzigen regulären Ausdruck abzielen, empfehlen wir Ihnen, ein Upgrade auf Log Manager v2.3.1 oder höher durchzuführen und eine Änderung Ihrer Konfiguration anhand der Beispielkonfiguration in Betracht zu ziehen.](#log-manager-multiple-logs-v2.3.10)
Wenn Sie ein Upgrade von einer früheren Version von Log Manager als Version 2.2.0 durchführen, können Sie stattdessen weiterhin die Liste verwenden. `componentLogsConfiguration` `componentLogsConfigurationMap` Es wird jedoch dringend empfohlen, das Zuordnungsformat zu verwenden, sodass Sie Aktualisierungen zum Zusammenführen und Zurücksetzen verwenden können, um Konfigurationen für bestimmte Komponenten zu ändern. Informationen zu diesem `componentLogsConfiguration` Parameter finden Sie in den Konfigurationsparametern für Version 2.1.x dieser Komponente.
*`componentName`*
Die Protokollkonfiguration für die *`componentName`* Komponente oder Anwendung für diese Protokollkonfiguration. Sie können den Namen einer Greengrass-Komponente oder einen anderen Wert angeben, um diese Protokollgruppe zu identifizieren.
Jedes Objekt enthält die folgenden Informationen:
`minimumLogLevel`
(Optional) Die Mindestanzahl der hochzuladenden Protokollnachrichten. Diese Mindeststufe gilt nur, wenn die Protokolle dieser Komponente ein bestimmtes JSON-Format verwenden, das Sie im Repository des [AWS IoT Greengrass Protokollierungsmoduls](https://github.com/aws-greengrass/aws-greengrass-logging-java) finden GitHub.
Wählen Sie aus den folgenden Protokollebenen, die hier in der Reihenfolge der Stufen aufgeführt sind:
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Standard: `INFO`
`diskSpaceLimit`
(Optional) Die maximale Gesamtgröße aller Protokolldateien für diese Komponente in der von Ihnen angegebenen Einheit`diskSpaceLimitUnit`. Wenn die Gesamtgröße der Protokolldateien dieser Komponente diese maximale Gesamtgröße überschreitet, löscht die AWS IoT Greengrass Core-Software die ältesten Protokolldateien dieser Komponente.
Dieser Parameter bezieht sich auf den Parameter für die [Loggrößenbeschränkung](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) der [Greengrass-Kernkomponente](greengrass-nucleus-component.md). Die AWS IoT Greengrass Core-Software verwendet den kleinsten der beiden Werte als maximale Gesamtprotokollgröße für diese Komponente.
`diskSpaceLimitUnit`
(Optional) Die Einheit für die`diskSpaceLimit`. Wählen Sie aus den folgenden Optionen aus:
+ `KB`— Kilobyte
+ `MB`— Megabyte
+ `GB`— Gigabyte
Standard: `KB`
`logFileDirectoryPath`
(Optional) Der Pfad zu dem Ordner, der die Protokolldateien dieser Komponente enthält.
Sie müssen diesen Parameter nicht für Greengrass-Komponenten angeben, die auf Standardausgabe (stdout) und Standardfehler (stderr) drucken.
Standard: `/greengrass/v2/logs`.
`logFileRegex`
(Optional) Ein regulärer Ausdruck, der das Namensformat der Protokolldatei angibt, das die Komponente oder Anwendung verwendet. Die Log Manager-Komponente verwendet diesen regulären Ausdruck, um Protokolldateien im Ordner unter zu identifizieren`logFileDirectoryPath`.
Sie müssen diesen Parameter nicht für Greengrass-Komponenten angeben, die auf Standardausgabe (stdout) und Standardfehler (stderr) drucken.
Wenn Ihre Komponente oder Anwendung Protokolldateien rotiert, geben Sie einen regulären Ausdruck an, der den Namen der rotierten Protokolldateien entspricht. Sie könnten beispielsweise angeben**hello\$1world\$1\$1\$1\$1w\$1.log**, dass Protokolle für eine Hello World-Anwendung hochgeladen werden sollen. Das `\\\\w*` Muster entspricht null oder mehr Wortzeichen, einschließlich alphanumerischer Zeichen und Unterstriche. Dieser reguläre Ausdruck entspricht Protokolldateien mit und ohne Zeitstempel im Namen. In diesem Beispiel lädt der Protokollmanager die folgenden Protokolldateien hoch:
+ `hello_world.log`— Die neueste Protokolldatei für die Hello World-Anwendung.
+ `hello_world_2020_12_15_17_0.log`— Eine ältere Protokolldatei für die Hello World-Anwendung.
Standard:`componentName\\\\w*.log`, wobei *componentName* der Name der Komponente für diese Protokollkonfiguration ist.
`deleteLogFileAfterCloudUpload`
(Optional) Sie können eine Protokolldatei löschen, nachdem die Log-Manager-Komponente die Protokolle in Logs hochgeladen hat. CloudWatch
Standard: `false`
`multiLineStartPattern`
(Optional) Ein regulärer Ausdruck, der angibt, wann es sich bei einer Protokollnachricht in einer neuen Zeile um eine neue Protokollnachricht handelt. Wenn der reguläre Ausdruck nicht mit der neuen Zeile übereinstimmt, hängt die Log-Manager-Komponente die neue Zeile an die Protokollnachricht für die vorherige Zeile an.
Standardmäßig prüft die Log Manager-Komponente, ob die Zeile mit einem Leerzeichen beginnt, z. B. einem Tabulator oder einem Leerzeichen. Ist dies nicht der Fall, behandelt der Protokollmanager diese Zeile als neue Protokollnachricht. Andernfalls wird diese Zeile an die aktuelle Protokollnachricht angehängt. Dieses Verhalten stellt sicher, dass die Log-Manager-Komponente Nachrichten, die sich über mehrere Zeilen erstrecken, nicht aufteilt, wie z. B. Stack-Traces.
`periodicUploadIntervalSec`
(Optional) Der Zeitraum in Sekunden, in dem die Log Manager-Komponente nach neuen Protokolldateien sucht, die hochgeladen werden können.
Standard: `300` (5 Minuten)
Minimum: `0.000001` (1 Mikrosekunde)
`updateToTlogIntervalSec`
(Optional) Der Zeitraum in Sekunden, in dem der Nucleus Details zu Amazon CloudWatch Events Log-Upload-Ereignissen in das lokale Transaktionslog () schreibt. `config.tlog` Standardmäßig wird der in angegebene Wert verwendet. `periodicUploadIntervalSec` Sie können diesen Parameter ändern, um das Schreibintervall zu verlängern.
Standard: `periodicUploadIntervalSec`
Minimum: `periodicUploadIntervalSec`
`deprecatedVersionSupport`
Gibt an, ob der Protokollmanager die in Log Manager v2.3.5 eingeführten Verbesserungen der Protokollierungsgeschwindigkeit verwenden sollte. Stellen Sie den Wert auf ein, `false` um die Verbesserungen zu nutzen.
Wenn Sie diesen Wert `false` bei der Aktualisierung von Log Manager v2.3.1 oder früher auf festlegen, werden möglicherweise doppelte Protokolleinträge hochgeladen.
Der Standardwert ist `true`.
**Example Beispiel: Update zur Zusammenführung von Konfigurationen**
Die folgende Beispielkonfiguration legt fest, dass System- und `com.example.HelloWorld` Komponentenprotokolle in Logs hochgeladen werden CloudWatch sollen.
```
{
"logsUploaderConfiguration": {
"systemLogsConfiguration": {
"uploadToCloudWatch": "true",
"minimumLogLevel": "INFO",
"diskSpaceLimit": "10",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
},
"componentLogsConfigurationMap": {
"com.example.HelloWorld": {
"minimumLogLevel": "INFO",
"diskSpaceLimit": "20",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
}
}
},
"periodicUploadIntervalSec": "300",
"deprecatedVersionSupport": "false"
}
```
**Example Beispiel: Konfiguration zum Hochladen mehrerer aktiver Protokolldateien mit Log Manager v2.3.1**
Die folgende Beispielkonfiguration ist das empfohlene Beispiel, wenn Sie mehrere aktive Protokolldateien als Ziel verwenden möchten. Diese Beispielkonfiguration gibt an, in welche aktiven Protokolldateien Sie hochladen möchten CloudWatch. Bei Verwendung dieser Beispielkonfiguration werden auch alle rotierten Dateien hochgeladen, die dem entsprechen`logFileRegex`. Diese Beispielkonfiguration wird von Log Manager v2.3.1 unterstützt.
```
{
"logsUploaderConfiguration": {
"componentLogsConfigurationMap": {
"com.example.A": {
"logFileRegex": "com.example.A\\w*.log",
"deleteLogFileAfterCloudUpload": "false"
}
"com.example.B": {
"logFileRegex": "com.example.B\\w*.log",
"deleteLogFileAfterCloudUpload": "false"
}
}
},
"periodicUploadIntervalSec": "10"
}
```
------
#### [ v2.3.6 – v2.3.9 ]
`logsUploaderConfiguration`
(Optional) Die Konfiguration für Protokolle, die die Log Manager-Komponente hochlädt. Dieses Objekt enthält die folgenden Informationen:
`systemLogsConfiguration`
(Optional) Die Konfiguration für AWS IoT Greengrass Core-Softwaresystemprotokolle, die Protokolle der [Greengrass-Nukleus](greengrass-nucleus-component.md) - und [Plugin-Komponenten](develop-greengrass-components.md#component-types) enthalten. Geben Sie diese Konfiguration an, damit die Log-Manager-Komponente Systemprotokolle verwalten kann. Dieses Objekt enthält die folgenden Informationen:
`uploadToCloudWatch`
(Optional) Sie können Systemprotokolle in CloudWatch Logs hochladen.
Standard: `false`
`minimumLogLevel`
(Optional) Die Mindestanzahl an Protokollnachrichten, die hochgeladen werden sollen. Diese Mindeststufe gilt nur, wenn Sie die [Greengrass Nucleus-Komponente](greengrass-nucleus-component.md) für die Ausgabe von Protokollen im JSON-Format konfigurieren. Um Logs im JSON-Format zu aktivieren, geben Sie `JSON` für den [Logging-Formatparameter](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-logging-format) (`logging.format`) an.
Wählen Sie aus den folgenden Protokollebenen, die hier in der Reihenfolge der Stufen aufgeführt sind:
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Standard: `INFO`
`diskSpaceLimit`
(Optional) Die maximale Gesamtgröße der Greengrass-Systemprotokolldateien in der von Ihnen angegebenen Einheit. `diskSpaceLimitUnit` Wenn die Gesamtgröße der Greengrass-Systemprotokolldateien diese maximale Gesamtgröße überschreitet, löscht die AWS IoT Greengrass Core-Software die ältesten Greengrass-Systemprotokolldateien.
Dieser Parameter entspricht dem Parameter für die [Protokollgrößenbeschränkung](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) der [Greengrass-Kernkomponente](greengrass-nucleus-component.md). Die AWS IoT Greengrass Core-Software verwendet das Minimum der beiden Werte als maximale Gesamtgröße des Greengrass-Systemprotokolls.
`diskSpaceLimitUnit`
(Optional) Die Einheit für die`diskSpaceLimit`. Wählen Sie aus den folgenden Optionen aus:
+ `KB`— Kilobyte
+ `MB`— Megabyte
+ `GB`— Gigabyte
Standard: `KB`
`deleteLogFileAfterCloudUpload`
(Optional) Sie können eine Protokolldatei löschen, nachdem die Log-Manager-Komponente die Protokolle in Logs hochgeladen hat. CloudWatch
Standard: `false`
`componentLogsConfigurationMap`
(Optional) Eine Übersicht der Protokollkonfigurationen für Komponenten auf dem Kerngerät. Jedes `componentName` Objekt in dieser Zuordnung definiert die Protokollkonfiguration für die Komponente oder Anwendung. Die Log-Manager-Komponente lädt diese Komponentenprotokolle in Logs hoch. CloudWatch
Wir empfehlen dringend, einen einzigen Konfigurationsschlüssel pro Komponente zu verwenden. Sie sollten nur auf eine Gruppe von Dateien abzielen, die nur eine Protokolldatei haben, in die aktiv geschrieben wird, wenn Sie die verwenden`logFileRegex`. Die Nichtbeachtung dieser Empfehlung kann dazu führen, dass doppelte Protokolle hochgeladen werden CloudWatch. [Wenn Sie auf mehrere aktive Protokolldateien mit einem einzigen regulären Ausdruck abzielen, empfehlen wir Ihnen, ein Upgrade auf Log Manager v2.3.1 oder höher durchzuführen und eine Änderung Ihrer Konfiguration anhand der Beispielkonfiguration in Betracht zu ziehen.](#log-manager-multiple-logs-v2.3.1)
Wenn Sie ein Upgrade von einer früheren Version von Log Manager als Version 2.2.0 durchführen, können Sie stattdessen weiterhin die Liste verwenden. `componentLogsConfiguration` `componentLogsConfigurationMap` Es wird jedoch dringend empfohlen, das Zuordnungsformat zu verwenden, sodass Sie Aktualisierungen zum Zusammenführen und Zurücksetzen verwenden können, um Konfigurationen für bestimmte Komponenten zu ändern. Informationen zu diesem `componentLogsConfiguration` Parameter finden Sie in den Konfigurationsparametern für Version 2.1.x dieser Komponente.
*`componentName`*
Die Protokollkonfiguration für die *`componentName`* Komponente oder Anwendung für diese Protokollkonfiguration. Sie können den Namen einer Greengrass-Komponente oder einen anderen Wert angeben, um diese Protokollgruppe zu identifizieren.
Jedes Objekt enthält die folgenden Informationen:
`minimumLogLevel`
(Optional) Die Mindestanzahl der hochzuladenden Protokollnachrichten. Diese Mindeststufe gilt nur, wenn die Protokolle dieser Komponente ein bestimmtes JSON-Format verwenden, das Sie im Repository des [AWS IoT Greengrass Protokollierungsmoduls](https://github.com/aws-greengrass/aws-greengrass-logging-java) finden GitHub.
Wählen Sie aus den folgenden Protokollebenen, die hier in der Reihenfolge der Stufen aufgeführt sind:
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Standard: `INFO`
`diskSpaceLimit`
(Optional) Die maximale Gesamtgröße aller Protokolldateien für diese Komponente in der von Ihnen angegebenen Einheit`diskSpaceLimitUnit`. Wenn die Gesamtgröße der Protokolldateien dieser Komponente diese maximale Gesamtgröße überschreitet, löscht die AWS IoT Greengrass Core-Software die ältesten Protokolldateien dieser Komponente.
Dieser Parameter bezieht sich auf den Parameter für die [Loggrößenbeschränkung](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) der [Greengrass-Kernkomponente](greengrass-nucleus-component.md). Die AWS IoT Greengrass Core-Software verwendet den kleinsten der beiden Werte als maximale Gesamtprotokollgröße für diese Komponente.
`diskSpaceLimitUnit`
(Optional) Die Einheit für die`diskSpaceLimit`. Wählen Sie aus den folgenden Optionen aus:
+ `KB`— Kilobyte
+ `MB`— Megabyte
+ `GB`— Gigabyte
Standard: `KB`
`logFileDirectoryPath`
(Optional) Der Pfad zu dem Ordner, der die Protokolldateien dieser Komponente enthält.
Sie müssen diesen Parameter nicht für Greengrass-Komponenten angeben, die auf Standardausgabe (stdout) und Standardfehler (stderr) drucken.
Standard: `/greengrass/v2/logs`.
`logFileRegex`
(Optional) Ein regulärer Ausdruck, der das Namensformat der Protokolldatei angibt, das die Komponente oder Anwendung verwendet. Die Log Manager-Komponente verwendet diesen regulären Ausdruck, um Protokolldateien im Ordner unter zu identifizieren`logFileDirectoryPath`.
Sie müssen diesen Parameter nicht für Greengrass-Komponenten angeben, die auf Standardausgabe (stdout) und Standardfehler (stderr) drucken.
Wenn Ihre Komponente oder Anwendung Protokolldateien rotiert, geben Sie einen regulären Ausdruck an, der den Namen der rotierten Protokolldateien entspricht. Sie könnten beispielsweise angeben**hello\$1world\$1\$1\$1\$1w\$1.log**, dass Protokolle für eine Hello World-Anwendung hochgeladen werden sollen. Das `\\\\w*` Muster entspricht null oder mehr Wortzeichen, einschließlich alphanumerischer Zeichen und Unterstriche. Dieser reguläre Ausdruck entspricht Protokolldateien mit und ohne Zeitstempel im Namen. In diesem Beispiel lädt der Protokollmanager die folgenden Protokolldateien hoch:
+ `hello_world.log`— Die neueste Protokolldatei für die Hello World-Anwendung.
+ `hello_world_2020_12_15_17_0.log`— Eine ältere Protokolldatei für die Hello World-Anwendung.
Standard:`componentName\\\\w*.log`, wobei *componentName* der Name der Komponente für diese Protokollkonfiguration ist.
`deleteLogFileAfterCloudUpload`
(Optional) Sie können eine Protokolldatei löschen, nachdem die Log-Manager-Komponente die Protokolle in Logs hochgeladen hat. CloudWatch
Standard: `false`
`multiLineStartPattern`
(Optional) Ein regulärer Ausdruck, der angibt, wann es sich bei einer Protokollnachricht in einer neuen Zeile um eine neue Protokollnachricht handelt. Wenn der reguläre Ausdruck nicht mit der neuen Zeile übereinstimmt, hängt die Log-Manager-Komponente die neue Zeile an die Protokollnachricht für die vorherige Zeile an.
Standardmäßig prüft die Log Manager-Komponente, ob die Zeile mit einem Leerzeichen beginnt, z. B. einem Tabulator oder einem Leerzeichen. Ist dies nicht der Fall, behandelt der Protokollmanager diese Zeile als neue Protokollnachricht. Andernfalls wird diese Zeile an die aktuelle Protokollnachricht angehängt. Dieses Verhalten stellt sicher, dass die Log-Manager-Komponente Nachrichten, die sich über mehrere Zeilen erstrecken, nicht aufteilt, wie z. B. Stack-Traces.
`periodicUploadIntervalSec`
(Optional) Der Zeitraum in Sekunden, in dem die Log Manager-Komponente nach neuen Protokolldateien sucht, die hochgeladen werden können.
Standard: `300` (5 Minuten)
Minimum: `0.000001` (1 Mikrosekunde)
`deprecatedVersionSupport`
Gibt an, ob der Protokollmanager die in Log Manager v2.3.5 eingeführten Verbesserungen der Protokollierungsgeschwindigkeit verwenden sollte. Stellen Sie den Wert auf ein, `false` um die Verbesserungen zu nutzen.
Wenn Sie diesen Wert `false` bei der Aktualisierung von Log Manager v2.3.1 oder früher auf festlegen, werden möglicherweise doppelte Protokolleinträge hochgeladen.
Der Standardwert ist `true`.
**Example Beispiel: Update zur Zusammenführung von Konfigurationen**
Die folgende Beispielkonfiguration legt fest, dass System- und `com.example.HelloWorld` Komponentenprotokolle in Logs hochgeladen werden CloudWatch sollen.
```
{
"logsUploaderConfiguration": {
"systemLogsConfiguration": {
"uploadToCloudWatch": "true",
"minimumLogLevel": "INFO",
"diskSpaceLimit": "10",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
},
"componentLogsConfigurationMap": {
"com.example.HelloWorld": {
"minimumLogLevel": "INFO",
"diskSpaceLimit": "20",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
}
}
},
"periodicUploadIntervalSec": "300",
"deprecatedVersionSupport": "false"
}
```
**Example Beispiel: Konfiguration zum Hochladen mehrerer aktiver Protokolldateien mit Log Manager v2.3.1**
Die folgende Beispielkonfiguration ist das empfohlene Beispiel, wenn Sie mehrere aktive Protokolldateien als Ziel verwenden möchten. Diese Beispielkonfiguration gibt an, in welche aktiven Protokolldateien Sie hochladen möchten CloudWatch. Bei Verwendung dieser Beispielkonfiguration werden auch alle rotierten Dateien hochgeladen, die dem entsprechen`logFileRegex`. Diese Beispielkonfiguration wird von Log Manager v2.3.1 unterstützt.
```
{
"logsUploaderConfiguration": {
"componentLogsConfigurationMap": {
"com.example.A": {
"logFileRegex": "com.example.A\\w*.log",
"deleteLogFileAfterCloudUpload": "false"
}
"com.example.B": {
"logFileRegex": "com.example.B\\w*.log",
"deleteLogFileAfterCloudUpload": "false"
}
}
},
"periodicUploadIntervalSec": "10"
}
```
------
#### [ v2.3.0 – 2.3.5 ]
`logsUploaderConfiguration`
(Optional) Die Konfiguration für Protokolle, die die Log Manager-Komponente hochlädt. Dieses Objekt enthält die folgenden Informationen:
`systemLogsConfiguration`
(Optional) Die Konfiguration für AWS IoT Greengrass Core-Softwaresystemprotokolle, die Protokolle der [Greengrass-Nukleus](greengrass-nucleus-component.md) - und [Plugin-Komponenten](develop-greengrass-components.md#component-types) enthalten. Geben Sie diese Konfiguration an, damit die Log-Manager-Komponente Systemprotokolle verwalten kann. Dieses Objekt enthält die folgenden Informationen:
`uploadToCloudWatch`
(Optional) Sie können Systemprotokolle in CloudWatch Logs hochladen.
Standard: `false`
`minimumLogLevel`
(Optional) Die Mindestanzahl an Protokollnachrichten, die hochgeladen werden sollen. Diese Mindeststufe gilt nur, wenn Sie die [Greengrass Nucleus-Komponente](greengrass-nucleus-component.md) für die Ausgabe von Protokollen im JSON-Format konfigurieren. Um Logs im JSON-Format zu aktivieren, geben Sie `JSON` für den [Logging-Formatparameter](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-logging-format) (`logging.format`) an.
Wählen Sie aus den folgenden Protokollebenen, die hier in der Reihenfolge der Stufen aufgeführt sind:
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Standard: `INFO`
`diskSpaceLimit`
(Optional) Die maximale Gesamtgröße der Greengrass-Systemprotokolldateien in der von Ihnen angegebenen Einheit. `diskSpaceLimitUnit` Wenn die Gesamtgröße der Greengrass-Systemprotokolldateien diese maximale Gesamtgröße überschreitet, löscht die AWS IoT Greengrass Core-Software die ältesten Greengrass-Systemprotokolldateien.
Dieser Parameter entspricht dem Parameter für die [Protokollgrößenbeschränkung](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) der [Greengrass-Kernkomponente](greengrass-nucleus-component.md). Die AWS IoT Greengrass Core-Software verwendet das Minimum der beiden Werte als maximale Gesamtgröße des Greengrass-Systemprotokolls.
`diskSpaceLimitUnit`
(Optional) Die Einheit für die`diskSpaceLimit`. Wählen Sie aus den folgenden Optionen aus:
+ `KB`— Kilobyte
+ `MB`— Megabyte
+ `GB`— Gigabyte
Standard: `KB`
`deleteLogFileAfterCloudUpload`
(Optional) Sie können eine Protokolldatei löschen, nachdem die Log-Manager-Komponente die Protokolle in Logs hochgeladen hat. CloudWatch
Standard: `false`
`componentLogsConfigurationMap`
(Optional) Eine Übersicht der Protokollkonfigurationen für Komponenten auf dem Kerngerät. Jedes `componentName` Objekt in dieser Zuordnung definiert die Protokollkonfiguration für die Komponente oder Anwendung. Die Log-Manager-Komponente lädt diese Komponentenprotokolle in Logs hoch. CloudWatch
Wir empfehlen dringend, einen einzigen Konfigurationsschlüssel pro Komponente zu verwenden. Sie sollten nur auf eine Gruppe von Dateien abzielen, die nur eine Protokolldatei haben, in die aktiv geschrieben wird, wenn Sie die verwenden`logFileRegex`. Die Nichtbeachtung dieser Empfehlung kann dazu führen, dass doppelte Protokolle hochgeladen werden CloudWatch. [Wenn Sie auf mehrere aktive Protokolldateien mit einem einzigen regulären Ausdruck abzielen, empfehlen wir Ihnen, auf Log Manager v2.3.1 zu aktualisieren und eine Änderung Ihrer Konfiguration anhand der Beispielkonfiguration in Betracht zu ziehen.](#log-manager-multiple-logs-v2.3.1)
Wenn Sie ein Upgrade von einer früheren Version von Log Manager als Version 2.2.0 durchführen, können Sie stattdessen weiterhin die Liste verwenden. `componentLogsConfiguration` `componentLogsConfigurationMap` Es wird jedoch dringend empfohlen, das Zuordnungsformat zu verwenden, sodass Sie Aktualisierungen zum Zusammenführen und Zurücksetzen verwenden können, um Konfigurationen für bestimmte Komponenten zu ändern. Informationen zu diesem `componentLogsConfiguration` Parameter finden Sie in den Konfigurationsparametern für Version 2.1.x dieser Komponente.
*`componentName`*
Die Protokollkonfiguration für die *`componentName`* Komponente oder Anwendung für diese Protokollkonfiguration. Sie können den Namen einer Greengrass-Komponente oder einen anderen Wert angeben, um diese Protokollgruppe zu identifizieren.
Jedes Objekt enthält die folgenden Informationen:
`minimumLogLevel`
(Optional) Die Mindestanzahl der hochzuladenden Protokollnachrichten. Diese Mindeststufe gilt nur, wenn die Protokolle dieser Komponente ein bestimmtes JSON-Format verwenden, das Sie im Repository des [AWS IoT Greengrass Protokollierungsmoduls](https://github.com/aws-greengrass/aws-greengrass-logging-java) finden GitHub.
Wählen Sie aus den folgenden Protokollebenen, die hier in der Reihenfolge der Stufen aufgeführt sind:
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Standard: `INFO`
`diskSpaceLimit`
(Optional) Die maximale Gesamtgröße aller Protokolldateien für diese Komponente in der von Ihnen angegebenen Einheit`diskSpaceLimitUnit`. Wenn die Gesamtgröße der Protokolldateien dieser Komponente diese maximale Gesamtgröße überschreitet, löscht die AWS IoT Greengrass Core-Software die ältesten Protokolldateien dieser Komponente.
Dieser Parameter bezieht sich auf den Parameter für die [Loggrößenbeschränkung](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) der [Greengrass-Kernkomponente](greengrass-nucleus-component.md). Die AWS IoT Greengrass Core-Software verwendet den kleinsten der beiden Werte als maximale Gesamtprotokollgröße für diese Komponente.
`diskSpaceLimitUnit`
(Optional) Die Einheit für die`diskSpaceLimit`. Wählen Sie aus den folgenden Optionen aus:
+ `KB`— Kilobyte
+ `MB`— Megabyte
+ `GB`— Gigabyte
Standard: `KB`
`logFileDirectoryPath`
(Optional) Der Pfad zu dem Ordner, der die Protokolldateien dieser Komponente enthält.
Sie müssen diesen Parameter nicht für Greengrass-Komponenten angeben, die auf Standardausgabe (stdout) und Standardfehler (stderr) drucken.
Standard: `/greengrass/v2/logs`.
`logFileRegex`
(Optional) Ein regulärer Ausdruck, der das Format des Protokolldateinamens angibt, das die Komponente oder Anwendung verwendet. Die Log Manager-Komponente verwendet diesen regulären Ausdruck, um Protokolldateien im Ordner unter zu identifizieren`logFileDirectoryPath`.
Sie müssen diesen Parameter nicht für Greengrass-Komponenten angeben, die auf Standardausgabe (stdout) und Standardfehler (stderr) drucken.
Wenn Ihre Komponente oder Anwendung Protokolldateien rotiert, geben Sie einen regulären Ausdruck an, der den Namen der rotierten Protokolldateien entspricht. Sie könnten beispielsweise angeben**hello\$1world\$1\$1\$1\$1w\$1.log**, dass Protokolle für eine Hello World-Anwendung hochgeladen werden sollen. Das `\\\\w*` Muster entspricht null oder mehr Wortzeichen, einschließlich alphanumerischer Zeichen und Unterstriche. Dieser reguläre Ausdruck entspricht Protokolldateien mit und ohne Zeitstempel im Namen. In diesem Beispiel lädt der Protokollmanager die folgenden Protokolldateien hoch:
+ `hello_world.log`— Die neueste Protokolldatei für die Hello World-Anwendung.
+ `hello_world_2020_12_15_17_0.log`— Eine ältere Protokolldatei für die Hello World-Anwendung.
Standard:`componentName\\\\w*.log`, wobei *componentName* der Name der Komponente für diese Protokollkonfiguration ist.
`deleteLogFileAfterCloudUpload`
(Optional) Sie können eine Protokolldatei löschen, nachdem die Log-Manager-Komponente die Protokolle in Logs hochgeladen hat. CloudWatch
Standard: `false`
`multiLineStartPattern`
(Optional) Ein regulärer Ausdruck, der angibt, wann es sich bei einer Protokollnachricht in einer neuen Zeile um eine neue Protokollnachricht handelt. Wenn der reguläre Ausdruck nicht mit der neuen Zeile übereinstimmt, hängt die Log-Manager-Komponente die neue Zeile an die Protokollnachricht für die vorherige Zeile an.
Standardmäßig prüft die Log Manager-Komponente, ob die Zeile mit einem Leerzeichen beginnt, z. B. einem Tabulator oder einem Leerzeichen. Ist dies nicht der Fall, behandelt der Protokollmanager diese Zeile als neue Protokollnachricht. Andernfalls wird diese Zeile an die aktuelle Protokollnachricht angehängt. Dieses Verhalten stellt sicher, dass die Log-Manager-Komponente Nachrichten, die sich über mehrere Zeilen erstrecken, nicht aufteilt, wie z. B. Stack-Traces.
`periodicUploadIntervalSec`
(Optional) Der Zeitraum in Sekunden, in dem die Log Manager-Komponente nach neuen Protokolldateien sucht, die hochgeladen werden können.
Standard: `300` (5 Minuten)
Minimum: `0.000001` (1 Mikrosekunde)
**Example Beispiel: Aktualisierung der Zusammenführung von Konfigurationen**
Die folgende Beispielkonfiguration legt fest, dass System- und `com.example.HelloWorld` Komponentenprotokolle in Logs hochgeladen werden CloudWatch sollen.
```
{
"logsUploaderConfiguration": {
"systemLogsConfiguration": {
"uploadToCloudWatch": "true",
"minimumLogLevel": "INFO",
"diskSpaceLimit": "10",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
},
"componentLogsConfigurationMap": {
"com.example.HelloWorld": {
"minimumLogLevel": "INFO",
"diskSpaceLimit": "20",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
}
}
},
"periodicUploadIntervalSec": "300"
}
```
**Example Beispiel: Konfiguration zum Hochladen mehrerer aktiver Protokolldateien mit Log Manager v2.3.1**
Die folgende Beispielkonfiguration ist das empfohlene Beispiel, wenn Sie mehrere aktive Protokolldateien als Ziel verwenden möchten. Diese Beispielkonfiguration gibt an, in welche aktiven Protokolldateien Sie hochladen möchten CloudWatch. Bei Verwendung dieser Beispielkonfiguration werden auch alle rotierten Dateien hochgeladen, die dem entsprechen`logFileRegex`. Diese Beispielkonfiguration wird von Log Manager v2.3.1 unterstützt.
```
{
"logsUploaderConfiguration": {
"componentLogsConfigurationMap": {
"com.example.A": {
"logFileRegex": "com.example.A\\w*.log",
"deleteLogFileAfterCloudUpload": "false"
}
"com.example.B": {
"logFileRegex": "com.example.B\\w*.log",
"deleteLogFileAfterCloudUpload": "false"
}
}
},
"periodicUploadIntervalSec": "10"
}
```
------
#### [ v2.2.x ]
`logsUploaderConfiguration`
(Optional) Die Konfiguration für Protokolle, die die Log Manager-Komponente hochlädt. Dieses Objekt enthält die folgenden Informationen:
`systemLogsConfiguration`
(Optional) Die Konfiguration für AWS IoT Greengrass Core-Softwaresystemprotokolle, die Protokolle der [Greengrass-Nukleus](greengrass-nucleus-component.md) - und [Plugin-Komponenten](develop-greengrass-components.md#component-types) enthalten. Geben Sie diese Konfiguration an, damit die Log-Manager-Komponente Systemprotokolle verwalten kann. Dieses Objekt enthält die folgenden Informationen:
`uploadToCloudWatch`
(Optional) Sie können Systemprotokolle in CloudWatch Logs hochladen.
Standard: `false`
`minimumLogLevel`
(Optional) Die Mindestanzahl an Protokollnachrichten, die hochgeladen werden sollen. Diese Mindeststufe gilt nur, wenn Sie die [Greengrass Nucleus-Komponente](greengrass-nucleus-component.md) für die Ausgabe von Protokollen im JSON-Format konfigurieren. Um Logs im JSON-Format zu aktivieren, geben Sie `JSON` für den [Logging-Formatparameter](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-logging-format) (`logging.format`) an.
Wählen Sie aus den folgenden Protokollebenen, die hier in der Reihenfolge der Stufen aufgeführt sind:
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Standard: `INFO`
`diskSpaceLimit`
(Optional) Die maximale Gesamtgröße der Greengrass-Systemprotokolldateien in der von Ihnen angegebenen Einheit. `diskSpaceLimitUnit` Wenn die Gesamtgröße der Greengrass-Systemprotokolldateien diese maximale Gesamtgröße überschreitet, löscht die AWS IoT Greengrass Core-Software die ältesten Greengrass-Systemprotokolldateien.
Dieser Parameter entspricht dem Parameter für die [Protokollgrößenbeschränkung](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) der [Greengrass-Kernkomponente](greengrass-nucleus-component.md). Die AWS IoT Greengrass Core-Software verwendet das Minimum der beiden Werte als maximale Gesamtgröße des Greengrass-Systemprotokolls.
`diskSpaceLimitUnit`
(Optional) Die Einheit für die`diskSpaceLimit`. Wählen Sie aus den folgenden Optionen aus:
+ `KB`— Kilobyte
+ `MB`— Megabyte
+ `GB`— Gigabyte
Standard: `KB`
`deleteLogFileAfterCloudUpload`
(Optional) Sie können eine Protokolldatei löschen, nachdem die Log-Manager-Komponente die Protokolle in Logs hochgeladen hat. CloudWatch
Standard: `false`
`componentLogsConfigurationMap`
(Optional) Eine Übersicht der Protokollkonfigurationen für Komponenten auf dem Kerngerät. Jedes `componentName` Objekt in dieser Zuordnung definiert die Protokollkonfiguration für die Komponente oder Anwendung. Die Log-Manager-Komponente lädt diese Komponentenprotokolle in Logs hoch. CloudWatch
Wenn Sie ein Upgrade von einer früheren Version von Log Manager als Version 2.2.0 durchführen, können Sie stattdessen weiterhin die `componentLogsConfiguration` Liste verwenden. `componentLogsConfigurationMap` Es wird jedoch dringend empfohlen, das Zuordnungsformat zu verwenden, sodass Sie Aktualisierungen zum Zusammenführen und Zurücksetzen verwenden können, um Konfigurationen für bestimmte Komponenten zu ändern. Informationen zu diesem `componentLogsConfiguration` Parameter finden Sie in den Konfigurationsparametern für Version 2.1.x dieser Komponente.
*`componentName`*
Die Protokollkonfiguration für die *`componentName`* Komponente oder Anwendung für diese Protokollkonfiguration. Sie können den Namen einer Greengrass-Komponente oder einen anderen Wert angeben, um diese Protokollgruppe zu identifizieren.
Jedes Objekt enthält die folgenden Informationen:
`minimumLogLevel`
(Optional) Die Mindestanzahl der hochzuladenden Protokollnachrichten. Diese Mindeststufe gilt nur, wenn die Protokolle dieser Komponente ein bestimmtes JSON-Format verwenden, das Sie im Repository des [AWS IoT Greengrass Protokollierungsmoduls](https://github.com/aws-greengrass/aws-greengrass-logging-java) finden GitHub.
Wählen Sie aus den folgenden Protokollebenen, die hier in der Reihenfolge der Stufen aufgeführt sind:
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Standard: `INFO`
`diskSpaceLimit`
(Optional) Die maximale Gesamtgröße aller Protokolldateien für diese Komponente in der von Ihnen angegebenen Einheit`diskSpaceLimitUnit`. Wenn die Gesamtgröße der Protokolldateien dieser Komponente diese maximale Gesamtgröße überschreitet, löscht die AWS IoT Greengrass Core-Software die ältesten Protokolldateien dieser Komponente.
Dieser Parameter bezieht sich auf den Parameter für die [Loggrößenbeschränkung](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) der [Greengrass-Kernkomponente](greengrass-nucleus-component.md). Die AWS IoT Greengrass Core-Software verwendet den kleinsten der beiden Werte als maximale Gesamtprotokollgröße für diese Komponente.
`diskSpaceLimitUnit`
(Optional) Die Einheit für die`diskSpaceLimit`. Wählen Sie aus den folgenden Optionen aus:
+ `KB`— Kilobyte
+ `MB`— Megabyte
+ `GB`— Gigabyte
Standard: `KB`
`logFileDirectoryPath`
(Optional) Der Pfad zu dem Ordner, der die Protokolldateien dieser Komponente enthält.
Sie müssen diesen Parameter nicht für Greengrass-Komponenten angeben, die auf Standardausgabe (stdout) und Standardfehler (stderr) drucken.
Standard: `/greengrass/v2/logs`.
`logFileRegex`
(Optional) Ein regulärer Ausdruck, der das Format des Protokolldateinamens angibt, das die Komponente oder Anwendung verwendet. Die Log Manager-Komponente verwendet diesen regulären Ausdruck, um Protokolldateien im Ordner unter zu identifizieren`logFileDirectoryPath`.
Sie müssen diesen Parameter nicht für Greengrass-Komponenten angeben, die auf Standardausgabe (stdout) und Standardfehler (stderr) drucken.
Wenn Ihre Komponente oder Anwendung Protokolldateien rotiert, geben Sie einen regulären Ausdruck an, der den Namen der rotierten Protokolldateien entspricht. Sie könnten beispielsweise angeben**hello\$1world\$1\$1\$1\$1w\$1.log**, dass Protokolle für eine Hello World-Anwendung hochgeladen werden sollen. Das `\\\\w*` Muster entspricht null oder mehr Wortzeichen, einschließlich alphanumerischer Zeichen und Unterstriche. Dieser reguläre Ausdruck entspricht Protokolldateien mit und ohne Zeitstempel im Namen. In diesem Beispiel lädt der Protokollmanager die folgenden Protokolldateien hoch:
+ `hello_world.log`— Die neueste Protokolldatei für die Hello World-Anwendung.
+ `hello_world_2020_12_15_17_0.log`— Eine ältere Protokolldatei für die Hello World-Anwendung.
Standard:`componentName\\\\w*.log`, wobei *componentName* der Name der Komponente für diese Protokollkonfiguration ist.
`deleteLogFileAfterCloudUpload`
(Optional) Sie können eine Protokolldatei löschen, nachdem die Log-Manager-Komponente die Protokolle in Logs hochgeladen hat. CloudWatch
Standard: `false`
`multiLineStartPattern`
(Optional) Ein regulärer Ausdruck, der angibt, wann es sich bei einer Protokollnachricht in einer neuen Zeile um eine neue Protokollnachricht handelt. Wenn der reguläre Ausdruck nicht mit der neuen Zeile übereinstimmt, hängt die Log-Manager-Komponente die neue Zeile an die Protokollnachricht für die vorherige Zeile an.
Standardmäßig prüft die Log Manager-Komponente, ob die Zeile mit einem Leerzeichen beginnt, z. B. einem Tabulator oder einem Leerzeichen. Ist dies nicht der Fall, behandelt der Protokollmanager diese Zeile als neue Protokollnachricht. Andernfalls wird diese Zeile an die aktuelle Protokollnachricht angehängt. Dieses Verhalten stellt sicher, dass die Log-Manager-Komponente Nachrichten, die sich über mehrere Zeilen erstrecken, nicht aufteilt, wie z. B. Stack-Traces.
`periodicUploadIntervalSec`
(Optional) Der Zeitraum in Sekunden, in dem die Log Manager-Komponente nach neuen Protokolldateien sucht, die hochgeladen werden können.
Standard: `300` (5 Minuten)
Minimum: `0.000001` (1 Mikrosekunde)
**Example Beispiel: Aktualisierung der Zusammenführung von Konfigurationen**
Die folgende Beispielkonfiguration legt fest, dass System- und `com.example.HelloWorld` Komponentenprotokolle in Logs hochgeladen werden CloudWatch sollen.
```
{
"logsUploaderConfiguration": {
"systemLogsConfiguration": {
"uploadToCloudWatch": "true",
"minimumLogLevel": "INFO",
"diskSpaceLimit": "10",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
},
"componentLogsConfigurationMap": {
"com.example.HelloWorld": {
"minimumLogLevel": "INFO",
"diskSpaceLimit": "20",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
}
}
},
"periodicUploadIntervalSec": "300"
}
```
------
#### [ v2.1.x ]
`logsUploaderConfiguration`
(Optional) Die Konfiguration für Protokolle, die die Log Manager-Komponente hochlädt. Dieses Objekt enthält die folgenden Informationen:
`systemLogsConfiguration`
(Optional) Die Konfiguration für AWS IoT Greengrass Core-Softwaresystemprotokolle, die Protokolle der [Greengrass-Nukleus](greengrass-nucleus-component.md) - und [Plugin-Komponenten](develop-greengrass-components.md#component-types) enthalten. Geben Sie diese Konfiguration an, damit die Log-Manager-Komponente Systemprotokolle verwalten kann. Dieses Objekt enthält die folgenden Informationen:
`uploadToCloudWatch`
(Optional) Sie können Systemprotokolle in CloudWatch Logs hochladen.
Standard: `false`
`minimumLogLevel`
(Optional) Die Mindestanzahl an Protokollnachrichten, die hochgeladen werden sollen. Diese Mindeststufe gilt nur, wenn Sie die [Greengrass Nucleus-Komponente](greengrass-nucleus-component.md) für die Ausgabe von Protokollen im JSON-Format konfigurieren. Um Logs im JSON-Format zu aktivieren, geben Sie `JSON` für den [Logging-Formatparameter](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-logging-format) (`logging.format`) an.
Wählen Sie aus den folgenden Protokollebenen, die hier in der Reihenfolge der Stufen aufgeführt sind:
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Standard: `INFO`
`diskSpaceLimit`
(Optional) Die maximale Gesamtgröße der Greengrass-Systemprotokolldateien in der von Ihnen angegebenen Einheit. `diskSpaceLimitUnit` Wenn die Gesamtgröße der Greengrass-Systemprotokolldateien diese maximale Gesamtgröße überschreitet, löscht die AWS IoT Greengrass Core-Software die ältesten Greengrass-Systemprotokolldateien.
Dieser Parameter entspricht dem Parameter für die [Protokollgrößenbeschränkung](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) der [Greengrass-Kernkomponente](greengrass-nucleus-component.md). Die AWS IoT Greengrass Core-Software verwendet das Minimum der beiden Werte als maximale Gesamtgröße des Greengrass-Systemprotokolls.
`diskSpaceLimitUnit`
(Optional) Die Einheit für die`diskSpaceLimit`. Wählen Sie aus den folgenden Optionen aus:
+ `KB`— Kilobyte
+ `MB`— Megabyte
+ `GB`— Gigabyte
Standard: `KB`
`deleteLogFileAfterCloudUpload`
(Optional) Sie können eine Protokolldatei löschen, nachdem die Log-Manager-Komponente die Protokolle in Logs hochgeladen hat. CloudWatch
Standard: `false`
`componentLogsConfiguration`
(Optional) Eine Liste der Protokollkonfigurationen für Komponenten auf dem Kerngerät. Jede Konfiguration in dieser Liste definiert die Protokollkonfiguration für eine Komponente oder Anwendung. Die Log-Manager-Komponente lädt diese Komponentenprotokolle in Logs hoch CloudWatch
Jedes Objekt enthält die folgenden Informationen:
`componentName`
Der Name der Komponente oder Anwendung für diese Protokollkonfiguration. Sie können den Namen einer Greengrass-Komponente oder einen anderen Wert angeben, um diese Protokollgruppe zu identifizieren.
`minimumLogLevel`
(Optional) Die Mindestanzahl der hochzuladenden Protokollnachrichten. Diese Mindeststufe gilt nur, wenn die Protokolle dieser Komponente ein bestimmtes JSON-Format verwenden, das Sie im Repository des [AWS IoT Greengrass Protokollierungsmoduls](https://github.com/aws-greengrass/aws-greengrass-logging-java) finden GitHub.
Wählen Sie aus den folgenden Protokollebenen, die hier in der Reihenfolge der Stufen aufgeführt sind:
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Standard: `INFO`
`diskSpaceLimit`
(Optional) Die maximale Gesamtgröße aller Protokolldateien für diese Komponente in der von Ihnen angegebenen Einheit`diskSpaceLimitUnit`. Wenn die Gesamtgröße der Protokolldateien dieser Komponente diese maximale Gesamtgröße überschreitet, löscht die AWS IoT Greengrass Core-Software die ältesten Protokolldateien dieser Komponente.
Dieser Parameter bezieht sich auf den Parameter für die [Loggrößenbeschränkung](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) der [Greengrass-Kernkomponente](greengrass-nucleus-component.md). Die AWS IoT Greengrass Core-Software verwendet den kleinsten der beiden Werte als maximale Gesamtprotokollgröße für diese Komponente.
`diskSpaceLimitUnit`
(Optional) Die Einheit für die`diskSpaceLimit`. Wählen Sie aus den folgenden Optionen aus:
+ `KB`— Kilobyte
+ `MB`— Megabyte
+ `GB`— Gigabyte
Standard: `KB`
`logFileDirectoryPath`
(Optional) Der Pfad zu dem Ordner, der die Protokolldateien dieser Komponente enthält.
Sie müssen diesen Parameter nicht für Greengrass-Komponenten angeben, die auf Standardausgabe (stdout) und Standardfehler (stderr) drucken.
Standard: `/greengrass/v2/logs`.
`logFileRegex`
(Optional) Ein regulärer Ausdruck, der das Format des Protokolldateinamens angibt, das die Komponente oder Anwendung verwendet. Die Log Manager-Komponente verwendet diesen regulären Ausdruck, um Protokolldateien im Ordner unter zu identifizieren`logFileDirectoryPath`.
Sie müssen diesen Parameter nicht für Greengrass-Komponenten angeben, die auf Standardausgabe (stdout) und Standardfehler (stderr) drucken.
Wenn Ihre Komponente oder Anwendung Protokolldateien rotiert, geben Sie einen regulären Ausdruck an, der den Namen der rotierten Protokolldateien entspricht. Sie könnten beispielsweise angeben**hello\$1world\$1\$1\$1\$1w\$1.log**, dass Protokolle für eine Hello World-Anwendung hochgeladen werden sollen. Das `\\\\w*` Muster entspricht null oder mehr Wortzeichen, einschließlich alphanumerischer Zeichen und Unterstriche. Dieser reguläre Ausdruck entspricht Protokolldateien mit und ohne Zeitstempel im Namen. In diesem Beispiel lädt der Protokollmanager die folgenden Protokolldateien hoch:
+ `hello_world.log`— Die neueste Protokolldatei für die Hello World-Anwendung.
+ `hello_world_2020_12_15_17_0.log`— Eine ältere Protokolldatei für die Hello World-Anwendung.
Standard:`componentName\\\\w*.log`, wobei *componentName* der Name der Komponente für diese Protokollkonfiguration ist.
`deleteLogFileAfterCloudUpload`
(Optional) Sie können eine Protokolldatei löschen, nachdem die Log-Manager-Komponente die Protokolle in Logs hochgeladen hat. CloudWatch
Standard: `false`
`multiLineStartPattern`
(Optional) Ein regulärer Ausdruck, der angibt, wann es sich bei einer Protokollnachricht in einer neuen Zeile um eine neue Protokollnachricht handelt. Wenn der reguläre Ausdruck nicht mit der neuen Zeile übereinstimmt, hängt die Log-Manager-Komponente die neue Zeile an die Protokollnachricht für die vorherige Zeile an.
Standardmäßig prüft die Log Manager-Komponente, ob die Zeile mit einem Leerzeichen beginnt, z. B. einem Tabulator oder einem Leerzeichen. Ist dies nicht der Fall, behandelt der Protokollmanager diese Zeile als neue Protokollnachricht. Andernfalls wird diese Zeile an die aktuelle Protokollnachricht angehängt. Dieses Verhalten stellt sicher, dass die Log-Manager-Komponente Nachrichten, die sich über mehrere Zeilen erstrecken, nicht aufteilt, wie z. B. Stack-Traces.
`periodicUploadIntervalSec`
(Optional) Der Zeitraum in Sekunden, in dem die Log Manager-Komponente nach neuen Protokolldateien sucht, die hochgeladen werden können.
Standard: `300` (5 Minuten)
Minimum: `0.000001` (1 Mikrosekunde)
**Example Beispiel: Aktualisierung der Zusammenführung von Konfigurationen**
Die folgende Beispielkonfiguration legt fest, dass System- und `com.example.HelloWorld` Komponentenprotokolle in Logs hochgeladen werden CloudWatch sollen.
```
{
"logsUploaderConfiguration": {
"systemLogsConfiguration": {
"uploadToCloudWatch": "true",
"minimumLogLevel": "INFO",
"diskSpaceLimit": "10",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
},
"componentLogsConfiguration": [
{
"componentName": "com.example.HelloWorld",
"minimumLogLevel": "INFO",
"diskSpaceLimit": "20",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
}
]
},
"periodicUploadIntervalSec": "300"
}
```
------
#### [ v2.0.x ]
`logsUploaderConfiguration`
(Optional) Die Konfiguration für Protokolle, die die Log Manager-Komponente hochlädt. Dieses Objekt enthält die folgenden Informationen:
`systemLogsConfiguration`
(Optional) Die Konfiguration für AWS IoT Greengrass Core-Software-Systemprotokolle. Geben Sie diese Konfiguration an, damit die Log Manager-Komponente Systemprotokolle verwalten kann. Dieses Objekt enthält die folgenden Informationen:
`uploadToCloudWatch`
(Optional) Sie können Systemprotokolle in CloudWatch Logs hochladen.
Standard: `false`
`minimumLogLevel`
(Optional) Die Mindestanzahl an Protokollnachrichten, die hochgeladen werden sollen. Diese Mindeststufe gilt nur, wenn Sie die [Greengrass Nucleus-Komponente](greengrass-nucleus-component.md) für die Ausgabe von Protokollen im JSON-Format konfigurieren. Um Logs im JSON-Format zu aktivieren, geben Sie `JSON` für den [Logging-Formatparameter](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-logging-format) (`logging.format`) an.
Wählen Sie aus den folgenden Protokollebenen, die hier in der Reihenfolge der Stufen aufgeführt sind:
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Standard: `INFO`
`diskSpaceLimit`
(Optional) Die maximale Gesamtgröße der Greengrass-Systemprotokolldateien in der von Ihnen angegebenen Einheit. `diskSpaceLimitUnit` Wenn die Gesamtgröße der Greengrass-Systemprotokolldateien diese maximale Gesamtgröße überschreitet, löscht die AWS IoT Greengrass Core-Software die ältesten Greengrass-Systemprotokolldateien.
Dieser Parameter entspricht dem Parameter für die [Protokollgrößenbeschränkung](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) der [Greengrass-Kernkomponente](greengrass-nucleus-component.md). Die AWS IoT Greengrass Core-Software verwendet das Minimum der beiden Werte als maximale Gesamtgröße des Greengrass-Systemprotokolls.
`diskSpaceLimitUnit`
(Optional) Die Einheit für die`diskSpaceLimit`. Wählen Sie aus den folgenden Optionen aus:
+ `KB`— Kilobyte
+ `MB`— Megabyte
+ `GB`— Gigabyte
Standard: `KB`
`deleteLogFileAfterCloudUpload`
(Optional) Sie können eine Protokolldatei löschen, nachdem die Log-Manager-Komponente die Protokolle in Logs hochgeladen hat. CloudWatch
Standard: `false`
`componentLogsConfiguration`
(Optional) Eine Liste der Protokollkonfigurationen für Komponenten auf dem Kerngerät. Jede Konfiguration in dieser Liste definiert die Protokollkonfiguration für eine Komponente oder Anwendung. Die Log-Manager-Komponente lädt diese Komponentenprotokolle in Logs hoch CloudWatch
Jedes Objekt enthält die folgenden Informationen:
`componentName`
Der Name der Komponente oder Anwendung für diese Protokollkonfiguration. Sie können den Namen einer Greengrass-Komponente oder einen anderen Wert angeben, um diese Protokollgruppe zu identifizieren.
`minimumLogLevel`
(Optional) Die Mindestanzahl der hochzuladenden Protokollnachrichten. Diese Mindeststufe gilt nur, wenn die Protokolle dieser Komponente ein bestimmtes JSON-Format verwenden, das Sie im Repository des [AWS IoT Greengrass Protokollierungsmoduls](https://github.com/aws-greengrass/aws-greengrass-logging-java) finden GitHub.
Wählen Sie aus den folgenden Protokollebenen, die hier in der Reihenfolge der Stufen aufgeführt sind:
+ `DEBUG`
+ `INFO`
+ `WARN`
+ `ERROR`
Standard: `INFO`
`diskSpaceLimit`
(Optional) Die maximale Gesamtgröße aller Protokolldateien für diese Komponente in der von Ihnen angegebenen Einheit`diskSpaceLimitUnit`. Wenn die Gesamtgröße der Protokolldateien dieser Komponente diese maximale Gesamtgröße überschreitet, löscht die AWS IoT Greengrass Core-Software die ältesten Protokolldateien dieser Komponente.
Dieser Parameter bezieht sich auf den Parameter für die [Loggrößenbeschränkung](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-system-logs-limit) (`totalLogsSizeKB`) der [Greengrass-Kernkomponente](greengrass-nucleus-component.md). Die AWS IoT Greengrass Core-Software verwendet den kleinsten der beiden Werte als maximale Gesamtprotokollgröße für diese Komponente.
`diskSpaceLimitUnit`
(Optional) Die Einheit für die`diskSpaceLimit`. Wählen Sie aus den folgenden Optionen aus:
+ `KB`— Kilobyte
+ `MB`— Megabyte
+ `GB`— Gigabyte
Standard: `KB`
`logFileDirectoryPath`
Der Pfad zu dem Ordner, der die Protokolldateien dieser Komponente enthält.
Um die Protokolle einer Greengrass-Komponente hochzuladen**`/greengrass/v2`/logs**, geben Sie Ihren Greengrass-Stammordner an und `/greengrass/v2` ersetzen Sie ihn durch diesen.
`logFileRegex`
Ein regulärer Ausdruck, der das Namensformat der Protokolldatei angibt, das die Komponente oder Anwendung verwendet. Die Log Manager-Komponente verwendet diesen regulären Ausdruck, um Protokolldateien im Ordner unter zu identifizieren`logFileDirectoryPath`.
Um die Logs einer Greengrass-Komponente hochzuladen, geben Sie eine Regex an, die den rotierten Log-Dateinamen entspricht. Sie könnten beispielsweise angeben**com.example.HelloWorld\$1\$1w\$1.log**, dass Protokolle für eine Hello World-Komponente hochgeladen werden sollen. Das `\\w*` Muster entspricht null oder mehr Wortzeichen, einschließlich alphanumerischer Zeichen und Unterstriche. Dieser reguläre Ausdruck entspricht Protokolldateien mit und ohne Zeitstempel im Namen. In diesem Beispiel lädt der Protokollmanager die folgenden Protokolldateien hoch:
+ `com.example.HelloWorld.log`— Die neueste Protokolldatei für die Hello World-Komponente.
+ `com.example.HelloWorld_2020_12_15_17_0.log`— Eine ältere Protokolldatei für die Hello World-Komponente. Der Greengrass-Kern fügt den Protokolldateien einen rotierenden Zeitstempel hinzu.
`deleteLogFileAfterCloudUpload`
(Optional) Sie können eine Protokolldatei löschen, nachdem die Log-Manager-Komponente die Protokolle in Logs hochgeladen hat. CloudWatch
Standard: `false`
`multiLineStartPattern`
(Optional) Ein regulärer Ausdruck, der angibt, wann es sich bei einer Protokollnachricht in einer neuen Zeile um eine neue Protokollnachricht handelt. Wenn der reguläre Ausdruck nicht mit der neuen Zeile übereinstimmt, hängt die Log-Manager-Komponente die neue Zeile an die Protokollnachricht für die vorherige Zeile an.
Standardmäßig prüft die Log Manager-Komponente, ob die Zeile mit einem Leerzeichen beginnt, z. B. einem Tabulator oder einem Leerzeichen. Ist dies nicht der Fall, behandelt der Protokollmanager diese Zeile als neue Protokollnachricht. Andernfalls wird diese Zeile an die aktuelle Protokollnachricht angehängt. Dieses Verhalten stellt sicher, dass die Log-Manager-Komponente Nachrichten, die sich über mehrere Zeilen erstrecken, nicht aufteilt, wie z. B. Stack-Traces.
`periodicUploadIntervalSec`
(Optional) Der Zeitraum in Sekunden, in dem die Log Manager-Komponente nach neuen Protokolldateien sucht, die hochgeladen werden können.
Standard: `300` (5 Minuten)
Minimum: `0.000001` (1 Mikrosekunde)
**Example Beispiel: Aktualisierung der Zusammenführung von Konfigurationen**
Die folgende Beispielkonfiguration legt fest, dass System- und `com.example.HelloWorld` Komponentenprotokolle in Logs hochgeladen werden CloudWatch sollen.
```
{
"logsUploaderConfiguration": {
"systemLogsConfiguration": {
"uploadToCloudWatch": "true",
"minimumLogLevel": "INFO",
"diskSpaceLimit": "10",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
},
"componentLogsConfiguration": [
{
"componentName": "com.example.HelloWorld",
"minimumLogLevel": "INFO",
"logFileDirectoryPath": "/greengrass/v2/logs",
"logFileRegex": "com.example.HelloWorld\\w*.log",
"diskSpaceLimit": "20",
"diskSpaceLimitUnit": "MB",
"deleteLogFileAfterCloudUpload": "false"
}
]
},
"periodicUploadIntervalSec": "300"
}
```
------
## Usage
Die Log-Manager-Komponente lädt Dateien in die folgenden Protokollgruppen und Protokolldatenströme hoch.
------
#### [ 2.1.0 and later ]
**Name der Protokollgruppe**
```
/aws/greengrass/componentType/region/componentName
```
Der Name der Protokollgruppe verwendet die folgenden Variablen:
+ `componentType`— Der Typ der Komponente, der einer der folgenden sein kann:
+ `GreengrassSystemComponent`— Diese Protokollgruppe umfasst Protokolle für die Nucleus- und Plugin-Komponenten, die in derselben JVM wie der Greengrass-Nucleus ausgeführt werden. Die Komponente ist Teil des [Greengrass-Kerns](greengrass-nucleus-component.md).
+ `UserComponent`— Diese Protokollgruppe umfasst Protokolle für generische Komponenten, Lambda-Komponenten und andere Anwendungen auf dem Gerät. Die Komponente ist nicht Teil des Greengrass-Kerns.
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
+ `region`— Die AWS Region, die das Kerngerät verwendet.
+ `componentName`— Der Name der Komponente. Für Systemprotokolle ist dieser Wert`System`.
**Name des Protokollstreams**
```
/date/thing/thingName
```
Der Name des Protokolldatenstroms verwendet die folgenden Variablen:
+ `date`— Das Datum des Protokolls, z. `2020/12/15` B. Die Log-Manager-Komponente verwendet das `yyyy/MM/dd` Format.
+ `thingName`— Der Name des Kerngeräts.
Wenn ein Dingname einen Doppelpunkt (`:`) enthält, ersetzt der Logmanager den Doppelpunkt durch ein Plus (`+`).
------
#### [ 2.0.x ]
**Name der Protokollgruppe**
```
/aws/greengrass/componentType/region/componentName
```
Der Name der Protokollgruppe verwendet die folgenden Variablen:
+ `componentType`— Der Typ der Komponente, der einer der folgenden sein kann:
+ `GreengrassSystemComponent`— Die Komponente ist Teil des [Greengrass-Kerns](greengrass-nucleus-component.md).
+ `UserComponent`— Die Komponente ist nicht Teil des Greengrass-Kerns. Der Logmanager verwendet diesen Typ für Greengrass-Komponenten und andere Anwendungen auf dem Gerät.
+ `region`— Die AWS Region, die das Kerngerät verwendet.
+ `componentName`— Der Name der Komponente. Für Systemprotokolle ist dieser Wert`System`.
**Name des Protokollstreams**
```
/date/deploymentTargets/thingName
```
Der Name des Protokolldatenstroms verwendet die folgenden Variablen:
+ `date`— Das Datum des Protokolls, z. `2020/12/15` B. Die Log-Manager-Komponente verwendet das `yyyy/MM/dd` Format.
+ `deploymentTargets`— Die Dinge, zu deren Deployments die Komponente gehört. Die Log-Manager-Komponente trennt jedes Ziel durch einen Schrägstrich. Wenn die Komponente aufgrund einer lokalen Bereitstellung auf dem Kerngerät ausgeführt wird, ist `LOCAL_DEPLOYMENT` dieser Wert.
Stellen Sie sich ein Beispiel vor`MyGreengrassCore`, bei dem Sie ein Kerngerät mit dem Namen haben und das Kerngerät über zwei Bereitstellungen verfügt:
+ Eine Bereitstellung, die auf das Kerngerät abzielt,`MyGreengrassCore`.
+ Eine Bereitstellung, die auf eine Dinggruppe mit dem Namen abzielt`MyGreengrassCoreGroup`, die das Kerngerät enthält.
Die `deploymentTargets` für dieses Kerngerät sind`thing/MyGreengrassCore/thinggroup/MyGreengrassCoreGroup`.
+ `thingName`— Der Name des Kerngeräts.
------
### Formate für Protokolleinträge.
Der Greengrass-Kern schreibt Protokolldateien entweder im String- oder JSON-Format. Bei Systemprotokollen steuern Sie das Format, indem Sie das `format` Feld des `logging` Eintrags festlegen. Sie finden den `logging` Eintrag in der Konfigurationsdatei der Greengrass Nucleus-Komponente. Weitere Informationen finden Sie unter [Greengrass Nucleus-Konfiguration](https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-nucleus-component.html#greengrass-nucleus-component-configuration).
Das Textformat ist formfrei und akzeptiert jede Zeichenfolge. Die folgende Servicemeldung zum Flottenstatus ist ein Beispiel für die Protokollierung im Zeichenkettenformat:
```
2023-03-26T18:18:27.271Z [INFO] (pool-1-thread-2)
com.aws.greengrass.status.FleetStatusService: fss-status-update-published.
Status update published to FSS. {trigger=CADENCE, serviceName=FleetStatusService,
currentState=RUNNING}
```
Sie sollten das JSON-Format verwenden, wenn Sie Protokolle mit dem [Greengrass-CLI-Befehl logs](https://docs.aws.amazon.com/greengrass/v2/developerguide/gg-cli-logs.html) anzeigen oder programmgesteuert mit Protokollen interagieren möchten. Das folgende Beispiel skizziert die JSON-Form:
```
{
"loggerName": ,
"level": <"DEBUG" | "INFO" | "ERROR" | "TRACE" | "WARN">,
"eventType": ,
"cause": ,
"contexts": {},
"thread": ,
"message": ,
"timestamp": # Needs to be epoch time
}
```
Um die Ausgabe der Protokolle Ihrer Komponente zu steuern, können Sie die `minimumLogLevel` Konfigurationsoption verwenden. Um diese Option verwenden zu können, muss Ihre Komponente ihre Protokolleinträge im JSON-Format schreiben. Sie sollten dasselbe Format wie die Systemprotokolldatei verwenden.
## Lokale Protokolldatei
Diese Komponente verwendet dieselbe Protokolldatei wie die [Greengrass Nucleus-Komponente](greengrass-nucleus-component.md).
------
#### [ Linux ]
```
/greengrass/v2/logs/greengrass.log
```
------
#### [ Windows ]
```
C:\greengrass\v2\logs\greengrass.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:\$1greengrass\$1v2* durch den Pfad zum AWS IoT Greengrass Stammordner.
------
#### [ Linux ]
```
sudo tail -f /greengrass/v2/logs/greengrass.log
```
------
#### [ Windows (PowerShell) ]
```
Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
```
------
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| **Version** | **Änderungen** |
| --- | --- |
| 2.3.11 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/log-manager-component.html) |
| 2.3.10 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/log-manager-component.html) |
| 2.3.9 | Die Version wurde für die Version 2.14.0 von Greengrass Nucleus aktualisiert. |
| 2.3.8 | Die Version wurde für die Version 2.13.0 von Greengrass Nucleus aktualisiert. |
| 2.3.7 | Die Version wurde für die Version 2.12.0 von Greengrass Nucleus aktualisiert. |
| 2.3.6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/log-manager-component.html) |
| 2.3.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/log-manager-component.html) Die Version wurde für die Version 2.11.0 von Greengrass Nucleus aktualisiert. |
| 2.3.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/log-manager-component.html) |
| 2.3.3 | Die Version wurde für die Version 2.10.0 von Greengrass Nucleus aktualisiert. |
| 2.3.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/log-manager-component.html) |
| 2.3.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/log-manager-component.html) |
| 2.3.0 | Wir empfehlen, dass Sie auf Greengrass Nucleus 2.9.1 aktualisieren, wenn Sie auf Log Manager 2.3.0 aktualisieren. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/log-manager-component.html) |
| 2.2.8 | Die Version wurde für die Version 2.9.0 von Greengrass Nucleus aktualisiert. |
| 2.2.7 | Die Version wurde für die Version 2.8.0 von Greengrass Nucleus aktualisiert. |
| 2.2.6 | Die Version wurde für die Version 2.7.0 von Greengrass Nucleus aktualisiert. |
| 2.2.5 | Die Version wurde für die Version 2.6.0 von Greengrass Nucleus aktualisiert. |
| 2.2.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/log-manager-component.html) |
| 2.2.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/log-manager-component.html) |
| 2.2.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/log-manager-component.html) |
| 2.2.1 | Die Version wurde für die Version 2.5.0 von Greengrass Nucleus aktualisiert. |
| 2.2.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/log-manager-component.html) |
| 2.1.3 | Die Version wurde für die Version 2.4.0 von Greengrass Nucleus aktualisiert. |
| 2.1.2 | Die Version wurde für die Version 2.3.0 von Greengrass Nucleus aktualisiert. |
| 2.1.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/log-manager-component.html) |
| 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/log-manager-component.html) |
| 2.0.x | Erste Version |
# Komponenten für maschinelles Lernen
AWS IoT Greengrass bietet die folgenden Komponenten für maschinelles Lernen, die Sie auf unterstützten Geräten bereitstellen können, um [Inferenzen für maschinelles Lernen mithilfe von Modellen durchzuführen](perform-machine-learning-inference.md), die in Amazon SageMaker AI trainiert wurden, oder mit Ihren eigenen vortrainierten Modellen, die in Amazon S3 gespeichert sind.
AWS bietet die folgenden Kategorien von Komponenten für maschinelles Lernen:
+ **Modellkomponente** — Enthält Modelle für maschinelles Lernen als Greengrass-Artefakte.
+ **Runtime-Komponente** — Enthält das Skript, das das Machine Learning-Framework und seine Abhängigkeiten auf dem Greengrass-Core-Gerät installiert.
+ **Inferenzkomponente** — Enthält den Inferenzcode und enthält Komponentenabhängigkeiten zur Installation des Frameworks für maschinelles Lernen und zum Herunterladen vorab trainierter Modelle für maschinelles Lernen.
Sie können den Beispiel-Inferenzcode und die vortrainierten Modelle in den AWS bereitgestellten Komponenten für maschinelles Lernen verwenden, um die Bildklassifizierung und Objekterkennung mit DLR und Lite durchzuführen. TensorFlow Um benutzerdefinierte Inferenzen für maschinelles Lernen mit Ihren eigenen Modellen durchzuführen, die in Amazon S3 gespeichert sind, oder um ein anderes Framework für maschinelles Lernen zu verwenden, können Sie die Rezepte dieser öffentlichen Komponenten als Vorlagen verwenden, um benutzerdefinierte maschinelle Lernkomponenten zu erstellen. Weitere Informationen finden Sie unter [Passen Sie Ihre Komponenten für maschinelles Lernen an](ml-customization.md).
AWS IoT Greengrass enthält auch eine AWS bereitgestellte Komponente zur Verwaltung der Installation und des Lebenszyklus des SageMaker AI Edge Manager-Agenten auf Greengrass-Kerngeräten. Mit SageMaker AI Edge Manager können Sie mit Amazon SageMaker AI Neo kompilierte Modelle direkt auf Ihrem Kerngerät verwenden. Weitere Informationen finden Sie unter [Verwenden Sie Amazon SageMaker AI Edge Manager auf Greengrass-Kerngeräten](use-sagemaker-edge-manager.md).
In der folgenden Tabelle sind die Komponenten für maschinelles Lernen aufgeführt, die in AWS IoT Greengrass verfügbar sind.
**Anmerkung**
Einige der AWS bereitgestellten Komponenten hängen von bestimmten Nebenversionen des Greengrass-Kerns ab. Aufgrund dieser Abhängigkeit müssen Sie diese Komponenten aktualisieren, wenn Sie den Greengrass Nucleus auf eine neue Nebenversion aktualisieren. Informationen zu den spezifischen Versionen von Nucleus, von denen jede Komponente abhängt, finden Sie im entsprechenden Komponententhema. Weitere Informationen zur Aktualisierung des Nucleus finden Sie unter[Aktualisieren Sie die AWS IoT Greengrass Core-Software (OTA)](update-greengrass-core-v2.md).
Wenn eine Komponente einen Komponententyp sowohl generisch als auch Lambda hat, ist die aktuelle Version der Komponente der generische Typ und eine frühere Version der Komponente ist der Lambda-Typ.
| Komponente | Description | [Komponententyp](develop-greengrass-components.md#component-types) | Unterstützes Betriebssystem | [Open-Source](open-source.md) |
| --- | --- | --- | --- | --- |
| [SageMaker KI-Edge-Manager](sagemaker-edge-manager-component.md) | Stellt den Amazon SageMaker AI Edge Manager-Agenten auf dem Greengrass-Core-Gerät bereit. | Generisch | Linux, Windows | Nein |
| [DLR-Bildklassifizierung](dlr-image-classification-component.md) | Inferenzkomponente, die den DLR-Bildklassifizierungsmodellspeicher und die DLR-Laufzeitkomponente als Abhängigkeiten verwendet, um DLR zu installieren, Beispielmodelle für die Bildklassifizierung herunterzuladen und Inferenzen zur Bildklassifizierung auf unterstützten Geräten durchzuführen. | Generisch | Linux, Windows | Nein |
| [DLR-Objekterkennung](dlr-object-detection-component.md) | Inferenzkomponente, die den DLR-Objekterkennungsmodellspeicher und die DLR-Laufzeitkomponente als Abhängigkeiten verwendet, um DLR zu installieren, Beispielmodelle zur Objekterkennung herunterzuladen und Objekterkennungsinferenzen auf unterstützten Geräten durchzuführen. | Generisch | Linux, Windows | Nein |
| [Modellspeicher für die DLR-Bildklassifizierung](dlr-image-classification-model-store-component.md) | Modellkomponente, die Stichprobe ResNet -50 Bildklassifizierungsmodelle als Greengrass-Artefakte enthält. | Generisch | Linux, Windows | Nein |
| [Modellspeicher für DLR-Objekterkennung](dlr-object-detection-model-store-component.md) | Modellkomponente, die Beispielmodelle zur YOLOv3 Objekterkennung als Greengrass-Artefakte enthält. | Generisch | Linux, Windows | Nein |
| [DLR-Laufzeit](dlr-component.md) | Runtime-Komponente, die ein Installationsskript enthält, das zur Installation von DLR und seinen Abhängigkeiten auf dem Greengrass-Core-Gerät verwendet wird. | Generisch | Linux, Windows | Nein |
| [TensorFlow Lite-Bildklassifizierung](tensorflow-lite-image-classification-component.md) | Inferenzkomponente, die den TensorFlow Lite-Bildklassifizierungsmodellspeicher und die TensorFlow Lite-Runtime-Komponente als Abhängigkeiten verwendet, um TensorFlow Lite zu installieren, Beispielmodelle für die Bildklassifizierung herunterzuladen und die Inferenz für die Bildklassifizierung auf unterstützten Geräten durchzuführen. | Generisch | Linux, Windows | Nein |
| [TensorFlow Lite-Objekterkennung](tensorflow-lite-object-detection-component.md) | Inferenzkomponente, die den TensorFlow Lite-Objekterkennungsmodellspeicher und die TensorFlow Lite-Laufzeitkomponente als Abhängigkeiten verwendet, um TensorFlow Lite zu installieren, Beispielmodelle für die Objekterkennung herunterzuladen und Objekterkennungsinferenzen auf unterstützten Geräten durchzuführen. | Generisch | Linux, Windows | Nein |
| [TensorFlow Modellspeicher für Lite-Bildklassifizierung](tensorflow-lite-image-classification-model-store-component.md) | Modellkomponente, die ein Beispiel für ein MobileNet v1-Modell als Greengrass-Artefakt enthält. | Generisch | Linux, Windows | Nein |
| [TensorFlow Modellspeicher für Lite-Objekterkennung](tensorflow-lite-object-detection-model-store-component.md) | Modellkomponente, die ein SSD-Beispielmodell (Single Shot Detection) als MobileNet Greengrass-Artefakt enthält. | Generisch | Linux, Windows | Nein |
| [TensorFlow Lite-Laufzeit](tensorflow-lite-component.md) | Runtime-Komponente, die ein Installationsskript enthält, das zur Installation von TensorFlow Lite und seinen Abhängigkeiten auf dem Greengrass-Core-Gerät verwendet wird. | Generisch | Linux, Windows | Nein |
# SageMaker KI-Edge-Manager
**Wichtig**
SageMaker AI Edge Manager wurde am 26. April 2024 eingestellt. Weitere Informationen zur weiteren Bereitstellung Ihrer Modelle auf Edge-Geräten finden Sie unter [Ende der Nutzungsdauer von SageMaker AI Edge Manager](https://docs.aws.amazon.com/sagemaker/latest/dg/edge-eol.html).
Die Amazon SageMaker AI Edge Manager-Komponente (`aws.greengrass.SageMakerEdgeManager`) installiert die SageMaker AI Edge Manager-Agent-Binärdatei.
SageMaker AI Edge Manager bietet Modellmanagement für Edge-Geräte, sodass Sie Modelle für maschinelles Lernen auf Flotten von Edge-Geräten optimieren, sichern, überwachen und verwalten können. Die SageMaker AI Edge Manager-Komponente installiert und verwaltet den Lebenszyklus des SageMaker AI Edge Manager-Agenten auf Ihrem Kerngerät. Sie können SageMaker AI Edge Manager auch verwenden, um mit SageMaker KI Neo kompilierte Modelle als Modellkomponenten auf Greengrass-Kerngeräten zu verpacken und zu verwenden. Weitere Informationen zur Verwendung des SageMaker AI Edge Manager-Agenten auf Ihrem Kerngerät finden Sie unter. [Verwenden Sie Amazon SageMaker AI Edge Manager auf Greengrass-Kerngeräten](use-sagemaker-edge-manager.md)
SageMaker Die AI Edge Manager-Komponente v1.3.x installiert die Edge Manager-Agent-Binärdatei v1.20220822.836f3023. [Weitere Informationen zu den Binärversionen des Edge Manager-Agents finden Sie unter Edge Manager Agent.](https://docs.aws.amazon.com/sagemaker/latest/dg/edge-device-fleet-about)
**Anmerkung**
Die SageMaker AI Edge Manager-Komponente ist nur in den folgenden Versionen verfügbar AWS-Regionen:
US East (Ohio)
USA Ost (Nord-Virginia)
USA West (Oregon)
EU (Frankfurt)
EU (Irland)
Asien-Pazifik (Tokio)
**Topics**
+ [Versionen](#sagemaker-edge-manager-component-versions)
+ [Typ](#sagemaker-edge-manager-component-type)
+ [Betriebssystem](#sagemaker-edge-manager-component-os-support)
+ [Voraussetzungen](#sagemaker-edge-manager-component-requirements)
+ [Abhängigkeiten](#sagemaker-edge-manager-component-dependencies)
+ [Konfiguration](#sagemaker-edge-manager-component-configuration)
+ [Lokale Protokolldatei](#sagemaker-edge-manager-component-log-file)
+ [Änderungsprotokoll](#sagemaker-edge-manager-component-changelog)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 1.3.x
+ 1.2.x
+ 1.1.x
+ 1.0.x
## Typ
Diese Komponente ist eine generische Komponente (`aws.greengrass.generic`). Der [Greengrass-Kern](greengrass-nucleus-component.md) führt die Lebenszyklusskripte der Komponente aus.
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## 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:
+ Ein Greengrass-Core-Gerät, das auf Amazon Linux 2, einer Debian-basierten Linux-Plattform (x86\$164 oder Armv8) oder Windows (x86\$164) läuft. Falls Sie noch keines haben, beachten Sie die Informationen unter [Tutorial: Erste Schritte mit AWS IoT Greengrass V2](getting-started.md).
+ [Python](https://www.python.org/downloads/) 3.6 oder höher, auch `pip` für Ihre Version von Python, die auf Ihrem Kerngerät installiert ist.
+ Die [Greengrass-Geräterolle](device-service-role.md) wurde wie folgt konfiguriert:
+ Eine Vertrauensbeziehung, die es ermöglicht `credentials.iot.amazonaws.com` und `sagemaker.amazonaws.com` die Übernahme der Rolle ermöglicht, wie im folgenden Beispiel für eine IAM-Richtlinie dargestellt.
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "credentials.iot.amazonaws.com"
},
"Action": "sts:AssumeRole"
},
{
"Effect": "Allow",
"Principal": {
"Service": "sagemaker.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
+ Die von [AmazonSageMakerEdgeDeviceFleetPolicy](https://console.aws.amazon.com/iam/home#/policies/arn:aws:iam::aws:policy/service-role/AmazonSageMakerEdgeDeviceFleetPolicy)IAM verwaltete Richtlinie.
+ Die `s3:PutObject` Aktion, wie im folgenden Beispiel für eine IAM-Richtlinie dargestellt.
```
{
"Version": "2012-10-17",
"Statement": [
{
"Action": [
"s3:PutObject"
],
"Resource": [
"*"
],
"Effect": "Allow"
}
]
}
```
+ Ein Amazon S3 S3-Bucket, der im selben AWS-Konto und AWS-Region wie Ihr Greengrass-Core-Gerät erstellt wurde. SageMaker AI Edge Manager benötigt einen S3-Bucket, um eine Edge-Geräteflotte zu erstellen und Beispieldaten aus laufenden Inferenzen auf Ihrem Gerät zu speichern. Informationen zum Erstellen von S3-Buckets finden Sie unter [Erste Schritte mit Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/GetStartedWithS3.html).
+ Eine SageMaker KI-Edge-Geräteflotte, die denselben AWS IoT Rollenalias wie Ihr Greengrass-Core-Gerät verwendet. Weitere Informationen finden Sie unter [Erstellen Sie eine Flotte von Edge-Geräten](get-started-with-edge-manager-on-greengrass.md#create-edge-device-fleet-for-greengrass).
+ Ihr Greengrass-Core-Gerät ist als Edge-Gerät in Ihrer SageMaker AI Edge-Geräteflotte registriert. Der Name des Edge-Geräts muss mit dem AWS IoT Dingnamen für Ihr Core-Gerät übereinstimmen. Weitere Informationen finden Sie unter [Registrieren Sie Ihr Greengrass Core-Gerät](get-started-with-edge-manager-on-greengrass.md#register-greengrass-core-device-in-sme).
### 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 [Geräteverkehr über einen Proxy oder eine Firewall zulassen](allow-device-traffic.md).
| Endpoint | Port | Erforderlich | Description |
| --- | --- | --- | --- |
| `edge.sagemaker.region.amazonaws.com` | 443 | Ja | Überprüfen Sie den Status der Geräteregistrierung und senden Sie Messwerte an KI. SageMaker |
| `*.s3.amazonaws.com` | 443 | Ja | Laden Sie die Erfassungsdaten in den von Ihnen angegebenen S3-Bucket hoch. Sie können es `*` durch den Namen jedes Buckets ersetzen, in den Sie Daten hochladen. |
## 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](#sagemaker-edge-manager-component-changelog) 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](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.
------
#### [ 1.3.5 and 1.3.6 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 1.3.5 und 1.3.6 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | >=0.0.0 | Hart |
------
#### [ 1.3.4 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.3.4 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | >=0.0.0 | Hart |
------
#### [ 1.3.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.3.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | >=0.0.0 | Hart |
------
#### [ 1.3.2 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.3.2 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | >=0.0.0 | Hart |
------
#### [ 1.3.1 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.3.1 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | >=0.0.0 | Hart |
------
#### [ 1.1.1 - 1.3.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 1.1.1 bis 1.3.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | >=0.0.0 | Hart |
------
#### [ 1.1.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.1.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | >=0.0.0 | Hart |
------
#### [ 1.0.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | >=0.0.0 | Hart |
------
#### [ 1.0.1 and 1.0.2 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 1.0.1 und 1.0.2 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | >=0.0.0 | Hart |
------
#### [ 1.0.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | >=0.0.0 | Hart |
------
Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den [Komponentenrezepten](component-recipe-reference.md#recipe-reference-component-dependencies).
## Konfiguration
Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.
**Anmerkung**
In diesem Abschnitt werden die Konfigurationsparameter beschrieben, die Sie in der Komponente festlegen. Weitere Informationen zur entsprechenden SageMaker AI Edge Manager-Konfiguration finden Sie unter [Edge Manager Agent](https://docs.aws.amazon.com/sagemaker/latest/dg/edge-device-fleet-about.html#edge-device-fleet-running-agent) im *Amazon SageMaker AI Developer Guide*.
`DeviceFleetName`
Der Name der SageMaker AI Edge Manager-Geräteflotte, die Ihr Greengrass-Core-Gerät enthält.
Sie müssen im Konfigurationsupdate einen Wert für diesen Parameter angeben, wenn Sie diese Komponente bereitstellen.
`BucketName`
Der Name des S3-Buckets, in den Sie erfasste Inferenzdaten hochladen. Der Bucket-Name muss die Zeichenfolge `sagemaker` enthalten.
Wenn Sie `CaptureDataDestination` auf `Cloud` oder wenn Sie `CaptureDataPeriodicUpload` auf setzen`true`, müssen Sie bei der Bereitstellung dieser Komponente im Konfigurationsupdate einen Wert für diesen Parameter angeben.
Capture Data ist eine SageMaker KI-Funktion, mit der Sie Inferenzeingaben, Inferenzergebnisse und zusätzliche Inferenzdaten für future Analysen in einen S3-Bucket oder ein lokales Verzeichnis hochladen. Weitere Informationen zur Verwendung von Erfassungsdaten mit SageMaker AI Edge Manager finden Sie unter [Modell verwalten](https://docs.aws.amazon.com/sagemaker/latest/dg/edge-manage-model.html#edge-manage-model-capturedata) im *Amazon SageMaker AI Developer Guide*.
`CaptureDataBatchSize`
(Optional) Die Größe eines Stapels von Erfassungsdatenanfragen, die der Agent bearbeitet. Dieser Wert muss kleiner als die Puffergröße sein, die Sie in angeben`CaptureDataBufferSize`. Wir empfehlen, die Hälfte der Puffergröße nicht zu überschreiten.
Der Agent verarbeitet einen Anforderungsstapel, wenn die Anzahl der Anfragen im Puffer der `CaptureDataBatchSize` Anzahl entspricht, oder wenn das `CaptureDataPushPeriodSeconds` Intervall abgelaufen ist, je nachdem, was zuerst eintritt.
Standard: `10`
`CaptureDataBufferSize`
(Optional) Die maximale Anzahl von Erfassungsdatenanforderungen, die im Puffer gespeichert sind.
Standard: `30`
`CaptureDataDestination`
(Optional) Das Ziel, an dem Sie die erfassten Daten speichern. Folgende Parameterwerte sind möglich:
+ `Cloud`— Lädt erfasste Daten in den von Ihnen angegebenen S3-Bucket hoch. `BucketName`
+ `Disk`— Schreibt die erfassten Daten in das Arbeitsverzeichnis der Komponente.
Wenn Sie dies angeben`Disk`, können Sie die erfassten Daten auch regelmäßig in Ihren S3-Bucket hochladen, indem Sie `CaptureDataPeriodicUpload` auf `true` einstellen.
Standard: `Cloud`
`CaptureDataPeriodicUpload`
(Optional) Zeichenkettenwert, der angibt, ob die erfassten Daten regelmäßig hochgeladen werden sollen. Unterstützte Werte sind `true` und `false`.
Setzen Sie diesen Parameter auf, `true` wenn Sie `CaptureDataDestination` auf festlegen und Sie möchten`Disk`, dass der Agent die erfassten Daten regelmäßig in Ihren S3-Bucket hochlädt.
Standard: `false`
`CaptureDataPeriodicUploadPeriodSeconds`
(Optional) Das Intervall in Sekunden, in dem der SageMaker AI Edge Manager-Agent die erfassten Daten in den S3-Bucket hochlädt. Verwenden Sie diesen Parameter, wenn Sie `CaptureDataPeriodicUpload` auf `true` einstellen.
Standard: `8`
`CaptureDataPushPeriodSeconds`
(Optional) Das Intervall in Sekunden, in dem der SageMaker AI Edge Manager-Agent einen Stapel von Erfassungsdatenanforderungen aus dem Puffer verarbeitet.
Der Agent verarbeitet einen Anforderungsstapel, wenn die Anzahl der Anfragen im Puffer der `CaptureDataBatchSize` Anzahl entspricht, oder wenn das `CaptureDataPushPeriodSeconds` Intervall abgelaufen ist, je nachdem, was zuerst eintritt.
Standard: `4`
`CaptureDataBase64EmbedLimit`
(Optional) Die maximale Größe der erfassten Daten in Byte, die der SageMaker AI Edge Manager-Agent hochlädt.
Standard: `3072`
`FolderPrefix`
(Optional) Der Name des Ordners, in den der Agent die erfassten Daten schreibt. Wenn Sie `CaptureDataDestination` auf festlegen`Disk`, erstellt der Agent den Ordner in dem Verzeichnis, das von angegeben ist`CaptureDataDiskPath`. Wenn Sie `CaptureDataDestination` auf `Cloud` oder wenn Sie `CaptureDataPeriodicUpload` auf festlegen`true`, erstellt der Agent den Ordner in Ihrem S3-Bucket.
Standard: `sme-capture`
`CaptureDataDiskPath`
Diese Funktion ist in Version 1.1.0 und späteren Versionen der SageMaker AI Edge Manager-Komponente verfügbar.
(Optional) Der Pfad zu dem Ordner, in dem der Agent den Ordner mit den erfassten Daten erstellt. Wenn Sie `CaptureDataDestination` auf festlegen`Disk`, erstellt der Agent den Ordner mit den erfassten Daten in diesem Verzeichnis. Wenn Sie diesen Wert nicht angeben, erstellt der Agent den Ordner mit den erfassten Daten im Arbeitsverzeichnis der Komponente. Verwenden Sie den `FolderPrefix` Parameter, um den Namen des Ordners für erfasste Daten anzugeben.
Standard: `/greengrass/v2/work/aws.greengrass.SageMakerEdgeManager/capture`
`LocalDataRootPath`
Diese Funktion ist in Version 1.2.0 und späteren Versionen der SageMaker AI Edge Manager-Komponente verfügbar.
(Optional) Der Pfad, in dem diese Komponente die folgenden Daten auf dem Kerngerät speichert:
+ Die lokale Datenbank für Laufzeitdaten, wenn Sie `DbEnable` auf einstellen`true`.
+ SageMaker Von AI Neo kompilierte Modelle, die diese Komponente automatisch herunterlädt, wenn Sie `DeploymentEnable` auf `true` einstellen.
Standard: `/greengrass/v2/work/aws.greengrass.SageMakerEdgeManager`
`DbEnable`
(Optional) Sie können diese Komponente aktivieren, um Laufzeitdaten in einer lokalen Datenbank zu speichern, um die Daten für den Fall zu schützen, dass die Komponente ausfällt oder das Gerät ausfällt.
Diese Datenbank benötigt 5 MB Speicherplatz im Dateisystem des Kerngeräts.
Standard: `false`
`DeploymentEnable`
Diese Funktion ist in Version 1.2.0 und späteren Versionen der SageMaker AI Edge Manager-Komponente verfügbar.
(Optional) Sie können diese Komponente aktivieren, um automatisch mit SageMaker KI Neo kompilierte Modelle abzurufen, von denen Sie auf Amazon S3 hochladen. Nachdem Sie ein neues Modell auf Amazon S3 hochgeladen haben, verwenden Sie SageMaker AI Studio oder die SageMaker KI-API, um das neue Modell auf diesem Kerngerät bereitzustellen. Wenn Sie diese Funktion aktivieren, können Sie neue Modelle auf Kerngeräten bereitstellen, ohne eine AWS IoT Greengrass Bereitstellung erstellen zu müssen.
Um diese Funktion verwenden zu können, müssen Sie `DbEnable` auf `true` einstellen. Diese Funktion verwendet die lokale Datenbank, um Modelle zu verfolgen, die sie aus der AWS Cloud abruft.
Standard: `false`
`DeploymentPollInterval`
Diese Funktion ist in Version 1.2.0 und späteren Versionen der SageMaker AI Edge Manager-Komponente verfügbar.
(Optional) Der Zeitraum (in Minuten), zwischen dem diese Komponente nach neuen Modellen zum Herunterladen sucht. Diese Option gilt, wenn Sie `DeploymentEnable` auf einstellen`true`.
Standard: `1440` (1 Tag)
`DLRBackendOptions`
Diese Funktion ist in Version 1.2.0 und späteren Versionen der SageMaker AI Edge Manager-Komponente verfügbar.
(Optional) Die DLR-Laufzeit-Flags, die in der von dieser Komponente verwendeten DLR-Laufzeit gesetzt werden sollen. Sie können das folgende Flag setzen:
+ `TVM_TENSORRT_CACHE_DIR`— Aktiviert das Zwischenspeichern von TensorRT-Modellen. Geben Sie einen absoluten Pfad zu einem vorhandenen Ordner mit Lese-/Schreibberechtigungen an.
+ `TVM_TENSORRT_CACHE_DISK_SIZE_MB`— Weist die Obergrenze des TensorRT-Modell-Cache-Ordners zu. Wenn die Verzeichnisgröße diese Grenze überschreitet, werden die zwischengespeicherten Engines, die am wenigsten verwendet werden, gelöscht. Der Standardwert ist 512 MB.
Sie können diesen Parameter beispielsweise auf den folgenden Wert setzen, um das Zwischenspeichern von TensorRT-Modellen zu aktivieren und die Cachegröße auf 800 MB zu begrenzen.
```
TVM_TENSORRT_CACHE_DIR=/data/secured_folder/trt/cache; TVM_TENSORRT_CACHE_DISK_SIZE_MB=800
```
`SagemakerEdgeLogVerbose`
(Optional) Zeichenkettenwert, der angibt, ob die Debug-Protokollierung aktiviert werden soll. Unterstützte Werte sind `true` und `false`.
Standard: `false`
`UnixSocketName`
(Optional) Der Speicherort des SageMaker AI Edge Manager-Socket-Dateideskriptors auf dem Kerngerät.
Standard: `/tmp/aws.greengrass.SageMakerEdgeManager.sock`
**Example Beispiel: Update zur Zusammenführung von Konfigurationen**
Die folgende Beispielkonfiguration gibt an, dass das Kerngerät Teil von ist *MyEdgeDeviceFleet* und dass der Agent die Erfassungsdaten sowohl auf das Gerät als auch in einen S3-Bucket schreibt. Diese Konfiguration ermöglicht auch die Debug-Protokollierung.
```
{
"DeviceFleetName": "MyEdgeDeviceFleet",
"BucketName": "amzn-s3-demo-bucket",
"CaptureDataDestination": "Disk",
"CaptureDataPeriodicUpload": "true",
"SagemakerEdgeLogVerbose": "true"
}
```
## Lokale Protokolldatei
Diese Komponente verwendet die folgende Protokolldatei.
------
#### [ Linux ]
```
/greengrass/v2/logs/aws.greengrass.SageMakerEdgeManager.log
```
------
#### [ Windows ]
```
C:\greengrass\v2\logs\aws.greengrass.SageMakerEdgeManager.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:\$1greengrass\$1v2* durch den Pfad zum AWS IoT Greengrass Stammordner.
------
#### [ Linux ]
```
sudo tail -f /greengrass/v2/logs/aws.greengrass.SageMakerEdgeManager.log
```
------
#### [ Windows (PowerShell) ]
```
Get-Content C:\greengrass\v2\logs\aws.greengrass.SageMakerEdgeManager.log -Tail 10 -Wait
```
------
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| **Version** | **Änderungen** |
| --- | --- |
| 1.3.6 | Die Version wurde für die Version Greengrass Nucleus 2.12.5 aktualisiert. |
| 1.3.5 | Die Version wurde für die Version 2.12.0 von Greengrass Nucleus aktualisiert. |
| 1.3.4 | Die Version wurde für die Version 2.11.0 von Greengrass Nucleus aktualisiert. |
| 1.3.3 | Die Version wurde für die Version 2.10.0 von Greengrass Nucleus aktualisiert. |
| 1.3.2 | Die Version wurde für die Version 2.9.0 von Greengrass Nucleus aktualisiert. |
| 1.3.1 | Die Version wurde für die Version 2.8.0 von Greengrass Nucleus aktualisiert. |
| 1.3.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/sagemaker-edge-manager-component.html) |
| 1.2.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/sagemaker-edge-manager-component.html) |
| 1.1.1 | Die Version wurde für die Version 2.7.0 von Greengrass Nucleus aktualisiert. |
| 1.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/sagemaker-edge-manager-component.html) |
| 1.0.3 | Die Version wurde für die Version 2.4.0 von Greengrass Nucleus aktualisiert. |
| 1.0.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/sagemaker-edge-manager-component.html) |
| 1.0.1 | Die Version wurde für die Version 2.3.0 von Greengrass Nucleus aktualisiert. |
| 1.0.0 | Erste Version |
# DLR-Bildklassifizierung
Die DLR-Komponente zur Bildklassifizierung (`aws.greengrass.DLRImageClassification`) enthält Beispiel-Inferenzcode für die Durchführung von Inferenzen zur Bildklassifizierung mithilfe von [Deep Learning Runtime](https://github.com/neo-ai/neo-ai-dlr) - und Resnet-50-Modellen. Diese Komponente verwendet die Variante [Modellspeicher für die DLR-Bildklassifizierung](dlr-image-classification-model-store-component.md) und die [DLR-Laufzeit](dlr-component.md) Komponenten als Abhängigkeiten, um DLR und die Beispielmodelle herunterzuladen.
Um diese Inferenzkomponente mit einem speziell trainierten DLR-Modell zu verwenden, [erstellen Sie eine benutzerdefinierte Version](ml-customization.md#override-public-model-store) der abhängigen Modellspeicherkomponente. Um Ihren eigenen benutzerdefinierten Inferenzcode zu verwenden, können Sie das Rezept dieser Komponente als Vorlage verwenden, um eine benutzerdefinierte Inferenzkomponente zu [erstellen](ml-customization.md#create-inference-component).
**Topics**
+ [Versionen](#dlr-image-classification-component-versions)
+ [Typ](#dlr-image-classification-component-type)
+ [Betriebssystem](#dlr-image-classification-component-os-support)
+ [Voraussetzungen](#dlr-image-classification-component-requirements)
+ [Abhängigkeiten](#dlr-image-classification-component-dependencies)
+ [Konfiguration](#dlr-image-classification-component-configuration)
+ [Lokale Protokolldatei](#dlr-image-classification-component-log-file)
+ [Änderungsprotokoll](#dlr-image-classification-component-changelog)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 2.1.x
+ 2.0.x
## Typ
Diese Komponente ist eine generische Komponente (`aws.greengrass.generic`). Der [Greengrass-Kern](greengrass-nucleus-component.md) führt die Lebenszyklusskripte der Komponente aus.
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## 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:
+ Auf Greengrass-Core-Geräten, auf denen Amazon Linux 2 oder Ubuntu 18.04 ausgeführt wird, ist die [GNU C Library](https://www.gnu.org/software/libc/) (Glibc) Version 2.27 oder höher auf dem Gerät installiert.
+ Auf ARMv7L-Geräten wie Raspberry Pi sind Abhängigkeiten für OpenCV-Python auf dem Gerät installiert. Führen Sie den folgenden Befehl aus, um die Abhängigkeiten zu installieren.
```
sudo apt-get install libopenjp2-7 libilmbase23 libopenexr-dev libavcodec-dev libavformat-dev libswscale-dev libv4l-dev libgtk-3-0 libwebp-dev
```
+ Raspberry Pi-Geräte, auf denen Raspberry Pi OS Bullseye ausgeführt wird, müssen die folgenden Anforderungen erfüllen:
+ NumPy 1.22.4 oder höher auf dem Gerät installiert. Raspberry Pi OS Bullseye enthält eine frühere Version von NumPy, sodass Sie den folgenden Befehl ausführen können, um das Gerät zu aktualisieren NumPy .
```
pip3 install --upgrade numpy
```
+ Der ältere Kamerastack ist auf dem Gerät aktiviert. Raspberry Pi OS Bullseye enthält einen neuen Kamerastack, der standardmäßig aktiviert und nicht kompatibel ist. Sie müssen also den älteren Kamerastack aktivieren.
**Um den Legacy-Kamerastack zu aktivieren**
1. Führen Sie den folgenden Befehl aus, um das Raspberry Pi-Konfigurationstool zu öffnen.
```
sudo raspi-config
```
1. Wählen Sie **Schnittstellenoptionen**.
1. Wählen Sie **Legacy-Kamera** aus, um den Legacy-Kamerastack zu aktivieren.
1. Starten Sie den Raspberry Pi neu.
## Abhängigkeiten
Wenn Sie eine Komponente bereitstellen, stellt sie 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](#dlr-image-classification-component-changelog) 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](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.
------
#### [ 2.1.13 and 2.1.14 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.1.13 und 2.1.14 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Weich |
| [Modellspeicher für die DLR-Bildklassifizierung](dlr-image-classification-model-store-component.md) | \$12.1.0 | Hart |
| [DLR](dlr-component.md) | \$11.6.0 | Hart |
------
#### [ 2.1.12 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.12 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Weich |
| [Modellspeicher für die DLR-Bildklassifizierung](dlr-image-classification-model-store-component.md) | \$12.1.0 | Hart |
| [DLR](dlr-component.md) | \$11.6.0 | Hart |
------
#### [ 2.1.11 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.11 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Weich |
| [Modellspeicher für die DLR-Bildklassifizierung](dlr-image-classification-model-store-component.md) | \$12.1.0 | Hart |
| [DLR](dlr-component.md) | \$11.6.0 | Hart |
------
#### [ 2.1.10 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.10 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Weich |
| [Modellspeicher für die DLR-Bildklassifizierung](dlr-image-classification-model-store-component.md) | \$12.1.0 | Hart |
| [DLR](dlr-component.md) | \$11.6.0 | Hart |
------
#### [ 2.1.9 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.9 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Weich |
| [Modellspeicher für die DLR-Bildklassifizierung](dlr-image-classification-model-store-component.md) | \$12.1.0 | Hart |
| [DLR](dlr-component.md) | \$11.6.0 | Hart |
------
#### [ 2.1.8 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.8 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Weich |
| [Modellspeicher für die DLR-Bildklassifizierung](dlr-image-classification-model-store-component.md) | \$12.1.0 | Hart |
| [DLR](dlr-component.md) | \$11.6.0 | Hart |
------
#### [ 2.1.7 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.7 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Weich |
| [Modellspeicher für die DLR-Bildklassifizierung](dlr-image-classification-model-store-component.md) | \$12.1.0 | Hart |
| [DLR](dlr-component.md) | \$11.6.0 | Hart |
------
#### [ 2.1.6 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.6 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Weich |
| [Modellspeicher für die DLR-Bildklassifizierung](dlr-image-classification-model-store-component.md) | \$12.1.0 | Hart |
| [DLR](dlr-component.md) | \$11.6.0 | Hart |
------
#### [ 2.1.4 - 2.1.5 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.1.4 bis 2.1.5 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Weich |
| [Modellspeicher für die DLR-Bildklassifizierung](dlr-image-classification-model-store-component.md) | \$12.1.0 | Hart |
| [DLR](dlr-component.md) | \$11.6.0 | Hart |
------
#### [ 2.1.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Weich |
| [Modellspeicher für die DLR-Bildklassifizierung](dlr-image-classification-model-store-component.md) | \$12.1.0 | Hart |
| [DLR](dlr-component.md) | \$11.6.0 | Hart |
------
#### [ 2.1.2 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.2 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Weich |
| [Modellspeicher für die DLR-Bildklassifizierung](dlr-image-classification-model-store-component.md) | \$12.1.0 | Hart |
| [DLR](dlr-component.md) | \$11.6.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](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Weich |
| [Modellspeicher für die DLR-Bildklassifizierung](dlr-image-classification-model-store-component.md) | \$12.1.0 | Hart |
| [DLR](dlr-component.md) | \$11.6.0 | Hart |
------
#### [ 2.0.x ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.x dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | \$12.0.0 | Weich |
| Modellspeicher für die DLR-Bildklassifizierung | \$12.0.0 | Hart |
| DLR | \$11.3.0 | Weich |
------
## Konfiguration
Diese Komponente bietet die folgenden Konfigurationsparameter, die Sie bei der Bereitstellung der Komponente anpassen können.
------
#### [ 2.1.x ]
`accessControl`
(Optional) Das Objekt, das die [Autorisierungsrichtlinie](interprocess-communication.md#ipc-authorization-policies) enthält, die es der Komponente ermöglicht, Nachrichten unter dem Standardthema für Benachrichtigungen zu veröffentlichen.
Standard:
```
{
"aws.greengrass.ipc.mqttproxy": {
"aws.greengrass.DLRImageClassification:mqttproxy:1": {
"policyDescription": "Allows access to publish via topic ml/dlr/image-classification.",
"operations": [
"aws.greengrass#PublishToIoTCore"
],
"resources": [
"ml/dlr/image-classification"
]
}
}
}
```
`PublishResultsOnTopic`
(Optional) Das Thema, zu dem Sie die Inferenzergebnisse veröffentlichen möchten. Wenn Sie diesen Wert ändern, müssen Sie auch den Wert von `resources` im `accessControl` Parameter so ändern, dass er Ihrem benutzerdefinierten Themennamen entspricht.
Standard: `ml/dlr/image-classification`
`Accelerator`
Der Beschleuniger, den Sie verwenden möchten. Unterstützte Werte sind `cpu` und `gpu`.
Die Beispielmodelle in der abhängigen Modellkomponente unterstützen nur CPU-Beschleunigung. Um die GPU-Beschleunigung mit einem anderen benutzerdefinierten Modell zu verwenden, [erstellen Sie eine benutzerdefinierte Modellkomponente](ml-customization.md#override-public-model-store), um die Komponente des öffentlichen Modells zu überschreiben.
Standard: `cpu`
`ImageDirectory`
(Optional) Der Pfad des Ordners auf dem Gerät, in dem Inferenzkomponenten Bilder lesen. Sie können diesen Wert an einen beliebigen Ort auf Ihrem Gerät ändern, auf den Sie read/write Zugriff haben.
Standard: `/greengrass/v2/packages/artifacts-unarchived/component-name/image_classification/sample_images/`
Wenn Sie den Wert `UseCamera` auf setzen`true`, wird dieser Konfigurationsparameter ignoriert.
`ImageName`
(Optional) Der Name des Bilds, das die Inferenzkomponente als Eingabe für eine Make-Vorhersage verwendet. Die Komponente sucht in dem unter angegebenen Ordner nach dem Bild. `ImageDirectory` Standardmäßig verwendet die Komponente das Beispielbild im Standard-Bildverzeichnis. AWS IoT Greengrass unterstützt die folgenden Bildformate: `jpeg``jpg`,`png`, und`npy`.
Standard: `cat.jpeg`
Wenn Sie den Wert `UseCamera` auf setzen`true`, wird dieser Konfigurationsparameter ignoriert.
`InferenceInterval`
(Optional) Die Zeit in Sekunden zwischen den einzelnen Vorhersagen des Inferenzcodes. Der Beispiel-Inferenzcode wird unbegrenzt ausgeführt und wiederholt seine Vorhersagen im angegebenen Zeitintervall. Sie können dieses Intervall beispielsweise auf ein kürzeres Intervall ändern, wenn Sie mit einer Kamera aufgenommene Bilder für Vorhersagen in Echtzeit verwenden möchten.
Standard: `3600`
`ModelResourceKey`
(Optional) Die Modelle, die in der abhängigen öffentlichen Modellkomponente verwendet werden. Ändern Sie diesen Parameter nur, wenn Sie die Komponente des öffentlichen Modells durch eine benutzerdefinierte Komponente überschreiben.
Standard:
```
{
"armv7l": "DLR-resnet50-armv7l-cpu-ImageClassification",
"aarch64": "DLR-resnet50-aarch64-cpu-ImageClassification",
"x86_64": "DLR-resnet50-x86_64-cpu-ImageClassification",
"windows": "DLR-resnet50-win-cpu-ImageClassification"
}
```
`UseCamera`
(Optional) Zeichenkettenwert, der definiert, ob Bilder von einer Kamera verwendet werden sollen, die mit dem Greengrass-Core-Gerät verbunden ist. Unterstützte Werte sind `true` und `false`.
Wenn Sie diesen Wert auf setzen`true`, greift der Beispiel-Inferenzcode auf die Kamera auf Ihrem Gerät zu und führt die Inferenz lokal für das aufgenommene Bild aus. Die Werte der `ImageDirectory` Parameter `ImageName` und werden ignoriert. Stellen Sie sicher, dass der Benutzer, der diese Komponente ausführt, read/write Zugriff auf den Speicherort hat, an dem die Kamera aufgenommene Bilder speichert.
Standard: `false`
Wenn Sie sich das Rezept für diese Komponente ansehen, erscheint der `UseCamera` Konfigurationsparameter nicht in der Standardkonfiguration. Sie können den Wert dieses Parameters jedoch in einem [Update zur Zusammenführung der Konfiguration](update-component-configurations.md) ändern, wenn Sie die Komponente bereitstellen.
Wenn Sie `UseCamera` auf setzen`true`, müssen Sie auch einen Symlink erstellen, damit die Inferenzkomponente über die virtuelle Umgebung, die von der Runtime-Komponente erstellt wurde, auf Ihre Kamera zugreifen kann. Weitere Hinweise zur Verwendung einer Kamera mit den Beispiel-Inferenzkomponenten finden Sie unter. [Komponentenkonfigurationen aktualisieren](ml-tutorial-image-classification-camera.md)
------
#### [ 2.0.x ]
`MLRootPath`
(Optional) Der Pfad des Ordners auf Linux-Kerngeräten, in dem Inferenzkomponenten Bilder lesen und Inferenzergebnisse schreiben. Sie können diesen Wert in einen beliebigen Speicherort auf Ihrem Gerät ändern, auf den der Benutzer, der diese Komponente ausführt, Zugriff hat read/write .
Standard: `/greengrass/v2/work/variant.DLR/greengrass_ml`
Standard: `/greengrass/v2/work/variant.TensorFlowLite/greengrass_ml`
`Accelerator`
Der Beschleuniger, den Sie verwenden möchten. Unterstützte Werte sind `cpu` und `gpu`.
Die Beispielmodelle in der abhängigen Modellkomponente unterstützen nur CPU-Beschleunigung. Um die GPU-Beschleunigung mit einem anderen benutzerdefinierten Modell zu verwenden, [erstellen Sie eine benutzerdefinierte Modellkomponente](ml-customization.md#override-public-model-store), um die Komponente des öffentlichen Modells zu überschreiben.
Standard: `cpu`
`ImageName`
(Optional) Der Name des Bilds, das die Inferenzkomponente als Eingabe für eine Make-Vorhersage verwendet. Die Komponente sucht in dem unter angegebenen Ordner nach dem Bild. `ImageDirectory` Der Standardspeicherort ist`MLRootPath/images`. AWS IoT Greengrass unterstützt die folgenden Bildformate: `jpeg``jpg`,`png`, und`npy`.
Standard: `cat.jpeg`
`InferenceInterval`
(Optional) Die Zeit in Sekunden zwischen den einzelnen Vorhersagen des Inferenzcodes. Der Beispiel-Inferenzcode wird unbegrenzt ausgeführt und wiederholt seine Vorhersagen im angegebenen Zeitintervall. Sie können dieses Intervall beispielsweise auf ein kürzeres Intervall ändern, wenn Sie mit einer Kamera aufgenommene Bilder für Vorhersagen in Echtzeit verwenden möchten.
Standard: `3600`
`ModelResourceKey`
(Optional) Die Modelle, die in der abhängigen öffentlichen Modellkomponente verwendet werden. Ändern Sie diesen Parameter nur, wenn Sie die Komponente des öffentlichen Modells durch eine benutzerdefinierte Komponente überschreiben.
Standard:
```
armv7l: "DLR-resnet50-armv7l-cpu-ImageClassification"
x86_64: "DLR-resnet50-x86_64-cpu-ImageClassification"
```
------
## Lokale Protokolldatei
Diese Komponente verwendet die folgende Protokolldatei.
------
#### [ Linux ]
```
/greengrass/v2/logs/aws.greengrass.DLRImageClassification.log
```
------
#### [ Windows ]
```
C:\greengrass\v2\logs\aws.greengrass.DLRImageClassification.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:\$1greengrass\$1v2* durch den Pfad zum AWS IoT Greengrass Stammordner.
------
#### [ Linux ]
```
sudo tail -f /greengrass/v2/logs/aws.greengrass.DLRImageClassification.log
```
------
#### [ Windows (PowerShell) ]
```
Get-Content C:\greengrass\v2\logs\aws.greengrass.DLRImageClassification.log -Tail 10 -Wait
```
------
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| **Version** | **Änderungen** |
| --- | --- |
| 2.1.14 | Die Version wurde für die Version Greengrass Nucleus 2.12.5 aktualisiert. |
| 2.1.13 | Die Version wurde für die Version 2.12.0 von Greengrass Nucleus aktualisiert. |
| 2.1.12 | Die Version wurde für die Version 2.11.0 von Greengrass Nucleus aktualisiert. |
| 2.1.11 | Die Version wurde für die Version 2.10.0 von Greengrass Nucleus aktualisiert. |
| 2.1.10 | Die Version wurde für die Version 2.9.0 von Greengrass Nucleus aktualisiert. |
| 2.1.9 | Die Version wurde für die Version 2.8.0 von Greengrass Nucleus aktualisiert. |
| 2.1.8 | Die Version wurde für die Version 2.7.0 von Greengrass Nucleus aktualisiert. |
| 2.1.7 | Die Version wurde für die Version 2.6.0 von Greengrass Nucleus aktualisiert. |
| 2.1.6 | Die Version wurde für die Version 2.5.0 von Greengrass Nucleus aktualisiert. |
| 2.1.5 | Die Komponente wurde insgesamt veröffentlicht. AWS-Regionen |
| 2.1.4 | Die Version wurde für die Version 2.4.0 von Greengrass Nucleus aktualisiert. Diese Version ist in Europa (London) nicht verfügbar (`eu-west-2`). |
| 2.1.3 | Die Version wurde für die Version 2.3.0 von Greengrass Nucleus aktualisiert. |
| 2.1.2 | Die Version wurde für die Version 2.2.0 von Greengrass Nucleus aktualisiert. |
| 2.1.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/dlr-image-classification-component.html) |
| 2.0.4 | Erste Version |
# DLR-Objekterkennung
Die DLR-Objekterkennungskomponente (`aws.greengrass.DLRObjectDetection`) enthält Beispiel-Inferenzcode für die Durchführung von Inferenzen zur Objekterkennung mithilfe von [Deep Learning Runtime](https://github.com/neo-ai/neo-ai-dlr) sowie vortrainierte Beispielmodelle. Diese Komponente verwendet die Variante [Modellspeicher für DLR-Objekterkennung](dlr-object-detection-model-store-component.md) und die [DLR-Laufzeit](dlr-component.md) Komponenten als Abhängigkeiten, um DLR und die Beispielmodelle herunterzuladen.
Um diese Inferenzkomponente mit einem speziell trainierten DLR-Modell zu verwenden, [erstellen Sie eine benutzerdefinierte Version](ml-customization.md#override-public-model-store) der abhängigen Modellspeicherkomponente. Um Ihren eigenen benutzerdefinierten Inferenzcode zu verwenden, können Sie das Rezept dieser Komponente als Vorlage verwenden, um eine benutzerdefinierte Inferenzkomponente zu [erstellen](ml-customization.md#create-inference-component).
**Topics**
+ [Versionen](#dlr-object-detection-component-versions)
+ [Typ](#dlr-object-detection-component-type)
+ [Betriebssystem](#dlr-object-detection-component-os-support)
+ [Voraussetzungen](#dlr-object-detection-component-requirements)
+ [Abhängigkeiten](#dlr-object-detection-component-dependencies)
+ [Konfiguration](#dlr-object-detection-component-configuration)
+ [Lokale Protokolldatei](#dlr-object-detection-component-log-file)
+ [Änderungsprotokoll](#dlr-object-detection-component-changelog)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 2.1.x
+ 2.0.x
## Typ
Diese Komponente ist eine generische Komponente (`aws.greengrass.generic`). Der [Greengrass-Kern](greengrass-nucleus-component.md) führt die Lebenszyklusskripte der Komponente aus.
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## 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:
+ Auf Greengrass-Core-Geräten, auf denen Amazon Linux 2 oder Ubuntu 18.04 ausgeführt wird, ist die [GNU C Library](https://www.gnu.org/software/libc/) (Glibc) Version 2.27 oder höher auf dem Gerät installiert.
+ Auf ARMv7L-Geräten wie Raspberry Pi sind Abhängigkeiten für OpenCV-Python auf dem Gerät installiert. Führen Sie den folgenden Befehl aus, um die Abhängigkeiten zu installieren.
```
sudo apt-get install libopenjp2-7 libilmbase23 libopenexr-dev libavcodec-dev libavformat-dev libswscale-dev libv4l-dev libgtk-3-0 libwebp-dev
```
+ Raspberry Pi-Geräte, auf denen Raspberry Pi OS Bullseye ausgeführt wird, müssen die folgenden Anforderungen erfüllen:
+ NumPy 1.22.4 oder höher auf dem Gerät installiert. Raspberry Pi OS Bullseye enthält eine frühere Version von NumPy, sodass Sie den folgenden Befehl ausführen können, um das Gerät zu aktualisieren NumPy .
```
pip3 install --upgrade numpy
```
+ Der ältere Kamerastack ist auf dem Gerät aktiviert. Raspberry Pi OS Bullseye enthält einen neuen Kamerastack, der standardmäßig aktiviert und nicht kompatibel ist. Sie müssen also den älteren Kamerastack aktivieren.
**Um den Legacy-Kamerastack zu aktivieren**
1. Führen Sie den folgenden Befehl aus, um das Raspberry Pi-Konfigurationstool zu öffnen.
```
sudo raspi-config
```
1. Wählen Sie **Schnittstellenoptionen**.
1. Wählen Sie **Legacy-Kamera** aus, um den Legacy-Kamerastack zu aktivieren.
1. Starten Sie den Raspberry Pi neu.
## Abhängigkeiten
Wenn Sie eine Komponente bereitstellen, stellt sie 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](#dlr-object-detection-component-changelog) 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](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.
------
#### [ 2.1.13 and 2.1.14 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.1.13 und 2.1.14 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Weich |
| [Modellspeicher zur DLR-Objekterkennung](dlr-object-detection-model-store-component.md) | \$12.1.0 | Hart |
| [DLR](dlr-component.md) | \$11.6.0 | Hart |
------
#### [ 2.1.12 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.12 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Weich |
| [Modellspeicher zur DLR-Objekterkennung](dlr-object-detection-model-store-component.md) | \$12.1.0 | Hart |
| [DLR](dlr-component.md) | \$11.6.0 | Hart |
------
#### [ 2.1.11 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.11 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Weich |
| [Modellspeicher zur DLR-Objekterkennung](dlr-object-detection-model-store-component.md) | \$12.1.0 | Hart |
| [DLR](dlr-component.md) | \$11.6.0 | Hart |
------
#### [ 2.1.10 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.10 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Weich |
| [Modellspeicher zur DLR-Objekterkennung](dlr-object-detection-model-store-component.md) | \$12.1.0 | Hart |
| [DLR](dlr-component.md) | \$11.6.0 | Hart |
------
#### [ 2.1.9 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.9 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Weich |
| [Modellspeicher zur DLR-Objekterkennung](dlr-object-detection-model-store-component.md) | \$12.1.0 | Hart |
| [DLR](dlr-component.md) | \$11.6.0 | Hart |
------
#### [ 2.1.8 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.8 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Weich |
| [Modellspeicher zur DLR-Objekterkennung](dlr-object-detection-model-store-component.md) | \$12.1.0 | Hart |
| [DLR](dlr-component.md) | \$11.6.0 | Hart |
------
#### [ 2.1.7 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.7 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Weich |
| [Modellspeicher zur DLR-Objekterkennung](dlr-object-detection-model-store-component.md) | \$12.1.0 | Hart |
| [DLR](dlr-component.md) | \$11.6.0 | Hart |
------
#### [ 2.1.6 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.6 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Weich |
| [Modellspeicher zur DLR-Objekterkennung](dlr-object-detection-model-store-component.md) | \$12.1.0 | Hart |
| [DLR](dlr-component.md) | \$11.6.0 | Hart |
------
#### [ 2.1.4 - 2.1.5 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.1.4 bis 2.1.5 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Weich |
| [Modellspeicher zur DLR-Objekterkennung](dlr-object-detection-model-store-component.md) | \$12.1.0 | Hart |
| [DLR](dlr-component.md) | \$11.6.0 | Hart |
------
#### [ 2.1.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Weich |
| [Modellspeicher zur DLR-Objekterkennung](dlr-object-detection-model-store-component.md) | \$12.1.0 | Hart |
| [DLR](dlr-component.md) | \$11.6.0 | Hart |
------
#### [ 2.1.2 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.2 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Weich |
| [Modellspeicher zur DLR-Objekterkennung](dlr-object-detection-model-store-component.md) | \$12.1.0 | Hart |
| [DLR](dlr-component.md) | \$11.6.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](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Weich |
| [Modellspeicher zur DLR-Objekterkennung](dlr-object-detection-model-store-component.md) | \$12.1.0 | Hart |
| [DLR](dlr-component.md) | \$11.6.0 | Hart |
------
#### [ 2.0.x ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.x dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | \$12.0.0 | Weich |
| Modellspeicher für DLR-Objekterkennung | \$12.0.0 | Hart |
| DLR | \$11.3.0 | Weich |
------
## Konfiguration
Diese Komponente bietet die folgenden Konfigurationsparameter, die Sie bei der Bereitstellung der Komponente anpassen können.
------
#### [ 2.1.x ]
`accessControl`
(Optional) Das Objekt, das die [Autorisierungsrichtlinie](interprocess-communication.md#ipc-authorization-policies) enthält, die es der Komponente ermöglicht, Nachrichten unter dem Standardthema für Benachrichtigungen zu veröffentlichen.
Standard:
```
{
"aws.greengrass.ipc.mqttproxy": {
"aws.greengrass.DLRObjectDetection:mqttproxy:1": {
"policyDescription": "Allows access to publish via topic ml/dlr/object-detection.",
"operations": [
"aws.greengrass#PublishToIoTCore"
],
"resources": [
"ml/dlr/object-detection"
]
}
}
}
```
`PublishResultsOnTopic`
(Optional) Das Thema, zu dem Sie die Inferenzergebnisse veröffentlichen möchten. Wenn Sie diesen Wert ändern, müssen Sie auch den Wert von `resources` im `accessControl` Parameter so ändern, dass er Ihrem benutzerdefinierten Themennamen entspricht.
Standard: `ml/dlr/object-detection`
`Accelerator`
Der Beschleuniger, den Sie verwenden möchten. Unterstützte Werte sind `cpu` und `gpu`.
Die Beispielmodelle in der abhängigen Modellkomponente unterstützen nur CPU-Beschleunigung. Um die GPU-Beschleunigung mit einem anderen benutzerdefinierten Modell zu verwenden, [erstellen Sie eine benutzerdefinierte Modellkomponente](ml-customization.md#override-public-model-store), um die Komponente des öffentlichen Modells zu überschreiben.
Standard: `cpu`
`ImageDirectory`
(Optional) Der Pfad des Ordners auf dem Gerät, in dem Inferenzkomponenten Bilder lesen. Sie können diesen Wert an einen beliebigen Ort auf Ihrem Gerät ändern, auf den Sie read/write Zugriff haben.
Standard: `/greengrass/v2/packages/artifacts-unarchived/component-name/object_detection/sample_images/`
Wenn Sie den Wert `UseCamera` auf setzen`true`, wird dieser Konfigurationsparameter ignoriert.
`ImageName`
(Optional) Der Name des Bilds, das die Inferenzkomponente als Eingabe für eine Make-Vorhersage verwendet. Die Komponente sucht in dem unter angegebenen Ordner nach dem Bild. `ImageDirectory` Standardmäßig verwendet die Komponente das Beispielbild im Standard-Bildverzeichnis. AWS IoT Greengrass unterstützt die folgenden Bildformate: `jpeg``jpg`,`png`, und`npy`.
Standard: `objects.jpg`
Wenn Sie den Wert `UseCamera` auf setzen`true`, wird dieser Konfigurationsparameter ignoriert.
`InferenceInterval`
(Optional) Die Zeit in Sekunden zwischen den einzelnen Vorhersagen des Inferenzcodes. Der Beispiel-Inferenzcode wird unbegrenzt ausgeführt und wiederholt seine Vorhersagen im angegebenen Zeitintervall. Sie können dieses Intervall beispielsweise auf ein kürzeres Intervall ändern, wenn Sie mit einer Kamera aufgenommene Bilder für Vorhersagen in Echtzeit verwenden möchten.
Standard: `3600`
`ModelResourceKey`
(Optional) Die Modelle, die in der abhängigen öffentlichen Modellkomponente verwendet werden. Ändern Sie diesen Parameter nur, wenn Sie die Komponente des öffentlichen Modells durch eine benutzerdefinierte Komponente überschreiben.
Standard:
```
{
"armv7l": "DLR-yolo3-armv7l-cpu-ObjectDetection",
"aarch64": "DLR-yolo3-aarch64-gpu-ObjectDetection",
"x86_64": "DLR-yolo3-x86_64-cpu-ObjectDetection",
"windows": "DLR-resnet50-win-cpu-ObjectDetection"
}
```
`UseCamera`
(Optional) Zeichenkettenwert, der definiert, ob Bilder von einer Kamera verwendet werden sollen, die mit dem Greengrass-Core-Gerät verbunden ist. Unterstützte Werte sind `true` und `false`.
Wenn Sie diesen Wert auf setzen`true`, greift der Beispiel-Inferenzcode auf die Kamera auf Ihrem Gerät zu und führt die Inferenz lokal für das aufgenommene Bild aus. Die Werte der `ImageDirectory` Parameter `ImageName` und werden ignoriert. Stellen Sie sicher, dass der Benutzer, der diese Komponente ausführt, read/write Zugriff auf den Speicherort hat, an dem die Kamera aufgenommene Bilder speichert.
Standard: `false`
Wenn Sie sich das Rezept für diese Komponente ansehen, erscheint der `UseCamera` Konfigurationsparameter nicht in der Standardkonfiguration. Sie können den Wert dieses Parameters jedoch in einem [Update zur Zusammenführung der Konfiguration](update-component-configurations.md) ändern, wenn Sie die Komponente bereitstellen.
Wenn Sie `UseCamera` auf setzen`true`, müssen Sie auch einen Symlink erstellen, damit die Inferenzkomponente über die virtuelle Umgebung, die von der Runtime-Komponente erstellt wurde, auf Ihre Kamera zugreifen kann. Weitere Hinweise zur Verwendung einer Kamera mit den Beispiel-Inferenzkomponenten finden Sie unter. [Komponentenkonfigurationen aktualisieren](ml-tutorial-image-classification-camera.md)
------
#### [ 2.0.x ]
`MLRootPath`
(Optional) Der Pfad des Ordners auf Linux-Kerngeräten, in dem Inferenzkomponenten Bilder lesen und Inferenzergebnisse schreiben. Sie können diesen Wert in einen beliebigen Speicherort auf Ihrem Gerät ändern, auf den der Benutzer, der diese Komponente ausführt, Zugriff hat read/write .
Standard: `/greengrass/v2/work/variant.DLR/greengrass_ml`
Standard: `/greengrass/v2/work/variant.TensorFlowLite/greengrass_ml`
`Accelerator`
Ändern Sie nicht. Derzeit ist der einzige unterstützte Wert für den Beschleuniger`cpu`, weil die Modelle in den abhängigen Modellkomponenten nur für den CPU-Beschleuniger kompiliert werden.
`ImageName`
(Optional) Der Name des Bilds, das die Inferenzkomponente als Eingabe für eine Make-Vorhersage verwendet. Die Komponente sucht in dem unter angegebenen Ordner nach dem Bild. `ImageDirectory` Der Standardspeicherort ist`MLRootPath/images`. AWS IoT Greengrass unterstützt die folgenden Bildformate: `jpeg``jpg`,`png`, und`npy`.
Standard: `objects.jpg`
`InferenceInterval`
(Optional) Die Zeit in Sekunden zwischen den einzelnen Vorhersagen des Inferenzcodes. Der Beispiel-Inferenzcode wird unbegrenzt ausgeführt und wiederholt seine Vorhersagen im angegebenen Zeitintervall. Sie können dieses Intervall beispielsweise auf ein kürzeres Intervall ändern, wenn Sie mit einer Kamera aufgenommene Bilder für Vorhersagen in Echtzeit verwenden möchten.
Standard: `3600`
`ModelResourceKey`
(Optional) Die Modelle, die in der abhängigen öffentlichen Modellkomponente verwendet werden. Ändern Sie diesen Parameter nur, wenn Sie die Komponente des öffentlichen Modells durch eine benutzerdefinierte Komponente überschreiben.
Standard:
```
{
armv7l: "DLR-yolo3-armv7l-cpu-ObjectDetection",
x86_64: "DLR-yolo3-x86_64-cpu-ObjectDetection"
}
```
------
## Lokale Protokolldatei
Diese Komponente verwendet die folgende Protokolldatei.
------
#### [ Linux ]
```
/greengrass/v2/logs/aws.greengrass.DLRObjectDetection.log
```
------
#### [ Windows ]
```
C:\greengrass\v2\logs\aws.greengrass.DLRObjectDetection.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:\$1greengrass\$1v2* durch den Pfad zum AWS IoT Greengrass Stammordner.
------
#### [ Linux ]
```
sudo tail -f /greengrass/v2/logs/aws.greengrass.DLRObjectDetection.log
```
------
#### [ Windows (PowerShell) ]
```
Get-Content C:\greengrass\v2\logs\aws.greengrass.DLRObjectDetection.log -Tail 10 -Wait
```
------
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| **Version** | **Änderungen** |
| --- | --- |
| 2.1.14 | Die Version wurde für die Version Greengrass Nucleus 2.12.5 aktualisiert. |
| 2.1.13 | Die Version wurde für die Version 2.12.0 von Greengrass Nucleus aktualisiert. |
| 2.1.12 | Die Version wurde für die Version 2.11.0 von Greengrass Nucleus aktualisiert. |
| 2.1.11 | Die Version wurde für die Version 2.10.0 von Greengrass Nucleus aktualisiert. |
| 2.1.10 | Die Version wurde für die Version 2.9.0 von Greengrass Nucleus aktualisiert. |
| 2.1.9 | Die Version wurde für die Version 2.8.0 von Greengrass Nucleus aktualisiert. |
| 2.1.8 | Die Version wurde für die Version 2.7.0 von Greengrass Nucleus aktualisiert. |
| 2.1.7 | Die Version wurde für die Version 2.6.0 von Greengrass Nucleus aktualisiert. |
| 2.1.6 | Die Version wurde für die Version 2.5.0 von Greengrass Nucleus aktualisiert. |
| 2.1.5 | Die Komponente wurde insgesamt veröffentlicht. AWS-Regionen |
| 2.1.4 | Die Version wurde für die Version 2.4.0 von Greengrass Nucleus aktualisiert. Diese Version ist in Europa (London) nicht verfügbar (`eu-west-2`). |
| 2.1.3 | Die Version wurde für die Version 2.3.0 von Greengrass Nucleus aktualisiert. |
| 2.1.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/dlr-object-detection-component.html) |
| 2.1.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/dlr-object-detection-component.html) |
| 2.0.4 | Erste Version |
# Modellspeicher für die DLR-Bildklassifizierung
Der DLR-Bildklassifizierungsmodellspeicher ist eine Modellkomponente für maschinelles Lernen, die vortrainierte ResNet -50 Modelle als Greengrass-Artefakte enthält. [Die in dieser Komponente verwendeten vortrainierten Modelle werden aus dem [GluonCV Model Zoo](https://cv.gluon.ai/model_zoo/index.html) abgerufen und mit AI Neo Deep Learning Runtime kompiliert. SageMaker ](https://github.com/neo-ai/neo-ai-dlr)
Die [DLR-Inferenzkomponente zur Bildklassifizierung](dlr-image-classification-component.md) verwendet diese Komponente als Abhängigkeit für die Modellquelle. Um ein benutzerdefiniertes DLR-Modell zu verwenden, [erstellen Sie eine benutzerdefinierte Version](ml-customization.md#override-public-model-store) dieser Modellkomponente und fügen Sie Ihr benutzerdefiniertes Modell als Komponentenartefakt hinzu. Sie können das Rezept dieser Komponente als Vorlage verwenden, um benutzerdefinierte Modellkomponenten zu erstellen.
**Anmerkung**
Der Name der DLR-Speicherkomponente für das Bildklassifizierungsmodell variiert je nach Version. Der Komponentenname für Version 2.1.x und spätere Versionen lautet. `variant.DLR.ImageClassification.ModelStore` Der Komponentenname für Version 2.0.x lautet. `variant.ImageClassification.ModelStore`
**Topics**
+ [Versionen](#dlr-image-classification-model-store-component-versions)
+ [Typ](#dlr-image-classification-model-store-component-type)
+ [Betriebssystem](#dlr-image-classification-model-store-component-os-support)
+ [Voraussetzungen](#dlr-image-classification-model-store-component-requirements)
+ [Abhängigkeiten](#dlr-image-classification-model-store-component-dependencies)
+ [Konfiguration](#dlr-image-classification-model-store-component-configuration)
+ [Lokale Protokolldatei](#dlr-image-classification-model-store-component-log-file)
+ [Änderungsprotokoll](#dlr-image-classification-model-store-component-changelog)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 2.1.x () `variant.DLR.ImageClassification.ModelStore`
+ 2.0.x () `variant.ImageClassification.ModelStore`
## Typ
Diese Komponente ist eine generische Komponente (`aws.greengrass.generic`). Der [Greengrass-Kern](greengrass-nucleus-component.md) führt die Lebenszyklusskripte der Komponente aus.
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## 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:
+ Auf Greengrass-Core-Geräten, auf denen Amazon Linux 2 oder Ubuntu 18.04 ausgeführt wird, ist die [GNU C Library](https://www.gnu.org/software/libc/) (Glibc) Version 2.27 oder höher auf dem Gerät installiert.
+ Auf ARMv7L-Geräten wie Raspberry Pi sind Abhängigkeiten für OpenCV-Python auf dem Gerät installiert. Führen Sie den folgenden Befehl aus, um die Abhängigkeiten zu installieren.
```
sudo apt-get install libopenjp2-7 libilmbase23 libopenexr-dev libavcodec-dev libavformat-dev libswscale-dev libv4l-dev libgtk-3-0 libwebp-dev
```
+ Raspberry Pi-Geräte, auf denen Raspberry Pi OS Bullseye ausgeführt wird, müssen die folgenden Anforderungen erfüllen:
+ NumPy 1.22.4 oder höher auf dem Gerät installiert. Raspberry Pi OS Bullseye enthält eine frühere Version von NumPy, sodass Sie den folgenden Befehl ausführen können, um das Gerät zu aktualisieren NumPy .
```
pip3 install --upgrade numpy
```
+ Der ältere Kamerastack ist auf dem Gerät aktiviert. Raspberry Pi OS Bullseye enthält einen neuen Kamerastack, der standardmäßig aktiviert und nicht kompatibel ist. Sie müssen also den älteren Kamerastack aktivieren.
**Um den Legacy-Kamerastack zu aktivieren**
1. Führen Sie den folgenden Befehl aus, um das Raspberry Pi-Konfigurationstool zu öffnen.
```
sudo raspi-config
```
1. Wählen Sie **Schnittstellenoptionen**.
1. Wählen Sie **Legacy-Kamera** aus, um den Legacy-Kamerastack zu aktivieren.
1. Starten Sie den Raspberry Pi neu.
## Abhängigkeiten
Wenn Sie eine Komponente bereitstellen, stellt sie 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](#dlr-image-classification-model-store-component-changelog) 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](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.
------
#### [ 2.1.12 - 2.1.14 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.1.12 und 2.1.13 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Weich |
------
#### [ 2.1.11 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.11 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Weich |
------
#### [ 2.1.10 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.10 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Weich |
------
#### [ 2.1.9 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.9 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Weich |
------
#### [ 2.1.8 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.8 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Weich |
------
#### [ 2.1.7 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.7 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Weich |
------
#### [ 2.1.6 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.6 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Weich |
------
#### [ 2.1.5 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.5 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Weich |
------
#### [ 2.1.4 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.4 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Weich |
------
#### [ 2.1.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Weich |
------
#### [ 2.1.2 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.2 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Weich |
------
#### [ 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](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Weich |
------
#### [ 2.0.x ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.x dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | \$12.0.0 | Weich |
------
## Konfiguration
Diese Komponente hat keine Konfigurationsparameter.
## Lokale Protokolldatei
Diese Komponente gibt keine Protokolle aus.
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| **Version** | **Änderungen** |
| --- | --- |
| 2.1.13 | Die Version wurde für die Version Greengrass Nucleus 2.12.5 aktualisiert. |
| 2.1.12 | Die Version wurde für die Version 2.12.0 von Greengrass Nucleus aktualisiert. |
| 2.1.11 | Die Version wurde für die Version 2.11.0 von Greengrass Nucleus aktualisiert. |
| 2.1.10 | Die Version wurde für die Version 2.10.0 von Greengrass Nucleus aktualisiert. |
| 2.1.9 | Die Version wurde für die Version 2.9.0 von Greengrass Nucleus aktualisiert. |
| 2.1.8 | Die Version wurde für die Version 2.8.0 von Greengrass Nucleus aktualisiert. |
| 2.1.7 | Die Version wurde für die Version 2.7.0 von Greengrass Nucleus aktualisiert. |
| 2.1.6 | Die Version wurde für die Version 2.6.0 von Greengrass Nucleus aktualisiert. |
| 2.1.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/dlr-image-classification-model-store-component.html) |
| 2.1.4 | Die Version wurde für die Version 2.4.0 von Greengrass Nucleus aktualisiert. |
| 2.1.3 | Die Version wurde für die Version 2.3.0 von Greengrass Nucleus aktualisiert. |
| 2.1.2 | Die Version wurde für die Version 2.2.0 von Greengrass Nucleus aktualisiert. |
| 2.1.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/dlr-image-classification-model-store-component.html) |
| 2.0.4 | Erste Version |
# Modellspeicher für DLR-Objekterkennung
Der DLR-Modellspeicher zur Objekterkennung ist eine Modellkomponente für maschinelles Lernen, die vortrainierte YOLOv3 Modelle als Greengrass-Artefakte enthält. [Die in dieser Komponente verwendeten Beispielmodelle werden aus dem [GluonCV Model Zoo](https://cv.gluon.ai/model_zoo/index.html) abgerufen und mit AI Neo Deep Learning Runtime SageMaker kompiliert.](https://github.com/neo-ai/neo-ai-dlr)
Die [DLR-Inferenzkomponente zur Objekterkennung](dlr-object-detection-component.md) verwendet diese Komponente als Abhängigkeit für die Modellquelle. Um ein benutzerdefiniertes DLR-Modell zu verwenden, [erstellen Sie eine benutzerdefinierte Version](ml-customization.md#override-public-model-store) dieser Modellkomponente und fügen Sie Ihr benutzerdefiniertes Modell als Komponentenartefakt hinzu. Sie können das Rezept dieser Komponente als Vorlage verwenden, um benutzerdefinierte Modellkomponenten zu erstellen.
**Anmerkung**
Der Name der Speicherkomponente für das DLR-Objekterkennungsmodell variiert je nach Version. Der Komponentenname für Version 2.1.x und spätere Versionen lautet. `variant.DLR.ObjectDetection.ModelStore` Der Komponentenname für Version 2.0.x lautet. `variant.ObjectDetection.ModelStore`
**Topics**
+ [Versionen](#dlr-object-detection-model-store-component-versions)
+ [Typ](#dlr-object-detection-model-store-component-type)
+ [Betriebssystem](#dlr-object-detection-model-store-component-os-support)
+ [Voraussetzungen](#dlr-object-detection-model-store-component-requirements)
+ [Abhängigkeiten](#dlr-object-detection-model-store-component-dependencies)
+ [Konfiguration](#dlr-object-detection-model-store-component-configuration)
+ [Lokale Protokolldatei](#dlr-object-detection-model-store-component-log-file)
+ [Änderungsprotokoll](#dlr-object-detection-model-store-component-changelog)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 2.1.x
+ 2.0.x
## Typ
Diese Komponente ist eine generische Komponente (`aws.greengrass.generic`). Der [Greengrass-Kern](greengrass-nucleus-component.md) führt die Lebenszyklusskripte der Komponente aus.
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## 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:
+ Auf Greengrass-Core-Geräten, auf denen Amazon Linux 2 oder Ubuntu 18.04 ausgeführt wird, ist die [GNU C Library](https://www.gnu.org/software/libc/) (Glibc) Version 2.27 oder höher auf dem Gerät installiert.
+ Auf ARMv7L-Geräten wie Raspberry Pi sind Abhängigkeiten für OpenCV-Python auf dem Gerät installiert. Führen Sie den folgenden Befehl aus, um die Abhängigkeiten zu installieren.
```
sudo apt-get install libopenjp2-7 libilmbase23 libopenexr-dev libavcodec-dev libavformat-dev libswscale-dev libv4l-dev libgtk-3-0 libwebp-dev
```
+ Raspberry Pi-Geräte, auf denen Raspberry Pi OS Bullseye ausgeführt wird, müssen die folgenden Anforderungen erfüllen:
+ NumPy 1.22.4 oder höher auf dem Gerät installiert. Raspberry Pi OS Bullseye enthält eine frühere Version von NumPy, sodass Sie den folgenden Befehl ausführen können, um das Gerät zu aktualisieren NumPy .
```
pip3 install --upgrade numpy
```
+ Der ältere Kamerastack ist auf dem Gerät aktiviert. Raspberry Pi OS Bullseye enthält einen neuen Kamerastack, der standardmäßig aktiviert und nicht kompatibel ist. Sie müssen also den älteren Kamerastack aktivieren.
**Um den alten Kamerastack zu aktivieren**
1. Führen Sie den folgenden Befehl aus, um das Raspberry Pi-Konfigurationstool zu öffnen.
```
sudo raspi-config
```
1. Wählen Sie **Schnittstellenoptionen**.
1. Wählen Sie **Legacy-Kamera** aus, um den Legacy-Kamerastack zu aktivieren.
1. Starten Sie den Raspberry Pi neu.
## Abhängigkeiten
Wenn Sie eine Komponente bereitstellen, stellt sie 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](#dlr-object-detection-model-store-component-changelog) 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](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.
------
#### [ 2.1.13 and 2.1.14 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.1.13 und 2.1.14 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Weich |
------
#### [ 2.1.12 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.12 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Weich |
------
#### [ 2.1.11 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.11 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Weich |
------
#### [ 2.1.10 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.10 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Weich |
------
#### [ 2.1.9 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.9 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Weich |
------
#### [ 2.1.8 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.8 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Weich |
------
#### [ 2.1.7 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.7 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Weich |
------
#### [ 2.1.5 and 2.1.6 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.1.5 und 2.1.6 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Weich |
------
#### [ 2.1.4 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.4 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Weich |
------
#### [ 2.1.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Weich |
------
#### [ 2.1.2 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.2 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Weich |
------
#### [ 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](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Weich |
------
#### [ 2.0.x ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.x dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | \$12.0.0 | Weich |
------
## Konfiguration
Diese Komponente hat keine Konfigurationsparameter.
## Lokale Protokolldatei
Diese Komponente gibt keine Protokolle aus.
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| **Version** | **Änderungen** |
| --- | --- |
| 2.1.14 | Die Version wurde für die Version Greengrass Nucleus 2.12.5 aktualisiert. |
| 2.1.13 | Die Version wurde für die Version 2.12.0 von Greengrass Nucleus aktualisiert. |
| 2.1.12 | Die Version wurde für die Version 2.11.0 von Greengrass Nucleus aktualisiert. |
| 2.1.11 | Die Version wurde für die Version 2.10.0 von Greengrass Nucleus aktualisiert. |
| 2.1.10 | Die Version wurde für die Version 2.9.0 von Greengrass Nucleus aktualisiert. |
| 2.1.9 | Die Version wurde für die Version 2.8.0 von Greengrass Nucleus aktualisiert. |
| 2.1.8 | Die Version wurde für die Version 2.7.0 von Greengrass Nucleus aktualisiert. |
| 2.1.7 | Die Version wurde für die Version 2.6.0 von Greengrass Nucleus aktualisiert. |
| 2.1.6 | Fügt ein CPU-Modell hinzu, um ein Problem auf Armv8 () AArch64 -Geräten zu beheben. |
| 2.1.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/dlr-object-detection-model-store-component.html) |
| 2.1.4 | Die Version wurde für die Version 2.4.0 von Greengrass Nucleus aktualisiert. |
| 2.1.3 | Die Version wurde für die Version 2.3.0 von Greengrass Nucleus aktualisiert. |
| 2.1.2 | Die Version wurde für die Version 2.2.0 von Greengrass Nucleus aktualisiert. |
| 2.1.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/dlr-object-detection-model-store-component.html) |
| 2.0.4 | Erste Version |
# DLR-Laufzeit
Die DLR-Laufzeitkomponente (`variant.DLR`) enthält ein Skript, das [Deep Learning Runtime](https://github.com/neo-ai/neo-ai-dlr) (DLR) und seine Abhängigkeiten in einer virtuellen Umgebung auf Ihrem Gerät installiert. Die [DLR-Objekterkennung](dlr-object-detection-component.md) Komponenten [DLR-Bildklassifizierung](dlr-image-classification-component.md) und verwenden diese Komponente als Abhängigkeit für die Installation von DLR. Mit der Komponentenversion 1.6.x wird DLR v1.6.0 installiert und mit der Komponentenversion 1.3.x wird DLR v1.3.0 installiert.
[Um eine andere Laufzeit zu verwenden, können Sie das Rezept dieser Komponente als Vorlage verwenden, um eine benutzerdefinierte Komponente für maschinelles Lernen zu erstellen.](ml-customization.md)
**Topics**
+ [Versionen](#dlr-component-versions)
+ [Typ](#dlr-component-type)
+ [Betriebssystem](#dlr-component-os-support)
+ [Voraussetzungen](#dlr-component-requirements)
+ [Abhängigkeiten](#dlr-component-dependencies)
+ [Konfiguration](#dlr-component-configuration)
+ [Usage](#dlr-component-usage)
+ [Lokale Protokolldatei](#dlr-component-log-file)
+ [Änderungsprotokoll](#dlr-component-changelog)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 1.6.x
+ 1.3.x
## Typ
Diese Komponente ist eine generische Komponente () `aws.greengrass.generic`. Der [Greengrass-Kern](greengrass-nucleus-component.md) führt die Lebenszyklusskripte der Komponente aus.
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## 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:
+ Auf Greengrass-Core-Geräten, auf denen Amazon Linux 2 oder Ubuntu 18.04 ausgeführt wird, ist die [GNU C Library](https://www.gnu.org/software/libc/) (Glibc) Version 2.27 oder höher auf dem Gerät installiert.
+ Auf ARMv7L-Geräten wie Raspberry Pi sind Abhängigkeiten für OpenCV-Python auf dem Gerät installiert. Führen Sie den folgenden Befehl aus, um die Abhängigkeiten zu installieren.
```
sudo apt-get install libopenjp2-7 libilmbase23 libopenexr-dev libavcodec-dev libavformat-dev libswscale-dev libv4l-dev libgtk-3-0 libwebp-dev
```
+ Raspberry Pi-Geräte, auf denen Raspberry Pi OS Bullseye ausgeführt wird, müssen die folgenden Anforderungen erfüllen:
+ NumPy 1.22.4 oder höher auf dem Gerät installiert. Raspberry Pi OS Bullseye enthält eine frühere Version von NumPy, sodass Sie den folgenden Befehl ausführen können, um das Gerät zu aktualisieren NumPy .
```
pip3 install --upgrade numpy
```
+ Der ältere Kamerastack ist auf dem Gerät aktiviert. Raspberry Pi OS Bullseye enthält einen neuen Kamerastack, der standardmäßig aktiviert und nicht kompatibel ist. Sie müssen also den älteren Kamerastack aktivieren.
**Um den Legacy-Kamerastack zu aktivieren**
1. Führen Sie den folgenden Befehl aus, um das Raspberry Pi-Konfigurationstool zu öffnen.
```
sudo raspi-config
```
1. Wählen Sie **Schnittstellenoptionen**.
1. Wählen Sie **Legacy-Kamera** aus, um den Legacy-Kamerastack zu aktivieren.
1. Starten Sie den Raspberry Pi neu.
### Endpunkte und Anschlüsse
Standardmäßig verwendet diese Komponente ein Installationsskript, um Pakete mit den `pip` Befehlen`apt`, `yum``brew`, und zu installieren, je nachdem, welche Plattform das Kerngerät verwendet. Diese Komponente muss in der Lage sein, ausgehende Anfragen an verschiedene Paketindizes und Repositorys auszuführen, um das Installationsskript auszuführen. Damit der ausgehende Datenverkehr dieser Komponente über einen Proxy oder eine Firewall übertragen werden kann, müssen Sie die Endpunkte für die Paketindizes und Repositorys identifizieren, zu denen Ihr Kerngerät eine Verbindung zur Installation herstellt.
Beachten Sie bei der Identifizierung von Endpunkten, die für das Installationsskript dieser Komponente erforderlich sind, Folgendes:
+ Die Endpunkte hängen von der Plattform des Kerngeräts ab. Beispielsweise verwendet ein Kerngerät, auf dem Ubuntu ausgeführt wird, `apt` eher als `yum` oder`brew`. Darüber hinaus haben Geräte, die denselben Paketindex verwenden, möglicherweise unterschiedliche Quelllisten, sodass sie Pakete aus verschiedenen Repositorys abrufen können.
+ Die Endpunkte können sich bei mehreren Geräten, die denselben Paketindex verwenden, unterscheiden, da jedes Gerät über eigene Quelllisten verfügt, die definieren, wo Pakete abgerufen werden sollen.
+ Die Endpunkte können sich im Laufe der Zeit ändern. Jeder Paketindex enthält die URLs Repositorys, in die Sie Pakete herunterladen, und der Besitzer eines Pakets kann ändern, was URLs der Paketindex bereitstellt.
Weitere Informationen zu den Abhängigkeiten, die diese Komponente installiert, und zur Deaktivierung des Installationsskripts finden Sie unter dem [UseInstaller](#dlr-component-config-useinstaller-term)Konfigurationsparameter.
Weitere Informationen zu Endpunkten und Ports, die für den Basisbetrieb erforderlich sind, finden Sie unter[Geräteverkehr über einen Proxy oder eine Firewall zulassen](allow-device-traffic.md).
## 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](#dlr-component-changelog) 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](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.
------
#### [ 1.6.11 - 1.6.16 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 1.6.11 bis 1.6.16 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <3.0.0 | Weich |
------
#### [ 1.6.10 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.6.10 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Weich |
------
#### [ 1.6.9 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.6.9 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Weich |
------
#### [ 1.6.8 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.6.8 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Weich |
------
#### [ 1.6.6 and 1.6.7 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 1.6.6 und 1.6.7 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Weich |
------
#### [ 1.6.4 and 1.6.5 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 1.6.4 und 1.6.5 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Weich |
------
#### [ 1.6.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.6.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Weich |
------
#### [ 1.6.2 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.6.2 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Weich |
------
#### [ 1.6.1 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.6.1 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Weich |
------
#### [ 1.3.x ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.3.x dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | \$12.0.0 | Weich |
------
Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den [Komponentenrezepten](component-recipe-reference.md#recipe-reference-component-dependencies).
## Konfiguration
Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.
`MLRootPath`
(Optional) Der Pfad des Ordners auf Linux-Kerngeräten, in dem Inferenzkomponenten Bilder lesen und Inferenzergebnisse schreiben. Sie können diesen Wert in einen beliebigen Speicherort auf Ihrem Gerät ändern, auf den der Benutzer, der diese Komponente ausführt, Zugriff hat read/write .
Standard: `/greengrass/v2/work/variant.DLR/greengrass_ml`
`WindowsMLRootPath`
Diese Funktion ist in Version 1.6.6 und höher dieser Komponente verfügbar.
(Optional) Der Pfad des Ordners auf dem Windows Core-Gerät, in dem Inferenzkomponenten Bilder lesen und Inferenzergebnisse schreiben. Sie können diesen Wert in einen beliebigen Speicherort auf Ihrem Gerät ändern, auf den der Benutzer, der diese Komponente ausführt, Zugriff hat read/write .
Standard: `C:\greengrass\v2\\work\\variant.DLR\\greengrass_ml`
`UseInstaller`
(Optional) Zeichenkettenwert, der definiert, ob das Installationsskript in dieser Komponente zur Installation von DLR und seinen Abhängigkeiten verwendet werden soll. Unterstützte Werte sind `true` und `false`.
Legen Sie diesen Wert auf fest, `false` wenn Sie ein benutzerdefiniertes Skript für die DLR-Installation verwenden möchten oder wenn Sie Laufzeitabhängigkeiten in ein vorgefertigtes Linux-Image aufnehmen möchten. Um diese Komponente mit den von AWS-bereitgestellten DLR-Inferenzkomponenten zu verwenden, installieren Sie die folgenden Bibliotheken, einschließlich aller Abhängigkeiten, und stellen Sie sie dem Systembenutzer zur Verfügung, z. B. dem Systembenutzer, der die ML-Komponenten `ggc_user` ausführt.
+ [Python](https://www.python.org/downloads/) 3.7 oder höher, auch `pip` für Ihre Version von Python.
+ [Deep Learning Runtime](https://github.com/neo-ai/neo-ai-dlr) v1.6.0
+ [NumPy](https://numpy.org/install/).
+ [OpenCV-Python](https://pypi.org/project/opencv-python/).
+ [AWS IoT Device SDK v2 für Python](https://github.com/aws/aws-iot-device-sdk-python-v2).
+ [AWS Common Runtime (CRT) Python](https://github.com/awslabs/aws-crt-python).
+ [Picamera](https://picamera.readthedocs.io/en/release-1.13/) (nur für Raspberry Pi-Geräte).
+ [`awscam`Modul](https://docs.aws.amazon.com/deeplens/latest/dg/deeplens-library-awscam-module.html) (für AWS DeepLens Geräte).
+ LibGL (für Linux-Geräte)
Standard: `true`
## Usage
Verwenden Sie diese Komponente mit dem `UseInstaller` Konfigurationsparameter auf, `true` um DLR und seine Abhängigkeiten auf Ihrem Gerät zu installieren. Die Komponente richtet eine virtuelle Umgebung auf Ihrem Gerät ein, die OpenCV und die NumPy Bibliotheken enthält, die für DLR erforderlich sind.
**Anmerkung**
Das Installationsskript in dieser Komponente installiert auch die neuesten Versionen zusätzlicher Systembibliotheken, die für die Konfiguration der virtuellen Umgebung auf Ihrem Gerät und die Verwendung des installierten Frameworks für maschinelles Lernen erforderlich sind. Dadurch könnten die vorhandenen Systembibliotheken auf Ihrem Gerät aktualisiert werden. In der folgenden Tabelle finden Sie eine Liste der Bibliotheken, die diese Komponente für jedes unterstützte Betriebssystem installiert. Wenn Sie diesen Installationsvorgang anpassen möchten, setzen Sie den `UseInstaller` Konfigurationsparameter auf `false` und entwickeln Sie Ihr eigenes Installationsskript.
| Plattform | Auf dem Gerätesystem installierte Bibliotheken | In der virtuellen Umgebung installierte Bibliotheken |
| --- | --- | --- |
| Armv7l | build-essential, cmake, ca-certificates, git | setuptools, wheel |
| Amazon Linux 2 | mesa-libGL | Keine |
| Ubuntu | wget | Keine |
Wenn Sie Ihre Inferenzkomponente bereitstellen, überprüft diese Runtime-Komponente zunächst, ob DLR und seine Abhängigkeiten bereits auf Ihrem Gerät installiert sind, und falls nicht, installiert sie sie dann für Sie.
## Lokale Protokolldatei
Diese Komponente verwendet die folgende Protokolldatei.
------
#### [ Linux ]
```
/greengrass/v2/logs/variant.DLR.log
```
------
#### [ Windows ]
```
C:\greengrass\v2\logs\variant.DLR.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:\$1greengrass\$1v2* durch den Pfad zum AWS IoT Greengrass Stammordner.
------
#### [ Linux ]
```
sudo tail -f /greengrass/v2/logs/variant.DLR.log
```
------
#### [ Windows (PowerShell) ]
```
Get-Content C:\greengrass\v2\logs\variant.DLR.log -Tail 10 -Wait
```
------
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| **Version** | **Änderungen** |
| --- | --- |
| 1.6.16 | Version für Greengrass Nucleus Version 2.12.5 aktualisiert. |
| 1.6.12 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/dlr-component.html) |
| 1.6.11 | Die Version wurde für die Version 2.9.0 von Greengrass Nucleus aktualisiert. |
| 1.6.10 | Die Version wurde für die Version 2.8.0 von Greengrass Nucleus aktualisiert. |
| 1.6.9 | Die Version wurde für die Version 2.7.0 von Greengrass Nucleus aktualisiert. |
| 1.6.8 | Die Version wurde für die Version 2.6.0 von Greengrass Nucleus aktualisiert. |
| 1.6.7 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/dlr-component.html) |
| 1.6.6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/dlr-component.html) |
| 1.6.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/dlr-component.html) |
| 1.6.4 | Die Version wurde für die Version 2.4.0 von Greengrass Nucleus aktualisiert. |
| 1.6.3 | Die Version wurde für die Version 2.3.0 von Greengrass Nucleus aktualisiert. |
| 1.6.2 | Die Version wurde für die Version 2.2.0 von Greengrass Nucleus aktualisiert. |
| 1.6.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/dlr-component.html) |
| 1.3.2 | Erste Version Installiert DLR v1.3.0. |
# TensorFlow Lite-Bildklassifizierung
Die TensorFlow Lite-Komponente zur Bildklassifizierung (`aws.greengrass.TensorFlowLiteImageClassification`) enthält einen Beispiel-Inferenzcode für die Durchführung von Inferenzen zur Bildklassifizierung mithilfe der [TensorFlow Lite-Laufzeit](https://www.tensorflow.org/lite/guide/python) und ein vortrainiertes quantisiertes MobileNet 1.0-Beispielmodell. Diese Komponente verwendet die Variante [TensorFlow Modellspeicher für Lite-Bildklassifizierung](tensorflow-lite-image-classification-model-store-component.md) und die [TensorFlow Lite-Laufzeit](tensorflow-lite-component.md) Komponenten als Abhängigkeiten, um die TensorFlow Lite-Laufzeit und das Beispielmodell herunterzuladen.
Um diese Inferenzkomponente mit einem individuell trainierten TensorFlow Lite-Modell zu verwenden, [erstellen Sie eine benutzerdefinierte Version](ml-customization.md#override-public-model-store) der abhängigen Modellspeicherkomponente. Um Ihren eigenen benutzerdefinierten Inferenzcode zu verwenden, können Sie das Rezept dieser Komponente als Vorlage verwenden, um [eine benutzerdefinierte Inferenzkomponente zu erstellen](ml-customization.md#create-inference-component).
**Topics**
+ [Versionen](#tensorflow-lite-image-classification-component-versions)
+ [Typ](#tensorflow-lite-image-classification-component-type)
+ [Betriebssystem](#tensorflow-lite-image-classification-component-os-support)
+ [Voraussetzungen](#tensorflow-lite-image-classification-component-requirements)
+ [Abhängigkeiten](#tensorflow-lite-image-classification-component-dependencies)
+ [Konfiguration](#tensorflow-lite-image-classification-component-configuration)
+ [Lokale Protokolldatei](#tensorflow-lite-image-classification-component-log-file)
+ [Änderungsprotokoll](#tensorflow-lite-image-classification-component-changelog)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 2.1.x
## Typ
Diese Komponente ist eine generische Komponente () `aws.greengrass.generic`. Der [Greengrass-Kern](greengrass-nucleus-component.md) führt die Lebenszyklusskripte der Komponente aus.
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## 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:
+ Auf Greengrass-Core-Geräten, auf denen Amazon Linux 2 oder Ubuntu 18.04 ausgeführt wird, ist die [GNU C Library](https://www.gnu.org/software/libc/) (Glibc) Version 2.27 oder höher auf dem Gerät installiert.
+ Auf ARMv7L-Geräten wie Raspberry Pi sind Abhängigkeiten für OpenCV-Python auf dem Gerät installiert. Führen Sie den folgenden Befehl aus, um die Abhängigkeiten zu installieren.
```
sudo apt-get install libopenjp2-7 libilmbase23 libopenexr-dev libavcodec-dev libavformat-dev libswscale-dev libv4l-dev libgtk-3-0 libwebp-dev
```
+ Raspberry Pi-Geräte, auf denen Raspberry Pi OS Bullseye ausgeführt wird, müssen die folgenden Anforderungen erfüllen:
+ NumPy 1.22.4 oder höher auf dem Gerät installiert. Raspberry Pi OS Bullseye enthält eine frühere Version von NumPy, sodass Sie den folgenden Befehl ausführen können, um das Gerät zu aktualisieren NumPy .
```
pip3 install --upgrade numpy
```
+ Der ältere Kamerastack ist auf dem Gerät aktiviert. Raspberry Pi OS Bullseye enthält einen neuen Kamerastack, der standardmäßig aktiviert und nicht kompatibel ist. Sie müssen also den älteren Kamerastack aktivieren.
**Um den alten Kamerastack zu aktivieren**
1. Führen Sie den folgenden Befehl aus, um das Raspberry Pi-Konfigurationstool zu öffnen.
```
sudo raspi-config
```
1. Wählen Sie **Schnittstellenoptionen**.
1. Wählen Sie **Legacy-Kamera** aus, um den Legacy-Kamerastack zu aktivieren.
1. Starten Sie den Raspberry Pi neu.
## Abhängigkeiten
Wenn Sie eine Komponente bereitstellen, stellt sie 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](#tensorflow-lite-image-classification-component-changelog) 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](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.
------
#### [ 2.1.11 and 2.1.12 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.1.11 und 2.1.12 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Weich |
| [TensorFlow Lite-Modellspeicher zur Bildklassifizierung](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Hart |
| [TensorFlow Leicht](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Hart |
------
#### [ 2.1.10 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.10 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Weich |
| [TensorFlow Lite-Modellspeicher zur Bildklassifizierung](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Hart |
| [TensorFlow Leicht](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Hart |
------
#### [ 2.1.9 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.9 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Weich |
| [TensorFlow Lite-Modellspeicher zur Bildklassifizierung](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Hart |
| [TensorFlow Leicht](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Hart |
------
#### [ 2.1.8 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.8 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Weich |
| [TensorFlow Lite-Modellspeicher zur Bildklassifizierung](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Hart |
| [TensorFlow Leicht](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Hart |
------
#### [ 2.1.7 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.7 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Weich |
| [TensorFlow Lite-Modellspeicher zur Bildklassifizierung](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Hart |
| [TensorFlow Leicht](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Hart |
------
#### [ 2.1.6 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.6 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Weich |
| [TensorFlow Lite-Modellspeicher zur Bildklassifizierung](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Hart |
| [TensorFlow Leicht](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Hart |
------
#### [ 2.1.5 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.5 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Weich |
| [TensorFlow Lite-Modellspeicher zur Bildklassifizierung](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Hart |
| [TensorFlow Leicht](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Hart |
------
#### [ 2.1.4 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.4 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Weich |
| [TensorFlow Lite-Modellspeicher zur Bildklassifizierung](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Hart |
| [TensorFlow Leicht](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Hart |
------
#### [ 2.1.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Weich |
| [TensorFlow Lite-Modellspeicher zur Bildklassifizierung](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Hart |
| [TensorFlow Leicht](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Hart |
------
#### [ 2.1.2 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.2 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Weich |
| [TensorFlow Lite-Modellspeicher zur Bildklassifizierung](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Hart |
| [TensorFlow Leicht](tensorflow-lite-component.md) | >=2,5,0 <2,6,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](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Weich |
| [TensorFlow Lite-Modellspeicher zur Bildklassifizierung](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Hart |
| [TensorFlow Leicht](tensorflow-lite-component.md) | >=2,5,0 <2,6,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](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Weich |
| [TensorFlow Lite-Modellspeicher zur Bildklassifizierung](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Hart |
| [TensorFlow Leicht](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Hart |
------
## Konfiguration
Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.
`accessControl`
(Optional) Das Objekt, das die [Autorisierungsrichtlinie](interprocess-communication.md#ipc-authorization-policies) enthält, die es der Komponente ermöglicht, Nachrichten unter dem Standardthema für Benachrichtigungen zu veröffentlichen.
Standard:
```
{
"aws.greengrass.ipc.mqttproxy": {
"aws.greengrass.TensorFlowLiteImageClassification:mqttproxy:1": {
"policyDescription": "Allows access to publish via topic ml/tflite/image-classification.",
"operations": [
"aws.greengrass#PublishToIoTCore"
],
"resources": [
"ml/tflite/image-classification"
]
}
}
}
```
`PublishResultsOnTopic`
(Optional) Das Thema, zu dem Sie die Inferenzergebnisse veröffentlichen möchten. Wenn Sie diesen Wert ändern, müssen Sie auch den Wert von `resources` im `accessControl` Parameter so ändern, dass er Ihrem benutzerdefinierten Themennamen entspricht.
Standard: `ml/tflite/image-classification`
`Accelerator`
Der Beschleuniger, den Sie verwenden möchten. Unterstützte Werte sind `cpu` und `gpu`.
Die Beispielmodelle in der abhängigen Modellkomponente unterstützen nur CPU-Beschleunigung. Um die GPU-Beschleunigung mit einem anderen benutzerdefinierten Modell zu verwenden, [erstellen Sie eine benutzerdefinierte Modellkomponente](ml-customization.md#override-public-model-store), um die Komponente des öffentlichen Modells zu überschreiben.
Standard: `cpu`
`ImageDirectory`
(Optional) Der Pfad des Ordners auf dem Gerät, in dem Inferenzkomponenten Bilder lesen. Sie können diesen Wert an einen beliebigen Ort auf Ihrem Gerät ändern, auf den Sie read/write Zugriff haben.
Standard: `/greengrass/v2/packages/artifacts-unarchived/component-name/image_classification/sample_images/`
Wenn Sie den Wert `UseCamera` auf setzen`true`, wird dieser Konfigurationsparameter ignoriert.
`ImageName`
(Optional) Der Name des Bilds, das die Inferenzkomponente als Eingabe für eine Make-Vorhersage verwendet. Die Komponente sucht in dem unter angegebenen Ordner nach dem Bild. `ImageDirectory` Standardmäßig verwendet die Komponente das Beispielbild im Standard-Bildverzeichnis. AWS IoT Greengrass unterstützt die folgenden Bildformate: `jpeg``jpg`,`png`, und`npy`.
Standard: `cat.jpeg`
Wenn Sie den Wert `UseCamera` auf setzen`true`, wird dieser Konfigurationsparameter ignoriert.
`InferenceInterval`
(Optional) Die Zeit in Sekunden zwischen den einzelnen Vorhersagen des Inferenzcodes. Der Beispiel-Inferenzcode wird unbegrenzt ausgeführt und wiederholt seine Vorhersagen im angegebenen Zeitintervall. Sie können dieses Intervall beispielsweise auf ein kürzeres Intervall ändern, wenn Sie mit einer Kamera aufgenommene Bilder für Vorhersagen in Echtzeit verwenden möchten.
Standard: `3600`
`ModelResourceKey`
(Optional) Die Modelle, die in der abhängigen öffentlichen Modellkomponente verwendet werden. Ändern Sie diesen Parameter nur, wenn Sie die Komponente des öffentlichen Modells durch eine benutzerdefinierte Komponente überschreiben.
Standard:
```
{
"model": "TensorFlowLite-Mobilenet"
}
```
`UseCamera`
(Optional) Zeichenkettenwert, der definiert, ob Bilder von einer Kamera verwendet werden sollen, die mit dem Greengrass-Core-Gerät verbunden ist. Unterstützte Werte sind `true` und `false`.
Wenn Sie diesen Wert auf setzen`true`, greift der Beispiel-Inferenzcode auf die Kamera auf Ihrem Gerät zu und führt die Inferenz lokal für das aufgenommene Bild aus. Die Werte der `ImageDirectory` Parameter `ImageName` und werden ignoriert. Stellen Sie sicher, dass der Benutzer, der diese Komponente ausführt, read/write Zugriff auf den Speicherort hat, an dem die Kamera aufgenommene Bilder speichert.
Standard: `false`
Wenn Sie sich das Rezept für diese Komponente ansehen, erscheint der `UseCamera` Konfigurationsparameter nicht in der Standardkonfiguration. Sie können den Wert dieses Parameters jedoch in einem [Update zur Zusammenführung der Konfiguration](update-component-configurations.md) ändern, wenn Sie die Komponente bereitstellen.
Wenn Sie `UseCamera` auf setzen`true`, müssen Sie auch einen Symlink erstellen, damit die Inferenzkomponente über die virtuelle Umgebung, die von der Runtime-Komponente erstellt wurde, auf Ihre Kamera zugreifen kann. Weitere Hinweise zur Verwendung einer Kamera mit den Beispiel-Inferenzkomponenten finden Sie unter. [Komponentenkonfigurationen aktualisieren](ml-tutorial-image-classification-camera.md)
## Lokale Protokolldatei
Diese Komponente verwendet die folgende Protokolldatei.
------
#### [ Linux ]
```
/greengrass/v2/logs/aws.greengrass.TensorFlowLiteImageClassification.log
```
------
#### [ Windows ]
```
C:\greengrass\v2\logs\aws.greengrass.TensorFlowLiteImageClassification.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:\$1greengrass\$1v2* durch den Pfad zum AWS IoT Greengrass Stammordner.
------
#### [ Linux ]
```
sudo tail -f /greengrass/v2/logs/aws.greengrass.TensorFlowLiteImageClassification.log
```
------
#### [ Windows (PowerShell) ]
```
Get-Content C:\greengrass\v2\logs\aws.greengrass.TensorFlowLiteImageClassification.log -Tail 10 -Wait
```
------
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| Version | Änderungen |
| --- | --- |
| 2.1.12 | Die Version wurde für die Version Greengrass Nucleus 2.12.5 aktualisiert. |
| 2.1.11 | Die Version wurde für die Version 2.12.0 von Greengrass Nucleus aktualisiert. |
| 2.1.10 | Die Version wurde für die Version 2.11.0 von Greengrass Nucleus aktualisiert. |
| 2.1.9 | Die Version wurde für die Version 2.10.0 von Greengrass Nucleus aktualisiert. |
| 2.1.8 | Die Version wurde für die Version 2.9.0 von Greengrass Nucleus aktualisiert. |
| 2.1.7 | Die Version wurde für die Version 2.8.0 von Greengrass Nucleus aktualisiert. |
| 2.1.6 | Die Version wurde für die Version 2.7.0 von Greengrass Nucleus aktualisiert. |
| 2.1.5 | Die Version wurde für die Version 2.6.0 von Greengrass Nucleus aktualisiert. |
| 2.1.4 | Die Version wurde für die Version 2.5.0 von Greengrass Nucleus aktualisiert. |
| 2.1.3 | Die Version wurde für die Version 2.4.0 von Greengrass Nucleus aktualisiert. |
| 2.1.2 | Die Version wurde für die Version 2.3.0 von Greengrass Nucleus aktualisiert. |
| 2.1.1 | Die Version wurde für die Version 2.2.0 von Greengrass Nucleus aktualisiert. |
| 2.1.0 | Erste Version |
# TensorFlow Lite-Objekterkennung
Die TensorFlow Lite-Objekterkennungskomponente (`aws.greengrass.TensorFlowLiteObjectDetection`) enthält einen Beispiel-Inferenzcode für die Durchführung von Inferenzen zur Objekterkennung mit [TensorFlow Lite](https://www.tensorflow.org/lite/guide/python) und ein vortrainiertes Single Shot Detection (SSD) MobileNet 1.0-Modell als Beispiel. Diese Komponente verwendet die Variante [TensorFlow Modellspeicher für Lite-Objekterkennung](tensorflow-lite-object-detection-model-store-component.md) und die [TensorFlow Lite-Laufzeit](tensorflow-lite-component.md) Komponenten als Abhängigkeiten, um TensorFlow Lite und das Beispielmodell herunterzuladen.
Um diese Inferenzkomponente mit einem speziell trainierten TensorFlow Lite-Modell zu verwenden, können Sie [eine benutzerdefinierte Version der abhängigen Modellspeicherkomponente erstellen](ml-customization.md#override-public-model-store). Um Ihren eigenen benutzerdefinierten Inferenzcode zu verwenden, verwenden Sie das Rezept dieser Komponente als Vorlage, um [eine benutzerdefinierte Inferenzkomponente zu erstellen](ml-customization.md#create-inference-component).
**Topics**
+ [Versionen](#tensorflow-lite-object-detection-component-versions)
+ [Typ](#tensorflow-lite-object-detection-component-type)
+ [Betriebssystem](#tensorflow-lite-object-detection-component-os-support)
+ [Voraussetzungen](#tensorflow-lite-object-detection-component-requirements)
+ [Abhängigkeiten](#tensorflow-lite-object-detection-component-dependencies)
+ [Konfiguration](#tensorflow-lite-object-detection-component-configuration)
+ [Lokale Protokolldatei](#tensorflow-lite-object-detection-component-log-file)
+ [Änderungsprotokoll](#tensorflow-lite-object-detection-component-changelog)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 2.1.x
## Typ
Diese Komponente ist eine generische Komponente () `aws.greengrass.generic`. Der [Greengrass-Kern](greengrass-nucleus-component.md) führt die Lebenszyklusskripte der Komponente aus.
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## 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:
+ Auf Greengrass-Core-Geräten, auf denen Amazon Linux 2 oder Ubuntu 18.04 ausgeführt wird, ist die [GNU C Library](https://www.gnu.org/software/libc/) (Glibc) Version 2.27 oder höher auf dem Gerät installiert.
+ Auf ARMv7L-Geräten wie Raspberry Pi sind Abhängigkeiten für OpenCV-Python auf dem Gerät installiert. Führen Sie den folgenden Befehl aus, um die Abhängigkeiten zu installieren.
```
sudo apt-get install libopenjp2-7 libilmbase23 libopenexr-dev libavcodec-dev libavformat-dev libswscale-dev libv4l-dev libgtk-3-0 libwebp-dev
```
+ Raspberry Pi-Geräte, auf denen Raspberry Pi OS Bullseye ausgeführt wird, müssen die folgenden Anforderungen erfüllen:
+ NumPy 1.22.4 oder höher auf dem Gerät installiert. Raspberry Pi OS Bullseye enthält eine frühere Version von NumPy, sodass Sie den folgenden Befehl ausführen können, um das Gerät zu aktualisieren NumPy .
```
pip3 install --upgrade numpy
```
+ Der ältere Kamerastack ist auf dem Gerät aktiviert. Raspberry Pi OS Bullseye enthält einen neuen Kamerastack, der standardmäßig aktiviert und nicht kompatibel ist. Sie müssen also den älteren Kamerastack aktivieren.
**Um den Legacy-Kamerastack zu aktivieren**
1. Führen Sie den folgenden Befehl aus, um das Raspberry Pi-Konfigurationstool zu öffnen.
```
sudo raspi-config
```
1. Wählen Sie **Schnittstellenoptionen**.
1. Wählen Sie **Legacy-Kamera** aus, um den Legacy-Kamerastack zu aktivieren.
1. Starten Sie den Raspberry Pi neu.
## Abhängigkeiten
Wenn Sie eine Komponente bereitstellen, stellt sie 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](#tensorflow-lite-object-detection-component-changelog) 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](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.
------
#### [ 2.1.11 and 2.1.12 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.1.11 und 2.1.12 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Weich |
| [TensorFlow Lite-Modellspeicher zur Bildklassifizierung](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Hart |
| [TensorFlow Leicht](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Hart |
------
#### [ 2.1.10 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.10 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Weich |
| [TensorFlow Lite-Modellspeicher zur Bildklassifizierung](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Hart |
| [TensorFlow Leicht](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Hart |
------
#### [ 2.1.9 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.9 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Weich |
| [TensorFlow Lite-Modellspeicher zur Bildklassifizierung](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Hart |
| [TensorFlow Leicht](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Hart |
------
#### [ 2.1.8 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.8 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Weich |
| [TensorFlow Lite-Modellspeicher zur Bildklassifizierung](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Hart |
| [TensorFlow Leicht](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Hart |
------
#### [ 2.1.7 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.7 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Weich |
| [TensorFlow Lite-Modellspeicher zur Bildklassifizierung](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Hart |
| [TensorFlow Leicht](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Hart |
------
#### [ 2.1.6 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.6 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Weich |
| [TensorFlow Lite-Modellspeicher zur Bildklassifizierung](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Hart |
| [TensorFlow Leicht](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Hart |
------
#### [ 2.1.5 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.5 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Weich |
| [TensorFlow Lite-Modellspeicher zur Bildklassifizierung](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Hart |
| [TensorFlow Leicht](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Hart |
------
#### [ 2.1.4 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.4 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Weich |
| [TensorFlow Lite-Modellspeicher zur Bildklassifizierung](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Hart |
| [TensorFlow Leicht](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Hart |
------
#### [ 2.1.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Weich |
| [TensorFlow Lite-Modellspeicher zur Bildklassifizierung](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Hart |
| [TensorFlow Leicht](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Hart |
------
#### [ 2.1.2 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.2 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Weich |
| [TensorFlow Lite-Modellspeicher zur Bildklassifizierung](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Hart |
| [TensorFlow Leicht](tensorflow-lite-component.md) | >=2,5,0 <2,6,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](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Weich |
| [TensorFlow Lite-Modellspeicher zur Bildklassifizierung](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Hart |
| [TensorFlow Leicht](tensorflow-lite-component.md) | >=2,5,0 <2,6,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](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Weich |
| [TensorFlow Lite-Modellspeicher zur Bildklassifizierung](tensorflow-lite-image-classification-model-store-component.md) | >=2.1.0 <2.2.0 | Hart |
| [TensorFlow Leicht](tensorflow-lite-component.md) | >=2,5,0 <2,6,0 | Hart |
------
## Konfiguration
Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.
`accessControl`
(Optional) Das Objekt, das die [Autorisierungsrichtlinie](interprocess-communication.md#ipc-authorization-policies) enthält, die es der Komponente ermöglicht, Nachrichten unter dem Standardthema für Benachrichtigungen zu veröffentlichen.
Standard:
```
{
"aws.greengrass.ipc.mqttproxy": {
"aws.greengrass.TensorFlowLiteObjectDetection:mqttproxy:1": {
"policyDescription": "Allows access to publish via topic ml/tflite/object-detection.",
"operations": [
"aws.greengrass#PublishToIoTCore"
],
"resources": [
"ml/tflite/object-detection"
]
}
}
}
```
`PublishResultsOnTopic`
(Optional) Das Thema, zu dem Sie die Inferenzergebnisse veröffentlichen möchten. Wenn Sie diesen Wert ändern, müssen Sie auch den Wert von `resources` im `accessControl` Parameter so ändern, dass er Ihrem benutzerdefinierten Themennamen entspricht.
Standard: `ml/tflite/object-detection`
`Accelerator`
Der Beschleuniger, den Sie verwenden möchten. Unterstützte Werte sind `cpu` und `gpu`.
Die Beispielmodelle in der abhängigen Modellkomponente unterstützen nur CPU-Beschleunigung. Um die GPU-Beschleunigung mit einem anderen benutzerdefinierten Modell zu verwenden, [erstellen Sie eine benutzerdefinierte Modellkomponente](ml-customization.md#override-public-model-store), um die Komponente des öffentlichen Modells zu überschreiben.
Standard: `cpu`
`ImageDirectory`
(Optional) Der Pfad des Ordners auf dem Gerät, in dem Inferenzkomponenten Bilder lesen. Sie können diesen Wert an einen beliebigen Ort auf Ihrem Gerät ändern, auf den Sie read/write Zugriff haben.
Standard: `/greengrass/v2/packages/artifacts-unarchived/component-name/object_detection/sample_images/`
Wenn Sie den Wert `UseCamera` auf setzen`true`, wird dieser Konfigurationsparameter ignoriert.
`ImageName`
(Optional) Der Name des Bilds, das die Inferenzkomponente als Eingabe für eine Make-Vorhersage verwendet. Die Komponente sucht in dem unter angegebenen Ordner nach dem Bild. `ImageDirectory` Standardmäßig verwendet die Komponente das Beispielbild im Standard-Bildverzeichnis. AWS IoT Greengrass unterstützt die folgenden Bildformate: `jpeg``jpg`,`png`, und`npy`.
Standard: `objects.jpg`
Wenn Sie den Wert `UseCamera` auf setzen`true`, wird dieser Konfigurationsparameter ignoriert.
`InferenceInterval`
(Optional) Die Zeit in Sekunden zwischen den einzelnen Vorhersagen des Inferenzcodes. Der Beispiel-Inferenzcode wird unbegrenzt ausgeführt und wiederholt seine Vorhersagen im angegebenen Zeitintervall. Sie können dieses Intervall beispielsweise auf ein kürzeres Intervall ändern, wenn Sie mit einer Kamera aufgenommene Bilder für Vorhersagen in Echtzeit verwenden möchten.
Standard: `3600`
`ModelResourceKey`
(Optional) Die Modelle, die in der abhängigen öffentlichen Modellkomponente verwendet werden. Ändern Sie diesen Parameter nur, wenn Sie die Komponente des öffentlichen Modells durch eine benutzerdefinierte Komponente überschreiben.
Standard:
```
{
"model": "TensorFlowLite-SSD"
}
```
`UseCamera`
(Optional) Zeichenkettenwert, der definiert, ob Bilder von einer Kamera verwendet werden sollen, die mit dem Greengrass-Core-Gerät verbunden ist. Unterstützte Werte sind `true` und `false`.
Wenn Sie diesen Wert auf setzen`true`, greift der Beispiel-Inferenzcode auf die Kamera auf Ihrem Gerät zu und führt die Inferenz lokal für das aufgenommene Bild aus. Die Werte der `ImageDirectory` Parameter `ImageName` und werden ignoriert. Stellen Sie sicher, dass der Benutzer, der diese Komponente ausführt, read/write Zugriff auf den Speicherort hat, an dem die Kamera aufgenommene Bilder speichert.
Standard: `false`
Wenn Sie sich das Rezept für diese Komponente ansehen, erscheint der `UseCamera` Konfigurationsparameter nicht in der Standardkonfiguration. Sie können den Wert dieses Parameters jedoch in einem [Update zur Zusammenführung der Konfiguration](update-component-configurations.md) ändern, wenn Sie die Komponente bereitstellen.
Wenn Sie `UseCamera` auf setzen`true`, müssen Sie auch einen Symlink erstellen, damit die Inferenzkomponente über die virtuelle Umgebung, die von der Runtime-Komponente erstellt wurde, auf Ihre Kamera zugreifen kann. Weitere Hinweise zur Verwendung einer Kamera mit den Beispiel-Inferenzkomponenten finden Sie unter. [Komponentenkonfigurationen aktualisieren](ml-tutorial-image-classification-camera.md)
**Anmerkung**
Wenn Sie sich das Rezept für diese Komponente ansehen, wird der `UseCamera` Konfigurationsparameter in der Standardkonfiguration nicht angezeigt. Sie können den Wert dieses Parameters jedoch in einem [Update zur Zusammenführung der Konfiguration](update-component-configurations.md) ändern, wenn Sie die Komponente bereitstellen.
Wenn Sie `UseCamera` auf setzen`true`, müssen Sie auch einen Symlink erstellen, damit die Inferenzkomponente über die virtuelle Umgebung, die von der Runtime-Komponente erstellt wurde, auf Ihre Kamera zugreifen kann. Weitere Hinweise zur Verwendung einer Kamera mit den Beispiel-Inferenzkomponenten finden Sie unter. [Komponentenkonfigurationen aktualisieren](ml-tutorial-image-classification-camera.md)
## Lokale Protokolldatei
Diese Komponente verwendet die folgende Protokolldatei.
------
#### [ Linux ]
```
/greengrass/v2/logs/aws.greengrass.TensorFlowLiteObjectDetection.log
```
------
#### [ Windows ]
```
C:\greengrass\v2\logs\aws.greengrass.TensorFlowLiteObjectDetection.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:\$1greengrass\$1v2* durch den Pfad zum AWS IoT Greengrass Stammordner.
------
#### [ Linux ]
```
sudo tail -f /greengrass/v2/logs/aws.greengrass.TensorFlowLiteObjectDetection.log
```
------
#### [ Windows (PowerShell) ]
```
Get-Content C:\greengrass\v2\logs\aws.greengrass.TensorFlowLiteObjectDetection.log -Tail 10 -Wait
```
------
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| Version | Änderungen |
| --- | --- |
| 2.1.12 | Die Version wurde für die Version Greengrass Nucleus 2.12.5 aktualisiert. |
| 2.1.11 | Die Version wurde für die Version 2.12.0 von Greengrass Nucleus aktualisiert. |
| 2.1.10 | Die Version wurde für die Version 2.11.0 von Greengrass Nucleus aktualisiert. |
| 2.1.9 | Die Version wurde für die Version 2.10.0 von Greengrass Nucleus aktualisiert. |
| 2.1.8 | Die Version wurde für die Version 2.9.0 von Greengrass Nucleus aktualisiert. |
| 2.1.7 | Die Version wurde für die Version 2.8.0 von Greengrass Nucleus aktualisiert. |
| 2.1.6 | Die Version wurde für die Version 2.7.0 von Greengrass Nucleus aktualisiert. |
| 2.1.5 | Die Version wurde für die Version 2.6.0 von Greengrass Nucleus aktualisiert. |
| 2.1.4 | Die Version wurde für die Version 2.5.0 von Greengrass Nucleus aktualisiert. |
| 2.1.3 | Die Version wurde für die Version 2.4.0 von Greengrass Nucleus aktualisiert. |
| 2.1.2 | Die Version wurde für die Version 2.3.0 von Greengrass Nucleus aktualisiert. |
| 2.1.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/tensorflow-lite-object-detection-component.html) |
| 2.1.0 | Erste Version |
# TensorFlow Modellspeicher für Lite-Bildklassifizierung
Der TensorFlow Lite-Bildklassifizierungsmodellspeicher (`variant.TensorFlowLite.ImageClassification.ModelStore`) ist eine Modellkomponente für maschinelles Lernen, die ein vortrainiertes MobileNet v1-Modell als Greengrass-Artefakt enthält. [Das in dieser Komponente verwendete Beispielmodell wird vom [TensorFlowHub](https://tfhub.dev/) abgerufen und mit Lite implementiert. TensorFlow ](https://www.tensorflow.org/lite/guide/python)
Die [TensorFlow Lite-Bildklassifizierung](tensorflow-lite-image-classification-component.md) Inferenzkomponente verwendet diese Komponente als Abhängigkeit für die Modellquelle. Um ein benutzerdefiniertes TensorFlow Lite-Modell zu verwenden, [erstellen Sie eine benutzerdefinierte Version](ml-customization.md#override-public-model-store) dieser Modellkomponente und fügen Sie Ihr benutzerdefiniertes Modell als Komponentenartefakt hinzu. Sie können das Rezept dieser Komponente als Vorlage verwenden, um benutzerdefinierte Modellkomponenten zu erstellen.
**Topics**
+ [Versionen](#tensorflow-lite-image-classification-model-store-component-versions)
+ [Typ](#tensorflow-lite-image-classification-model-store-component-type)
+ [Betriebssystem](#tensorflow-lite-image-classification-model-store-component-os-support)
+ [Voraussetzungen](#tensorflow-lite-image-classification-model-store-component-requirements)
+ [Abhängigkeiten](#tensorflow-lite-image-classification-model-store-component-dependencies)
+ [Konfiguration](#tensorflow-lite-image-classification-model-store-component-configuration)
+ [Lokale Protokolldatei](#tensorflow-lite-image-classification-model-store-component-log-file)
+ [Änderungsprotokoll](#tensorflow-lite-image-classification-model-store-component-changelog)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 2.1.x
## Typ
Diese Komponente ist eine generische Komponente () `aws.greengrass.generic`. Der [Greengrass-Kern](greengrass-nucleus-component.md) führt die Lebenszyklusskripte der Komponente aus.
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## 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:
+ Auf Greengrass-Core-Geräten, auf denen Amazon Linux 2 oder Ubuntu 18.04 ausgeführt wird, ist die [GNU C Library](https://www.gnu.org/software/libc/) (Glibc) Version 2.27 oder höher auf dem Gerät installiert.
+ Auf ARMv7L-Geräten wie Raspberry Pi sind Abhängigkeiten für OpenCV-Python auf dem Gerät installiert. Führen Sie den folgenden Befehl aus, um die Abhängigkeiten zu installieren.
```
sudo apt-get install libopenjp2-7 libilmbase23 libopenexr-dev libavcodec-dev libavformat-dev libswscale-dev libv4l-dev libgtk-3-0 libwebp-dev
```
+ Raspberry Pi-Geräte, auf denen Raspberry Pi OS Bullseye ausgeführt wird, müssen die folgenden Anforderungen erfüllen:
+ NumPy 1.22.4 oder höher auf dem Gerät installiert. Raspberry Pi OS Bullseye enthält eine frühere Version von NumPy, sodass Sie den folgenden Befehl ausführen können, um das Gerät zu aktualisieren NumPy .
```
pip3 install --upgrade numpy
```
+ Der ältere Kamerastack ist auf dem Gerät aktiviert. Raspberry Pi OS Bullseye enthält einen neuen Kamerastack, der standardmäßig aktiviert und nicht kompatibel ist. Sie müssen also den älteren Kamerastack aktivieren.
**Um den Legacy-Kamerastack zu aktivieren**
1. Führen Sie den folgenden Befehl aus, um das Raspberry Pi-Konfigurationstool zu öffnen.
```
sudo raspi-config
```
1. Wählen Sie **Schnittstellenoptionen**.
1. Wählen Sie **Legacy-Kamera** aus, um den Legacy-Kamerastack zu aktivieren.
1. Starten Sie den Raspberry Pi neu.
## Abhängigkeiten
Wenn Sie eine Komponente bereitstellen, stellt sie 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](#tensorflow-lite-image-classification-model-store-component-changelog) 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](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.
------
#### [ 2.1.11 and 2.1.12 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.1.11 und 2.1.12 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Weich |
------
#### [ 2.1.10 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.10 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Weich |
------
#### [ 2.1.9 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.9 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Weich |
------
#### [ 2.1.8 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.8 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Weich |
------
#### [ 2.1.7 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.7 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Weich |
------
#### [ 2.1.6 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.6 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Weich |
------
#### [ 2.1.5 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.5 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Weich |
------
#### [ 2.1.4 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.4 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Weich |
------
#### [ 2.1.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Weich |
------
#### [ 2.1.2 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.2 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Weich |
------
#### [ 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](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Weich |
------
#### [ 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](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Weich |
------
## Konfiguration
Diese Komponente hat keine Konfigurationsparameter.
## Lokale Protokolldatei
Diese Komponente gibt keine Protokolle aus.
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| Version | Änderungen |
| --- | --- |
| 2.1.12 | Die Version wurde für die Version Greengrass Nucleus 2.12.5 aktualisiert. |
| 2.1.11 | Die Version wurde für die Version 2.12.0 von Greengrass Nucleus aktualisiert. |
| 2.1.10 | Die Version wurde für die Version 2.11.0 von Greengrass Nucleus aktualisiert. |
| 2.1.9 | Die Version wurde für die Version 2.10.0 von Greengrass Nucleus aktualisiert. |
| 2.1.8 | Die Version wurde für die Version 2.9.0 von Greengrass Nucleus aktualisiert. |
| 2.1.7 | Die Version wurde für die Version 2.8.0 von Greengrass Nucleus aktualisiert. |
| 2.1.6 | Die Version wurde für die Version 2.7.0 von Greengrass Nucleus aktualisiert. |
| 2.1.5 | Die Version wurde für die Version 2.6.0 von Greengrass Nucleus aktualisiert. |
| 2.1.4 | Die Version wurde für die Version 2.5.0 von Greengrass Nucleus aktualisiert. |
| 2.1.3 | Die Version wurde für die Version 2.4.0 von Greengrass Nucleus aktualisiert. |
| 2.1.2 | Die Version wurde für die Version 2.3.0 von Greengrass Nucleus aktualisiert. |
| 2.1.1 | Die Version wurde für die Version 2.2.0 von Greengrass Nucleus aktualisiert. |
| 2.1.0 | Erste Version |
# TensorFlow Modellspeicher für Lite-Objekterkennung
Der TensorFlow Lite-Objekterkennungsmodellspeicher (`variant.TensorFlowLite.ObjectDetection.ModelStore`) ist eine Modellkomponente für maschinelles Lernen, die ein vortrainiertes Single Shot Detection (SSD) MobileNet -Modell als Greengrass-Artefakt enthält. [Das in dieser Komponente verwendete Beispielmodell wird vom [TensorFlow Hub](https://tfhub.dev/) abgerufen und mit Lite implementiert. TensorFlow ](https://www.tensorflow.org/lite/guide/python)
Die [TensorFlow Lite-Inferenzkomponente zur Objekterkennung](tensorflow-lite-object-detection-component.md) verwendet diese Komponente als Abhängigkeit für die Modellquelle. Um ein benutzerdefiniertes TensorFlow Lite-Modell zu verwenden, [erstellen Sie eine benutzerdefinierte Version](ml-customization.md#override-public-model-store) dieser Modellkomponente und fügen Sie Ihr benutzerdefiniertes Modell als Komponentenartefakt hinzu. Sie können das Rezept dieser Komponente als Vorlage verwenden, um benutzerdefinierte Modellkomponenten zu erstellen.
**Topics**
+ [Versionen](#tensorflow-lite-object-detection-model-store-component-versions)
+ [Typ](#tensorflow-lite-object-detection-model-store-component-type)
+ [Betriebssystem](#tensorflow-lite-object-detection-model-store-component-os-support)
+ [Voraussetzungen](#tensorflow-lite-object-detection-model-store-component-requirements)
+ [Abhängigkeiten](#tensorflow-lite-object-detection-model-store-component-dependencies)
+ [Konfiguration](#tensorflow-lite-object-detection-model-store-component-configuration)
+ [Lokale Protokolldatei](#tensorflow-lite-object-detection-model-store-component-log-file)
+ [Änderungsprotokoll](#tensorflow-lite-object-detection-model-store-component-changelog)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 2.1.x
## Typ
Diese Komponente ist eine generische Komponente () `aws.greengrass.generic`. Der [Greengrass-Kern](greengrass-nucleus-component.md) führt die Lebenszyklusskripte der Komponente aus.
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## 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:
+ Auf Greengrass-Core-Geräten, auf denen Amazon Linux 2 oder Ubuntu 18.04 ausgeführt wird, ist die [GNU C Library](https://www.gnu.org/software/libc/) (Glibc) Version 2.27 oder höher auf dem Gerät installiert.
+ Auf ARMv7L-Geräten wie Raspberry Pi sind Abhängigkeiten für OpenCV-Python auf dem Gerät installiert. Führen Sie den folgenden Befehl aus, um die Abhängigkeiten zu installieren.
```
sudo apt-get install libopenjp2-7 libilmbase23 libopenexr-dev libavcodec-dev libavformat-dev libswscale-dev libv4l-dev libgtk-3-0 libwebp-dev
```
+ Raspberry Pi-Geräte, auf denen Raspberry Pi OS Bullseye ausgeführt wird, müssen die folgenden Anforderungen erfüllen:
+ NumPy 1.22.4 oder höher auf dem Gerät installiert. Raspberry Pi OS Bullseye enthält eine frühere Version von NumPy, sodass Sie den folgenden Befehl ausführen können, um das Gerät zu aktualisieren NumPy .
```
pip3 install --upgrade numpy
```
+ Der ältere Kamerastack ist auf dem Gerät aktiviert. Raspberry Pi OS Bullseye enthält einen neuen Kamerastack, der standardmäßig aktiviert und nicht kompatibel ist. Sie müssen also den älteren Kamerastack aktivieren.
**Um den alten Kamerastack zu aktivieren**
1. Führen Sie den folgenden Befehl aus, um das Raspberry Pi-Konfigurationstool zu öffnen.
```
sudo raspi-config
```
1. Wählen Sie **Schnittstellenoptionen**.
1. Wählen Sie **Legacy-Kamera** aus, um den Legacy-Kamerastack zu aktivieren.
1. Starten Sie den Raspberry Pi neu.
## Abhängigkeiten
Wenn Sie eine Komponente bereitstellen, stellt sie 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](#tensorflow-lite-object-detection-model-store-component-changelog) 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](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.
------
#### [ 2.1.11 and 2.1.12 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.1.11 und 2.1.12 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Weich |
------
#### [ 2.1.10 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.10 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Weich |
------
#### [ 2.1.9 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.9 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Weich |
------
#### [ 2.1.8 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.8 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Weich |
------
#### [ 2.1.7 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.7 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Weich |
------
#### [ 2.1.6 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.6 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Weich |
------
#### [ 2.1.5 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.5 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Weich |
------
#### [ 2.1.4 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.4 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Weich |
------
#### [ 2.1.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Weich |
------
#### [ 2.1.2 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.2 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Weich |
------
#### [ 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](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Weich |
------
#### [ 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](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Weich |
------
## Konfiguration
Diese Komponente hat keine Konfigurationsparameter.
## Lokale Protokolldatei
Diese Komponente gibt keine Protokolle aus.
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| Version | Änderungen |
| --- | --- |
| 2.1.12 | Die Version wurde für die Version Greengrass Nucleus 2.12.5 aktualisiert. |
| 2.1.11 | Die Version wurde für die Version 2.12.0 von Greengrass Nucleus aktualisiert. |
| 2.1.10 | Die Version wurde für die Version 2.11.0 von Greengrass Nucleus aktualisiert. |
| 2.1.9 | Die Version wurde für die Version 2.10.0 von Greengrass Nucleus aktualisiert. |
| 2.1.8 | Die Version wurde für die Version 2.9.0 von Greengrass Nucleus aktualisiert. |
| 2.1.7 | Die Version wurde für die Version 2.8.0 von Greengrass Nucleus aktualisiert. |
| 2.1.6 | Die Version wurde für die Version 2.7.0 von Greengrass Nucleus aktualisiert. |
| 2.1.5 | Die Version wurde für die Version 2.6.0 von Greengrass Nucleus aktualisiert. |
| 2.1.4 | Die Version wurde für die Version 2.5.0 von Greengrass Nucleus aktualisiert. |
| 2.1.3 | Die Version wurde für die Version 2.4.0 von Greengrass Nucleus aktualisiert. |
| 2.1.2 | Die Version wurde für die Version 2.3.0 von Greengrass Nucleus aktualisiert. |
| 2.1.1 | Die Version wurde für die Version 2.2.0 von Greengrass Nucleus aktualisiert. |
| 2.1.0 | Erste Version |
# TensorFlow Lite-Laufzeit
Die TensorFlow Lite-Runtime-Komponente (`variant.TensorFlowLite`) enthält ein Skript, das die [TensorFlow Lite-Version](https://www.tensorflow.org/lite/guide/python) 2.5.0 und ihre Abhängigkeiten in einer virtuellen Umgebung auf Ihrem Gerät installiert. Die [TensorFlow Lite-Komponente zur Bildklassifizierung](tensorflow-lite-image-classification-component.md) und [TensorFlow Lite-Objekterkennung](tensorflow-lite-object-detection-component.md) verwendet diese Laufzeitkomponente als Abhängigkeit für die Installation von TensorFlow Lite.
**Anmerkung**
TensorFlow Die Lite-Runtime-Komponente v2.5.6 und höher installiert bestehende Installationen der TensorFlow Lite-Runtime und ihrer Abhängigkeiten neu. Durch diese Neuinstallation wird sichergestellt, dass auf dem Kerngerät kompatible Versionen von TensorFlow Lite und seinen Abhängigkeiten ausgeführt werden.
Um eine andere Laufzeit zu verwenden, können Sie das Rezept dieser Komponente als Vorlage verwenden, um [eine benutzerdefinierte Komponente für maschinelles Lernen zu erstellen](ml-customization.md).
**Topics**
+ [Versionen](#tensorflow-lite-component-versions)
+ [Typ](#tensorflow-lite-component-type)
+ [Betriebssystem](#tensorflow-lite-component-os-support)
+ [Voraussetzungen](#tensorflow-lite-component-requirements)
+ [Abhängigkeiten](#tensorflow-lite-component-dependencies)
+ [Konfiguration](#tensorflow-lite-component-configuration)
+ [Usage](#tensorflow-lite-component-usage)
+ [Lokale Protokolldatei](#tensorflow-lite-component-log-file)
+ [Änderungsprotokoll](#tensorflow-lite-component-changelog)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 2.5.x
## Typ
Diese Komponente ist eine generische Komponente () `aws.greengrass.generic`. Der [Greengrass-Kern](greengrass-nucleus-component.md) führt die Lebenszyklusskripte der Komponente aus.
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## 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:
+ Auf Greengrass-Core-Geräten, auf denen Amazon Linux 2 oder Ubuntu 18.04 ausgeführt wird, ist die [GNU C Library](https://www.gnu.org/software/libc/) (Glibc) Version 2.27 oder höher auf dem Gerät installiert.
+ Auf ARMv7L-Geräten wie Raspberry Pi sind Abhängigkeiten für OpenCV-Python auf dem Gerät installiert. Führen Sie den folgenden Befehl aus, um die Abhängigkeiten zu installieren.
```
sudo apt-get install libopenjp2-7 libilmbase23 libopenexr-dev libavcodec-dev libavformat-dev libswscale-dev libv4l-dev libgtk-3-0 libwebp-dev
```
+ Raspberry Pi-Geräte, auf denen Raspberry Pi OS Bullseye ausgeführt wird, müssen die folgenden Anforderungen erfüllen:
+ NumPy 1.22.4 oder höher auf dem Gerät installiert. Raspberry Pi OS Bullseye enthält eine frühere Version von NumPy, sodass Sie den folgenden Befehl ausführen können, um das Gerät zu aktualisieren NumPy .
```
pip3 install --upgrade numpy
```
+ Der ältere Kamerastack ist auf dem Gerät aktiviert. Raspberry Pi OS Bullseye enthält einen neuen Kamerastack, der standardmäßig aktiviert und nicht kompatibel ist. Sie müssen also den älteren Kamerastack aktivieren.
**Um den alten Kamerastack zu aktivieren**
1. Führen Sie den folgenden Befehl aus, um das Raspberry Pi-Konfigurationstool zu öffnen.
```
sudo raspi-config
```
1. Wählen Sie **Schnittstellenoptionen**.
1. Wählen Sie **Legacy-Kamera** aus, um den Legacy-Kamerastack zu aktivieren.
1. Starten Sie den Raspberry Pi neu.
### Endpunkte und Anschlüsse
Standardmäßig verwendet diese Komponente ein Installationsskript, um Pakete mit den `pip` Befehlen`apt`, `yum``brew`, und zu installieren, je nachdem, welche Plattform das Kerngerät verwendet. Diese Komponente muss in der Lage sein, ausgehende Anfragen an verschiedene Paketindizes und Repositorys auszuführen, um das Installationsskript auszuführen. Damit der ausgehende Datenverkehr dieser Komponente über einen Proxy oder eine Firewall übertragen werden kann, müssen Sie die Endpunkte für die Paketindizes und Repositorys identifizieren, zu denen Ihr Kerngerät eine Verbindung zur Installation herstellt.
Beachten Sie bei der Identifizierung von Endpunkten, die für das Installationsskript dieser Komponente erforderlich sind, Folgendes:
+ Die Endpunkte hängen von der Plattform des Kerngeräts ab. Beispielsweise verwendet ein Kerngerät, auf dem Ubuntu ausgeführt wird, `apt` eher als `yum` oder`brew`. Darüber hinaus haben Geräte, die denselben Paketindex verwenden, möglicherweise unterschiedliche Quelllisten, sodass sie Pakete aus verschiedenen Repositorys abrufen können.
+ Die Endpunkte können sich bei mehreren Geräten, die denselben Paketindex verwenden, unterscheiden, da jedes Gerät über eigene Quelllisten verfügt, die definieren, wo Pakete abgerufen werden sollen.
+ Die Endpunkte können sich im Laufe der Zeit ändern. Jeder Paketindex enthält die URLs Repositorys, in die Sie Pakete herunterladen, und der Besitzer eines Pakets kann ändern, was URLs der Paketindex bereitstellt.
Weitere Informationen zu den Abhängigkeiten, die diese Komponente installiert, und zur Deaktivierung des Installationsskripts finden Sie unter dem [UseInstaller](#tensorflow-lite-component-config-useinstaller-term)Konfigurationsparameter.
Weitere Informationen zu Endpunkten und Ports, die für den Basisbetrieb erforderlich sind, finden Sie unter[Geräteverkehr über einen Proxy oder eine Firewall zulassen](allow-device-traffic.md).
## 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](#tensorflow-lite-component-changelog) 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](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.
------
#### [ 2.5.14 and 2.5.15 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.5.14 und 2.5.15 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Weich |
------
#### [ 2.5.13 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.5.13 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Weich |
------
#### [ 2.5.12 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.5.12 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Weich |
------
#### [ 2.5.11 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.5.11 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Weich |
------
#### [ 2.5.10 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.5.10 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Weich |
------
#### [ 2.5.9 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.5.9 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Weich |
------
#### [ 2.5.8 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.5.8 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Weich |
------
#### [ 2.5.5 - 2.5.7 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.5.5 bis 2.5.7 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Weich |
------
#### [ 2.5.3 and 2.5.4 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.5.3 und 2.5.4 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Weich |
------
#### [ 2.5.2 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.5.2 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Weich |
------
#### [ 2.5.1 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.5.1 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Weich |
------
#### [ 2.5.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.5.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Weich |
------
[Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den Komponentenrezepten.](component-recipe-reference.md#recipe-reference-component-dependencies)
## Konfiguration
Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.
`MLRootPath`
(Optional) Der Pfad des Ordners auf Linux-Kerngeräten, in dem Inferenzkomponenten Bilder lesen und Inferenzergebnisse schreiben. Sie können diesen Wert in einen beliebigen Speicherort auf Ihrem Gerät ändern, auf den der Benutzer, der diese Komponente ausführt, Zugriff hat read/write .
Standard: `/greengrass/v2/work/variant.TensorFlowLite/greengrass_ml`
`WindowsMLRootPath`
Diese Funktion ist in Version 1.6.6 und höher dieser Komponente verfügbar.
(Optional) Der Pfad des Ordners auf dem Windows Core-Gerät, in dem Inferenzkomponenten Bilder lesen und Inferenzergebnisse schreiben. Sie können diesen Wert in einen beliebigen Speicherort auf Ihrem Gerät ändern, auf den der Benutzer, der diese Komponente ausführt, Zugriff hat read/write .
Standard: `C:\greengrass\v2\\work\\variant.DLR\\greengrass_ml`
`UseInstaller`
(Optional) Zeichenkettenwert, der definiert, ob das Installationsskript in dieser Komponente verwendet werden soll, um TensorFlow Lite und seine Abhängigkeiten zu installieren. Unterstützte Werte sind `true` und `false`.
Setzen Sie diesen Wert auf, `false` wenn Sie ein benutzerdefiniertes Skript für die TensorFlow Lite-Installation verwenden möchten oder wenn Sie Laufzeitabhängigkeiten in ein vorgefertigtes Linux-Image aufnehmen möchten. Um diese Komponente mit den von AWS-bereitgestellten TensorFlow Lite-Inferenzkomponenten zu verwenden, installieren Sie die folgenden Bibliotheken, einschließlich aller Abhängigkeiten, und stellen Sie sie dem Systembenutzer zur Verfügung, z. B. `ggc_user` dem Systembenutzer, der die ML-Komponenten ausführt.
+ [Python](https://www.python.org/downloads/) 3.8 oder höher, auch `pip` für Ihre Version von Python
+ [TensorFlow Lite v2.5.0](https://www.tensorflow.org/lite/guide/python)
+ [NumPy](https://numpy.org/install/)
+ [Öffnen Sie CV-Python](https://pypi.org/project/opencv-python/)
+ [AWS IoT Device SDK v2 für Python](https://github.com/aws/aws-iot-device-sdk-python-v2)
+ [AWS Common Runtime (CRT) Python](https://github.com/awslabs/aws-crt-python)
+ [Picamera](https://picamera.readthedocs.io/en/release-1.13/) (für Raspberry Pi-Geräte)
+ [`awscam`Modul](https://docs.aws.amazon.com/deeplens/latest/dg/deeplens-library-awscam-module.html) (für AWS DeepLens Geräte)
+ LibGL (für Linux-Geräte)
Standard: `true`
## Usage
Verwenden Sie diese Komponente mit dem `UseInstaller` Konfigurationsparameter auf, `true` um TensorFlow Lite und seine Abhängigkeiten auf Ihrem Gerät zu installieren. Die Komponente richtet eine virtuelle Umgebung auf Ihrem Gerät ein, die OpenCV und die NumPy Bibliotheken enthält, die für TensorFlow Lite erforderlich sind.
**Anmerkung**
Das Installationsskript in dieser Komponente installiert auch die neuesten Versionen zusätzlicher Systembibliotheken, die für die Konfiguration der virtuellen Umgebung auf Ihrem Gerät und die Verwendung des installierten Frameworks für maschinelles Lernen erforderlich sind. Dadurch könnten die vorhandenen Systembibliotheken auf Ihrem Gerät aktualisiert werden. In der folgenden Tabelle finden Sie eine Liste der Bibliotheken, die diese Komponente für jedes unterstützte Betriebssystem installiert. Wenn Sie diesen Installationsvorgang anpassen möchten, setzen Sie den `UseInstaller` Konfigurationsparameter auf `false` und entwickeln Sie Ihr eigenes Installationsskript.
| Plattform | Auf dem Gerätesystem installierte Bibliotheken | In der virtuellen Umgebung installierte Bibliotheken |
| --- | --- | --- |
| Armv7l | build-essential, cmake, ca-certificates, git | setuptools, wheel |
| Amazon Linux 2 | mesa-libGL | Keine |
| Ubuntu | wget | Keine |
Wenn Sie Ihre Inferenzkomponente bereitstellen, überprüft diese Runtime-Komponente zunächst, ob TensorFlow Lite und die zugehörigen Abhängigkeiten auf Ihrem Gerät bereits installiert sind. Wenn nicht, installiert die Runtime-Komponente sie für Sie.
## Lokale Protokolldatei
Diese Komponente verwendet die folgende Protokolldatei.
------
#### [ Linux ]
```
/greengrass/v2/logs/variant.TensorFlowLite.log
```
------
#### [ Windows ]
```
C:\greengrass\v2\logs\variant.TensorFlowLite.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:\$1greengrass\$1v2* durch den Pfad zum AWS IoT Greengrass Stammordner.
------
#### [ Linux ]
```
sudo tail -f /greengrass/v2/logs/variant.TensorFlowLite.log
```
------
#### [ Windows (PowerShell) ]
```
Get-Content C:\greengrass\v2\logs\variant.TensorFlowLite.log -Tail 10 -Wait
```
------
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| Version | Änderungen |
| --- | --- |
| 2.5.15 | Version für Greengrass Nucleus 2.12.5 aktualisiert. |
| 2.5.14 | Die Version wurde für die Version 2.12.0 von Greengrass Nucleus aktualisiert. |
| 2.5.13 | Die Version wurde für die Version 2.11.0 von Greengrass Nucleus aktualisiert. |
| 2.5.12 | Die Version wurde für die Version 2.10.0 von Greengrass Nucleus aktualisiert. |
| 2.5.11 | Die Version wurde für die Version 2.9.0 von Greengrass Nucleus aktualisiert. |
| 2.5.10 | Die Version wurde für die Version 2.8.0 von Greengrass Nucleus aktualisiert. |
| 2.5.9 | Die Version wurde für die Version 2.7.0 von Greengrass Nucleus aktualisiert. |
| 2.5.8 | Die Version wurde für die Version 2.6.0 von Greengrass Nucleus aktualisiert. |
| 2.5.7 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/tensorflow-lite-component.html) |
| 2.5.6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/tensorflow-lite-component.html) |
| 2.5.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/tensorflow-lite-component.html) |
| 2.5.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/tensorflow-lite-component.html) |
| 2.5.3 | Die Version wurde für die Version 2.4.0 von Greengrass Nucleus aktualisiert. |
| 2.5.2 | Die Version wurde für die Version 2.3.0 von Greengrass Nucleus aktualisiert. |
| 2.5.1 | Die Version wurde für die Version 2.2.0 von Greengrass Nucleus aktualisiert. |
| 2.5.0 | Erste Version |
# Modbus-RTU-Protokolladapter
Die Modbus-RTU-Protokolladapter-Komponente (`aws.greengrass.Modbus`) fragt Informationen von lokalen Modbus RTU-Geräten ab.
Um mit dieser Komponente Informationen von einem lokalen Modbus RTU-Gerät anzufordern, veröffentlichen Sie eine Nachricht zu dem Thema, das diese Komponente abonniert. Geben Sie in der Nachricht die Modbus RTU-Anforderung an, die an ein Gerät gesendet werden soll. Anschließend veröffentlicht diese Komponente eine Antwort, die das Ergebnis der Modbus-RTU-Anfrage enthält.
**Anmerkung**
Diese Komponente bietet ähnliche Funktionen wie der Modbus RTU-Protokolladapter-Anschluss in V1. AWS IoT Greengrass *Weitere Informationen finden Sie unter [Modbus RTU-Protokolladapter-Anschluss](https://docs.aws.amazon.com/greengrass/latest/developerguide/modbus-protocol-adapter-connector.html) im V1-Entwicklerhandbuch.AWS IoT Greengrass *
**Topics**
+ [Versionen](#modbus-rtu-protocol-adapter-component-versions)
+ [Typ](#modbus-rtu-protocol-adapter-component-type)
+ [Betriebssystem](#modbus-rtu-protocol-adapter-component-os-support)
+ [Voraussetzungen](#modbus-rtu-protocol-adapter-component-requirements)
+ [Abhängigkeiten](#modbus-rtu-protocol-adapter-component-dependencies)
+ [Konfiguration](#modbus-rtu-protocol-adapter-component-configuration)
+ [Eingabedaten](#modbus-rtu-protocol-adapter-component-input-data)
+ [Ausgabedaten](#modbus-rtu-protocol-adapter-component-output-data)
+ [Modbus RTU-Anforderungen und -Antworten](#modbus-rtu-protocol-adapter-component-requests-responses)
+ [Lokale Protokolldatei](#modbus-rtu-protocol-adapter-component-log-file)
+ [Lizenzen](#modbus-rtu-protocol-adapter-component-licenses)
+ [Änderungsprotokoll](#modbus-rtu-protocol-adapter-component-changelog)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 2.1.x
+ 2.0.x
## Typ
Diese Komponente ist eine Lambda-Komponente (`aws.greengrass.lambda`). [Der [Greengrass-Kern führt die](greengrass-nucleus-component.md) Lambda-Funktion dieser Komponente mithilfe der Lambda-Launcher-Komponente aus.](lambda-launcher-component.md)
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## Betriebssystem
Diese Komponente kann nur auf Linux-Kerngeräten installiert werden.
## Voraussetzungen
Für diese Komponente gelten die folgenden Anforderungen:
+ Ihr Kerngerät muss die Anforderungen für die Ausführung von Lambda-Funktionen erfüllen. Wenn Sie möchten, dass das Kerngerät containerisierte Lambda-Funktionen ausführt, muss das Gerät die entsprechenden Anforderungen erfüllen. Weitere Informationen finden Sie unter [Anforderungen an die Lambda-Funktion](setting-up.md#greengrass-v2-lambda-requirements).
+ [Python-Version](https://www.python.org/) 3.7 wurde auf dem Core-Gerät installiert und zur Umgebungsvariablen PATH hinzugefügt.
+ Eine physische Verbindung zwischen dem AWS IoT Greengrass Kerngerät und den Modbus-Geräten. Das Kerngerät muss über eine serielle Schnittstelle, z. B. einen USB-Anschluss, physisch mit dem Modbus RTU-Netzwerk verbunden sein.
+ Um Ausgabedaten von dieser Komponente zu empfangen, müssen Sie bei der Bereitstellung dieser Komponente das folgende Konfigurationsupdate für die [ältere Abonnement-Router-Komponente](legacy-subscription-router-component.md) (`aws.greengrass.LegacySubscriptionRouter`) zusammenführen. Diese Konfiguration gibt das Thema an, zu dem diese Komponente Antworten veröffentlicht.
------
#### [ Legacy subscription router v2.1.x ]
```
{
"subscriptions": {
"aws-greengrass-modbus": {
"id": "aws-greengrass-modbus",
"source": "component:aws.greengrass.Modbus",
"subject": "modbus/adapter/response",
"target": "cloud"
}
}
}
```
------
#### [ Legacy subscription router v2.0.x ]
```
{
"subscriptions": {
"aws-greengrass-modbus": {
"id": "aws-greengrass-modbus",
"source": "arn:aws:lambda:region:aws:function:aws-greengrass-modbus:version",
"subject": "modbus/adapter/response",
"target": "cloud"
}
}
}
```
+ *region*Ersetzen Sie es durch AWS-Region das, was Sie verwenden.
+ *version*Ersetzen Sie durch die Version der Lambda-Funktion, die diese Komponente ausführt. Um die Version der Lambda-Funktion zu finden, müssen Sie sich das Rezept für die Version dieser Komponente ansehen, die Sie bereitstellen möchten. Öffnen Sie die Detailseite dieser Komponente in der [AWS IoT Greengrass Konsole](https://console.aws.amazon.com//greengrass) und suchen Sie nach dem **Schlüssel-Wert-Paar der Lambda-Funktion**. Dieses Schlüssel-Wert-Paar enthält den Namen und die Version der Lambda-Funktion.
**Wichtig**
Sie müssen die Lambda-Funktionsversion auf dem Legacy-Abonnement-Router jedes Mal aktualisieren, wenn Sie diese Komponente bereitstellen. Dadurch wird sichergestellt, dass Sie die richtige Lambda-Funktionsversion für die Komponentenversion verwenden, die Sie bereitstellen.
------
Weitere Informationen finden Sie unter [Erstellen von Bereitstellungen](create-deployments.md).
+ Der Modbus-RTU-Protokolladapter wird für die Ausführung in einer VPC unterstützt.
## Abhängigkeiten
Wenn Sie eine Komponente bereitstellen, stellt er 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](#modbus-rtu-protocol-adapter-component-changelog) 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](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.
------
#### [ 2.1.11 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.11 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.16.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.1.10 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.10 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.15.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.1.9 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.9 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.14.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.1.8 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.8 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.1.7 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.7 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.1.6 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.6 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.1.4 and 2.1.5 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.1.4 und 2.1.5 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.1.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.1.2 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.2 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.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](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.0.8 and 2.1.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.0.8 und 2.1.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.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](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.0.6 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.6 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.0.5 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.5 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.0.4 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.4 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.0.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.3 <2.1.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | >=1.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | >=1,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | >=1.0.0 | Hart |
------
Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den [Komponentenrezepten](component-recipe-reference.md#recipe-reference-component-dependencies).
## Konfiguration
Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.
**Anmerkung**
Die Standardkonfiguration dieser Komponente umfasst Lambda-Funktionsparameter. Wir empfehlen, dass Sie nur die folgenden Parameter bearbeiten, um diese Komponente auf Ihren Geräten zu konfigurieren.
------
#### [ v2.1.x ]
`lambdaParams`
Ein Objekt, das die Parameter für die Lambda-Funktion dieser Komponente enthält. Dieses Objekt enthält die folgenden Informationen:
`EnvironmentVariables`
Ein Objekt, das die Parameter der Lambda-Funktion enthält. Dieses Objekt enthält die folgenden Informationen:
`ModbusLocalPort`
Der absolute Pfad zur physischen seriellen Modbus-Schnittstelle auf dem Kerngerät, z. B. `/dev/ttyS2`
Um diese Komponente in einem Container auszuführen, müssen Sie diesen Pfad als Systemgerät (in`containerParams.devices`) definieren, auf das die Komponente zugreifen kann. Diese Komponente wird standardmäßig in einem Container ausgeführt.
Diese Komponente muss read/write Zugriff auf das Gerät haben.
`ModbusBaudRate`
(Optional) Ein Zeichenkettenwert, der die Baudrate für die serielle Kommunikation mit lokalen Modbus-TCP-Geräten angibt.
Standard: `9600`
`ModbusByteSize`
(Optional) Ein Zeichenkettenwert, der die Größe eines Bytes bei der seriellen Kommunikation mit lokalen Modbus-TCP-Geräten angibt. Wählen Sie`5`, `6``7`, oder `8` Bits.
Standard: `8`
`ModbusParity`
(Optional) Der Paritätsmodus, der zur Überprüfung der Datenintegrität bei der seriellen Kommunikation mit lokalen Modbus-TCP-Geräten verwendet werden soll.
+ `E`— Überprüfen Sie die Datenintegrität mit gleichmäßiger Parität.
+ `O`— Überprüfen Sie die Datenintegrität mit ungerader Parität.
+ `N`— Überprüfen Sie nicht die Datenintegrität.
Standard: `N`
`ModbusStopBits`
(Optional) Ein Zeichenkettenwert, der die Anzahl der Bits angibt, die das Ende eines Bytes bei der seriellen Kommunikation mit lokalen Modbus-TCP-Geräten angeben.
Standard: `1`
`containerMode`
(Optional) Der Containerisierungsmodus für diese Komponente. Wählen Sie aus den folgenden Optionen aus:
+ `GreengrassContainer`— Die Komponente wird in einer isolierten Laufzeitumgebung innerhalb des AWS IoT Greengrass Containers ausgeführt.
Wenn Sie diese Option angeben, müssen Sie ein Systemgerät (in`containerParams.devices`) angeben, um dem Container Zugriff auf das Modbus-Gerät zu gewähren.
+ `NoContainer`— Die Komponente läuft nicht in einer isolierten Laufzeitumgebung.
Standard: `GreengrassContainer`
`containerParams`
(Optional) Ein Objekt, das die Container-Parameter für diese Komponente enthält. Die Komponente verwendet diese Parameter, wenn Sie `GreengrassContainer` für angeben`containerMode`.
Dieses Objekt enthält die folgenden Informationen:
`memorySize`
(Optional) Die Speichermenge (in Kilobyte), die der Komponente zugewiesen werden soll.
Der Standardwert ist 512 MB (525.312 KB).
`devices`
(Optional) Ein Objekt, das die Systemgeräte angibt, auf die die Komponente in einem Container zugreifen kann.
Um diese Komponente in einem Container auszuführen, müssen Sie das Systemgerät, das Sie konfigurieren, in der `ModbusLocalPort` Umgebungsvariablen angeben.
Dieses Objekt enthält die folgenden Informationen:
`0`— Dies ist ein Array-Index als Zeichenfolge.
Ein Objekt, das die folgenden Informationen enthält:
`path`
Der Pfad zum Systemgerät auf dem Kerngerät. Dieser Wert muss denselben Wert haben wie der Wert, für den Sie die Konfiguration konfigurieren`ModbusLocalPort`.
`permission`
(Optional) Die Berechtigung, vom Container aus auf das Systemgerät zuzugreifen. Dieser Wert muss sein`rw`, was angibt, dass die Komponente read/write Zugriff auf das Systemgerät hat.
Standard: `rw`
`addGroupOwner`
(Optional) Ob die Systemgruppe, die die Komponente ausführt, als Besitzer des Systemgeräts hinzugefügt werden soll oder nicht.
Standard: `true`
`pubsubTopics`
(Optional) Ein Objekt, das die Themen enthält, für die die Komponente den Empfang von Nachrichten abonniert. Sie können jedes Thema angeben und angeben, ob die Komponente MQTT-Themen von AWS IoT Core oder lokale Themen abonniert. publish/subscribe
Dieses Objekt enthält die folgenden Informationen:
`0`— Dies ist ein Array-Index als Zeichenfolge.
Ein Objekt, das die folgenden Informationen enthält:
`type`
(Optional) Der publish/subscribe Messaging-Typ, den diese Komponente verwendet, um Nachrichten zu abonnieren. Wählen Sie aus den folgenden Optionen aus:
+ `PUB_SUB` — Abonnieren Sie lokale Veröffentlichen/Abonnement-Nachrichten. Wenn Sie diese Option wählen, darf das Thema keine MQTT-Platzhalter enthalten. Weitere Informationen zum Senden von Nachrichten von einer benutzerdefinierten Komponente aus, wenn Sie diese Option angeben, finden Sie unter. [Lokale Nachrichten veröffentlichen/abonnieren](ipc-publish-subscribe.md)
+ `IOT_CORE`— Abonnieren Sie AWS IoT Core MQTT-Nachrichten. Wenn Sie diese Option wählen, kann das Thema MQTT-Platzhalter enthalten. Weitere Informationen zum Senden von Nachrichten aus benutzerdefinierten Komponenten, wenn Sie diese Option angeben, finden Sie unter. [MQTT-Nachrichten veröffentlichen/abonnieren AWS IoT Core](ipc-iot-core-mqtt.md)
Standard: `PUB_SUB`
`topic`
(Optional) Das Thema, das die Komponente abonniert, um Nachrichten zu empfangen. Wenn Sie `IotCore` für angeben`type`, können Sie in diesem Thema MQTT-Platzhalter (`+`und`#`) verwenden.
**Example Beispiel: Aktualisierung der Konfigurationszusammenführung (Container-Modus)**
```
{
"lambdaExecutionParameters": {
"EnvironmentVariables": {
"ModbusLocalPort": "/dev/ttyS2"
}
},
"containerMode": "GreengrassContainer",
"containerParams": {
"devices": {
"0": {
"path": "/dev/ttyS2",
"permission": "rw",
"addGroupOwner": true
}
}
}
}
```
**Example Beispiel: Aktualisierung der Konfigurationszusammenführung (kein Container-Modus)**
```
{
"lambdaExecutionParameters": {
"EnvironmentVariables": {
"ModbusLocalPort": "/dev/ttyS2"
}
},
"containerMode": "NoContainer"
}
```
------
#### [ v2.0.x ]
`lambdaParams`
Ein Objekt, das die Parameter für die Lambda-Funktion dieser Komponente enthält. Dieses Objekt enthält die folgenden Informationen:
`EnvironmentVariables`
Ein Objekt, das die Parameter der Lambda-Funktion enthält. Dieses Objekt enthält die folgenden Informationen:
`ModbusLocalPort`
Der absolute Pfad zur physischen seriellen Modbus-Schnittstelle auf dem Kerngerät, z. B. `/dev/ttyS2`
Um diese Komponente in einem Container auszuführen, müssen Sie diesen Pfad als Systemgerät (in`containerParams.devices`) definieren, auf das die Komponente zugreifen kann. Diese Komponente wird standardmäßig in einem Container ausgeführt.
Diese Komponente muss read/write Zugriff auf das Gerät haben.
`containerMode`
(Optional) Der Containerisierungsmodus für diese Komponente. Wählen Sie aus den folgenden Optionen aus:
+ `GreengrassContainer`— Die Komponente wird in einer isolierten Laufzeitumgebung innerhalb des AWS IoT Greengrass Containers ausgeführt.
Wenn Sie diese Option angeben, müssen Sie ein Systemgerät (in`containerParams.devices`) angeben, um dem Container Zugriff auf das Modbus-Gerät zu gewähren.
+ `NoContainer`— Die Komponente läuft nicht in einer isolierten Laufzeitumgebung.
Standard: `GreengrassContainer`
`containerParams`
(Optional) Ein Objekt, das die Container-Parameter für diese Komponente enthält. Die Komponente verwendet diese Parameter, wenn Sie `GreengrassContainer` für angeben`containerMode`.
Dieses Objekt enthält die folgenden Informationen:
`memorySize`
(Optional) Die Speichermenge (in Kilobyte), die der Komponente zugewiesen werden soll.
Der Standardwert ist 512 MB (525.312 KB).
`devices`
(Optional) Ein Objekt, das die Systemgeräte angibt, auf die die Komponente in einem Container zugreifen kann.
Um diese Komponente in einem Container auszuführen, müssen Sie das Systemgerät, das Sie konfigurieren, in der `ModbusLocalPort` Umgebungsvariablen angeben.
Dieses Objekt enthält die folgenden Informationen:
`0`— Dies ist ein Array-Index als Zeichenfolge.
Ein Objekt, das die folgenden Informationen enthält:
`path`
Der Pfad zum Systemgerät auf dem Kerngerät. Dieser Wert muss denselben Wert haben wie der Wert, für den Sie die Konfiguration konfigurieren`ModbusLocalPort`.
`permission`
(Optional) Die Berechtigung, vom Container aus auf das Systemgerät zuzugreifen. Dieser Wert muss sein`rw`, was angibt, dass die Komponente read/write Zugriff auf das Systemgerät hat.
Standard: `rw`
`addGroupOwner`
(Optional) Ob die Systemgruppe, die die Komponente ausführt, als Besitzer des Systemgeräts hinzugefügt werden soll oder nicht.
Standard: `true`
`pubsubTopics`
(Optional) Ein Objekt, das die Themen enthält, für die die Komponente den Empfang von Nachrichten abonniert. Sie können jedes Thema angeben und angeben, ob die Komponente MQTT-Themen von AWS IoT Core oder lokale Themen abonniert. publish/subscribe
Dieses Objekt enthält die folgenden Informationen:
`0`— Dies ist ein Array-Index als Zeichenfolge.
Ein Objekt, das die folgenden Informationen enthält:
`type`
(Optional) Der publish/subscribe Messaging-Typ, den diese Komponente verwendet, um Nachrichten zu abonnieren. Wählen Sie aus den folgenden Optionen aus:
+ `PUB_SUB` — Abonnieren Sie lokale Veröffentlichen/Abonnement-Nachrichten. Wenn Sie diese Option wählen, darf das Thema keine MQTT-Platzhalter enthalten. Weitere Informationen zum Senden von Nachrichten von einer benutzerdefinierten Komponente aus, wenn Sie diese Option angeben, finden Sie unter. [Lokale Nachrichten veröffentlichen/abonnieren](ipc-publish-subscribe.md)
+ `IOT_CORE`— Abonnieren Sie AWS IoT Core MQTT-Nachrichten. Wenn Sie diese Option wählen, kann das Thema MQTT-Platzhalter enthalten. Weitere Informationen zum Senden von Nachrichten aus benutzerdefinierten Komponenten, wenn Sie diese Option angeben, finden Sie unter. [MQTT-Nachrichten veröffentlichen/abonnieren AWS IoT Core](ipc-iot-core-mqtt.md)
Standard: `PUB_SUB`
`topic`
(Optional) Das Thema, das die Komponente abonniert, um Nachrichten zu empfangen. Wenn Sie `IotCore` für angeben`type`, können Sie in diesem Thema MQTT-Platzhalter (`+`und`#`) verwenden.
**Example Beispiel: Aktualisierung der Konfigurationszusammenführung (Container-Modus)**
```
{
"lambdaExecutionParameters": {
"EnvironmentVariables": {
"ModbusLocalPort": "/dev/ttyS2"
}
},
"containerMode": "GreengrassContainer",
"containerParams": {
"devices": {
"0": {
"path": "/dev/ttyS2",
"permission": "rw",
"addGroupOwner": true
}
}
}
}
```
**Example Beispiel: Aktualisierung der Konfigurationszusammenführung (kein Container-Modus)**
```
{
"lambdaExecutionParameters": {
"EnvironmentVariables": {
"ModbusLocalPort": "/dev/ttyS2"
}
},
"containerMode": "NoContainer"
}
```
------
## Eingabedaten
Diese Komponente akzeptiert Modbus-RTU-Anforderungsparameter zum folgenden Thema und sendet die Modbus-RTU-Anforderung an das Gerät. Standardmäßig abonniert diese Komponente lokale Nachrichten. publish/subscribe Weitere Informationen zum Veröffentlichen von Nachrichten aus Ihren benutzerdefinierten Komponenten in dieser Komponente finden Sie unter[Lokale Nachrichten veröffentlichen/abonnieren](ipc-publish-subscribe.md).
**Standardthema (lokales Veröffentlichen/Abonnieren):** `modbus/adapter/request`
Die Nachricht akzeptiert die folgenden Eigenschaften. Eingabenachrichten müssen im JSON-Format vorliegen.
`request`
Die Parameter für die zu sendende Modbus-RTU-Anforderung.
Die Form der Anforderungsnachricht hängt vom Typ der Modbus-RTU-Anforderung ab, die sie darstellt. Die folgenden Eigenschaften sind für alle Anfragen erforderlich.
Typ: `object` der die folgenden Informationen enthält:
`operation`
Der Name des auszuführenden Vorgangs. Geben Sie beispielsweise an, `ReadCoilsRequest` dass Spulen auf einem Modbus-RTU-Gerät gelesen werden sollen. Weitere Informationen zu unterstützten Vorgängen finden Sie unter. [Modbus RTU-Anforderungen und -Antworten](#modbus-rtu-protocol-adapter-component-requests-responses)
Typ: `string`
`device`
Das Zielgerät der Anfrage.
Dieser Wert muss eine Ganzzahl zwischen `0` und sein`247`.
Typ: `integer`
Die weiteren Parameter, die in die Anforderung aufgenommen werden sollen, hängen von der Operation ab. Diese Komponente führt die [zyklische Redundanzprüfung (CRC)](https://en.wikipedia.org/wiki/Cyclic_redundancy_check) durch, um Datenanfragen für Sie zu verifizieren.
Wenn Ihre Anfrage eine `address` Eigenschaft enthält, müssen Sie ihren Wert als Ganzzahl angeben. Beispiel, `"address": 1`.
`id`
Eine willkürliche ID für die Anforderung. Verwenden Sie diese Eigenschaft, um eine Eingabeanforderung einer Ausgabeantwort zuzuordnen. Wenn Sie diese Eigenschaft angeben, setzt die Komponente die `id` Eigenschaft im Antwortobjekt auf diesen Wert.
Typ: `string`
**Example Beispieleingabe: Lesen Spulenanforderungen**
```
{
"request": {
"operation": "ReadCoilsRequest",
"device": 1,
"address": 1,
"count": 1
},
"id": "MyRequest"
}
```
## Ausgabedaten
Diese Komponente veröffentlicht standardmäßig Antworten als Ausgabedaten zum folgenden MQTT-Thema. Sie müssen dieses Thema `subject` in der Konfiguration für die [ältere Abonnement-Router-Komponente](legacy-subscription-router-component.md) angeben. Weitere Informationen zum Abonnieren von Nachrichten zu diesem Thema in Ihren benutzerdefinierten Komponenten finden Sie unter[MQTT-Nachrichten veröffentlichen/abonnieren AWS IoT Core](ipc-iot-core-mqtt.md).
**Standardthema (AWS IoT Core MQTT):** `modbus/adapter/response`
Die Form der Antwortnachricht hängt von der Anforderungsoperation und dem Antwortstatus ab. Beispiele finden Sie unter [Beispiel: Anforderungen und Antworten](#modbus-rtu-protocol-adapter-component-examples).
Jede Antwort beinhaltet die folgenden Eigenschaften:
`response`
Die Antwort des Modbus RTU-Geräts.
Typ: der `object` die folgenden Informationen enthält:
`status`
Der Status der Anforderung. Der Status kann einer der folgenden Werte sein:
+ `Success`— Die Anfrage war gültig, die Komponente hat die Anfrage an das Modbus RTU-Netzwerk gesendet und das Modbus RTU-Netzwerk hat eine Antwort zurückgegeben.
+ `Exception`— Die Anfrage war gültig, die Komponente hat die Anfrage an das Modbus RTU-Netzwerk gesendet und das Modbus RTU-Netzwerk hat eine Ausnahme zurückgegeben. Weitere Informationen finden Sie unter [Antwortstatus: Ausnahme](#modbus-rtu-protocol-adapter-component-response-exception).
+ `No Response`— Die Anfrage war ungültig und die Komponente hat den Fehler erkannt, bevor sie die Anfrage an das Modbus RTU-Netzwerk gesendet hat. Weitere Informationen finden Sie unter [Antwortstatus: Keine Antwort](#modbus-rtu-protocol-adapter-component-response-noresponse).
`operation`
Der Vorgang, den die Komponente angefordert hat.
`device`
Das Gerät, an das die Komponente die Anfrage gesendet hat.
`payload`
Die Antwort des Modbus RTU-Geräts. Wenn ja `status``No Response`, enthält dieses Objekt nur eine `error` Eigenschaft mit der Beschreibung des Fehlers (z. B.`[Input/Output] No Response received from the remote unit`).
`id`
Die ID der Anfrage, anhand derer Sie ermitteln können, welche Antwort welcher Anfrage entspricht.
**Anmerkung**
Eine Antwort für einen Schreibvorgang ist lediglich ein Echo der Anforderung. Schreibantworten enthalten zwar keine aussagekräftigen Informationen, es empfiehlt sich jedoch, den Status der Antwort zu überprüfen, um festzustellen, ob die Anfrage erfolgreich ist oder nicht.
**Example Beispielausgabe: Erfolg**
```
{
"response" : {
"status" : "success",
"device": 1,
"operation": "ReadCoilsRequest",
"payload": {
"function_code": 1,
"bits": [1]
}
},
"id" : "MyRequest"
}
```
**Example Beispielausgabe: Fehler**
```
{
"response" : {
"status" : "fail",
"error_message": "Internal Error",
"error": "Exception",
"device": 1,
"operation": "ReadCoilsRequest",
"payload": {
"function_code": 129,
"exception_code": 2
}
},
"id" : "MyRequest"
}
```
Weitere Beispiele finden Sie unter [Beispiel: Anforderungen und Antworten](#modbus-rtu-protocol-adapter-component-examples).
## Modbus RTU-Anforderungen und -Antworten
Dieser Konnektor akzeptiert Modbus RTU-Anfrageparameter als [Eingabedaten](#modbus-rtu-protocol-adapter-component-input-data) und veröffentlicht Antworten als [Ausgabedaten](#modbus-rtu-protocol-adapter-component-output-data).
Die folgenden allgemeinen Operationen werden unterstützt.
| Vorgangsname in Anforderung | Funktionscode in Antwort |
| --- | --- |
| ReadCoilsRequest | 01 |
| ReadDiscreteInputsRequest | 02 |
| ReadHoldingRegistersRequest | 03 |
| ReadInputRegistersRequest | 04 |
| WriteSingleCoilRequest | 05 |
| WriteSingleRegisterRequest | 06 |
| WriteMultipleCoilsRequest | 15 |
| WriteMultipleRegistersRequest | 16 |
| MaskWriteRegisterRequest | 22 |
| ReadWriteMultipleRegistersRequest | 23 |
### Beispiel: Anforderungen und Antworten
Im Folgenden finden Sie Beispiele für Anfragen und Antworten für unterstützte Operationen.
Lesen Sie die Spulen
**Anfragebeispiel:**
```
{
"request": {
"operation": "ReadCoilsRequest",
"device": 1,
"address": 1,
"count": 1
},
"id": "TestRequest"
}
```
**Antwortbeispiel:**
```
{
"response": {
"status": "success",
"device": 1,
"operation": "ReadCoilsRequest",
"payload": {
"function_code": 1,
"bits": [1]
}
},
"id" : "TestRequest"
}
```
Lesen Sie diskrete Eingänge
**Anfragebeispiel:**
```
{
"request": {
"operation": "ReadDiscreteInputsRequest",
"device": 1,
"address": 1,
"count": 1
},
"id": "TestRequest"
}
```
**Antwortbeispiel:**
```
{
"response": {
"status": "success",
"device": 1,
"operation": "ReadDiscreteInputsRequest",
"payload": {
"function_code": 2,
"bits": [1]
}
},
"id" : "TestRequest"
}
```
Lesen Sie die Halteregister
**Anfragebeispiel:**
```
{
"request": {
"operation": "ReadHoldingRegistersRequest",
"device": 1,
"address": 1,
"count": 1
},
"id": "TestRequest"
}
```
**Antwortbeispiel:**
```
{
"response": {
"status": "success",
"device": 1,
"operation": "ReadHoldingRegistersRequest",
"payload": {
"function_code": 3,
"registers": [20,30]
}
},
"id" : "TestRequest"
}
```
Eingaberegister lesen
**Anfragebeispiel:**
```
{
"request": {
"operation": "ReadInputRegistersRequest",
"device": 1,
"address": 1,
"count": 1
},
"id": "TestRequest"
}
```
Schreiben Sie Single Coil
**Anfragebeispiel:**
```
{
"request": {
"operation": "WriteSingleCoilRequest",
"device": 1,
"address": 1,
"value": 1
},
"id": "TestRequest"
}
```
**Antwortbeispiel:**
```
{
"response": {
"status": "success",
"device": 1,
"operation": "WriteSingleCoilRequest",
"payload": {
"function_code": 5,
"address": 1,
"value": true
}
},
"id" : "TestRequest"
}
```
Schreiben Sie ein einzelnes Register
**Anfragebeispiel:**
```
{
"request": {
"operation": "WriteSingleRegisterRequest",
"device": 1,
"address": 1,
"value": 1
},
"id": "TestRequest"
}
```
Schreiben Sie mehrere Spulen
**Anfragebeispiel:**
```
{
"request": {
"operation": "WriteMultipleCoilsRequest",
"device": 1,
"address": 1,
"values": [1,0,0,1]
},
"id": "TestRequest"
}
```
**Antwortbeispiel:**
```
{
"response": {
"status": "success",
"device": 1,
"operation": "WriteMultipleCoilsRequest",
"payload": {
"function_code": 15,
"address": 1,
"count": 4
}
},
"id" : "TestRequest"
}
```
Schreiben Sie mehrere Register
**Anfragebeispiel:**
```
{
"request": {
"operation": "WriteMultipleRegistersRequest",
"device": 1,
"address": 1,
"values": [20,30,10]
},
"id": "TestRequest"
}
```
**Antwortbeispiel:**
```
{
"response": {
"status": "success",
"device": 1,
"operation": "WriteMultipleRegistersRequest",
"payload": {
"function_code": 23,
"address": 1,
"count": 3
}
},
"id" : "TestRequest"
}
```
Maske schreiben, Register schreiben
**Anfragebeispiel:**
```
{
"request": {
"operation": "MaskWriteRegisterRequest",
"device": 1,
"address": 1,
"and_mask": 175,
"or_mask": 1
},
"id": "TestRequest"
}
```
**Antwortbeispiel:**
```
{
"response": {
"status": "success",
"device": 1,
"operation": "MaskWriteRegisterRequest",
"payload": {
"function_code": 22,
"and_mask": 0,
"or_mask": 8
}
},
"id" : "TestRequest"
}
```
Mehrere Register lesen, schreiben
**Anfragebeispiel:**
```
{
"request": {
"operation": "ReadWriteMultipleRegistersRequest",
"device": 1,
"read_address": 1,
"read_count": 2,
"write_address": 3,
"write_registers": [20,30,40]
},
"id": "TestRequest"
}
```
**Antwortbeispiel:**
```
{
"response": {
"status": "success",
"device": 1,
"operation": "ReadWriteMultipleRegistersRequest",
"payload": {
"function_code": 23,
"registers": [10,20,10,20]
}
},
"id" : "TestRequest"
}
```
Die Antwort beinhaltet die Register, die die Komponente liest.
### Antwortstatus: Ausnahme
Ausnahmen können auftreten, wenn das Anfrageformat gültig ist, die Anfrage aber nicht erfolgreich abgeschlossen wurde. In diesem Fall enthält die Antwort die folgenden Informationen:
+ Der `status` wird auf `Exception` gesetzt.
+ Der `function_code` entspricht dem Funktionscode der Anforderung \$1 128.
+ Der `exception_code` enthält den Ausnahmecode. Weitere Informationen finden Sie unter Modbus-Ausnahmecodes.
**Beispiel:**
```
{
"response": {
"status": "fail",
"error_message": "Internal Error",
"error": "Exception",
"device": 1,
"operation": "ReadCoilsRequest",
"payload": {
"function_code": 129,
"exception_code": 2
}
},
"id": "TestRequest"
}
```
### Antwortstatus: Keine Antwort
Dieser Konnektor führt Validierungsprüfungen für die Modbus-Anforderung durch. So wird beispielsweise nach ungültigen Formaten und fehlenden Feldern gesucht. Wenn die Validierung fehlschlägt, sendet der Konnektor die Anforderung nicht. Stattdessen gibt er eine Antwort zurück, die die folgenden Informationen enthält:
+ Der `status` wird auf `No Response` gesetzt.
+ Der `error` enthält die Fehlerursache.
+ Die `error_message` enthält die Fehlermeldung.
**Beispiele:**
```
{
"response": {
"status": "fail",
"error_message": "Invalid address field. Expected , got ",
"error": "No Response",
"device": 1,
"operation": "ReadCoilsRequest",
"payload": {
"error": "Invalid address field. Expected Expected , got "
}
},
"id": "TestRequest"
}
```
Wenn die Anforderung auf ein nicht vorhandenes Gerät abzielt oder wenn das Modbus RTU-Netzwerk nicht funktioniert, erhalten Sie möglicherweise eine `ModbusIOException`, die das No Response-Format verwendet.
```
{
"response": {
"status": "fail",
"error_message": "[Input/Output] No Response received from the remote unit",
"error": "No Response",
"device": 1,
"operation": "ReadCoilsRequest",
"payload": {
"error": "[Input/Output] No Response received from the remote unit"
}
},
"id": "TestRequest"
}
```
## Lokale Protokolldatei
Diese Komponente verwendet die folgende Protokolldatei.
```
/greengrass/v2/logs/aws.greengrass.Modbus.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. `/greengrass/v2`Ersetzen Sie es durch den Pfad zum AWS IoT Greengrass Stammordner.
```
sudo tail -f /greengrass/v2/logs/aws.greengrass.Modbus.log
```
## Lizenzen
Diese Komponente umfasst die folgende Software/Lizenzierung von Drittanbietern:
+ [pymodbus /BSD-Lizenz](https://github.com/riptideio/pymodbus/blob/master/README.rst)
+ [pyserial /BSD-Lizenz](https://github.com/pyserial/pyserial)
Diese Komponente wird im Rahmen der [Greengrass Core Software-Lizenzvereinbarung](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf) veröffentlicht.
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| **Version** | **Änderungen** |
| --- | --- |
| 2.1.11 | Die Version wurde für die Version 2.15.0 von Greengrass Nucleus aktualisiert. |
| 2.1.10 | Die Version wurde für die Version 2.14.0 von Greengrass Nucleus aktualisiert. |
| 2.1.9 | Die Version wurde für die Version 2.13.0 von Greengrass Nucleus aktualisiert. |
| 2.1.8 | Die Version wurde für die Version 2.12.0 von Greengrass Nucleus aktualisiert. |
| 2.1.7 | Die Version wurde für die Version 2.11.0 von Greengrass Nucleus aktualisiert. |
| 2.1.6 | Die Version wurde für die Version 2.10.0 von Greengrass Nucleus aktualisiert. |
| 2.1.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/modbus-rtu-protocol-adapter-component.html) |
| 2.1.4 | Die Version wurde für die Version 2.9.0 von Greengrass Nucleus aktualisiert. |
| 2.1.3 | Die Version wurde für die Version 2.8.0 von Greengrass Nucleus aktualisiert. |
| 2.1.2 | Die Version wurde für die Version 2.7.0 von Greengrass Nucleus aktualisiert. |
| 2.1.1 | Die Version wurde für die Version 2.6.0 von Greengrass Nucleus aktualisiert. |
| 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/modbus-rtu-protocol-adapter-component.html) |
| 2.0.8 | Die Version wurde für die Version 2.5.0 von Greengrass Nucleus aktualisiert. |
| 2.0.7 | Die Version wurde für die Version 2.4.0 von Greengrass Nucleus aktualisiert. |
| 2.0.6 | Die Version wurde für die Version 2.3.0 von Greengrass Nucleus aktualisiert. |
| 2.0.5 | Die Version wurde für die Version 2.2.0 von Greengrass Nucleus aktualisiert. |
| 2.0.4 | Die Version wurde für die Version 2.1.0 von Greengrass Nucleus aktualisiert. |
| 2.0.3 | Erste Version |
# MQTT-Brücke
Die MQTT-Bridge-Komponente (`aws.greengrass.clientdevices.mqtt.Bridge`) leitet MQTT-Nachrichten zwischen Client-Geräten, lokalem Greengrass Publish/Subscribe und weiter. AWS IoT Core Sie können diese Komponente verwenden, um auf MQTT-Nachrichten von Client-Geräten in benutzerdefinierten Komponenten zu reagieren und Client-Geräte mit dem zu synchronisieren. AWS Cloud
**Anmerkung**
Client-Geräte sind lokale IoT-Geräte, die eine Verbindung zu einem Greengrass-Core-Gerät herstellen, um MQTT-Nachrichten und Daten zur Verarbeitung zu senden. Weitere Informationen finden Sie unter [Interagieren Sie mit lokalen IoT-Geräten](interact-with-local-iot-devices.md).
Sie können diese Komponente verwenden, um Nachrichten zwischen den folgenden Message Brokern weiterzuleiten:
+ Lokaler MQTT — Der lokale MQTT-Broker verarbeitet Nachrichten zwischen Client-Geräten und einem Core-Gerät.
+ Lokal publish/subscribe — Der lokale Greengrass-Nachrichtenbroker verarbeitet Nachrichten zwischen Komponenten auf einem Kerngerät. Weitere Informationen zur Interaktion mit diesen Nachrichten in Greengrass-Komponenten finden Sie unter[Lokale Nachrichten veröffentlichen/abonnieren](ipc-publish-subscribe.md).
+ AWS IoT Core — Der AWS IoT Core MQTT-Broker verarbeitet Nachrichten zwischen IoT-Geräten und AWS Cloud Zielen. Weitere Informationen zur Interaktion mit diesen Nachrichten in Greengrass-Komponenten finden Sie unter[MQTT-Nachrichten veröffentlichen/abonnieren AWS IoT Core](ipc-iot-core-mqtt.md).
**Anmerkung**
Die MQTT-Bridge verwendet QoS 1 zum Veröffentlichen und Abonnieren AWS IoT Core, auch wenn ein Client-Gerät QoS 0 verwendet, um den lokalen MQTT-Broker zu veröffentlichen und zu abonnieren. Infolgedessen können Sie zusätzliche Latenz beobachten, wenn Sie MQTT-Nachrichten von Client-Geräten auf dem lokalen MQTT-Broker an weiterleiten. AWS IoT Core Weitere Informationen zur MQTT-Konfiguration auf Kerngeräten finden Sie unter. [Konfigurieren Sie MQTT-Timeouts und Cache-Einstellungen](configure-greengrass-core-v2.md#configure-mqtt)
**Topics**
+ [Versionen](#mqtt-bridge-component-versions)
+ [Typ](#mqtt-bridge-component-type)
+ [Betriebssystem](#mqtt-bridge-component-os-support)
+ [Voraussetzungen](#mqtt-bridge-component-requirements)
+ [Abhängigkeiten](#mqtt-bridge-component-dependencies)
+ [Konfiguration](#mqtt-bridge-component-configuration)
+ [Lokale Protokolldatei](#mqtt-bridge-component-log-file)
+ [Änderungsprotokoll](#mqtt-bridge-component-changelog)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 2.3.x
+ 2.2.x
+ 2.1.x
+ 2.0.x
## Typ
Diese Komponente ist eine Plugin-Komponente (`aws.greengrass.plugin`). Der [Greengrass-Kern führt diese Komponente in derselben Java Virtual Machine (JVM) wie der Nucleus](greengrass-nucleus-component.md) aus. Der Nucleus wird neu gestartet, wenn Sie die Version dieser Komponente auf dem Core-Gerät ändern.
Diese Komponente verwendet dieselbe Protokolldatei wie der Greengrass-Kern. Weitere Informationen finden Sie unter [AWS IoT Greengrass Protokolle überwachen](monitor-logs.md).
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## 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:
+ Wenn Sie die MQTT-Broker-Komponente des Kerngeräts so konfigurieren, dass sie einen anderen Port als den Standardport 8883 verwendet, müssen Sie MQTT Bridge v2.1.0 oder höher verwenden. Konfigurieren Sie es so, dass es eine Verbindung über den Port herstellt, an dem der Broker arbeitet.
+ Die MQTT-Bridge-Komponente wird für die Ausführung in einer VPC unterstützt.
## Abhängigkeiten
Wenn Sie eine Komponente bereitstellen, stellt sie 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](#mqtt-bridge-component-changelog) 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](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.
------
#### [ 2.3.2 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.3.2 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Authentifizierung auf dem Client-Gerät](client-device-auth-component.md) | >=2.2.0 <2.6.0 | Hart |
------
#### [ 2.3.0 and 2.3.1 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.3.0 und 2.3.1 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Authentifizierung auf dem Client-Gerät](client-device-auth-component.md) | >=2.2.0 <2.5.0 | Hart |
------
#### [ 2.2.5 and 2.2.6 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.2.5 und 2.2.6 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Authentifizierung auf dem Client-Gerät](client-device-auth-component.md) | >=2.2.0 <2.5.0 | Hart |
------
#### [ 2.2.3 and 2.2.4 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.2.3 und 2.2.4 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Authentifizierung auf dem Client-Gerät](client-device-auth-component.md) | >=2.2.0 <2.4.0 | Hart |
------
#### [ 2.2.0 – 2.2.2 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.2.0 bis 2.2.2 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Authentifizierung auf dem Client-Gerät](client-device-auth-component.md) | >=2.2.0 <2.3.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 |
| --- | --- | --- |
| [Authentifizierung auf dem Client-Gerät](client-device-auth-component.md) | >=2.0.0 <2.2.0 | Hart |
------
#### [ 2.0.0 to 2.1.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.0.0 bis 2.1.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Authentifizierung auf dem Client-Gerät](client-device-auth-component.md) | >=2.0.0 <2.1.0 | Hart |
------
[Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den Komponentenrezepten.](component-recipe-reference.md#recipe-reference-component-dependencies)
## Konfiguration
Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.
------
#### [ 2.3.0 – 2.3.2 ]
`mqttTopicMapping`
Die Themenzuordnungen, die Sie überbrücken möchten. Diese Komponente abonniert Nachrichten zum Quellthema und veröffentlicht die Nachrichten, die sie empfängt, im Zielthema. Jede Themenzuordnung definiert das Thema, den Quelltyp und den Zieltyp.
Dieses Objekt enthält die folgenden Informationen:
`topicMappingNameKey`
Der Name dieser Themenzuordnung. *topicMappingNameKey*Ersetzen Sie ihn durch einen Namen, anhand dessen Sie diese Themenzuordnung leichter identifizieren können.
Dieses Objekt enthält die folgenden Informationen:
`topic`
Das Thema oder der Themenfilter als Brücke zwischen dem Quell- und dem Zielbroker.
Sie können die Platzhalter `+` und `#` MQTT-Themen-Platzhalter verwenden, um Nachrichten zu allen Themen weiterzuleiten, die einem Themenfilter entsprechen. *Weitere Informationen finden Sie unter [MQTT-Themen im Entwicklerhandbuch](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html).AWS IoT Core *
[Um MQTT-Themen-Platzhalter mit dem `Pubsub` Quellbroker zu verwenden, müssen Sie Version 2.6.0 oder höher der Greengrass Nucleus-Komponente verwenden.](greengrass-nucleus-component.md)
`targetTopicPrefix`
Das Präfix, das dem Zielthema hinzugefügt werden soll, wenn diese Komponente die Nachricht weiterleitet.
`source`
Der Quellnachrichtenbroker. Wählen Sie aus den folgenden Optionen aus:
+ `LocalMqtt`— Der lokale MQTT-Broker, über den Client-Geräte kommunizieren.
+ `Pubsub`— Der lokale publish/subscribe Greengrass-Nachrichtenbroker.
+ `IotCore`— Der AWS IoT Core MQTT-Nachrichtenbroker.
**Anmerkung**
Die MQTT-Bridge verwendet QoS 1 zum Veröffentlichen und Abonnieren AWS IoT Core, auch wenn ein Client-Gerät QoS 0 verwendet, um den lokalen MQTT-Broker zu veröffentlichen und zu abonnieren. Infolgedessen können Sie zusätzliche Latenz beobachten, wenn Sie MQTT-Nachrichten von Client-Geräten auf dem lokalen MQTT-Broker an weiterleiten. AWS IoT Core Weitere Informationen zur MQTT-Konfiguration auf Kerngeräten finden Sie unter. [Konfigurieren Sie MQTT-Timeouts und Cache-Einstellungen](configure-greengrass-core-v2.md#configure-mqtt)
`source`und `target` muss anders sein.
`target`
Der Ziel-Message-Broker. Wählen Sie aus den folgenden Optionen aus:
+ `LocalMqtt`— Der lokale MQTT-Broker, über den Client-Geräte kommunizieren.
+ `Pubsub`— Der lokale publish/subscribe Greengrass-Nachrichtenbroker.
+ `IotCore`— Der AWS IoT Core MQTT-Nachrichtenbroker.
**Anmerkung**
Die MQTT-Bridge verwendet QoS 1 zum Veröffentlichen und Abonnieren AWS IoT Core, auch wenn ein Client-Gerät QoS 0 verwendet, um den lokalen MQTT-Broker zu veröffentlichen und zu abonnieren. Infolgedessen können Sie zusätzliche Latenz beobachten, wenn Sie MQTT-Nachrichten von Client-Geräten auf dem lokalen MQTT-Broker an weiterleiten. AWS IoT Core Weitere Informationen zur MQTT-Konfiguration auf Kerngeräten finden Sie unter. [Konfigurieren Sie MQTT-Timeouts und Cache-Einstellungen](configure-greengrass-core-v2.md#configure-mqtt)
`source`und `target` muss anders sein.
mqtt5 RouteOptions
(Optional) Stellt Optionen für die Konfiguration von Themenzuordnungen bereit, um Nachrichten vom Quellthema zum Zielthema zu überbrücken.
Dieses Objekt enthält die folgenden Informationen:
*mqtt5RouteOptionsNameKey*
Der Name der Routenoptionen für ein Topic-Mapping. *mqtt5RouteOptionsNameKey*Ersetzen Sie ihn durch den im `mqttTopicMapping` Feld *topicMappingNameKey* definierten Treffer.
Dieses Objekt enthält die folgenden Informationen:
Kein Lokal
(Optional) Wenn diese Option aktiviert ist, leitet die Bridge keine Nachrichten zu einem Thema weiter, das die Bridge selbst veröffentlicht hat. Verwenden Sie dies, um Schleifen wie folgt zu verhindern:
```
{
"mqtt5RouteOptions": {
"toIoTCore": {
"noLocal": true
}
},
"mqttTopicMapping": {
"toIoTCore": {
"topic": "device",
"source": "LocalMqtt",
"target": "IotCore"
},
"toLocal": {
"topic": "device",
"source": "IotCore",
"target": "LocalMqtt"
}
}
}
```
`noLocal`wird nur für Routen unterstützt, bei denen der `source` ist`LocalMqtt`.
Standard: false
retainAsPublished
(Optional) Wenn diese Option aktiviert ist, haben Nachrichten, die von der Bridge weitergeleitet werden, dieselbe `retain` Kennzeichnung wie Nachrichten, die für diese Route auf dem Broker veröffentlicht wurden.
`retainAsPublished`wird nur für Routen unterstützt, bei denen dies der `source` ist`LocalMqtt`.
Standard: false
mqtt
(Optional) MQTT-Protokolleinstellungen für die Kommunikation mit dem lokalen Broker.
version
(Optional) Die MQTT-Protokollversion, die von der Bridge für die Kommunikation mit dem lokalen Broker verwendet wird. Muss mit der in der Nucleus-Konfiguration ausgewählten MQTT-Version identisch sein.
Wählen Sie eine der folgenden Optionen aus:
+ `mqtt3`
+ `mqtt5`
Sie müssen einen MQTT-Broker bereitstellen, wenn das `target` Feld `source` oder des `mqttTopicMapping` Objekts auf gesetzt ist. `LocalMqtt` Wenn Sie die `mqtt5` Option wählen, müssen Sie die [MQTT 5-Broker (EMAX)](mqtt-broker-emqx-component.md) verwenden.
Standard: `mqtt3`
ackTimeoutSeconds
(Optional) Zeitintervall für das Warten auf PUBACK-, SUBACK- oder UNSUBACK-Pakete, bevor der Vorgang fehlschlägt.
Standard: 60
connAckTimeoutFrau
(Optional) Zeitintervall, in dem auf ein CONNACK-Paket gewartet werden soll, bevor die Verbindung unterbrochen wird.
Standard: 20000 (20 Sekunden)
pingTimeoutMs
(Optional) Die Zeit in Millisekunden, die die Bridge auf den Empfang einer PINGACK-Nachricht vom lokalen Broker wartet. Wenn die Wartezeit das Timeout überschreitet, wird die Bridge geschlossen und die MQTT-Verbindung erneut geöffnet. Dieser Wert muss kleiner als sein. `keepAliveTimeoutSeconds`
Standard: 30000 (30 Sekunden)
keepAliveTimeoutSekunden
(Optional) Die Zeitspanne in Sekunden zwischen den einzelnen PING-Nachrichten, die die Bridge sendet, um die MQTT-Verbindung aufrechtzuerhalten. Dieser Wert muss größer als `pingTimeoutMs` sein.
Standard: 60
maxReconnectDelayFrau
(Optional) Die maximale Zeit in Sekunden, für die MQTT die Verbindung wiederherstellt.
Standard: 30000 (30 Sekunden)
minReconnectDelayFrau
(Optional) Die Mindestzeit in Sekunden, die MQTT benötigt, um die Verbindung wiederherzustellen.
Maximal empfangen
(Optional) Die maximale Anzahl unbestätigter QoS1-Pakete, die die Bridge senden kann.
Standard: 100
maximumPacketSize
Die maximale Anzahl von Byte, die der Client für ein MQTT-Paket akzeptiert.
Standard: null (kein Limit)
sessionExpiryInterval
(Optional) Die Dauer in Sekunden, die Sie für die Dauer einer Sitzung zwischen der Bridge und dem lokalen Broker anfordern können.
Standard: 4294967295 (Sitzung läuft nie ab)
`brokerUri`
(Optional) Die URI des lokalen MQTT-Brokers. Sie müssen diesen Parameter angeben, wenn Sie den MQTT-Broker so konfigurieren, dass er einen anderen Port als den Standardport 8883 verwendet. Verwenden Sie das folgende Format und ersetzen Sie es durch den Port, an *port* dem der MQTT-Broker arbeitet:. `ssl://localhost:port`
Standard: `ssl://localhost:8883`
startupTimeoutSeconds
(Optional) Die maximale Zeit in Sekunden für den Start der Komponente. Der Status der Komponente ändert sich auf, `BROKEN` wenn dieser Timeout überschritten wird.
Standard: `120`
**Example Beispiel: Aktualisierung der Zusammenführung von Konfigurationen**
Das folgende Beispiel für ein Konfigurationsupdate spezifiziert Folgendes:
+ Leitet Nachrichten von Client-Geräten AWS IoT Core an Themen weiter, die dem `clients/+/hello/world` Themenfilter entsprechen.
+ Leiten Sie Nachrichten zu Themen, die publish/subscribe dem Themenfilter entsprechen, von Client-Geräten an lokale Geräte weiter und fügen Sie dem Zielthema das `events/input/` Präfix hinzu. `clients/+/detections` Das resultierende Zielthema entspricht dem `events/input/clients/+/detections` Themenfilter.
+ Leiten Sie Nachrichten von Client-Geräten AWS IoT Core an Themen weiter, die dem `clients/+/status` Themenfilter entsprechen, und fügen Sie dem Zielthema das `$aws/rules/StatusUpdateRule/` Präfix hinzu. In diesem Beispiel werden diese Nachrichten direkt an eine [AWS IoT Regel](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html) mit dem Namen „`StatusUpdateRule`Kosten reduzieren“ mithilfe von [Basic Ingest weitergeleitet](https://docs.aws.amazon.com/iot/latest/developerguide/iot-basic-ingest.html).
```
{
"mqttTopicMapping": {
"ClientDeviceHelloWorld": {
"topic": "clients/+/hello/world",
"source": "LocalMqtt",
"target": "IotCore"
},
"ClientDeviceEvents": {
"topic": "clients/+/detections",
"targetTopicPrefix": "events/input/",
"source": "LocalMqtt",
"target": "Pubsub"
},
"ClientDeviceCloudStatusUpdate": {
"topic": "clients/+/status",
"targetTopicPrefix": "$aws/rules/StatusUpdateRule/",
"source": "LocalMqtt",
"target": "IotCore"
}
}
}
```
**Example Beispiel: Konfiguration von MQTT 5**
Die folgende Beispielkonfiguration aktualisiert Folgendes:
+ Ermöglicht der Bridge, das MQTT 5-Protokoll mit dem lokalen Broker zu verwenden.
+ Konfiguriert die Einstellung MQTT keep as published für das `ClientDeviceHelloWorld` Topic-Mapping.
```
{
"mqttTopicMapping": {
"ClientDeviceHelloWorld": {
"topic": "clients/+/hello/world",
"source": "LocalMqtt",
"target": "IotCore"
}
},
"mqtt5RouteOptions": {
"ClientDeviceHelloWorld": {
"retainAsPublished": true
}
},
"mqtt": {
"version": "mqtt5"
}
}
```
------
#### [ 2.2.6 ]
`mqttTopicMapping`
Die Themenzuordnungen, die Sie überbrücken möchten. Diese Komponente abonniert Nachrichten zum Quellthema und veröffentlicht die Nachrichten, die sie empfängt, im Zielthema. Jede Themenzuordnung definiert das Thema, den Quelltyp und den Zieltyp.
Dieses Objekt enthält die folgenden Informationen:
`topicMappingNameKey`
Der Name dieser Themenzuordnung. *topicMappingNameKey*Ersetzen Sie ihn durch einen Namen, anhand dessen Sie diese Themenzuordnung leichter identifizieren können.
Dieses Objekt enthält die folgenden Informationen:
`topic`
Das Thema oder der Themenfilter als Brücke zwischen dem Quell- und dem Zielbroker.
Sie können die Platzhalter `+` und `#` MQTT-Themen-Platzhalter verwenden, um Nachrichten zu allen Themen weiterzuleiten, die einem Themenfilter entsprechen. *Weitere Informationen finden Sie unter [MQTT-Themen im Entwicklerhandbuch](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html).AWS IoT Core *
[Um MQTT-Themen-Platzhalter mit dem `Pubsub` Quellbroker zu verwenden, müssen Sie Version 2.6.0 oder höher der Greengrass Nucleus-Komponente verwenden.](greengrass-nucleus-component.md)
`targetTopicPrefix`
Das Präfix, das dem Zielthema hinzugefügt werden soll, wenn diese Komponente die Nachricht weiterleitet.
`source`
Der Quellnachrichtenbroker. Wählen Sie aus den folgenden Optionen aus:
+ `LocalMqtt`— Der lokale MQTT-Broker, über den Client-Geräte kommunizieren.
+ `Pubsub`— Der lokale publish/subscribe Greengrass-Nachrichtenbroker.
+ `IotCore`— Der AWS IoT Core MQTT-Nachrichtenbroker.
**Anmerkung**
Die MQTT-Bridge verwendet QoS 1 zum Veröffentlichen und Abonnieren AWS IoT Core, auch wenn ein Client-Gerät QoS 0 verwendet, um den lokalen MQTT-Broker zu veröffentlichen und zu abonnieren. Infolgedessen können Sie zusätzliche Latenz beobachten, wenn Sie MQTT-Nachrichten von Client-Geräten auf dem lokalen MQTT-Broker an weiterleiten. AWS IoT Core Weitere Informationen zur MQTT-Konfiguration auf Kerngeräten finden Sie unter. [Konfigurieren Sie MQTT-Timeouts und Cache-Einstellungen](configure-greengrass-core-v2.md#configure-mqtt)
`source`und `target` muss anders sein.
`target`
Der Ziel-Message-Broker. Wählen Sie aus den folgenden Optionen aus:
+ `LocalMqtt`— Der lokale MQTT-Broker, über den Client-Geräte kommunizieren.
+ `Pubsub`— Der lokale publish/subscribe Greengrass-Nachrichtenbroker.
+ `IotCore`— Der AWS IoT Core MQTT-Nachrichtenbroker.
**Anmerkung**
Die MQTT-Bridge verwendet QoS 1 zum Veröffentlichen und Abonnieren AWS IoT Core, auch wenn ein Client-Gerät QoS 0 verwendet, um den lokalen MQTT-Broker zu veröffentlichen und zu abonnieren. Infolgedessen können Sie zusätzliche Latenz beobachten, wenn Sie MQTT-Nachrichten von Client-Geräten auf dem lokalen MQTT-Broker an weiterleiten. AWS IoT Core Weitere Informationen zur MQTT-Konfiguration auf Kerngeräten finden Sie unter. [Konfigurieren Sie MQTT-Timeouts und Cache-Einstellungen](configure-greengrass-core-v2.md#configure-mqtt)
`source`und `target` muss anders sein.
`brokerUri`
(Optional) Die URI des lokalen MQTT-Brokers. Sie müssen diesen Parameter angeben, wenn Sie den MQTT-Broker so konfigurieren, dass er einen anderen Port als den Standardport 8883 verwendet. Verwenden Sie das folgende Format und ersetzen Sie es durch den Port, an *port* dem der MQTT-Broker arbeitet:. `ssl://localhost:port`
Standard: `ssl://localhost:8883`
startupTimeoutSeconds
(Optional) Die maximale Zeit in Sekunden für den Start der Komponente. Der Status der Komponente ändert sich auf, `BROKEN` wenn dieser Timeout überschritten wird.
Standard: `120`
**Example Beispiel: Aktualisierung der Zusammenführung von Konfigurationen**
Das folgende Beispiel für ein Konfigurationsupdate spezifiziert Folgendes:
+ Leitet Nachrichten von Client-Geräten AWS IoT Core an Themen weiter, die dem `clients/+/hello/world` Themenfilter entsprechen.
+ Leiten Sie Nachrichten zu Themen, die publish/subscribe dem Themenfilter entsprechen, von Client-Geräten an lokale Geräte weiter und fügen Sie dem Zielthema das `events/input/` Präfix hinzu. `clients/+/detections` Das resultierende Zielthema entspricht dem `events/input/clients/+/detections` Themenfilter.
+ Leiten Sie Nachrichten von Client-Geräten AWS IoT Core an Themen weiter, die dem `clients/+/status` Themenfilter entsprechen, und fügen Sie dem Zielthema das `$aws/rules/StatusUpdateRule/` Präfix hinzu. In diesem Beispiel werden diese Nachrichten direkt an eine [AWS IoT Regel](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html) mit dem Namen „`StatusUpdateRule`Kosten reduzieren“ mithilfe von [Basic Ingest weitergeleitet](https://docs.aws.amazon.com/iot/latest/developerguide/iot-basic-ingest.html).
```
{
"mqttTopicMapping": {
"ClientDeviceHelloWorld": {
"topic": "clients/+/hello/world",
"source": "LocalMqtt",
"target": "IotCore"
},
"ClientDeviceEvents": {
"topic": "clients/+/detections",
"targetTopicPrefix": "events/input/",
"source": "LocalMqtt",
"target": "Pubsub"
},
"ClientDeviceCloudStatusUpdate": {
"topic": "clients/+/status",
"targetTopicPrefix": "$aws/rules/StatusUpdateRule/",
"source": "LocalMqtt",
"target": "IotCore"
}
}
}
```
------
#### [ 2.2.0 - 2.2.5 ]
`mqttTopicMapping`
Die Themenzuordnungen, die Sie überbrücken möchten. Diese Komponente abonniert Nachrichten zum Quellthema und veröffentlicht die Nachrichten, die sie empfängt, im Zielthema. Jede Themenzuordnung definiert das Thema, den Quelltyp und den Zieltyp.
Dieses Objekt enthält die folgenden Informationen:
`topicMappingNameKey`
Der Name dieser Themenzuordnung. *topicMappingNameKey*Ersetzen Sie ihn durch einen Namen, anhand dessen Sie diese Themenzuordnung leichter identifizieren können.
Dieses Objekt enthält die folgenden Informationen:
`topic`
Das Thema oder der Themenfilter als Brücke zwischen dem Quell- und dem Zielbroker.
Sie können die Platzhalter `+` und `#` MQTT-Themen-Platzhalter verwenden, um Nachrichten zu allen Themen weiterzuleiten, die einem Themenfilter entsprechen. *Weitere Informationen finden Sie unter [MQTT-Themen im Entwicklerhandbuch](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html).AWS IoT Core *
[Um MQTT-Themen-Platzhalter mit dem `Pubsub` Quellbroker zu verwenden, müssen Sie Version 2.6.0 oder höher der Greengrass Nucleus-Komponente verwenden.](greengrass-nucleus-component.md)
`targetTopicPrefix`
Das Präfix, das dem Zielthema hinzugefügt werden soll, wenn diese Komponente die Nachricht weiterleitet.
`source`
Der Quellnachrichtenbroker. Wählen Sie aus den folgenden Optionen aus:
+ `LocalMqtt`— Der lokale MQTT-Broker, über den Client-Geräte kommunizieren.
+ `Pubsub`— Der lokale publish/subscribe Greengrass-Nachrichtenbroker.
+ `IotCore`— Der AWS IoT Core MQTT-Nachrichtenbroker.
**Anmerkung**
Die MQTT-Bridge verwendet QoS 1 zum Veröffentlichen und Abonnieren AWS IoT Core, auch wenn ein Client-Gerät QoS 0 verwendet, um den lokalen MQTT-Broker zu veröffentlichen und zu abonnieren. Infolgedessen können Sie zusätzliche Latenz beobachten, wenn Sie MQTT-Nachrichten von Client-Geräten auf dem lokalen MQTT-Broker an weiterleiten. AWS IoT Core Weitere Informationen zur MQTT-Konfiguration auf Kerngeräten finden Sie unter. [Konfigurieren Sie MQTT-Timeouts und Cache-Einstellungen](configure-greengrass-core-v2.md#configure-mqtt)
`source`und `target` muss anders sein.
`target`
Der Ziel-Message-Broker. Wählen Sie aus den folgenden Optionen aus:
+ `LocalMqtt`— Der lokale MQTT-Broker, über den Client-Geräte kommunizieren.
+ `Pubsub`— Der lokale publish/subscribe Greengrass-Nachrichtenbroker.
+ `IotCore`— Der AWS IoT Core MQTT-Nachrichtenbroker.
**Anmerkung**
Die MQTT-Bridge verwendet QoS 1 zum Veröffentlichen und Abonnieren AWS IoT Core, auch wenn ein Client-Gerät QoS 0 verwendet, um den lokalen MQTT-Broker zu veröffentlichen und zu abonnieren. Infolgedessen können Sie zusätzliche Latenz beobachten, wenn Sie MQTT-Nachrichten von Client-Geräten auf dem lokalen MQTT-Broker an weiterleiten. AWS IoT Core Weitere Informationen zur MQTT-Konfiguration auf Kerngeräten finden Sie unter. [Konfigurieren Sie MQTT-Timeouts und Cache-Einstellungen](configure-greengrass-core-v2.md#configure-mqtt)
`source`und `target` muss anders sein.
`brokerUri`
(Optional) Die URI des lokalen MQTT-Brokers. Sie müssen diesen Parameter angeben, wenn Sie den MQTT-Broker so konfigurieren, dass er einen anderen Port als den Standardport 8883 verwendet. Verwenden Sie das folgende Format und ersetzen Sie es durch den Port, an *port* dem der MQTT-Broker arbeitet:. `ssl://localhost:port`
Standard: `ssl://localhost:8883`
**Example Beispiel: Aktualisierung der Konfigurationszusammenführung**
Das folgende Beispiel für ein Konfigurationsupdate spezifiziert Folgendes:
+ Leitet Nachrichten von Client-Geräten AWS IoT Core an Themen weiter, die dem `clients/+/hello/world` Themenfilter entsprechen.
+ Leiten Sie Nachrichten zu Themen, die publish/subscribe dem Themenfilter entsprechen, von Client-Geräten an lokale Geräte weiter und fügen Sie dem Zielthema das `events/input/` Präfix hinzu. `clients/+/detections` Das resultierende Zielthema entspricht dem `events/input/clients/+/detections` Themenfilter.
+ Leiten Sie Nachrichten von Client-Geräten AWS IoT Core an Themen weiter, die dem `clients/+/status` Themenfilter entsprechen, und fügen Sie dem Zielthema das `$aws/rules/StatusUpdateRule/` Präfix hinzu. In diesem Beispiel werden diese Nachrichten direkt an eine [AWS IoT Regel](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html) mit dem Namen „`StatusUpdateRule`Kosten reduzieren“ mithilfe von [Basic Ingest weitergeleitet](https://docs.aws.amazon.com/iot/latest/developerguide/iot-basic-ingest.html).
```
{
"mqttTopicMapping": {
"ClientDeviceHelloWorld": {
"topic": "clients/+/hello/world",
"source": "LocalMqtt",
"target": "IotCore"
},
"ClientDeviceEvents": {
"topic": "clients/+/detections",
"targetTopicPrefix": "events/input/",
"source": "LocalMqtt",
"target": "Pubsub"
},
"ClientDeviceCloudStatusUpdate": {
"topic": "clients/+/status",
"targetTopicPrefix": "$aws/rules/StatusUpdateRule/",
"source": "LocalMqtt",
"target": "IotCore"
}
}
}
```
------
#### [ 2.1.x ]
`mqttTopicMapping`
Die Themenzuordnungen, die Sie überbrücken möchten. Diese Komponente abonniert Nachrichten zum Quellthema und veröffentlicht die Nachrichten, die sie empfängt, im Zielthema. Jede Themenzuordnung definiert das Thema, den Quelltyp und den Zieltyp.
Dieses Objekt enthält die folgenden Informationen:
`topicMappingNameKey`
Der Name dieser Themenzuordnung. *topicMappingNameKey*Ersetzen Sie ihn durch einen Namen, anhand dessen Sie diese Themenzuordnung leichter identifizieren können.
Dieses Objekt enthält die folgenden Informationen:
`topic`
Das Thema oder der Themenfilter als Brücke zwischen dem Quell- und dem Zielbroker.
Wenn Sie den `LocalMqtt` oder den `IotCore` Quellbroker angeben, können Sie die Topic-Platzhalter `+` und den `#` MQTT-Themen-Platzhalter verwenden, um Nachrichten zu allen Themen weiterzuleiten, die einem Themenfilter entsprechen. *Weitere Informationen finden Sie unter [MQTT-Themen im Entwicklerhandbuch](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html).AWS IoT Core *
`source`
Der Quell-Message-Broker. Wählen Sie aus den folgenden Optionen aus:
+ `LocalMqtt`— Der lokale MQTT-Broker, über den Client-Geräte kommunizieren.
+ `Pubsub`— Der lokale publish/subscribe Greengrass-Nachrichtenbroker.
+ `IotCore`— Der AWS IoT Core MQTT-Nachrichtenbroker.
**Anmerkung**
Die MQTT-Bridge verwendet QoS 1 zum Veröffentlichen und Abonnieren AWS IoT Core, auch wenn ein Client-Gerät QoS 0 verwendet, um den lokalen MQTT-Broker zu veröffentlichen und zu abonnieren. Infolgedessen können Sie zusätzliche Latenz beobachten, wenn Sie MQTT-Nachrichten von Client-Geräten auf dem lokalen MQTT-Broker an weiterleiten. AWS IoT Core Weitere Informationen zur MQTT-Konfiguration auf Kerngeräten finden Sie unter. [Konfigurieren Sie MQTT-Timeouts und Cache-Einstellungen](configure-greengrass-core-v2.md#configure-mqtt)
`source`und `target` muss anders sein.
`target`
Der Ziel-Message-Broker. Wählen Sie aus den folgenden Optionen aus:
+ `LocalMqtt`— Der lokale MQTT-Broker, über den Client-Geräte kommunizieren.
+ `Pubsub`— Der lokale publish/subscribe Greengrass-Nachrichtenbroker.
+ `IotCore`— Der AWS IoT Core MQTT-Nachrichtenbroker.
**Anmerkung**
Die MQTT-Bridge verwendet QoS 1 zum Veröffentlichen und Abonnieren AWS IoT Core, auch wenn ein Client-Gerät QoS 0 verwendet, um den lokalen MQTT-Broker zu veröffentlichen und zu abonnieren. Infolgedessen können Sie zusätzliche Latenz beobachten, wenn Sie MQTT-Nachrichten von Client-Geräten auf dem lokalen MQTT-Broker an weiterleiten. AWS IoT Core Weitere Informationen zur MQTT-Konfiguration auf Kerngeräten finden Sie unter. [Konfigurieren Sie MQTT-Timeouts und Cache-Einstellungen](configure-greengrass-core-v2.md#configure-mqtt)
`source`und `target` muss anders sein.
`brokerUri`
(Optional) Die URI des lokalen MQTT-Brokers. Sie müssen diesen Parameter angeben, wenn Sie den MQTT-Broker so konfigurieren, dass er einen anderen Port als den Standardport 8883 verwendet. Verwenden Sie das folgende Format und ersetzen Sie es durch den Port, an *port* dem der MQTT-Broker arbeitet:. `ssl://localhost:port`
Standard: `ssl://localhost:8883`
**Example Beispiel: Aktualisierung der Konfigurationszusammenführung**
Das folgende Beispiel für ein Konfigurationsupdate spezifiziert die Weiterleitung von Nachrichten von Client-Geräten AWS IoT Core an die `clients/MyClientDevice2/hello/world` Themen `clients/MyClientDevice1/hello/world` und.
```
{
"mqttTopicMapping": {
"ClientDevice1HelloWorld": {
"topic": "clients/MyClientDevice1/hello/world",
"source": "LocalMqtt",
"target": "IotCore"
},
"ClientDevice2HelloWorld": {
"topic": "clients/MyClientDevice2/hello/world",
"source": "LocalMqtt",
"target": "IotCore"
}
}
}
```
------
#### [ 2.0.x ]
`mqttTopicMapping`
Die Themenzuordnungen, die Sie verbinden möchten. Diese Komponente abonniert Nachrichten zum Quellthema und veröffentlicht die Nachrichten, die sie empfängt, im Zielthema. Jede Themenzuordnung definiert das Thema, den Quelltyp und den Zieltyp.
Dieses Objekt enthält die folgenden Informationen:
`topicMappingNameKey`
Der Name dieser Themenzuordnung. *topicMappingNameKey*Ersetzen Sie ihn durch einen Namen, anhand dessen Sie diese Themenzuordnung leichter identifizieren können.
Dieses Objekt enthält die folgenden Informationen:
`topic`
Das Thema oder der Themenfilter als Brücke zwischen dem Quell- und dem Zielbroker.
Wenn Sie den `LocalMqtt` oder den `IotCore` Quellbroker angeben, können Sie die Topic-Platzhalter `+` und den `#` MQTT-Themen-Platzhalter verwenden, um Nachrichten zu allen Themen weiterzuleiten, die einem Themenfilter entsprechen. *Weitere Informationen finden Sie unter [MQTT-Themen im Entwicklerhandbuch](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html).AWS IoT Core *
`source`
Der Quell-Message-Broker. Wählen Sie aus den folgenden Optionen aus:
+ `LocalMqtt`— Der lokale MQTT-Broker, über den Client-Geräte kommunizieren.
+ `Pubsub`— Der lokale publish/subscribe Greengrass-Nachrichtenbroker.
+ `IotCore`— Der AWS IoT Core MQTT-Nachrichtenbroker.
**Anmerkung**
Die MQTT-Bridge verwendet QoS 1 zum Veröffentlichen und Abonnieren AWS IoT Core, auch wenn ein Client-Gerät QoS 0 verwendet, um den lokalen MQTT-Broker zu veröffentlichen und zu abonnieren. Infolgedessen können Sie zusätzliche Latenz beobachten, wenn Sie MQTT-Nachrichten von Client-Geräten auf dem lokalen MQTT-Broker an weiterleiten. AWS IoT Core Weitere Informationen zur MQTT-Konfiguration auf Kerngeräten finden Sie unter. [Konfigurieren Sie MQTT-Timeouts und Cache-Einstellungen](configure-greengrass-core-v2.md#configure-mqtt)
`source`und `target` muss anders sein.
`target`
Der Ziel-Message-Broker. Wählen Sie aus den folgenden Optionen aus:
+ `LocalMqtt`— Der lokale MQTT-Broker, über den Client-Geräte kommunizieren.
+ `Pubsub`— Der lokale publish/subscribe Greengrass-Nachrichtenbroker.
+ `IotCore`— Der AWS IoT Core MQTT-Nachrichtenbroker.
**Anmerkung**
Die MQTT-Bridge verwendet QoS 1 zum Veröffentlichen und Abonnieren AWS IoT Core, auch wenn ein Client-Gerät QoS 0 verwendet, um den lokalen MQTT-Broker zu veröffentlichen und zu abonnieren. Infolgedessen können Sie zusätzliche Latenz beobachten, wenn Sie MQTT-Nachrichten von Client-Geräten auf dem lokalen MQTT-Broker an weiterleiten. AWS IoT Core Weitere Informationen zur MQTT-Konfiguration auf Kerngeräten finden Sie unter. [Konfigurieren Sie MQTT-Timeouts und Cache-Einstellungen](configure-greengrass-core-v2.md#configure-mqtt)
`source`und `target` muss anders sein.
**Example Beispiel: Aktualisierung der Zusammenführung von Konfigurationen**
Das folgende Beispiel für ein Konfigurationsupdate spezifiziert die Weiterleitung von Nachrichten von Client-Geräten AWS IoT Core an die `clients/MyClientDevice2/hello/world` Themen `clients/MyClientDevice1/hello/world` und.
```
{
"mqttTopicMapping": {
"ClientDevice1HelloWorld": {
"topic": "clients/MyClientDevice1/hello/world",
"source": "LocalMqtt",
"target": "IotCore"
},
"ClientDevice2HelloWorld": {
"topic": "clients/MyClientDevice2/hello/world",
"source": "LocalMqtt",
"target": "IotCore"
}
}
}
```
------
## Lokale Protokolldatei
Diese Komponente verwendet dieselbe Protokolldatei wie die [Greengrass Nucleus-Komponente](greengrass-nucleus-component.md).
------
#### [ Linux ]
```
/greengrass/v2/logs/greengrass.log
```
------
#### [ Windows ]
```
C:\greengrass\v2\logs\greengrass.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:\$1greengrass\$1v2* durch den Pfad zum AWS IoT Greengrass Stammordner.
------
#### [ Linux ]
```
sudo tail -f /greengrass/v2/logs/greengrass.log
```
------
#### [ Windows (PowerShell) ]
```
Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
```
------
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| **Version** | **Änderungen** |
| --- | --- |
| 2.3.2 | Die Version wurde für die Version 2.5.0 [der Client-Geräteauthentifizierung](client-device-auth-component.md) aktualisiert. |
| 2.3.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/mqtt-bridge-component.html) |
| 2.3.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/mqtt-bridge-component.html) |
| 2.2.6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/mqtt-bridge-component.html) |
| 2.2.5 | Die Version wurde für die Version 2.4.0 [der Client-Geräteauthentifizierung](client-device-auth-component.md) aktualisiert. |
| 2.2.4 | Die Version wurde für die Version 2.3.0 der [Greengrass-Client-Geräteauthentifizierung](client-device-auth-component.md) aktualisiert. |
| 2.2.3 | Diese Version enthält Fehlerkorrekturen und Verbesserungen. |
| 2.2.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/mqtt-bridge-component.html) |
| 2.2.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/mqtt-bridge-component.html) |
| 2.2.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/mqtt-bridge-component.html) |
| 2.1.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/mqtt-bridge-component.html) |
| 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/mqtt-bridge-component.html) |
| 2.0.1 | Diese Version enthält Fehlerkorrekturen und Verbesserungen. |
| 2.0.0 | Erste Version |
# MQTT 3.1.1-Broker (Moquette)
Die Moquette MQTT-Broker-Komponente (`aws.greengrass.clientdevices.mqtt.Moquette`) verarbeitet MQTT-Nachrichten zwischen Client-Geräten und einem Greengrass-Core-Gerät. [Diese Komponente stellt eine modifizierte Version des Moquette MQTT-Brokers bereit.](https://github.com/moquette-io/moquette) Stellen Sie diesen MQTT-Broker bereit, um einen einfachen MQTT-Broker auszuführen. Weitere Informationen zur Auswahl eines MQTT-Brokers finden Sie unter. [Wählen Sie einen MQTT-Broker](choose-local-mqtt-broker.md)
Dieser Broker implementiert das MQTT 3.1.1-Protokoll. Es umfasst Unterstützung für gespeicherte QoS 0-, QoS 1- und QoS-2-Nachrichten, Lastwill-Nachrichten und persistente Sitzungen.
**Anmerkung**
Client-Geräte sind lokale IoT-Geräte, die eine Verbindung zu einem Greengrass-Core-Gerät herstellen, um MQTT-Nachrichten und Daten zur Verarbeitung zu senden. Weitere Informationen finden Sie unter [Interagieren Sie mit lokalen IoT-Geräten](interact-with-local-iot-devices.md).
**Topics**
+ [Versionen](#mqtt-broker-moquette-component-versions)
+ [Typ](#mqtt-broker-moquette-component-type)
+ [Betriebssystem](#mqtt-broker-moquette-component-os-support)
+ [Voraussetzungen](#mqtt-broker-moquette-component-requirements)
+ [Abhängigkeiten](#mqtt-broker-moquette-component-dependencies)
+ [Konfiguration](#mqtt-broker-moquette-component-configuration)
+ [Lokale Protokolldatei](#mqtt-broker-moquette-component-log-file)
+ [Änderungsprotokoll](#mqtt-broker-moquette-component-changelog)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 2.3.x
+ 2.2.x
+ 2.1.x
+ 2.0.x
## Typ
Diese Komponente ist eine Plugin-Komponente (`aws.greengrass.plugin`). Der [Greengrass-Kern führt diese Komponente in derselben Java Virtual Machine (JVM) wie der Nucleus](greengrass-nucleus-component.md) aus. Der Nucleus wird neu gestartet, wenn Sie die Version dieser Komponente auf dem Core-Gerät ändern.
Diese Komponente verwendet dieselbe Protokolldatei wie der Greengrass-Kern. Weitere Informationen finden Sie unter [AWS IoT Greengrass Protokolle überwachen](monitor-logs.md).
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## 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 Kerngerät muss in der Lage sein, Verbindungen an dem Port anzunehmen, an dem der MQTT-Broker arbeitet. Diese Komponente führt den MQTT-Broker standardmäßig auf Port 8883 aus. Sie können bei der Konfiguration dieser Komponente einen anderen Port angeben.
Wenn Sie einen anderen Port angeben und die [MQTT-Bridge-Komponente verwenden, um MQTT-Nachrichten](mqtt-bridge-component.md) an andere Broker weiterzuleiten, müssen Sie MQTT Bridge v2.1.0 oder höher verwenden. Konfigurieren Sie es so, dass es den Port verwendet, an dem der MQTT-Broker arbeitet.
Wenn Sie einen anderen Port angeben und die [IP-Detector-Komponente](ip-detector-component.md) zur Verwaltung von MQTT-Broker-Endpunkten verwenden, müssen Sie den IP-Detektor v2.1.0 oder höher verwenden. Konfigurieren Sie es so, dass der Port gemeldet wird, an dem der MQTT-Broker arbeitet.
+ Die Moquette MQTT-Broker-Komponente wird für die Ausführung in einer VPC unterstützt.
## Abhängigkeiten
Wenn Sie eine Komponente bereitstellen, stellt sie 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](#mqtt-broker-moquette-component-changelog) 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](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.
------
#### [ 2.3.7 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.3.7 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Authentifizierung auf dem Client-Gerät](client-device-auth-component.md) | >=2.2.0 <2.6.0 | Hart |
------
#### [ 2.3.2 – 2.3.6 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.3.2 bis 2.3.6 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Authentifizierung auf dem Client-Gerät](client-device-auth-component.md) | >=2.2.0 <2.5.0 | Hart |
------
#### [ 2.3.0 and 2.3.1 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.3.0 und 2.3.1 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Authentifizierung auf dem Client-Gerät](client-device-auth-component.md) | >=2.2.0 <2.4.0 | Hart |
------
#### [ 2.2.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.2.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Authentifizierung auf dem Client-Gerät](client-device-auth-component.md) | >=2.2.0 <2.3.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 |
| --- | --- | --- |
| [Authentifizierung auf dem Client-Gerät](client-device-auth-component.md) | >=2.0.0 <2.2.0 | Hart |
------
#### [ 2.0.0 - 2.0.2 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.0.0 bis 2.0.2 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Authentifizierung auf dem Client-Gerät](client-device-auth-component.md) | >=2.0.0 <2.1.0 | Hart |
------
[Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den Komponentenrezepten.](component-recipe-reference.md#recipe-reference-component-dependencies)
## Konfiguration
Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.
`moquette`
(Optional) Die zu verwendende [Moquette MQTT-Broker-Konfiguration](https://github.com/moquette-io/moquette). Sie können eine Teilmenge der Moqeutte-Konfigurationsoptionen in dieser Komponente konfigurieren. [Weitere Informationen finden Sie in den Inline-Kommentaren in der Moquette-Konfigurationsdatei.](https://github.com/moquette-io/moquette/blob/main/distribution/src/main/resources/moquette.conf)
Dieses Objekt enthält die folgenden Informationen:
`ssl_port`
(Optional) Der Port, an dem der MQTT-Broker arbeitet.
Wenn Sie einen anderen Port angeben und die [MQTT-Bridge-Komponente verwenden, um MQTT-Nachrichten](mqtt-bridge-component.md) an andere Broker weiterzuleiten, müssen Sie MQTT Bridge v2.1.0 oder höher verwenden. Konfigurieren Sie es so, dass es den Port verwendet, an dem der MQTT-Broker arbeitet.
Wenn Sie einen anderen Port angeben und die [IP-Detector-Komponente](ip-detector-component.md) zur Verwaltung von MQTT-Broker-Endpunkten verwenden, müssen Sie den IP-Detektor v2.1.0 oder höher verwenden. Konfigurieren Sie es so, dass der Port gemeldet wird, an dem der MQTT-Broker arbeitet.
Standard: `8883`
`host`
(Optional) Die Schnittstelle, an die der MQTT-Broker bindet. Sie können diesen Parameter beispielsweise so ändern, dass der MQTT-Broker nur an ein bestimmtes lokales Netzwerk bindet.
Standard: `0.0.0.0` (bindet an alle Netzwerkschnittstellen)
startupTimeoutSeconds
(Optional) Die maximale Zeit in Sekunden, die die Komponente zum Starten benötigt. Der Status der Komponente ändert sich auf, `BROKEN` wenn dieser Timeout überschritten wird.
Standard: `120`
**Example Beispiel: Aktualisierung der Zusammenführung von Konfigurationen**
Die folgende Beispielkonfiguration legt fest, dass der MQTT-Broker auf Port 443 betrieben werden soll.
```
{
"moquette": {
"ssl_port": "443"
}
}
```
## Lokale Protokolldatei
Diese Komponente verwendet dieselbe Protokolldatei wie die [Greengrass Nucleus-Komponente](greengrass-nucleus-component.md).
------
#### [ Linux ]
```
/greengrass/v2/logs/greengrass.log
```
------
#### [ Windows ]
```
C:\greengrass\v2\logs\greengrass.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:\$1greengrass\$1v2* durch den Pfad zum AWS IoT Greengrass Stammordner.
------
#### [ Linux ]
```
sudo tail -f /greengrass/v2/logs/greengrass.log
```
------
#### [ Windows (PowerShell) ]
```
Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
```
------
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| **Version** | **Änderungen** |
| --- | --- |
| 2.3.7 | Die Version wurde für die Version 2.5.0 [der Client-Geräteauthentifizierung](client-device-auth-component.md) aktualisiert. |
| 2.3.6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/mqtt-broker-moquette-component.html) |
| 2.3.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/mqtt-broker-moquette-component.html) |
| 2.3.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/mqtt-broker-moquette-component.html) |
| 2.3.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/mqtt-broker-moquette-component.html) |
| 2.3.2 | Die Version wurde für die Version 2.4.0 [der Client-Geräteauthentifizierung](client-device-auth-component.md) aktualisiert. |
| 2.3.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/mqtt-broker-moquette-component.html) |
| 2.3.0 | Fügt Unterstützung für Zertifikatsketten hinzu. |
| 2.2.0 | Die Version wurde für die Version 2.2.0 [der Client-Geräteauthentifizierung](client-device-auth-component.md) aktualisiert. |
| 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/mqtt-broker-moquette-component.html) |
| 2.0.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/mqtt-broker-moquette-component.html) |
| 2.0.1 | Die Version wurde für die Version 2.4.0 von Greengrass Nucleus aktualisiert. |
| 2.0.0 | Erste Version |
# MQTT 5-Broker (EMAX)
Die EMQX MQTT-Broker-Komponente (`aws.greengrass.clientdevices.mqtt.EMQX`) verarbeitet MQTT-Nachrichten zwischen Client-Geräten und einem Greengrass-Core-Gerät. [Diese Komponente stellt eine modifizierte Version des EMQX MQTT 5.0-Brokers bereit.](https://www.emqx.com/en/mqtt/mqtt5) Stellen Sie diesen MQTT-Broker bereit, um MQTT 5-Funktionen bei der Kommunikation zwischen Client-Geräten und einem Core-Gerät zu verwenden. Weitere Informationen zur Auswahl eines MQTT-Brokers finden Sie unter. [Wählen Sie einen MQTT-Broker](choose-local-mqtt-broker.md)
Dieser Broker implementiert das MQTT 5.0-Protokoll. Es unterstützt Ablaufintervalle für Sitzungen und Nachrichten, Benutzereigenschaften, gemeinsame Abonnements, Themenaliase und mehr. MQTT 5 ist abwärtskompatibel mit MQTT 3.1.1. Wenn Sie also den [Moquette MQTT 3.1.1-Broker ausführen, können Sie ihn durch den EMQX MQTT](mqtt-broker-moquette-component.md) 5-Broker ersetzen, und die Client-Geräte können weiterhin eine Verbindung herstellen und wie gewohnt arbeiten.
**Anmerkung**
Client-Geräte sind lokale IoT-Geräte, die eine Verbindung zu einem Greengrass-Core-Gerät herstellen, um MQTT-Nachrichten und Daten zur Verarbeitung zu senden. Weitere Informationen finden Sie unter [Interagieren Sie mit lokalen IoT-Geräten](interact-with-local-iot-devices.md).
**Topics**
+ [Versionen](#mqtt-broker-emqx-component-versions)
+ [Typ](#mqtt-broker-emqx-component-type)
+ [Betriebssystem](#mqtt-broker-emqx-component-os-support)
+ [Voraussetzungen](#mqtt-broker-emqx-component-requirements)
+ [Abhängigkeiten](#mqtt-broker-emqx-component-dependencies)
+ [Konfiguration](#mqtt-broker-emqx-component-configuration)
+ [Lokale Protokolldatei](#mqtt-broker-emqx-component-log-file)
+ [Lizenzen](#mqtt-broker-emqx-component-licenses)
+ [Änderungsprotokoll](#mqtt-broker-emqx-component-changelog)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 2.0.x
+ 1.2.x
+ 1.1.x
+ 1.0.x
## Typ
Diese Komponente ist eine generische Komponente (`aws.greengrass.generic`). Der [Greengrass-Kern](greengrass-nucleus-component.md) führt die Lebenszyklusskripte der Komponente aus.
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## 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 Kerngerät muss in der Lage sein, Verbindungen an dem Port anzunehmen, an dem der MQTT-Broker arbeitet. Diese Komponente führt den MQTT-Broker standardmäßig auf Port 8883 aus. Sie können bei der Konfiguration dieser Komponente einen anderen Port angeben.
Wenn Sie einen anderen Port angeben und die [MQTT-Bridge-Komponente verwenden, um MQTT-Nachrichten](mqtt-bridge-component.md) an andere Broker weiterzuleiten, müssen Sie MQTT Bridge v2.1.0 oder höher verwenden. Konfigurieren Sie es so, dass es den Port verwendet, an dem der MQTT-Broker arbeitet.
Wenn Sie einen anderen Port angeben und die [IP-Detector-Komponente](ip-detector-component.md) zur Verwaltung von MQTT-Broker-Endpunkten verwenden, müssen Sie den IP-Detektor v2.1.0 oder höher verwenden. Konfigurieren Sie es so, dass der Port gemeldet wird, an dem der MQTT-Broker arbeitet.
+ Auf Linux-Core-Geräten wurde Docker auf dem Core-Gerät installiert und konfiguriert:
+ [Docker Engine](https://docs.docker.com/engine/) 1.9.1 oder höher ist auf dem Greengrass-Core-Gerät installiert. Version 20.10 ist die neueste Version, für die verifiziert wurde, dass sie mit der Core-Software funktioniert. AWS IoT Greengrass Sie müssen Docker direkt auf dem Kerngerät installieren, bevor Sie Komponenten bereitstellen, auf denen Docker-Container ausgeführt werden.
+ Der Docker-Daemon wurde auf dem Kerngerät gestartet und ausgeführt, bevor Sie diese Komponente bereitstellen.
+ Der Systembenutzer, der diese Komponente ausführt, muss über Root- oder Administratorrechte verfügen. Alternativ können Sie diese Komponente als Systembenutzer in der `docker` Gruppe ausführen und die `requiresPrivileges` Option dieser Komponente so konfigurieren, dass der EQMX MQTT-Broker ohne Rechte ausgeführt wird. `false`
+ Die EMQX MQTT-Broker-Komponente wird für die Ausführung in einer VPC unterstützt.
+ Die EMQX MQTT-Broker-Komponente wird auf der Plattform nicht unterstützt. `armv7`
## Abhängigkeiten
Wenn Sie eine Komponente bereitstellen, stellt sie 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](#mqtt-broker-emqx-component-changelog) 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](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.
------
#### [ 2.0.2 – 2.0.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.0.2 und 2.0.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Authentifizierung auf dem Client-Gerät](client-device-auth-component.md) | >=2.2.0 <2.6.0 | Weich |
------
#### [ 2.0.1 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.1 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Authentifizierung auf dem Client-Gerät](client-device-auth-component.md) | >=2.2.0 <2.6.0 | Hart |
------
#### [ 2.0.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Authentifizierung auf dem Client-Gerät](client-device-auth-component.md) | >=2.2.0 <2.5.0 | Hart |
------
#### [ 1.2.2 – 1.2.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 1.2.2 bis 1.2.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Authentifizierung auf dem Client-Gerät](client-device-auth-component.md) | >=2.2.0 <2.5.0 | Hart |
------
#### [ 1.2.0 and 1.2.1 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 1.2.0 und 1.2.1 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Authentifizierung auf dem Client-Gerät](client-device-auth-component.md) | >=2.2.0 <2.4.0 | Hart |
------
#### [ 1.0.0 and 1.1.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 1.0.0 und 1.1.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Authentifizierung auf dem Client-Gerät](client-device-auth-component.md) | >=2.2.0 <2.3.0 | Hart |
------
[Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den Komponentenrezepten.](component-recipe-reference.md#recipe-reference-component-dependencies)
## Konfiguration
------
#### [ 2.0.0 - 2.0.3 ]
Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.
**Wichtig**
Wenn Sie Version 2 der MQTT 5-Broker-Komponente (EMQX) verwenden, müssen Sie Ihre Konfigurationsdatei aktualisieren. Die Konfigurationsdateien der Version 1 funktionieren nicht mit Version 2.
emqxConfig
(Optional) Die zu verwendende [EMQX MQTT-Broker-Konfiguration](https://www.emqx.io/docs/en/v5.1/configuration/configuration.html). Sie können EMQX-Konfigurationsoptionen in dieser Komponente festlegen.
Wenn Sie den EMQX-Broker verwenden, verwendet Greengrass eine Standardkonfiguration. Diese Konfiguration wird verwendet, sofern Sie sie nicht mithilfe dieses Felds ändern.
Wenn Sie die folgenden Konfigurationseinstellungen ändern, wird die EMQX-Broker-Komponente neu gestartet. Andere Konfigurationsänderungen gelten, ohne dass die Komponente neu gestartet wird.
+ `emqxConfig/cluster`
+ `emqxConfig/node`
+ `emqxConfig/rpc`
`aws.greengrass.clientdevices.mqtt.EMQX`ermöglicht es Ihnen, sicherheitsrelevante Optionen zu konfigurieren. Dazu gehören TLS-Einstellungen, Authentifizierungs- und Autorisierungsanbieter. Wir haben die Standardkonfiguration empfohlen, die die gegenseitige TLS-Authentifizierung und den Greengrass-Client-Geräteauthentifizierungsanbieter verwendet.
**Example Beispiel: Standardkonfiguration**
Das folgende Beispiel zeigt die Standardeinstellungen, die für den MQTT 5 (EMQX) -Broker festgelegt wurden. Sie können diese Einstellungen mithilfe der Konfigurationseinstellung überschreiben. `emqxConfig`
```
{
"authorization": {
"no_match": "deny",
"sources": []
},
"node": {
"cookie": ""
},
"listeners": {
"ssl": {
"default": {
"ssl_options": {
"keyfile": "{work:path}\\data\\key.pem",
"certfile": "{work:path}\\data\\cert.pem",
"cacertfile": null,
"verify": "verify_peer",
"versions": ["tlsv1.3", "tlsv1.2"],
"fail_if_no_peer_cert": true
}
}
},
"tcp": {
"default": {
"enabled": false
}
},
"ws": {
"default": {
"enabled": false
}
},
"wss": {
"default": {
"enabled": false
}
}
},
"plugins": {
"states": [{"name_vsn": "gg-1.0.0", "enable": true}],
"install_dir": "plugins"
}
}
```
AuthMode
(Optional) Legt den Autorisierungsanbieter für den Broker fest. Dabei kann es sich um einen der folgenden Werte handeln:
+ `enabled`— (Standard) Verwenden Sie den Greengrass-Authentifizierungs- und Autorisierungsanbieter.
+ `bypass_on_failure`— Verwenden Sie den Greengrass-Authentifizierungsanbieter und dann alle verbleibenden Authentifizierungsanbieter in der EMQX-Anbieterkette, falls Greengrass entweder die Authentifizierung oder Autorisierung verweigert.
+ `bypass`— Der Greengrass-Anbieter ist deaktiviert. Authentifizierung und Autorisierung werden von der EMQX-Anbieterkette abgewickelt.
`requiresPrivilege`
(Optional) Auf Linux-Core-Geräten können Sie angeben, dass der EMQX MQTT-Broker ohne Root- oder Administratorrechte ausgeführt werden soll. Wenn Sie diese Option auf setzen`false`, muss der Systembenutzer, der diese Komponente ausführt, Mitglied der Gruppe sein. `docker`
Standard: `true`
`startupTimeoutSeconds`
(Optional) Die maximale Zeit in Sekunden, die der EMQX MQTT-Broker zum Starten benötigt. Der Status der Komponente ändert sich auf, `BROKEN` wenn dieser Timeout überschritten wird.
Standard: `90`
`ipcTimeoutSeconds`
(Optional) Die maximale Zeit in Sekunden, die die Komponente benötigt, um darauf zu warten, dass der Greengrass-Kern auf IPC-Anfragen (Interprocess Communication) reagiert. Erhöhen Sie diesen Wert, wenn diese Komponente bei der Überprüfung, ob ein Client-Gerät autorisiert ist, Timeout-Fehler meldet.
Standard: `5`
`crtLogLevel`
(Optional) Die Protokollebene für die AWS Common Runtime (CRT) -Bibliothek.
Standardmäßig wird die Protokollebene (in) des EMQX MQTT-Brokers verwendet. `log.level` `emqx`
`restartIdentifier`
(Optional) Konfigurieren Sie diese Option, um den EMQX MQTT-Broker neu zu starten. Wenn sich dieser Konfigurationswert ändert, startet diese Komponente den MQTT-Broker neu. Sie können diese Option verwenden, um zu erzwingen, dass Client-Geräte die Verbindung trennen.
`dockerOptions`
(Optional) Konfigurieren Sie diese Option nur auf Linux-Betriebssystemen, um der Docker-Befehlszeile Parameter hinzuzufügen. Um beispielsweise zusätzliche Ports zuzuordnen, verwenden Sie den `-p` Docker-Parameter:
```
"-p 1883:1883"
```
**Example Beispiel: Aktualisierung einer v1.x-Konfigurationsdatei auf v2.x**
Das folgende Beispiel zeigt die Änderungen, die erforderlich sind, um eine v1.x-Konfigurationsdatei auf Version 2.x zu aktualisieren.
Die Konfigurationsdatei der Version 1.x:
```
{
"emqx": {
"listener.ssl.external": "443",
"listener.ssl.external.max_connections": "1024000",
"listener.ssl.external.max_conn_rate": "500",
"listener.ssl.external.rate_limit": "50KB,5s",
"listener.ssl.external.handshake_timeout": "15s",
"log.level": "warning"
},
"mergeConfigurationFiles": {
"etc/plugins/aws_greengrass_emqx_auth.conf": "auth_mode=enabled\n use_greengrass_managed_certificates=true\n"
}
}
```
Die entsprechende Konfigurationsdatei für v2:
```
{
"emqxConfig": {
"listeners": {
"ssl": {
"default": {
"bind": "8883",
"max_connections": "1024000",
"max_conn_rate": "500",
"ssl_options": {
"handshake_timeout": "15s"
}
}
}
},
"log": {
"console": {
"enable": true,
"level": "warning"
}
}
},
"authMode": "enabled"
}
```
Es gibt kein Äquivalent zum `listener.ssl.external.rate_limit` Konfigurationseintrag. Die `use_greengrass_managed_certificates` Konfigurationsoption wurde entfernt.
**Example Beispiel: Legen Sie einen neuen Port für den Broker fest**
Das folgende Beispiel ändert den Port, an dem der MQTT-Broker arbeitet, vom Standardport 8883 auf den Port 1234. Wenn Sie Linux verwenden, fügen Sie das `dockerOptions` Feld hinzu.
```
{
"emqxConfig": {
"listeners": {
"ssl": {
"default": {
"bind": 1234
}
}
}
},
"dockerOptions": "-p 1234:1234"
}
```
**Example Beispiel: Passen Sie den Log-Level des MQTT-Brokers an**
Im folgenden Beispiel wird die Protokollebene des MQTT-Brokers auf geändert. `debug` Sie können aus den folgenden Protokollebenen wählen:
+ `debug`
+ `info`
+ `notice`
+ `warning`
+ `error`
+ `critical`
+ `alert`
+ `emergency`
Die Standard-Protokollebene ist`warning`.
```
{
"emqxConfig": {
"log": {
"console": {
"level": "debug"
}
}
}
}
```
**Example Beispiel: Aktivieren Sie das EMQX-Dashboard**
Das folgende Beispiel aktiviert das EMQX-Dashboard, sodass Sie Ihren Broker überwachen und verwalten können. Wenn Sie Linux verwenden, fügen Sie das `dockerOptions` Feld hinzu.
```
{
"emqxConfig": {
"dashboard": {
"listeners": {
"http": {
"bind": 18083
}
}
}
},
"dockerOptions": "-p 18083:18083"
}
```
------
#### [ 1.0.0 - 1.2.2 ]
Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.
`emqx`
(Optional) Die zu verwendende [EMQX MQTT-Broker-Konfiguration](https://www.emqx.io/docs/en/v4.4/configuration/configuration.html). Sie können eine Teilmenge der EMQX-Konfigurationsoptionen in dieser Komponente konfigurieren.
Dieses Objekt enthält die folgenden Informationen:
`listener.ssl.external`
(Optional) Der Port, an dem der MQTT-Broker arbeitet.
Wenn Sie einen anderen Port angeben und die [MQTT-Bridge-Komponente verwenden, um MQTT-Nachrichten](mqtt-bridge-component.md) an andere Broker weiterzuleiten, müssen Sie MQTT Bridge v2.1.0 oder höher verwenden. Konfigurieren Sie es so, dass es den Port verwendet, an dem der MQTT-Broker arbeitet.
Wenn Sie einen anderen Port angeben und die [IP-Detector-Komponente](ip-detector-component.md) zur Verwaltung von MQTT-Broker-Endpunkten verwenden, müssen Sie den IP-Detektor v2.1.0 oder höher verwenden. Konfigurieren Sie es so, dass der Port gemeldet wird, an dem der MQTT-Broker arbeitet.
Standard: `8883`
`listener.ssl.external.max_connections`
(Optional) Die maximale Anzahl gleichzeitiger Verbindungen, die der MQTT-Broker unterstützt.
Standard: `1024000`
`listener.ssl.external.max_conn_rate`
(Optional) Die maximale Anzahl neuer Verbindungen pro Sekunde, die der MQTT-Broker empfangen kann.
Standard: `500`
`listener.ssl.external.rate_limit`
(Optional) Das Bandbreitenlimit für alle Verbindungen zum MQTT-Broker. Geben Sie die Bandbreite und Dauer für diese Bandbreite, getrennt durch ein Komma (`,`), im folgenden Format an:. `bandwidth,duration` Sie können beispielsweise angeben`50KB,5s`, dass der MQTT-Broker alle 5 Sekunden auf 50 Kilobyte (KB) an Daten begrenzt werden soll.
`listener.ssl.external.handshake_timeout`
(Optional) Die Zeitspanne, die der MQTT-Broker wartet, bis die Authentifizierung einer neuen Verbindung abgeschlossen ist.
Standard: `15s`
`mqtt.max_packet_size`
(Optional) Die maximale Größe einer MQTT-Nachricht.
Standard: `268435455` (256 MB minus 1)
`log.level`
(Optional) Die Protokollebene für den MQTT-Broker. Wählen Sie aus den folgenden Optionen aus:
+ `debug`
+ `info`
+ `notice`
+ `warning`
+ `error`
+ `critical`
+ `alert`
+ `emergency`
Die Standard-Protokollebene ist`warning`.
`requiresPrivilege`
(Optional) Auf Linux-Core-Geräten können Sie angeben, dass der EMQX MQTT-Broker ohne Root- oder Administratorrechte ausgeführt werden soll. Wenn Sie diese Option auf setzen`false`, muss der Systembenutzer, der diese Komponente ausführt, Mitglied der Gruppe sein. `docker`
Standard: `true`
`startupTimeoutSeconds`
(Optional) Die maximale Zeit in Sekunden, die der EMQX MQTT-Broker zum Starten benötigt. Der Status der Komponente ändert sich auf, `BROKEN` wenn dieser Timeout überschritten wird.
Standard: `90`
`ipcTimeoutSeconds`
(Optional) Die maximale Zeit in Sekunden, die die Komponente benötigt, um darauf zu warten, dass der Greengrass-Kern auf IPC-Anfragen (Interprocess Communication) reagiert. Erhöhen Sie diesen Wert, wenn diese Komponente bei der Überprüfung, ob ein Client-Gerät autorisiert ist, Timeout-Fehler meldet.
Standard: `5`
`crtLogLevel`
(Optional) Die Protokollebene für die AWS Common Runtime (CRT) -Bibliothek.
Standardmäßig wird die Protokollebene (in) des EMQX MQTT-Brokers verwendet. `log.level` `emqx`
`restartIdentifier`
(Optional) Konfigurieren Sie diese Option, um den EMQX MQTT-Broker neu zu starten. Wenn sich dieser Konfigurationswert ändert, startet diese Komponente den MQTT-Broker neu. Sie können diese Option verwenden, um zu erzwingen, dass Client-Geräte die Verbindung trennen.
`dockerOptions`
(Optional) Konfigurieren Sie diese Option nur auf Linux-Betriebssystemen, um der Docker-Befehlszeile Parameter hinzuzufügen. Um beispielsweise zusätzliche Ports zuzuordnen, verwenden Sie den `-p` Docker-Parameter:
```
"-p 1883:1883"
```
`mergeConfigurationFiles`
(Optional) Konfigurieren Sie diese Option, um die Standardeinstellungen in den angegebenen EMQX-Konfigurationsdateien zu ergänzen oder zu überschreiben. Informationen zu den Konfigurationsdateien und ihren Formaten finden Sie unter [Konfiguration](https://www.emqx.io/docs/en/v4.4/configuration/configuration.html) in der *EMQX* 4.0-Dokumentation. Die von Ihnen angegebenen Werte werden an die Konfigurationsdatei angehängt.
Im folgenden Beispiel wird die `etc/emqx.conf` Datei aktualisiert.
```
"mergeConfigurationFiles": {
"etc/emqx.conf": "broker.sys_interval=30s\nbroker.sys_heartbeat=10s"
},
```
Zusätzlich zu den von EMQX unterstützten Konfigurationsdateien unterstützt Greengrass eine Datei, die das Greengrass-Authentifizierungs-Plugin für EMQX konfiguriert namens. `etc/plugins/aws_greengrass_emqx_auth.conf` Es gibt zwei unterstützte Optionen, und. `auth_mode` `use_greengrass_managed_certificates` Um einen anderen Authentifizierungsanbieter zu verwenden, setzen Sie die `auth_mode` Option auf einen der folgenden Werte:
+ `enabled`— (Standard) Verwenden Sie den Greengrass-Authentifizierungs- und Autorisierungsanbieter.
+ `bypass_on_failure`— Verwenden Sie den Greengrass-Authentifizierungsanbieter und dann alle verbleibenden Authentifizierungsanbieter in der EMQX-Anbieterkette, falls Greengrass entweder die Authentifizierung oder Autorisierung verweigert.
+ `bypass`— Der Greengrass-Anbieter ist deaktiviert. Authentifizierung und Autorisierung werden dann von der EMQX-Anbieterkette abgewickelt.
Wenn ja`use_greengrass_managed_certificates`, bedeutet diese Option`true`, dass Greengrass die Broker-TLS-Zertifikate verwaltet. Falls`false`, bedeutet dies, dass Sie die Zertifikate über eine andere Quelle bereitstellen.
Im folgenden Beispiel werden die Standardeinstellungen in der `etc/plugins/aws_greengrass_emqx_auth.conf` Konfigurationsdatei aktualisiert.
```
"mergeConfigurationFiles": {
"etc/plugins/aws_greengrass_emqx_auth.conf": "auth_mode=enabled\n use_greengrass_managed_certificates=true\n"
},
```
`aws.greengrass.clientdevices.mqtt.EMQX`ermöglicht es Ihnen, sicherheitsrelevante Optionen zu konfigurieren. Dazu gehören TLS-Einstellungen, Authentifizierungs- und Autorisierungsanbieter. Die empfohlene Konfiguration ist die Standardkonfiguration, die die gegenseitige TLS-Authentifizierung und den Greengrass Client Device Auth Provider verwendet.
`replaceConfigurationFiles`
(Optional) Konfigurieren Sie diese Option, um die angegebenen EMQX-Konfigurationsdateien zu ersetzen. Die von Ihnen angegebenen Werte ersetzen die gesamte vorhandene Konfigurationsdatei. Sie können die `etc/emqx.conf` Datei in diesem Abschnitt nicht angeben. Sie müssen `mergeConfigurationFile` zum Ändern verwenden`etc/emqx.conf`.
**Example Beispiel: Update zur Zusammenführung von Konfigurationen**
Die folgende Beispielkonfiguration legt fest, dass der MQTT-Broker auf Port 443 betrieben werden soll.
```
{
"emqx": {
"listener.ssl.external": "443",
"listener.ssl.external.max_connections": "1024000",
"listener.ssl.external.max_conn_rate": "500",
"listener.ssl.external.rate_limit": "50KB,5s",
"listener.ssl.external.handshake_timeout": "15s",
"log.level": "warning"
},
"requiresPrivilege": "true",
"startupTimeoutSeconds": "90",
"ipcTimeoutSeconds": "5"
}
```
------
## Lokale Protokolldatei
Diese Komponente verwendet die folgende Protokolldatei.
------
#### [ Linux ]
```
/greengrass/v2/logs/aws.greengrass.clientdevices.mqtt.EMQX.log
```
------
#### [ Windows ]
```
C:\greengrass\v2\logs\aws.greengrass.clientdevices.mqtt.EMQX.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:\$1greengrass\$1v2* durch den Pfad zum AWS IoT Greengrass Stammordner.
------
#### [ Linux ]
```
sudo tail -f /greengrass/v2/logs/aws.greengrass.clientdevices.mqtt.EMQX.log
```
------
#### [ Windows (PowerShell) ]
```
Get-Content C:\greengrass\v2\logs\aws.greengrass.clientdevices.mqtt.EMQX.log -Tail 10 -Wait
```
------
## Lizenzen
Auf Windows-Betriebssystemen enthält diese Software Code, der unter den [Microsoft-Softwarelizenzbedingungen - Microsoft Visual Studio Community 2022](https://visualstudio.microsoft.com/license-terms/vs2022-ga-community) vertrieben wird. Durch das Herunterladen dieser Software erklären Sie sich mit den Lizenzbedingungen dieses Codes einverstanden.
Diese Komponente wird im Rahmen der [Greengrass Core Software-Lizenzvereinbarung](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf) veröffentlicht.
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
------
#### [ v2.x ]
| **Version** | **Änderungen** |
| --- | --- |
| 2.0.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/mqtt-broker-emqx-component.html) |
| 2.0.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/mqtt-broker-emqx-component.html) |
| 2.0.1 | Die Version wurde für die Version 2.5.0 der [Client-Geräteauthentifizierung aktualisiert.](client-device-auth-component.md) |
| 2.0.0 | Diese Version des MQTT 5-Brokers (EMQX) erwartet andere Konfigurationsparameter als Version 1.x. Wenn Sie eine nicht standardmäßige Konfiguration für Version 1.x verwenden, müssen Sie die Konfiguration der Komponente für 2.x aktualisieren. Weitere Informationen finden Sie unter [Konfiguration](#mqtt-broker-emqx-component-configuration). [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/mqtt-broker-emqx-component.html) |
------
#### [ v1.x ]
| **Version** | **Änderungen** |
| --- | --- |
| 1.2.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/mqtt-broker-emqx-component.html) |
| 1.2.2 | Die Version wurde für die Version 2.4.0 der [Client-Geräteauthentifizierung](client-device-auth-component.md) aktualisiert. |
| 1.2.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/mqtt-broker-emqx-component.html) |
| 1.2.0 | Fügt Unterstützung für Zertifikatsketten hinzu. |
| 1.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/mqtt-broker-emqx-component.html) |
| 1.0.1 | Behebt ein Problem beim TLS-Handshake, das dazu führt, dass einige MQTT-Clients keine Verbindung herstellen können. |
| 1.0.0 | Erste Version |
------
# Nucleus-Telemetrie-Sender
Die Nucleus-Telemetrie-Emitter-Komponente (`aws.greengrass.telemetry.NucleusEmitter`) sammelt Telemetriedaten zur Systemintegrität und veröffentlicht sie kontinuierlich zu einem lokalen Thema und einem MQTT-Thema. AWS IoT Core Mit dieser Komponente können Sie Systemtelemetrie in Echtzeit auf Ihren Greengrass-Kerngeräten erfassen. Informationen zum Greengrass-Telemetrie-Agenten, der Systemtelemetrie-Daten auf Amazon EventBridge veröffentlicht, finden Sie unter. [Erfassung von Telemetriedaten zur Systemintegrität von AWS IoT Greengrass Kerngeräten](telemetry.md)
Standardmäßig veröffentlicht die Nucleus-Telemetrie-Emitter-Komponente alle 60 Sekunden Telemetriedaten zum folgenden lokalen Thema. publish/subscribe
```
$local/greengrass/telemetry
```
Die Nucleus-Telemetrie-Emitter-Komponente veröffentlicht standardmäßig nicht in einem AWS IoT Core MQTT-Thema. Sie können diese Komponente so konfigurieren, dass sie bei der Bereitstellung in einem AWS IoT Core MQTT-Thema veröffentlicht wird. [Die Verwendung eines MQTT-Topics zur Veröffentlichung von Daten in der AWS Cloud ist kostenpflichtig AWS IoT Core .](https://aws.amazon.com/iot-core/pricing/)
AWS IoT Greengrass bietet mehrere [Community-Komponenten](greengrass-software-catalog.md), mit denen Sie Telemetriedaten mithilfe von InfluxDB und Grafana lokal auf Ihrem Kerngerät analysieren und visualisieren können. Diese Komponenten verwenden Telemetriedaten von der Nukleus-Emitter-Komponente. [Weitere Informationen finden Sie in der README-Datei für die InfluxDB-Publisher-Komponente.](https://github.com/awslabs/aws-greengrass-labs-telemetry-influxdbpublisher)
**Topics**
+ [Versionen](#nucleus-emitter-component-versions)
+ [Typ](#nucleus-emitter-component-type)
+ [Betriebssystem](#nucleus-emitter-component-os-support)
+ [Abhängigkeiten](#nucleus-emitter-component-dependencies)
+ [Konfiguration](#nucleus-emitter-component-configuration)
+ [Ausgabedaten](#nucleus-emitter-component-output-data)
+ [Usage](#nucleus-emitter-component-usage)
+ [Lokale Protokolldatei](#nucleus-emitter-component-log-file)
+ [Änderungsprotokoll](#nucleus-emitter-component-changelog)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 1.0.x
## Typ
Diese Komponente ist eine Plugin-Komponente (`aws.greengrass.plugin`). Der [Greengrass-Kern führt diese Komponente in derselben Java Virtual Machine (JVM) wie der Nucleus](greengrass-nucleus-component.md) aus. Der Nucleus wird neu gestartet, wenn Sie die Version dieser Komponente auf dem Core-Gerät ändern.
Diese Komponente verwendet dieselbe Protokolldatei wie der Greengrass-Kern. Weitere Informationen finden Sie unter [AWS IoT Greengrass Protokolle überwachen](monitor-logs.md).
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## Betriebssystem
Diese Komponente kann auf Kerngeräten installiert werden, auf denen die folgenden Betriebssysteme ausgeführt werden:
+ Linux
+ Windows
## Abhängigkeiten
Wenn Sie eine Komponente bereitstellen, stellt sie 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](#nucleus-emitter-component-changelog) 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](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.
------
#### [ 1.0.12 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.12 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,4,0 <2,17,0 | Weich |
------
#### [ 1.0.11 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.11 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,4,0 <2,16,0 | Hart |
------
#### [ 1.0.10 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.10 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,4,0 <2,15,0 | Hart |
------
#### [ 1.0.9 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.9 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.4.0 <2.14.0 | Hart |
------
#### [ 1.0.8 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.8 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,4,0 <2,13,0 | Hart |
------
#### [ 1.0.7 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.7 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.4.0 <2.12.0 | Hart |
------
#### [ 1.0.6 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.6 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.4.0 <2.11.0 | Hart |
------
#### [ 1.0.5 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.5 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.4.0 <2.10.0 | Hart |
------
#### [ 1.0.4 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.4 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,4,0 <2,9,0 | Hart |
------
#### [ 1.0.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,4,0 <2,8,0 | Hart |
------
#### [ 1.0.2 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.2 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,4,0 <2,7,0 | Hart |
------
#### [ 1.0.1 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.1 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,4,0 <2,6,0 | Hart |
------
#### [ 1.0.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,4,0 <2,5,0 | Hart |
------
[Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den Komponentenrezepten.](component-recipe-reference.md#recipe-reference-component-dependencies)
## Konfiguration
Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.
`pubSubPublish`
(Optional) Definiert, ob Telemetriedaten zum `$local/greengrass/telemetry` Thema veröffentlicht werden sollen. Unterstützte Werte sind `true` und `false`.
Standard: `true`
`mqttTopic`
(Optional) Das AWS IoT Core MQTT-Thema, zu dem diese Komponente Telemetriedaten veröffentlicht.
Setzen Sie diesen Wert auf das AWS IoT Core MQTT-Thema, in dem Sie Telemetriedaten veröffentlichen möchten. Wenn dieser Wert leer ist, veröffentlicht der Nucle-Emitter keine Telemetriedaten auf dem. AWS Cloud
[Die Verwendung eines MQTT-Themas zur Veröffentlichung von Daten auf der AWS Cloud ist kostenpflichtig.AWS IoT Core](https://aws.amazon.com/iot-core/pricing/)
Standard: `""`
`telemetryPublishIntervalMs`
(Optional) Der Zeitraum (in Millisekunden), zwischen dem die Komponente Telemetriedaten veröffentlicht. Wenn Sie diesen Wert niedriger als den unterstützten Mindestwert festlegen, verwendet die Komponente stattdessen den Mindestwert.
Niedrigere Veröffentlichungsintervalle führen zu einer höheren CPU-Auslastung auf Ihrem Kerngerät. Wir empfehlen, mit dem Standard-Veröffentlichungsintervall zu beginnen und es an die CPU-Auslastung Ihres Geräts anzupassen.
Minimum: `500`
Standard: `60000`
**Example Beispiel: Aktualisierung zur Zusammenführung von Konfigurationen**
Das folgende Beispiel zeigt ein Beispiel für ein Update zur Zusammenführung von Konfigurationen, das die Veröffentlichung von Telemetriedaten für das `$local/greengrass/telemetry` Thema und das `greengrass/myTelemetry` AWS IoT Core MQTT-Thema alle 5 Sekunden ermöglicht.
```
{
"pubSubPublish": "true",
"mqttTopic": "greengrass/myTelemetry",
"telemetryPublishIntervalMs": 5000
}
```
## Ausgabedaten
Diese Komponente veröffentlicht Telemetrie-Metriken als JSON-Array zum folgenden Thema.
**Lokales Thema:** `$local/greengrass/telemetry`
Sie können sich optional dafür entscheiden, auch Telemetrie-Metriken zu einem AWS IoT Core MQTT-Thema zu veröffentlichen. *Weitere Informationen zu den Themen finden Sie unter [MQTT-Themen im AWS IoT Core Developer](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) Guide.*
**Example Beispiel für Daten**
```
[
{
"A": "Average",
"N": "CpuUsage",
"NS": "SystemMetrics",
"TS": 1627597331445,
"U": "Percent",
"V": 26.21981271562346
},
{
"A": "Count",
"N": "TotalNumberOfFDs",
"NS": "SystemMetrics",
"TS": 1627597331445,
"U": "Count",
"V": 7316
},
{
"A": "Count",
"N": "SystemMemUsage",
"NS": "SystemMetrics",
"TS": 1627597331445,
"U": "Megabytes",
"V": 10098
},
{
"A": "Count",
"N": "NumberOfComponentsStarting",
"NS": "GreengrassComponents",
"TS": 1627597331446,
"U": "Count",
"V": 0
},
{
"A": "Count",
"N": "NumberOfComponentsInstalled",
"NS": "GreengrassComponents",
"TS": 1627597331446,
"U": "Count",
"V": 0
},
{
"A": "Count",
"N": "NumberOfComponentsStateless",
"NS": "GreengrassComponents",
"TS": 1627597331446,
"U": "Count",
"V": 0
},
{
"A": "Count",
"N": "NumberOfComponentsStopping",
"NS": "GreengrassComponents",
"TS": 1627597331446,
"U": "Count",
"V": 0
},
{
"A": "Count",
"N": "NumberOfComponentsBroken",
"NS": "GreengrassComponents",
"TS": 1627597331446,
"U": "Count",
"V": 0
},
{
"A": "Count",
"N": "NumberOfComponentsRunning",
"NS": "GreengrassComponents",
"TS": 1627597331446,
"U": "Count",
"V": 7
},
{
"A": "Count",
"N": "NumberOfComponentsErrored",
"NS": "GreengrassComponents",
"TS": 1627597331446,
"U": "Count",
"V": 0
},
{
"A": "Count",
"N": "NumberOfComponentsNew",
"NS": "GreengrassComponents",
"TS": 1627597331446,
"U": "Count",
"V": 0
},
{
"A": "Count",
"N": "NumberOfComponentsFinished",
"NS": "GreengrassComponents",
"TS": 1627597331446,
"U": "Count",
"V": 2
}
]
```
Das Ausgabe-Array enthält eine Liste von Metriken mit den folgenden Eigenschaften:
`A`
Der Aggregationstyp für die Metrik.
Für die `CpuUsage` Metrik ist diese Eigenschaft auf gesetzt, `Average` da der veröffentlichte Wert der Metrik der durchschnittlichen CPU-Auslastung seit dem letzten Veröffentlichungsereignis entspricht.
Bei allen anderen Metriken aggregiert der Nucleus-Emitter den Metrikwert nicht, und diese Eigenschaft ist auf `Count` gesetzt.
`N`
Name der Metrik.
`NS`
Der Metrik-Namespace.
`TS`
Der Zeitstempel, zu dem die Daten gesammelt wurden.
`U`
Die Einheit des metrischen Werts.
`V`
Der -Metrikwert
Der Nukleus-Emitter veröffentlicht die folgenden Metriken:
| Name | Description |
| --- | --- |
| **System (System)** |
| `SystemMemUsage` | Die Menge an Speicher, die derzeit von allen Anwendungen auf dem Greengrass-Core-Gerät verwendet wird, einschließlich des Betriebssystems. |
| `CpuUsage` | Die Menge an CPU, die derzeit von allen Anwendungen auf dem Greengrass-Core-Gerät verwendet wird, einschließlich des Betriebssystems. |
| `TotalNumberOfFDs` | Die Anzahl der Dateideskriptoren, die vom Betriebssystem des Greengrass-Core-Geräts gespeichert werden. Ein Dateideskriptor identifiziert eindeutig eine geöffnete Datei. |
| **Grüngraskern** |
| `NumberOfComponentsRunning` | Die Anzahl der Komponenten, die auf dem Greengrass-Core-Gerät ausgeführt werden. |
| `NumberOfComponentsErrored` | Die Anzahl der Komponenten, die sich auf dem Greengrass-Core-Gerät im Fehlerstatus befinden. |
| `NumberOfComponentsInstalled` | Die Anzahl der Komponenten, die auf dem Greengrass-Core-Gerät installiert sind. |
| `NumberOfComponentsStarting` | Die Anzahl der Komponenten, die auf dem Greengrass-Core-Gerät gestartet werden. |
| `NumberOfComponentsNew` | Die Anzahl der Komponenten, die auf dem Greengrass-Core-Gerät neu sind. |
| `NumberOfComponentsStopping` | Die Anzahl der Komponenten, die auf dem Greengrass-Core-Gerät gestoppt werden. |
| `NumberOfComponentsFinished` | Die Anzahl der Komponenten, die auf dem Greengrass-Core-Gerät fertiggestellt wurden. |
| `NumberOfComponentsBroken` | Die Anzahl der Komponenten, die auf dem Greengrass-Core-Gerät defekt sind. |
| `NumberOfComponentsStateless` | Die Anzahl der Komponenten, die auf dem Greengrass-Core-Gerät zustandslos sind. |
## Usage
Um Telemetriedaten zur Systemintegrität zu verwenden, können Sie benutzerdefinierte Komponenten erstellen, die die Themen abonnieren, zu denen der Nucleus-Emitter die Telemetriedaten veröffentlicht, und bei Bedarf auf diese Daten reagieren. Da die Nucle-Emitter-Komponente die Möglichkeit bietet, Telemetriedaten zu einem lokalen Thema zu veröffentlichen, können Sie dieses Thema abonnieren und die veröffentlichten Daten verwenden, um lokal auf Ihrem Kerngerät zu agieren. Das Core-Gerät kann dann auf Telemetriedaten reagieren, selbst wenn es nur über eine begrenzte Konnektivität zur Cloud verfügt.
Sie können beispielsweise eine Komponente konfigurieren, die das `$local/greengrass/telemetry` Thema auf Telemetriedaten überwacht, und die Daten an die Stream-Manager-Komponente senden, um Ihre Daten an die zu streamen. AWS Cloud Weitere Hinweise zum Erstellen einer solchen Komponente finden Sie unter [Lokale Nachrichten veröffentlichen/abonnieren](ipc-publish-subscribe.md) und. [Erstellen Sie benutzerdefinierte Komponenten, die den Stream-Manager verwenden](use-stream-manager-in-custom-components.md)
## Lokale Protokolldatei
Diese Komponente verwendet dieselbe Protokolldatei wie die [Greengrass Nucleus-Komponente](greengrass-nucleus-component.md).
------
#### [ Linux ]
```
/greengrass/v2/logs/greengrass.log
```
------
#### [ Windows ]
```
C:\greengrass\v2\logs\greengrass.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:\$1greengrass\$1v2* durch den Pfad zum AWS IoT Greengrass Stammordner.
------
#### [ Linux ]
```
sudo tail -f /greengrass/v2/logs/greengrass.log
```
------
#### [ Windows (PowerShell) ]
```
Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
```
------
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| **Version** | **Änderungen** |
| --- | --- |
| 1.0.12 | Die Version wurde für die Version 2.16.0 von Greengrass Nucleus aktualisiert. |
| 1.0.11 | Die Version wurde für die Version 2.15.0 von Greengrass Nucleus aktualisiert. |
| 1.0.10 | Die Version wurde für die Version 2.14.0 von Greengrass Nucleus aktualisiert. |
| 1.0.9 | Die Version wurde für die Version 2.13.0 von Greengrass Nucleus aktualisiert. |
| 1.0.8 | Die Version wurde für die Version 2.12.0 von Greengrass Nucleus aktualisiert. |
| 1.0.7 | Die Version wurde für die Version 2.11.0 von Greengrass Nucleus aktualisiert. |
| 1.0.6 | Die Version wurde für die Version 2.10.0 von Greengrass Nucleus aktualisiert. |
| 1.0.5 | Die Version wurde für die Version 2.9.0 von Greengrass Nucleus aktualisiert. |
| 1.0.4 | Die Version wurde für die Version 2.8.0 von Greengrass Nucleus aktualisiert. |
| 1.0.3 | Die Version wurde für die Version 2.7.0 von Greengrass Nucleus aktualisiert. |
| 1.0.2 | Die Version wurde für die Version 2.6.0 von Greengrass Nucleus aktualisiert. |
| 1.0.1 | Die Version wurde für die Version 2.5.0 von Greengrass Nucleus aktualisiert. |
| 1.0.0 | Erste Version |
# PKCS \$111 -Anbieter
[Mit der PKCS \$111 -Anbieterkomponente (`aws.greengrass.crypto.Pkcs11Provider`) können Sie die AWS IoT Greengrass Core-Software so konfigurieren, dass sie über die PKCS \$111 -Schnittstelle ein Hardware-Sicherheitsmodul (HSM) verwendet.](https://en.wikipedia.org/wiki/PKCS_11) Diese Komponente ermöglicht es Ihnen, Zertifikate und private Schlüsseldateien sicher zu speichern, sodass sie nicht offengelegt oder in der Software dupliziert werden. Weitere Informationen finden Sie unter [Integration von Hardware-Sicherheit](hardware-security.md).
Um ein Greengrass-Core-Gerät bereitzustellen, das sein Zertifikat und seinen privaten Schlüssel in einem HSM speichert, müssen Sie diese Komponente bei der Installation der Core-Software als Provisioning-Plugin angeben. AWS IoT Greengrass Weitere Informationen finden Sie unter [Installieren Sie die AWS IoT Greengrass Core-Software mit manueller Ressourcenbereitstellung](manual-installation.md).
AWS IoT Greengrass stellt diese Komponente als JAR-Datei bereit, die Sie herunterladen können, um sie während der Installation als Provisioning-Plugin anzugeben. Sie können die neueste Version der JAR-Datei der Komponente unter der folgenden URL herunterladen: [https://d2s8p88vqu9w66.cloudfront. net/releases/Pkcs11Provider/aws.greengrass.crypto.pkcs11Provider-latest.jar](https://d2s8p88vqu9w66.cloudfront.net/releases/Pkcs11Provider/aws.greengrass.crypto.Pkcs11Provider-latest.jar).
**Topics**
+ [Versionen](#pkcs11-provider-component-versions)
+ [Typ](#pkcs11-provider-component-type)
+ [Betriebssystem](#pkcs11-provider-component-os-support)
+ [Voraussetzungen](#pkcs11-provider-component-requirements)
+ [Abhängigkeiten](#pkcs11-provider-component-dependencies)
+ [Konfiguration](#pkcs11-provider-component-configuration)
+ [Lokale Protokolldatei](#pkcs11-provider-component-log-file)
+ [Änderungsprotokoll](#pkcs11-provider-component-changelog)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 2.0.x
## Typ
Diese Komponente ist eine Plugin-Komponente (`aws.greengrass.plugin`). Der [Greengrass-Kern führt diese Komponente in derselben Java Virtual Machine (JVM) wie der Nucleus](greengrass-nucleus-component.md) aus. Der Nucleus wird neu gestartet, wenn Sie die Version dieser Komponente auf dem Kerngerät ändern.
Diese Komponente verwendet dieselbe Protokolldatei wie der Greengrass-Kern. Weitere Informationen finden Sie unter [AWS IoT Greengrass Protokolle überwachen](monitor-logs.md).
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## Betriebssystem
Diese Komponente kann nur auf Linux-Core-Geräten installiert werden.
## Voraussetzungen
Für diese Komponente gelten die folgenden Anforderungen:
+ Ein Hardware-Sicherheitsmodul, das das [PKCS \$11 v1.5-Signaturschema](https://tools.ietf.org/html/rfc2313) und RSA-Schlüssel mit einer RSA-2048-Schlüsselgröße (oder größer) oder ECC-Schlüssel unterstützt.
**Anmerkung**
Um ein Hardware-Sicherheitsmodul mit ECC-Schlüsseln zu verwenden, müssen Sie [Greengrass Nucleus](greengrass-nucleus-component.md) v2.5.6 oder höher verwenden.
Um ein Hardware-Sicherheitsmodul und einen [Secret Manager](secret-manager-component.md) zu verwenden, müssen Sie ein Hardware-Sicherheitsmodul mit RSA-Schlüsseln verwenden.
+ Eine PKCS \$111 -Anbieterbibliothek, die die AWS IoT Greengrass Core-Software zur Laufzeit laden kann (mit libdl), um PKCS \$111 -Funktionen aufzurufen. Die PKCS \$111 -Anbieterbibliothek muss die folgenden PKCS \$111 -API-Operationen implementieren:
+ `C_Initialize`
+ `C_Finalize`
+ `C_GetSlotList`
+ `C_GetSlotInfo`
+ `C_GetTokenInfo`
+ `C_OpenSession`
+ `C_GetSessionInfo`
+ `C_CloseSession`
+ `C_Login`
+ `C_Logout`
+ `C_GetAttributeValue`
+ `C_FindObjectsInit`
+ `C_FindObjects`
+ `C_FindObjectsFinal`
+ `C_DecryptInit`
+ `C_Decrypt`
+ `C_DecryptUpdate`
+ `C_DecryptFinal`
+ `C_SignInit`
+ `C_Sign`
+ `C_SignUpdate`
+ `C_SignFinal`
+ `C_GetMechanismList`
+ `C_GetMechanismInfo`
+ `C_GetInfo`
+ `C_GetFunctionList`
+ Das Hardwaremodul muss nach Slot-Label auflösbar sein, wie in der PKCS\$111-Spezifikation definiert.
+ Sie müssen den privaten Schlüssel und das Zertifikat im HSM im selben Steckplatz speichern, und sie müssen dieselbe Objektbezeichnung und Objekt-ID verwenden, wenn das HSM Objekt unterstützt. IDs
+ Das Zertifikat und der private Schlüssel müssen durch Objektbezeichnungen aufgelöst werden können.
+ Der private Schlüssel muss über die folgenden Berechtigungen verfügen:
+ `sign`
+ `decrypt`
+ (Optional) Um die [Secret Manager-Komponente](secret-manager-component.md) verwenden zu können, müssen Sie Version 2.1.0 oder höher verwenden, und der private Schlüssel muss über die folgenden Berechtigungen verfügen:
+ `unwrap`
+ `wrap`
+ (Optional) Wenn Sie die TPM2 Bibliothek verwenden und den Greengrass Core als Service ausführen, müssen Sie eine Umgebungsvariable mit dem Speicherort des PKCS \$111 -Speichers angeben. Das folgende Beispiel ist eine Systemd-Dienstdatei mit der erforderlichen Umgebungsvariablen:
```
[Unit]
Description=Greengrass Core
After=network.target
[Service]
Type=simple
PIDFile=/var/run/greengrass.pid
Environment=TPM2_PKCS11_STORE=/path/to/store/directory
RemainAfterExit=no
Restart=on-failure
RestartSec=10
ExecStart=/bin/sh /greengrass/v2/alts/current/distro/bin/loader
[Install]
WantedBy=multi-user.target
```
## Abhängigkeiten
Wenn Sie eine Komponente bereitstellen, stellt sie 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](#pkcs11-provider-component-changelog) 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](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.
------
#### [ 2.0.11 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.11 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,5,3 <2,17,0 | Weich |
------
#### [ 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](greengrass-nucleus-component.md) | >=2,5,3 <2,16,0 | Weich |
------
#### [ 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](greengrass-nucleus-component.md) | >=2.5.3 <2.15.0 | Weich |
------
#### [ 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](greengrass-nucleus-component.md) | >=2.5.3 <2.14.0 | Weich |
------
#### [ 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](greengrass-nucleus-component.md) | >=2.5.3 <2.13.0 | Weich |
------
#### [ 2.0.6 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.6 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.5.3 <2.12.0 | Weich |
------
#### [ 2.0.5 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.5 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.5.3 <2.11.0 | Weich |
------
#### [ 2.0.4 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.4 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.5.3 <2.10.0 | Weich |
------
#### [ 2.0.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,5,3 <2,9,0 | Weich |
------
#### [ 2.0.2 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.2 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,5,3 <2,8,0 | Weich |
------
#### [ 2.0.1 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.1 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,5,3 <2,7,0 | Weich |
------
#### [ 2.0.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,5,3 <2,6,0 | Weich |
------
[Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den Komponentenrezepten.](component-recipe-reference.md#recipe-reference-component-dependencies)
## Konfiguration
Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.
`name`
Ein Name für die PKCS \$111 -Konfiguration.
`library`
Der absolute Dateipfad zur Bibliothek der PKCS \$111 -Implementierung, die die AWS IoT Greengrass Core-Software mit libdl laden kann.
`slot`
Die ID des Steckplatzes, der den privaten Schlüssel und das Gerätezertifikat enthält. Dieser Wert unterscheidet sich vom Steckplatzindex oder der Steckplatzbezeichnung.
`userPin`
Die Benutzer-PIN, die für den Zugriff auf den Steckplatz verwendet werden soll.
**Example Beispiel: Aktualisierung der Zusammenführung von Konfigurationen**
```
{
"name": "softhsm_pkcs11",
"library": "/usr/lib/softhsm/libsofthsm2.so",
"slot": 1,
"userPin": "1234"
}
```
## Lokale Protokolldatei
Diese Komponente verwendet dieselbe Protokolldatei wie die [Greengrass Nucleus-Komponente](greengrass-nucleus-component.md).
------
#### [ Linux ]
```
/greengrass/v2/logs/greengrass.log
```
------
#### [ Windows ]
```
C:\greengrass\v2\logs\greengrass.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:\$1greengrass\$1v2* durch den Pfad zum AWS IoT Greengrass Stammordner.
------
#### [ Linux ]
```
sudo tail -f /greengrass/v2/logs/greengrass.log
```
------
#### [ Windows (PowerShell) ]
```
Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
```
------
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| **Version** | **Änderungen** |
| --- | --- |
| 2.0.11 | Die Version wurde für die Version 2.16.0 von Greengrass Nucleus aktualisiert. |
| 2.0.10 | Die Version wurde für die Version 2.15.0 von Greengrass Nucleus aktualisiert. |
| 2.0.9 | Die Version wurde für die Version 2.14.0 von Greengrass Nucleus aktualisiert. |
| 2.0.8 | Die Version wurde für die Version 2.13.0 von Greengrass Nucleus aktualisiert. |
| 2.0.7 | Die Version wurde für die Version 2.12.0 von Greengrass Nucleus aktualisiert. |
| 2.0.6 | Die Version wurde für die Version 2.11.0 von Greengrass Nucleus aktualisiert. |
| 2.0.5 | Die Version wurde für die Version 2.10.0 von Greengrass Nucleus aktualisiert. |
| 2.0.4 | Die Version wurde für die Version 2.9.0 von Greengrass Nucleus aktualisiert. |
| 2.0.3 | Die Version wurde für die Version 2.8.0 von Greengrass Nucleus aktualisiert. |
| 2.0.2 | Die Version wurde für die Version 2.7.0 von Greengrass Nucleus aktualisiert. |
| 2.0.1 | Die Version wurde für die Version 2.6.0 von Greengrass Nucleus aktualisiert. |
| 2.0.0 | Erste Version |
# Geheimer Manager
Die Secret Manager-Komponente (`aws.greengrass.SecretManager`) verteilt Geheimnisse von AWS Secrets Manager Greengrass-Kerngeräten. Verwenden Sie diese Komponente, um Anmeldeinformationen wie Passwörter sicher in benutzerdefinierten Komponenten auf Ihren Greengrass-Kerngeräten zu verwenden. Weitere Informationen zu Secrets Manager finden Sie unter [Was ist AWS Secrets Manager?](https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html) im *AWS Secrets Manager Benutzerhandbuch*.
Um auf die Geheimnisse dieser Komponente in Ihren benutzerdefinierten Greengrass-Komponenten zuzugreifen, verwenden Sie den [GetSecretValue](ipc-secret-manager.md#ipc-operation-getsecretvalue)Vorgang in. AWS IoT Device SDK Weitere Informationen erhalten Sie unter [Verwenden Sie den AWS IoT Device SDK , um mit dem Greengrass-Kern und anderen Komponenten zu kommunizieren und AWS IoT CoreKommunizieren Sie mit dem Greengrass-Kern, anderen Komponenten und AWS IoT Core](interprocess-communication.md) und [Geheime Werte abrufen](ipc-secret-manager.md).
Diese Komponente verschlüsselt Geheimnisse auf dem Kerngerät, um Ihre Anmeldeinformationen und Passwörter zu schützen, bis Sie sie verwenden müssen. Sie verwendet den privaten Schlüssel des Kerngeräts, um Geheimnisse zu verschlüsseln und zu entschlüsseln.
**Topics**
+ [Versionen](#secret-manager-component-versions)
+ [Typ](#secret-manager-component-type)
+ [Betriebssystem](#secret-manager-component-os-support)
+ [Voraussetzungen](#secret-manager-component-requirements)
+ [Abhängigkeiten](#secret-manager-component-dependencies)
+ [Konfiguration](#secret-manager-component-configuration)
+ [Lokale Protokolldatei](#secret-manager-component-log-file)
+ [Änderungsprotokoll](#secret-manager-component-changelog)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 2.2.x
+ 2.1.x
+ 2.0.x
## Typ
Diese Komponente ist eine Plugin-Komponente (`aws.greengrass.plugin`). Der [Greengrass-Kern führt diese Komponente in derselben Java Virtual Machine (JVM) wie der Nucleus](greengrass-nucleus-component.md) aus. Der Nucleus wird neu gestartet, wenn Sie die Version dieser Komponente auf dem Core-Gerät ändern.
Diese Komponente verwendet dieselbe Protokolldatei wie der Greengrass-Kern. Weitere Informationen finden Sie unter [AWS IoT Greengrass Protokolle überwachen](monitor-logs.md).
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## 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 [Greengrass-Geräterolle](device-service-role.md) muss die `secretsmanager:GetSecretValue` Aktion zulassen, wie in der folgenden Beispiel-IAM-Richtlinie gezeigt.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"secretsmanager:GetSecretValue"
],
"Effect": "Allow",
"Resource": [
"arn:aws:secretsmanager:us-east-1:123456789012:secret:MySecret"
]
}
]
}
```
------
```
```
**Anmerkung**
Wenn Sie einen vom Kunden verwalteten AWS Key Management Service Schlüssel zum Verschlüsseln von Geheimnissen verwenden, muss die Geräterolle die Aktion ebenfalls zulassen. `kms:Decrypt`
Weitere Informationen zu den IAM-Richtlinien für Secrets Manager finden Sie im folgenden *AWS Secrets Manager Benutzerhandbuch*:
+ [Authentifizierung und Zugriffskontrolle für AWS Secrets Manager](https://docs.aws.amazon.com/secretsmanager/latest/userguide/auth-and-access.html)
+ [Aktionen, Ressourcen und Kontextschlüssel, die Sie in einer IAM-Richtlinie oder Geheimrichtlinie verwenden können AWS Secrets Manager](https://docs.aws.amazon.com/secretsmanager/latest/userguide/reference_iam-permissions.html)
+ Benutzerdefinierte Komponenten müssen eine Autorisierungsrichtlinie definieren, die `aws.greengrass#GetSecretValue` den Zugriff auf Geheimnisse ermöglicht, die Sie mit dieser Komponente speichern. In dieser Autorisierungsrichtlinie können Sie den Zugriff von Komponenten auf bestimmte Geheimnisse einschränken. Weitere Informationen finden Sie unter [Secret Manager IPC-Autorisierung](ipc-secret-manager.md#ipc-secret-manager-authorization).
+ (Optional) Wenn Sie den privaten Schlüssel und das Zertifikat des Core-Geräts in einem [Hardware-Sicherheitsmodul](hardware-security.md) (HSM) speichern, muss das HSM RSA-Schlüssel unterstützen, der private Schlüssel muss über die `unwrap` entsprechende Berechtigung verfügen und der öffentliche Schlüssel muss über die entsprechende Berechtigung verfügen. `wrap`
### 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](allow-device-traffic.md).
| Endpoint | Port | Erforderlich | Description |
| --- | --- | --- | --- |
| `secretsmanager.region.amazonaws.com` | 443 | Ja | Laden Sie Geheimnisse auf das Kerngerät herunter. |
## 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](#secret-manager-component-changelog) 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](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.
------
#### [ 2.2.7 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.2.7 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,5,0 <2,17,0 | Weich |
------
#### [ 2.2.6 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.2.6 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,5,0 <2,16,0 | Weich |
------
#### [ 2.2.2 – 2.2.5 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.2.2 bis 2.2.5 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,5,0 <2,15,0 | Weich |
------
#### [ 2.2.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.2.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.13.0 <2.14.0 | Weich |
------
#### [ 2.1.7 – 2.1.8 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.1.7 und 2.1.8 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,5,0 <2,13,0 | Weich |
------
#### [ 2.1.6 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.6 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.5.0 <2.12.0 | Weich |
------
#### [ 2.1.5 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.5 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,5,0 <2,11,0 | Weich |
------
#### [ 2.1.4 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.4 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.5.0 <2.10.0 | Weich |
------
#### [ 2.1.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,5,0 <2,9,0 | Weich |
------
#### [ 2.1.2 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.2 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,5,0 <2,8,0 | Weich |
------
#### [ 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](greengrass-nucleus-component.md) | >=2,5,0 <2,7,0 | Weich |
------
#### [ 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](greengrass-nucleus-component.md) | >=2,5,0 <2,6,0 | Weich |
------
#### [ 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](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Weich |
------
#### [ 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](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Weich |
------
#### [ 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](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Weich |
------
#### [ 2.0.6 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.6 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Weich |
------
#### [ 2.0.4 and 2.0.5 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.0.4 und 2.0.5 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.3 <2.1.0 | Weich |
------
[Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den Komponentenrezepten.](component-recipe-reference.md#recipe-reference-component-dependencies)
## Konfiguration
Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.
`periodicRefreshIntervalMin` (optional)
Das Intervall in Minuten, in dem diese Komponente die konfigurierten Geheimnisse auf dem Kerngerät mit den neuesten Geheimwerten des AWS Secrets Manager Dienstes synchronisiert. Wenn dieses Intervall nicht konfiguriert ist, aktualisiert Secret Manager die konfigurierten Geheimnisse nicht regelmäßig.
```
{
"cloudSecrets": [
{
"arn": "arn:aws:secretsmanager:us-west-2:123456789012:secret:MyGreengrassSecret-abcdef"
}
],
"periodicRefreshIntervalMin" : 60
}
```
`cloudSecrets`
Eine Liste von Secrets Manager Manager-Geheimnissen, die auf dem Kerngerät bereitgestellt werden sollen. Sie können Labels angeben, um zu definieren, welche Versionen der einzelnen Secrets bereitgestellt werden sollen. Wenn Sie keine Version angeben, stellt diese Komponente die Version mit dem angehängten Staging-Label `AWSCURRENT` bereit. *Weitere Informationen finden Sie unter [Staging-Labels](https://docs.aws.amazon.com/secretsmanager/latest/userguide/terms-concepts.html#term_staging-label) im AWS Secrets Manager Benutzerhandbuch.*
Die Secret Manager-Komponente speichert Geheimnisse lokal zwischen. Wenn sich der geheime Wert in Secrets Manager ändert, ruft diese Komponente den neuen Wert nicht automatisch ab. Um die lokale Kopie zu aktualisieren, geben Sie dem Geheimnis eine neue Bezeichnung und konfigurieren Sie diese Komponente so, dass sie das durch das neue Label identifizierte Geheimnis abruft.
Jedes Objekt enthält die folgenden Informationen:
`arn`
Der ARN des Secrets, das bereitgestellt werden soll. Der ARN des Geheimnisses kann entweder ein vollständiger ARN oder ein teilweiser ARN sein. Wir empfehlen, dass Sie einen vollständigen ARN anstelle eines teilweisen ARN angeben. Weitere Informationen [finden Sie unter Finden eines Geheimnisses aus einem partiellen ARN](https://docs.aws.amazon.com/secretsmanager/latest/userguide/troubleshoot.html#ARN_secretnamehyphen). Im Folgenden finden Sie ein Beispiel für einen vollständigen ARN und einen teilweisen ARN:
+ Vollständiger ARN: `arn:aws:secretsmanager:us-east-2:111122223333:secret:SecretName-abcdef`
+ Teilweiser ARN: `arn:aws:secretsmanager:us-east-2:111122223333:secret:SecretName`
`labels`
(Optional) Eine Liste mit Labels zur Identifizierung der Versionen des Secrets, die auf dem Kerngerät bereitgestellt werden sollen.
Jedes Label muss eine Zeichenfolge sein.
**Example Beispiel: Aktualisierung der Konfigurationszusammenführung**
```
{
"cloudSecrets": [
{
"arn": "arn:aws:secretsmanager:us-west-2:123456789012:secret:MyGreengrassSecret-abcdef"
}
]
}
```
## Lokale Protokolldatei
Diese Komponente verwendet dieselbe Protokolldatei wie die [Greengrass Nucleus-Komponente](greengrass-nucleus-component.md).
------
#### [ Linux ]
```
/greengrass/v2/logs/greengrass.log
```
------
#### [ Windows ]
```
C:\greengrass\v2\logs\greengrass.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:\$1greengrass\$1v2* durch den Pfad zum AWS IoT Greengrass Stammordner.
------
#### [ Linux ]
```
sudo tail -f /greengrass/v2/logs/greengrass.log
```
------
#### [ Windows (PowerShell) ]
```
Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
```
------
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| **Version** | **Änderungen** |
| --- | --- |
| 2.2.7 | Die Version wurde für die Version 2.16.0 von Greengrass Nucleus aktualisiert. |
| 2.2.6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/secret-manager-component.html) |
| 2.2.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/secret-manager-component.html) |
| 2.2.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/secret-manager-component.html) |
| 2.2.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/secret-manager-component.html) |
| 2.2.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/secret-manager-component.html) |
| 2.2.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/secret-manager-component.html) |
| 2.2.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/secret-manager-component.html) |
| 2.1.8 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/secret-manager-component.html) |
| 2.1.7 | Die Version wurde für die Version 2.12.0 von Greengrass Nucleus aktualisiert. |
| 2.1.6 | Die Version wurde für die Version 2.11.0 von Greengrass Nucleus aktualisiert. |
| 2.1.5 | Die Version wurde für die Version 2.10.0 von Greengrass Nucleus aktualisiert. |
| 2.1.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/secret-manager-component.html) |
| 2.1.3 | Die Version wurde für die Version 2.8.0 von Greengrass Nucleus aktualisiert. |
| 2.1.2 | Die Version wurde für die Version 2.7.0 von Greengrass Nucleus aktualisiert. |
| 2.1.1 | Die Version wurde für die Version 2.6.0 von Greengrass Nucleus aktualisiert. |
| 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/secret-manager-component.html) |
| 2.0.9 | Die Version wurde für die Version 2.4.0 von Greengrass Nucleus aktualisiert. |
| 2.0.8 | Die Version wurde für die Version 2.3.0 von Greengrass Nucleus aktualisiert. |
| 2.0.7 | Die Version wurde für die Version 2.2.0 von Greengrass Nucleus aktualisiert. |
| 2.0.6 | Die Version wurde für die Version 2.1.0 von Greengrass Nucleus aktualisiert. |
| 2.0.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/secret-manager-component.html) |
| 2.0.4 | Erste Version |
# Sicheres Tunneling
Mit der `aws.greengrass.SecureTunneling` Komponente können Sie eine sichere bidirektionale Kommunikation mit einem Greengrass-Core-Gerät aufbauen, das sich hinter eingeschränkten Firewalls befindet.
Stellen Sie sich zum Beispiel vor, Sie haben ein Greengrass-Core-Gerät hinter einer Firewall, die alle eingehenden Verbindungen verbietet. Secure Tunneling verwendet MQTT, um ein Zugriffstoken auf das Gerät zu übertragen, und stellt dann über die WebSockets Firewall eine SSH-Verbindung zum Gerät her. Mit diesem AWS IoT verwalteten Tunnel können Sie die für Ihr Gerät benötigte SSH-Verbindung öffnen. *Weitere Informationen zur Verwendung von AWS IoT Secure Tunneling für die Verbindung zu Remote-Geräten finden Sie unter [AWS IoT Secure Tunneling](https://docs.aws.amazon.com/iot/latest/developerguide/secure-tunneling.html) im Entwicklerhandbuch.AWS IoT *
Diese Komponente abonniert den AWS IoT Core MQTT-Nachrichtenbroker zu diesem `$aws/things/greengrass-core-device/tunnels/notify` Thema, um Benachrichtigungen über sicheres Tunneling zu erhalten.
**Topics**
+ [Versionen](#secure-tunneling-component-versions)
+ [Typ](#secure-tunneling-component-type)
+ [Betriebssystem](#secure-tunneling-component-os-support)
+ [Voraussetzungen](#secure-tunneling-component-requirements)
+ [Abhängigkeiten](#secure-tunneling-component-dependencies)
+ [Konfiguration](#secure-tunneling-component-configuration)
+ [Lokale Protokolldatei](#secure-tunneling-component-log-file)
+ [Lizenzen](#secure-tunneling-component-licenses)
+ [Usage](#secure-tunneling-component-usage)
+ [Weitere Informationen finden Sie auch unter](#secure-tunneling-component-see-also)
+ [Änderungsprotokoll](#secure-tunneling-component-changelog)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 1.1.x
+ 1.0.x
## Typ
Diese Komponente ist eine generische Komponente (`aws.greengrass.generic`). Der [Greengrass-Kern](greengrass-nucleus-component.md) führt die Lebenszyklusskripte der Komponente aus.
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## Betriebssystem
Diese Komponente kann nur auf Linux-Core-Geräten installiert werden.
Architekturen:
+ Armv71
+ Arm 8 () AArch64
+ x86\$164
## Voraussetzungen
Für diese Komponente gelten die folgenden Anforderungen:
+ Für die Secure Tunneling-Komponente stehen mindestens 32 MB Festplattenspeicher zur Verfügung. Diese Anforderung gilt nicht für die Greengrass-Kernsoftware oder andere Komponenten, die auf demselben Gerät ausgeführt werden.
+ Für die Secure Tunneling-Komponente sind mindestens 16 MB RAM verfügbar. Diese Anforderung gilt nicht für die Greengrass-Kernsoftware oder andere Komponenten, die auf demselben Gerät ausgeführt werden. Weitere Informationen finden Sie unter [Steuern Sie die Speicherzuweisung mit JVM-Optionen](configure-greengrass-core-v2.md#jvm-tuning).
+ GNU C Library (Glibc) Version 2.25 oder höher mit einem Linux-Kernel von 3.2 oder höher sind für die Secure Tunneling-Komponente Version 1.0.12 und höher erforderlich. Versionen des Betriebssystems und der Bibliotheken, deren Haltbarkeitsdatum für den langfristigen Support abgelaufen ist, werden nicht unterstützt. Sie sollten ein Betriebssystem und Bibliotheken mit langfristigem Support verwenden.
+ Sowohl das Betriebssystem als auch die Java-Runtime müssen als 64-Bit-Version installiert sein.
+ [Python](https://www.python.org/) 3.5 oder höher wurde auf dem Greengrass-Core-Gerät installiert und der Umgebungsvariablen PATH hinzugefügt.
+ `libcrypto.so.1.1`auf dem Greengrass-Core-Gerät installiert und zur Umgebungsvariablen PATH hinzugefügt.
+ Öffnen Sie den ausgehenden Verkehr auf Port 443 auf dem Greengrass-Core-Gerät.
+ Aktivieren Sie die Unterstützung für den Kommunikationsdienst, den Sie für die Kommunikation mit dem Greengrass Core-Gerät verwenden möchten. Um beispielsweise eine SSH-Verbindung zu dem Gerät herzustellen, müssen Sie SSH auf diesem Gerät aktivieren.
### 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](allow-device-traffic.md).
| Endpoint | Port | Erforderlich | Description |
| --- | --- | --- | --- |
| `data.tunneling.iot.region.amazonaws.com` | 443 | Ja | Richten Sie sichere Tunnel ein. |
## Abhängigkeiten
Wenn Sie eine Komponente bereitstellen, stellt sie 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](#secure-tunneling-component-changelog) 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](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.
------
#### [ 1.0.19 – 1.1.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 1.0.19 bis 1.1.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <3.0.0 | Weich |
------
#### [ 1.0.18 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.18 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Weich |
------
#### [ 1.0.16 – 1.0.17 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 1.0.16 bis 1.0.17 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Weich |
------
#### [ 1.0.14 – 1.0.15 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 1.0.14 bis 1.0.15 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Weich |
------
#### [ 1.0.11 – 1.0.13 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 1.0.11 — 1.0.13 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Weich |
------
#### [ 1.0.10 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.10 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Weich |
------
#### [ 1.0.9 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.9 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Weich |
------
#### [ 1.0.8 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.8 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Weich |
------
#### [ 1.0.5 - 1.0.7 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 1.0.5 bis 1.0.7 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Weich |
------
#### [ 1.0.4 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.4 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Weich |
------
#### [ 1.0.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Weich |
------
#### [ 1.0.2 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.2 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Weich |
------
#### [ 1.0.1 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.1 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Weich |
------
#### [ 1.0.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 1.0.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.3 <2.1.0 | Weich |
------
[Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den Komponentenrezepten.](component-recipe-reference.md#recipe-reference-component-dependencies)
## Konfiguration
Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.
`OS_DIST_INFO`
(Optional) Das Betriebssystem Ihres Kerngeräts. Standardmäßig versucht die Komponente, das auf Ihrem Kerngerät ausgeführte Betriebssystem automatisch zu identifizieren. Wenn die Komponente nicht mit dem Standardwert startet, verwenden Sie diesen Wert, um das Betriebssystem anzugeben. Eine Liste der unterstützten Betriebssysteme für diese Komponente finden Sie unter[Anforderungen an Speichergeräte](greengrass-nucleus-component.md#greengrass-v2-requirements).
Dieser Wert kann einer der folgenden sein:`auto`,`ubuntu`,`amzn2`,`raspberrypi`.
Standard: `auto`
`accessControl`
(Optional) Das Objekt, das die [Autorisierungsrichtlinie](interprocess-communication.md#ipc-authorization-policies) enthält, die es der Komponente ermöglicht, das Thema Secure Tunneling-Benachrichtigungen zu abonnieren.
Ändern Sie diesen Konfigurationsparameter nicht, wenn Ihre Bereitstellung auf eine Dinggruppe abzielt. Wenn Ihre Bereitstellung auf ein einzelnes Kerngerät abzielt und Sie dessen Abonnement auf das Thema des Geräts beschränken möchten, geben Sie den Ding-Namen des Kerngeräts an. Ersetzen Sie in dem `resources` Wert in der Autorisierungsrichtlinie des Geräts den Platzhalter für das MQTT-Thema durch den Ding-Namen des Geräts.
```
{
"aws.greengrass.ipc.mqttproxy": {
"aws.iot.SecureTunneling:mqttproxy:1": {
"policyDescription": "Access to tunnel notification pubsub topic",
"operations": [
"aws.greengrass#SubscribeToIoTCore"
],
"resources": [
"$aws/things/+/tunnels/notify"
]
}
}
}
```
**Example Beispiel: Aktualisierung der Zusammenführung von Konfigurationen**
Die folgende Beispielkonfiguration gibt an, **MyGreengrassCore** dass diese Komponente sichere Tunnel auf einem Kerngerät mit dem Namen Ubuntu öffnen kann.
```
{
"OS_DIST_INFO": "ubuntu",
"accessControl": {
"aws.greengrass.ipc.mqttproxy": {
"aws.iot.SecureTunneling:mqttproxy:1": {
"policyDescription": "Access to tunnel notification pubsub topic",
"operations": [
"aws.greengrass#SubscribeToIoTCore"
],
"resources": [
"$aws/things/MyGreengrassCore/tunnels/notify"
]
}
}
}
}
```
## Lokale Protokolldatei
Diese Komponente verwendet die folgende Protokolldatei.
```
/greengrass/v2/logs/aws.greengrass.SecureTunneling.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. `/greengrass/v2`Ersetzen Sie durch den Pfad zum AWS IoT Greengrass Stammordner.
```
sudo tail -f /greengrass/v2/logs/aws.greengrass.SecureTunneling.log
```
## Lizenzen
Diese Komponente umfasst die folgende Software/Lizenzierung von Drittanbietern:
+ [AWS IoT Geräteclient](https://github.com/awslabs/aws-iot-device-client) /Apache License 2.0
+ [AWS IoT Device SDK for Java](https://github.com/aws/aws-greengrass-core-sdk-java/)/Apache-Lizenz 2.0
+ [gson /Apache](https://github.com/google/gson) Lizenz 2.0
+ [log4j /Apache Lizenz 2.0](https://logging.apache.org/log4j/2.x/)
+ [slf4j /Apache Lizenz 2.0](http://www.slf4j.org/)
## Usage
Gehen Sie wie folgt vor, um die Secure Tunneling-Komponente auf Ihrem Gerät zu verwenden:
1. Stellen Sie die Secure Tunneling-Komponente auf Ihrem Gerät bereit.
1. Öffnen Sie die [AWS IoT -Konsole](https://console.aws.amazon.com/iot). Wählen Sie im linken Menü die Option **Remote-Aktionen** und dann **Sichere** Tunnel aus.
1. Erstellen Sie einen Tunnel zu Ihrem Greengrass-Gerät.
1. Laden Sie das Quellzugriffstoken herunter.
1. Verwenden Sie den lokalen Proxy mit dem Quellzugriffstoken, um eine Verbindung zu Ihrem Ziel herzustellen. Weitere Informationen finden Sie unter [So verwenden Sie den lokalen Proxy](https://docs.aws.amazon.com/iot/latest/developerguide/how-use-local-proxy.html) im *AWS IoT Entwicklerhandbuch*.
## Weitere Informationen finden Sie auch unter
+ [AWS IoT*sicheres Tunneling im Entwicklerhandbuch AWS IoT *](https://docs.aws.amazon.com/iot/latest/developerguide/secure-tunneling.html)
+ [Wie benutzt man den lokalen Proxy](https://docs.aws.amazon.com/iot/latest/developerguide/how-use-local-proxy.html) *im Developer Guide AWS IoT *
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| **Version** | **Änderungen** |
| --- | --- |
| 1.1.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/secure-tunneling-component.html) |
| 1.1.2 | Diese Version ist nicht mehr verfügbar. Die Verbesserungen in dieser Version sind in späteren Versionen dieser Komponente verfügbar. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/secure-tunneling-component.html) |
| 1.1.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/secure-tunneling-component.html) |
| 1.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/secure-tunneling-component.html) |
| 1.0.19 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/secure-tunneling-component.html) Wenn Sie den lokalen Secure Tunneling-Proxy als Tunnelquellclient verwenden, aktualisieren Sie Ihre Komponente erst auf diese Version, wenn Sie auch den lokalen Proxy auf Version 3.1.1 oder höher aktualisiert haben. |
| 1.0.18 | Die Version wurde für die Version 2.12.0 von Greengrass Nucleus aktualisiert. |
| 1.0.17 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/secure-tunneling-component.html) |
| 1.0.16 | Die Version wurde für die Version 2.11.0 von Greengrass Nucleus aktualisiert. |
| 1.0.15 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/secure-tunneling-component.html) |
| 1.0.14 | Die Version wurde für die Version 2.10.0 von Greengrass Nucleus aktualisiert. |
| 1.0.13 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/secure-tunneling-component.html) |
| 1.0.12 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/secure-tunneling-component.html) |
| 1.0.11 | Die Version wurde für die Version 2.9.0 von Greengrass Nucleus aktualisiert. |
| 1.0.10 | Die Version wurde für die Version 2.8.0 von Greengrass Nucleus aktualisiert. |
| 1.0.9 | Die Version wurde für die Version 2.7.0 von Greengrass Nucleus aktualisiert. |
| 1.0.8 | Die Version wurde für die Version 2.6.0 von Greengrass Nucleus aktualisiert. |
| 1.0.7 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/secure-tunneling-component.html) |
| 1.0.6 | Diese Version enthält Fehlerkorrekturen. |
| 1.0.5 | Die Version wurde für die Version 2.5.0 von Greengrass Nucleus aktualisiert. |
| 1.0.4 | Die Version wurde für die Version 2.4.0 von Greengrass Nucleus aktualisiert. |
| 1.0.3 | Die Version wurde für die Version 2.3.0 von Greengrass Nucleus aktualisiert. |
| 1.0.2 | Die Version wurde für die Version 2.2.0 von Greengrass Nucleus aktualisiert. |
| 1.0.1 | Die Version wurde für die Version 2.1.0 von Greengrass Nucleus aktualisiert. |
| 1.0.0 | Erste Version |
# Schattenmanager
Die Shadow-Manager-Komponente (`aws.greengrass.ShadowManager`) aktiviert den lokalen Shadow-Dienst auf Ihrem Kerngerät. Der lokale Shadow-Dienst ermöglicht es Komponenten, die Kommunikation zwischen Prozessen zu nutzen, um [mit lokalen Shadows zu interagieren](ipc-local-shadows.md). Die Shadow-Manager-Komponente verwaltet die Speicherung lokaler Shadow-Dokumente und kümmert sich auch um die Synchronisation lokaler Shadow-Zustände mit dem AWS IoT Device Shadow-Dienst.
Weitere Informationen darüber, wie Greengrass-Core-Geräte mit Schatten interagieren können, finden Sie unter[Interagiere mit Geräteschatten](interact-with-shadows.md).
**Topics**
+ [Versionen](#shadow-manager-component-versions)
+ [Typ](#shadow-manager-component-type)
+ [Betriebssystem](#shadow-manager-component-os-support)
+ [Voraussetzungen](#shadow-manager-component-requirements)
+ [Abhängigkeiten](#shadow-manager-component-dependencies)
+ [Konfiguration](#shadow-manager-component-configuration)
+ [Lokale Protokolldatei](#shadow-manager-component-log-file)
+ [Änderungsprotokoll](#shadow-manager-component-changelog)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 2.3.x
+ 2.2.x
+ 2.1.x
+ 2.0.x
## Typ
Diese Komponente ist eine Plugin-Komponente (`aws.greengrass.plugin`). Der [Greengrass-Kern führt diese Komponente in derselben Java Virtual Machine (JVM) wie der Nucleus](greengrass-nucleus-component.md) aus. Der Nucleus wird neu gestartet, wenn Sie die Version dieser Komponente auf dem Core-Gerät ändern.
Diese Komponente verwendet dieselbe Protokolldatei wie der Greengrass-Kern. Weitere Informationen finden Sie unter [AWS IoT Greengrass Protokolle überwachen](monitor-logs.md).
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## 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:
+ (Optional) Um Shadows mit dem AWS IoT Device Shadow-Dienst zu synchronisieren, muss die AWS IoT Richtlinie des Greengrass-Core-Geräts die folgenden AWS IoT Core Shadow-Richtlinienaktionen zulassen:
+ `iot:GetThingShadow`
+ `iot:UpdateThingShadow`
+ `iot:DeleteThingShadow`
Weitere Informationen zu diesen AWS IoT Core Richtlinien finden Sie unter [AWS IoT Core Richtlinienaktionen](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policy-actions.html) im *AWS IoT Entwicklerhandbuch*.
Weitere Informationen zur AWS IoT Mindestrichtlinie finden Sie unter [Minimale AWS IoT Richtlinie für AWS IoT Greengrass V2 Kerngeräte](device-auth.md#greengrass-core-minimal-iot-policy)
+ Die Shadow Manager-Komponente wird für die Ausführung in einer VPC unterstützt.
## Abhängigkeiten
Wenn Sie eine Komponente bereitstellen, stellt sie 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](#shadow-manager-component-changelog) 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](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.
------
#### [ 2.3.13 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.3.13 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,5,0 <2,17,0 | Weich |
------
#### [ 2.3.12 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.3.12 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,5,0 <2,17,0 | Weich |
------
#### [ 2.3.11 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.3.11 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,5,0 <2,16,0 | Weich |
------
#### [ 2.3.10 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.3.10 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,5,0 <2,15,0 | Weich |
------
#### [ 2.3.9 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.3.9 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,5,0 <2,14,0 | Weich |
------
#### [ 2.3.5 – 2.3.8 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.3.5 bis 2.3.8 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,5,0 <2,13,0 | Weich |
------
#### [ 2.3.3 and 2.3.4 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.3.3 und 2.3.4 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.5.0 <2.12.0 | Weich |
------
#### [ 2.3.2 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.3.2 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2,5,0 <2,11,0 | Weich |
------
#### [ 2.3.0 and 2.3.1 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.3.0 und 2.3.1 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.5.0 <2.10.0 | Weich |
------
#### [ 2.2.3 and 2.2.4 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.2.3 und 2.2.4 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.2.0 <3.0.0 | Weich |
------
#### [ 2.2.2 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.2.2 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.2.0 <2.9.0 | Weich |
------
#### [ 2.2.1 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.2.1 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.2.0 <2.8.0 | Weich |
------
#### [ 2.1.1 and 2.2.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.1.1 und 2.2.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.2.0 <2.7.0 | Weich |
------
#### [ 2.0.5 - 2.1.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.0.5 bis 2.1.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.2.0 <2.6.0 | Weich |
------
#### [ 2.0.3 and 2.0.4 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.0.3 und 2.0.4 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.2.0 <2.5.0 | Weich |
------
#### [ 2.0.1 and 2.0.2 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.0.1 und 2.0.2 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.2.0 <2.4.0 | Weich |
------
#### [ 2.0.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.2.0 <2.3.0 | Weich |
------
[Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den Komponentenrezepten.](component-recipe-reference.md#recipe-reference-component-dependencies)
## Konfiguration
Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.
------
#### [ 2.3.x ]
`strategy`
(Optional) Die Strategie, mit der diese Komponente Schatten zwischen AWS IoT Core und dem Kerngerät synchronisiert.
Dieses Objekt enthält die folgenden Informationen.
`type`
(Optional) Die Art der Strategie, die diese Komponente verwendet, um Schatten zwischen AWS IoT Core und dem Kerngerät zu synchronisieren. Wählen Sie aus den folgenden Optionen aus:
+ `realTime`— Synchronisiert Schatten bei AWS IoT Core jedem Shadow-Update.
+ `periodic`— Synchronisieren Sie Schatten in einem regelmäßigen Intervall, das Sie mit dem `delay` Konfigurationsparameter angeben. AWS IoT Core
Standard: `realTime`
`delay`
(Optional) Das Intervall in Sekunden, mit dem diese Komponente Schatten synchronisiert AWS IoT Core, wenn Sie die `periodic` Synchronisierungsstrategie angeben.
Dieser Parameter ist erforderlich, wenn Sie die `periodic` Synchronisierungsstrategie angeben.
`synchronize`
(Optional) Die Synchronisierungseinstellungen, die bestimmen, wie Schatten mit dem AWS Cloud synchronisiert werden.
Sie müssen ein Konfigurationsupdate mit dieser Eigenschaft erstellen, um Schatten mit dem AWS Cloud zu synchronisieren.
Dieses Objekt enthält die folgenden Informationen.
`coreThing`
(Optional) Das Core-Gerät wird zur Synchronisation gescrollt. Dieses Objekt enthält die folgenden Informationen.
`classic`
(Optional) Standardmäßig synchronisiert der Shadow-Manager den lokalen Status des klassischen Shadows für Ihr Kerngerät mit dem AWS Cloud. Wenn Sie den klassischen Geräteshadow nicht synchronisieren möchten, setzen Sie ihn auf`false`.
Standard: `true`
`namedShadows`
(Optional) Die Liste der benannten Core-Device-Shadows, die synchronisiert werden sollen. Sie müssen die genauen Namen der Schatten angeben.
Der AWS IoT Greengrass Dienst verwendet den `AWSManagedGreengrassV2Deployment` benannten Shadow, um Bereitstellungen zu verwalten, die auf einzelne Kerngeräte abzielen. Dieser benannte Shadow ist für die Verwendung durch den AWS IoT Greengrass Dienst reserviert. Aktualisieren oder löschen Sie diesen benannten Schatten nicht.
`shadowDocumentsMap`
(Optional) Die zusätzlichen Geräteschatten, die synchronisiert werden sollen. Die Verwendung dieses Konfigurationsparameters erleichtert die Angabe von Schattendokumenten. Es wird empfohlen, diesen Parameter anstelle des `shadowDocuments` Objekts zu verwenden.
Wenn Sie ein `shadowDocumentsMap` Objekt angeben, dürfen Sie kein `shadowDocuments` Objekt angeben.
Jedes Objekt enthält die folgenden Informationen:
*`thingName`*
Die Shadow-Konfiguration für die *thingName* für diese Shadow-Konfiguration.
`classic`
(Optional) Wenn Sie den klassischen Geräteshadow für das `thingName` Gerät nicht synchronisieren möchten, setzen Sie ihn auf`false`.
`namedShadows`
Die Liste der benannten Schatten, die Sie synchronisieren möchten. Sie müssen die genauen Namen der Schatten angeben.
`shadowDocuments`
(Optional) Die Liste der zusätzlichen Geräteschatten, die synchronisiert werden sollen. Wir empfehlen, stattdessen den `shadowDocumentsMap` Parameter zu verwenden.
Wenn Sie ein `shadowDocuments` Objekt angeben, dürfen Sie kein `shadowDocumentsMap` Objekt angeben.
Jedes Objekt in dieser Liste enthält die folgenden Informationen.
`thingName`
Der Dingname des Geräts, für das Schatten synchronisiert werden sollen.
`classic`
(Optional) Wenn Sie den klassischen Geräteshadow für das `thingName` Gerät nicht synchronisieren möchten, setzen Sie ihn auf`false`.
Standard: `true`
`namedShadows`
(Optional) Die Liste der benannten Geräteschatten, die Sie synchronisieren möchten. Sie müssen die genauen Namen der Schatten angeben.
`direction`
(Optional) Die Richtung, in der Schatten zwischen dem lokalen Shadow-Dienst und dem synchronisiert AWS Cloud werden sollen. Sie können diese Option konfigurieren, um die Bandbreite und die Verbindungen zum zu reduzieren AWS Cloud. Wählen Sie aus den folgenden Optionen aus:
+ `betweenDeviceAndCloud`— Synchronisiert Shadows zwischen dem lokalen Shadow-Dienst und dem AWS Cloud.
+ `deviceToCloud`— Sendet Shadow-Updates vom lokalen Shadow-Dienst an den AWS Cloud und ignoriert Shadow-Updates vom AWS Cloud.
+ `cloudToDevice`— Empfangen Sie Shadow-Updates vom AWS Cloud und senden Sie keine Shadow-Updates vom lokalen Shadow-Dienst an den AWS Cloud.
Standard: `BETWEEN_DEVICE_AND_CLOUD`
`rateLimits`
(Optional) Die Einstellungen, die die Ratenlimits für Shadow-Service-Anfragen festlegen.
Dieses Objekt enthält die folgenden Informationen.
`maxOutboundSyncUpdatesPerSecond`
(Optional) Die maximale Anzahl von Synchronisierungsanfragen pro Sekunde, die das Gerät überträgt.
Standard: 100 Anfragen/Sekunde
`maxTotalLocalRequestsRate`
(Optional) Die maximale Anzahl lokaler IPC-Anfragen pro Sekunde, die an das Kerngerät gesendet werden.
Standard: 200 Anfragen/Sekunde
`maxLocalRequestsPerSecondPerThing`
(Optional) Die maximale Anzahl lokaler IPC-Anfragen pro Sekunde, die für jedes verbundene IoT-Ding gesendet werden.
Standard: 20 requests/second für jedes Ding
Diese Parameter für die Ratenbegrenzung definieren die maximale Anzahl von Anfragen pro Sekunde für den lokalen Shadow-Dienst. Die maximale Anzahl von Anfragen pro Sekunde für den AWS IoT Device Shadow-Dienst hängt von Ihrem ab AWS-Region. Weitere Informationen finden Sie in den Grenzwerten für die [AWS IoT Device Shadow Service API](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) in der *Allgemeine Amazon Web Services-Referenz*.
`shadowDocumentSizeLimitBytes`
(Optional) Die maximal zulässige Größe jedes JSON-Statusdokuments für lokale Schatten.
Wenn Sie diesen Wert erhöhen, müssen Sie auch das Ressourcenlimit für das JSON-Statusdokument für Wolkenschatten erhöhen. Weitere Informationen finden Sie in den Grenzwerten für die [AWS IoT Device Shadow Service API](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) in der *Allgemeine Amazon Web Services-Referenz*.
Standard: 8192 Byte
Maximum: 30720 Byte
**Example Beispiel: Update zur Zusammenführung von Konfigurationen**
Das folgende Beispiel zeigt ein Beispiel für ein Update zur Zusammenführung von Konfigurationen mit allen verfügbaren Konfigurationsparametern für die Shadow Manager-Komponente.
```
{
"strategy":{
"type":"periodic",
"delay":300
},
"synchronize":{
"shadowDocumentsMap":{
"MyDevice1":{
"classic":false,
"namedShadows":[
"MyShadowA",
"MyShadowB"
]
},
"MyDevice2":{
"classic":true,
"namedShadows":[]
}
},
"direction":"betweenDeviceAndCloud"
},
"rateLimits":{
"maxOutboundSyncUpdatesPerSecond":100,
"maxTotalLocalRequestsRate":200,
"maxLocalRequestsPerSecondPerThing":20
},
"shadowDocumentSizeLimitBytes":8192
}
```
------
#### [ 2.2.x ]
`strategy`
(Optional) Die Strategie, die diese Komponente verwendet, um Schatten zwischen AWS IoT Core und dem Kerngerät zu synchronisieren.
Dieses Objekt enthält die folgenden Informationen.
`type`
(Optional) Die Art der Strategie, die diese Komponente verwendet, um Schatten zwischen AWS IoT Core und dem Kerngerät zu synchronisieren. Wählen Sie aus den folgenden Optionen aus:
+ `realTime`— Synchronisiert Schatten bei AWS IoT Core jedem Shadow-Update.
+ `periodic`— Synchronisieren Sie Schatten in einem regelmäßigen Intervall, das Sie mit dem `delay` Konfigurationsparameter angeben. AWS IoT Core
Standard: `realTime`
`delay`
(Optional) Das Intervall in Sekunden, mit dem diese Komponente Schatten synchronisiert AWS IoT Core, wenn Sie die `periodic` Synchronisierungsstrategie angeben.
Dieser Parameter ist erforderlich, wenn Sie die `periodic` Synchronisierungsstrategie angeben.
`synchronize`
(Optional) Die Synchronisierungseinstellungen, die bestimmen, wie Schatten mit dem AWS Cloud synchronisiert werden.
Sie müssen ein Konfigurationsupdate mit dieser Eigenschaft erstellen, um Schatten mit dem AWS Cloud zu synchronisieren.
Dieses Objekt enthält die folgenden Informationen.
`coreThing`
(Optional) Das Core-Gerät wird zur Synchronisation gescrollt. Dieses Objekt enthält die folgenden Informationen.
`classic`
(Optional) Standardmäßig synchronisiert der Shadow-Manager den lokalen Status des klassischen Shadows für Ihr Kerngerät mit dem AWS Cloud. Wenn Sie den klassischen Geräteshadow nicht synchronisieren möchten, setzen Sie ihn auf`false`.
Standard: `true`
`namedShadows`
(Optional) Die Liste der benannten Core-Device-Shadows, die synchronisiert werden sollen. Sie müssen die genauen Namen der Schatten angeben.
Der AWS IoT Greengrass Dienst verwendet den `AWSManagedGreengrassV2Deployment` benannten Shadow, um Bereitstellungen zu verwalten, die auf einzelne Kerngeräte abzielen. Dieser benannte Shadow ist für die Verwendung durch den AWS IoT Greengrass Dienst reserviert. Aktualisieren oder löschen Sie diesen benannten Schatten nicht.
`shadowDocumentsMap`
(Optional) Die zusätzlichen Geräteschatten, die synchronisiert werden sollen. Die Verwendung dieses Konfigurationsparameters erleichtert die Angabe von Schattendokumenten. Es wird empfohlen, diesen Parameter anstelle des `shadowDocuments` Objekts zu verwenden.
Wenn Sie ein `shadowDocumentsMap` Objekt angeben, dürfen Sie kein `shadowDocuments` Objekt angeben.
Jedes Objekt enthält die folgenden Informationen:
*`thingName`*
Die Shadow-Konfiguration für die *thingName* für diese Shadow-Konfiguration.
`classic`
(Optional) Wenn Sie den klassischen Geräteshadow für das `thingName` Gerät nicht synchronisieren möchten, setzen Sie ihn auf`false`.
`namedShadows`
Die Liste der benannten Schatten, die Sie synchronisieren möchten. Sie müssen die genauen Namen der Schatten angeben.
`shadowDocuments`
(Optional) Die Liste der zusätzlichen Geräteschatten, die synchronisiert werden sollen. Wir empfehlen, stattdessen den `shadowDocumentsMap` Parameter zu verwenden.
Wenn Sie ein `shadowDocuments` Objekt angeben, dürfen Sie kein `shadowDocumentsMap` Objekt angeben.
Jedes Objekt in dieser Liste enthält die folgenden Informationen.
`thingName`
Der Dingname des Geräts, für das Schatten synchronisiert werden sollen.
`classic`
(Optional) Wenn Sie den klassischen Geräteshadow für das `thingName` Gerät nicht synchronisieren möchten, setzen Sie ihn auf`false`.
Standard: `true`
`namedShadows`
(Optional) Die Liste der benannten Geräteschatten, die Sie synchronisieren möchten. Sie müssen die genauen Namen der Schatten angeben.
`direction`
(Optional) Die Richtung, in der Schatten zwischen dem lokalen Shadow-Dienst und dem synchronisiert AWS Cloud werden sollen. Sie können diese Option konfigurieren, um die Bandbreite und die Verbindungen zum zu reduzieren AWS Cloud. Wählen Sie aus den folgenden Optionen aus:
+ `betweenDeviceAndCloud`— Synchronisiert Shadows zwischen dem lokalen Shadow-Dienst und dem AWS Cloud.
+ `deviceToCloud`— Sendet Shadow-Updates vom lokalen Shadow-Dienst an den AWS Cloud und ignoriert Shadow-Updates vom AWS Cloud.
+ `cloudToDevice`— Empfangen Sie Shadow-Updates vom AWS Cloud und senden Sie keine Shadow-Updates vom lokalen Shadow-Dienst an den AWS Cloud.
Standard: `BETWEEN_DEVICE_AND_CLOUD`
`rateLimits`
(Optional) Die Einstellungen, die die Ratenlimits für Shadow-Service-Anfragen festlegen.
Dieses Objekt enthält die folgenden Informationen.
`maxOutboundSyncUpdatesPerSecond`
(Optional) Die maximale Anzahl von Synchronisierungsanfragen pro Sekunde, die das Gerät überträgt.
Standard: 100 Anfragen/Sekunde
`maxTotalLocalRequestsRate`
(Optional) Die maximale Anzahl lokaler IPC-Anfragen pro Sekunde, die an das Kerngerät gesendet werden.
Standard: 200 Anfragen/Sekunde
`maxLocalRequestsPerSecondPerThing`
(Optional) Die maximale Anzahl lokaler IPC-Anfragen pro Sekunde, die für jedes verbundene IoT-Ding gesendet werden.
Standard: 20 requests/second für jedes Ding
Diese Parameter für die Ratenbegrenzung definieren die maximale Anzahl von Anfragen pro Sekunde für den lokalen Shadow-Dienst. Die maximale Anzahl von Anfragen pro Sekunde für den AWS IoT Device Shadow-Dienst hängt von Ihrem ab AWS-Region. Weitere Informationen finden Sie in den Grenzwerten für die [AWS IoT Device Shadow Service API](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) in der *Allgemeine Amazon Web Services-Referenz*.
`shadowDocumentSizeLimitBytes`
(Optional) Die maximal zulässige Größe jedes JSON-Statusdokuments für lokale Schatten.
Wenn Sie diesen Wert erhöhen, müssen Sie auch das Ressourcenlimit für das JSON-Statusdokument für Wolkenschatten erhöhen. Weitere Informationen finden Sie in den Grenzwerten für die [AWS IoT Device Shadow Service API](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) in der *Allgemeine Amazon Web Services-Referenz*.
Standard: 8192 Byte
Maximum: 30720 Byte
**Example Beispiel: Update zur Zusammenführung von Konfigurationen**
Das folgende Beispiel zeigt ein Beispiel für ein Update zur Zusammenführung von Konfigurationen mit allen verfügbaren Konfigurationsparametern für die Shadow Manager-Komponente.
```
{
"strategy":{
"type":"periodic",
"delay":300
},
"synchronize":{
"shadowDocumentsMap":{
"MyDevice1":{
"classic":false,
"namedShadows":[
"MyShadowA",
"MyShadowB"
]
},
"MyDevice2":{
"classic":true,
"namedShadows":[]
}
},
"direction":"betweenDeviceAndCloud"
},
"rateLimits":{
"maxOutboundSyncUpdatesPerSecond":100,
"maxTotalLocalRequestsRate":200,
"maxLocalRequestsPerSecondPerThing":20
},
"shadowDocumentSizeLimitBytes":8192
}
```
------
#### [ 2.1.x ]
`strategy`
(Optional) Die Strategie, die diese Komponente verwendet, um Schatten zwischen AWS IoT Core und dem Kerngerät zu synchronisieren.
Dieses Objekt enthält die folgenden Informationen.
`type`
(Optional) Die Art der Strategie, die diese Komponente verwendet, um Schatten zwischen AWS IoT Core und dem Kerngerät zu synchronisieren. Wählen Sie aus den folgenden Optionen aus:
+ `realTime`— Synchronisiert Schatten bei AWS IoT Core jedem Shadow-Update.
+ `periodic`— Synchronisieren Sie Schatten in einem regelmäßigen Intervall, das Sie mit dem `delay` Konfigurationsparameter angeben. AWS IoT Core
Standard: `realTime`
`delay`
(Optional) Das Intervall in Sekunden, mit dem diese Komponente Schatten synchronisiert AWS IoT Core, wenn Sie die `periodic` Synchronisierungsstrategie angeben.
Dieser Parameter ist erforderlich, wenn Sie die `periodic` Synchronisierungsstrategie angeben.
`synchronize`
(Optional) Die Synchronisierungseinstellungen, die bestimmen, wie Schatten mit dem AWS Cloud synchronisiert werden.
Sie müssen ein Konfigurationsupdate mit dieser Eigenschaft erstellen, um Schatten mit dem AWS Cloud zu synchronisieren.
Dieses Objekt enthält die folgenden Informationen.
`coreThing`
(Optional) Das Core-Gerät wird zur Synchronisation gescrollt. Dieses Objekt enthält die folgenden Informationen.
`classic`
(Optional) Standardmäßig synchronisiert der Shadow-Manager den lokalen Status des klassischen Shadows für Ihr Kerngerät mit dem AWS Cloud. Wenn Sie den klassischen Geräteshadow nicht synchronisieren möchten, setzen Sie ihn auf`false`.
Standard: `true`
`namedShadows`
(Optional) Die Liste der benannten Core-Device-Shadows, die synchronisiert werden sollen. Sie müssen die genauen Namen der Schatten angeben.
Der AWS IoT Greengrass Dienst verwendet den `AWSManagedGreengrassV2Deployment` benannten Shadow, um Bereitstellungen zu verwalten, die auf einzelne Kerngeräte abzielen. Dieser benannte Shadow ist für die Verwendung durch den AWS IoT Greengrass Dienst reserviert. Aktualisieren oder löschen Sie diesen benannten Schatten nicht.
`shadowDocumentsMap`
(Optional) Die zusätzlichen Geräteschatten, die synchronisiert werden sollen. Die Verwendung dieses Konfigurationsparameters erleichtert die Angabe von Schattendokumenten. Es wird empfohlen, diesen Parameter anstelle des `shadowDocuments` Objekts zu verwenden.
Wenn Sie ein `shadowDocumentsMap` Objekt angeben, dürfen Sie kein `shadowDocuments` Objekt angeben.
Jedes Objekt enthält die folgenden Informationen:
*`thingName`*
Die Shadow-Konfiguration für die *thingName* für diese Shadow-Konfiguration.
`classic`
(Optional) Wenn Sie den klassischen Geräteshadow für das `thingName` Gerät nicht synchronisieren möchten, setzen Sie ihn auf`false`.
`namedShadows`
Die Liste der benannten Schatten, die Sie synchronisieren möchten. Sie müssen die genauen Namen der Schatten angeben.
`shadowDocuments`
(Optional) Die Liste der zusätzlichen Geräteschatten, die synchronisiert werden sollen. Wir empfehlen, stattdessen den `shadowDocumentsMap` Parameter zu verwenden.
Wenn Sie ein `shadowDocuments` Objekt angeben, dürfen Sie kein `shadowDocumentsMap` Objekt angeben.
Jedes Objekt in dieser Liste enthält die folgenden Informationen.
`thingName`
Der Dingname des Geräts, für das Schatten synchronisiert werden sollen.
`classic`
(Optional) Wenn Sie den klassischen Geräteshadow für das `thingName` Gerät nicht synchronisieren möchten, setzen Sie ihn auf`false`.
Standard: `true`
`namedShadows`
(Optional) Die Liste der benannten Geräteschatten, die Sie synchronisieren möchten. Sie müssen die genauen Namen der Schatten angeben.
`rateLimits`
(Optional) Die Einstellungen, die die Ratenlimits für Shadow-Service-Anfragen festlegen.
Dieses Objekt enthält die folgenden Informationen.
`maxOutboundSyncUpdatesPerSecond`
(Optional) Die maximale Anzahl von Synchronisierungsanfragen pro Sekunde, die das Gerät überträgt.
Standard: 100 Anfragen/Sekunde
`maxTotalLocalRequestsRate`
(Optional) Die maximale Anzahl lokaler IPC-Anfragen pro Sekunde, die an das Kerngerät gesendet werden.
Standard: 200 Anfragen/Sekunde
`maxLocalRequestsPerSecondPerThing`
(Optional) Die maximale Anzahl lokaler IPC-Anfragen pro Sekunde, die für jedes verbundene IoT-Ding gesendet werden.
Standard: 20 requests/second für jedes Ding
Diese Parameter für die Ratenbegrenzung definieren die maximale Anzahl von Anfragen pro Sekunde für den lokalen Shadow-Dienst. Die maximale Anzahl von Anfragen pro Sekunde für den AWS IoT Device Shadow-Dienst hängt von Ihrem ab AWS-Region. Weitere Informationen finden Sie in den Grenzwerten für die [AWS IoT Device Shadow Service API](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) in der *Allgemeine Amazon Web Services-Referenz*.
`shadowDocumentSizeLimitBytes`
(Optional) Die maximal zulässige Größe jedes JSON-Statusdokuments für lokale Schatten.
Wenn Sie diesen Wert erhöhen, müssen Sie auch das Ressourcenlimit für das JSON-Statusdokument für Wolkenschatten erhöhen. Weitere Informationen finden Sie in den Grenzwerten für die [AWS IoT Device Shadow Service API](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) in der *Allgemeine Amazon Web Services-Referenz*.
Standard: 8192 Byte
Maximum: 30720 Byte
**Example Beispiel: Update zur Zusammenführung von Konfigurationen**
Das folgende Beispiel zeigt ein Beispiel für ein Update zur Zusammenführung von Konfigurationen mit allen verfügbaren Konfigurationsparametern für die Shadow Manager-Komponente.
```
{
"strategy":{
"type":"periodic",
"delay":300
},
"synchronize":{
"shadowDocumentsMap":{
"MyDevice1":{
"classic":false,
"namedShadows":[
"MyShadowA",
"MyShadowB"
]
},
"MyDevice2":{
"classic":true,
"namedShadows":[]
}
},
"direction":"betweenDeviceAndCloud"
},
"rateLimits":{
"maxOutboundSyncUpdatesPerSecond":100,
"maxTotalLocalRequestsRate":200,
"maxLocalRequestsPerSecondPerThing":20
},
"shadowDocumentSizeLimitBytes":8192
}
```
------
#### [ 2.0.x ]
`synchronize`
(Optional) Die Synchronisierungseinstellungen, die bestimmen, wie Schatten mit dem AWS Cloud synchronisiert werden.
Sie müssen ein Konfigurationsupdate mit dieser Eigenschaft erstellen, um Schatten mit dem AWS Cloud zu synchronisieren.
Dieses Objekt enthält die folgenden Informationen.
`coreThing`
(Optional) Das Core-Gerät wird zur Synchronisation gescrollt. Dieses Objekt enthält die folgenden Informationen.
`classic`
(Optional) Standardmäßig synchronisiert der Shadow-Manager den lokalen Status des klassischen Shadows für Ihr Kerngerät mit dem AWS Cloud. Wenn Sie den klassischen Geräteshadow nicht synchronisieren möchten, setzen Sie ihn auf`false`.
Standard: `true`
`namedShadows`
(Optional) Die Liste der benannten Core-Device-Shadows, die synchronisiert werden sollen. Sie müssen die genauen Namen der Schatten angeben.
Der AWS IoT Greengrass Dienst verwendet den `AWSManagedGreengrassV2Deployment` benannten Shadow, um Bereitstellungen zu verwalten, die auf einzelne Kerngeräte abzielen. Dieser benannte Shadow ist für die Verwendung durch den AWS IoT Greengrass Dienst reserviert. Aktualisieren oder löschen Sie diesen benannten Schatten nicht.
`shadowDocumentsMap`
(Optional) Die zusätzlichen Geräteschatten, die synchronisiert werden sollen. Die Verwendung dieses Konfigurationsparameters erleichtert die Angabe von Schattendokumenten. Es wird empfohlen, diesen Parameter anstelle des `shadowDocuments` Objekts zu verwenden.
Wenn Sie ein `shadowDocumentsMap` Objekt angeben, dürfen Sie kein `shadowDocuments` Objekt angeben.
Jedes Objekt enthält die folgenden Informationen:
*`thingName`*
Die Shadow-Konfiguration für die *thingName* für diese Shadow-Konfiguration.
`classic`
(Optional) Wenn Sie den klassischen Geräteshadow für das `thingName` Gerät nicht synchronisieren möchten, setzen Sie ihn auf`false`.
`namedShadows`
Die Liste der benannten Schatten, die Sie synchronisieren möchten. Sie müssen die genauen Namen der Schatten angeben.
`shadowDocuments`
(Optional) Die Liste der zusätzlichen Geräteschatten, die synchronisiert werden sollen. Wir empfehlen, stattdessen den `shadowDocumentsMap` Parameter zu verwenden.
Wenn Sie ein `shadowDocuments` Objekt angeben, dürfen Sie kein `shadowDocumentsMap` Objekt angeben.
Jedes Objekt in dieser Liste enthält die folgenden Informationen.
`thingName`
Der Dingname des Geräts, für das Schatten synchronisiert werden sollen.
`classic`
(Optional) Wenn Sie den klassischen Geräteshadow für das `thingName` Gerät nicht synchronisieren möchten, setzen Sie ihn auf`false`.
Standard: `true`
`namedShadows`
(Optional) Die Liste der benannten Geräteschatten, die Sie synchronisieren möchten. Sie müssen die genauen Namen der Schatten angeben.
`rateLimits`
(Optional) Die Einstellungen, die die Ratenlimits für Shadow-Service-Anfragen festlegen.
Dieses Objekt enthält die folgenden Informationen.
`maxOutboundSyncUpdatesPerSecond`
(Optional) Die maximale Anzahl von Synchronisierungsanfragen pro Sekunde, die das Gerät überträgt.
Standard: 100 Anfragen/Sekunde
`maxTotalLocalRequestsRate`
(Optional) Die maximale Anzahl lokaler IPC-Anfragen pro Sekunde, die an das Kerngerät gesendet werden.
Standard: 200 Anfragen/Sekunde
`maxLocalRequestsPerSecondPerThing`
(Optional) Die maximale Anzahl lokaler IPC-Anfragen pro Sekunde, die für jedes verbundene IoT-Ding gesendet werden.
Standard: 20 requests/second für jedes Ding
Diese Parameter für die Ratenbegrenzung definieren die maximale Anzahl von Anfragen pro Sekunde für den lokalen Shadow-Dienst. Die maximale Anzahl von Anfragen pro Sekunde für den AWS IoT Device Shadow-Dienst hängt von Ihrem ab AWS-Region. Weitere Informationen finden Sie in den Grenzwerten für die [AWS IoT Device Shadow Service API](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) in der *Allgemeine Amazon Web Services-Referenz*.
`shadowDocumentSizeLimitBytes`
(Optional) Die maximal zulässige Größe jedes JSON-Statusdokuments für lokale Schatten.
Wenn Sie diesen Wert erhöhen, müssen Sie auch das Ressourcenlimit für das JSON-Statusdokument für Wolkenschatten erhöhen. Weitere Informationen finden Sie in den Grenzwerten für die [AWS IoT Device Shadow Service API](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#device-shadow-limits) in der *Allgemeine Amazon Web Services-Referenz*.
Standard: 8192 Byte
Maximum: 30720 Byte
**Example Beispiel: Update zur Zusammenführung von Konfigurationen**
Das folgende Beispiel zeigt ein Beispiel für ein Update zur Zusammenführung von Konfigurationen mit allen verfügbaren Konfigurationsparametern für die Shadow Manager-Komponente.
```
{
"synchronize": {
"coreThing": {
"classic": true,
"namedShadows": [
"MyCoreShadowA",
"MyCoreShadowB"
]
},
"shadowDocuments": [
{
"thingName": "MyDevice1",
"classic": false,
"namedShadows": [
"MyShadowA",
"MyShadowB"
]
},
{
"thingName": "MyDevice2",
"classic": true,
"namedShadows": []
}
]
},
"rateLimits": {
"maxOutboundSyncUpdatesPerSecond": 100,
"maxTotalLocalRequestsRate": 200,
"maxLocalRequestsPerSecondPerThing": 20
},
"shadowDocumentSizeLimitBytes": 8192
}
```
------
## Lokale Protokolldatei
Diese Komponente verwendet dieselbe Protokolldatei wie die [Greengrass Nucleus-Komponente](greengrass-nucleus-component.md).
------
#### [ Linux ]
```
/greengrass/v2/logs/greengrass.log
```
------
#### [ Windows ]
```
C:\greengrass\v2\logs\greengrass.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:\$1greengrass\$1v2* durch den Pfad zum AWS IoT Greengrass Stammordner.
------
#### [ Linux ]
```
sudo tail -f /greengrass/v2/logs/greengrass.log
```
------
#### [ Windows (PowerShell) ]
```
Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
```
------
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| Version | Änderungen |
| --- | --- |
| 2.3.13 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/shadow-manager-component.html) |
| 2.3.12 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/shadow-manager-component.html) |
| 2.3.11 | Die Version wurde für die Version 2.15.0 von Greengrass Nucleus aktualisiert. |
| 2.3.10 | Die Version wurde für die Version 2.14.0 von Greengrass Nucleus aktualisiert. |
| 2.3.9 | Die Version wurde für die Version 2.13.0 von Greengrass Nucleus aktualisiert. |
| 2.3.8 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/shadow-manager-component.html) |
| 2.3.7 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/shadow-manager-component.html) |
| 2.3.6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/shadow-manager-component.html) |
| 2.3.5 | Die Version wurde für die Version 2.12.0 von Greengrass Nucleus aktualisiert. |
| 2.3.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/shadow-manager-component.html) |
| 2.3.3 | Die Version wurde für die Version 2.11.0 von Greengrass Nucleus aktualisiert. |
| 2.3.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/shadow-manager-component.html) |
| 2.3.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/shadow-manager-component.html) |
| 2.3.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/shadow-manager-component.html) |
| 2.2.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/shadow-manager-component.html) |
| 2.2.3 | Die Version wurde für die Version 2.9.0 von Greengrass Nucleus aktualisiert. |
| 2.2.2 | Die Version wurde für die Version 2.8.0 von Greengrass Nucleus aktualisiert. |
| 2.2.1 | Die Version wurde für die Version 2.7.0 von Greengrass Nucleus aktualisiert. |
| 2.2.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/shadow-manager-component.html) |
| 2.1.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/shadow-manager-component.html) |
| 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/shadow-manager-component.html) |
| 2.0.6 | Diese Version enthält Fehlerkorrekturen und Verbesserungen. |
| 2.0.5 | Die Version wurde für die Version 2.5.0 von Greengrass Nucleus aktualisiert. |
| 2.0.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/shadow-manager-component.html) |
| 2.0.3 | Die Version wurde für die Version 2.4.0 von Greengrass Nucleus aktualisiert. |
| 2.0.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/shadow-manager-component.html) |
| 2.0.1 | Die Version wurde für die Version 2.3.0 von Greengrass Nucleus aktualisiert. |
| 2.0.0 | Erste Version |
# Amazon SNS
Die Amazon SNS-Komponente (`aws.greengrass.SNS`) veröffentlicht Nachrichten zu einem Amazon Simple Notification Service (Amazon SNS) -Thema. Sie können diese Komponente verwenden, um Ereignisse von Greengrass-Core-Geräten an Webserver, E-Mail-Adressen und andere Nachrichtenabonnenten zu senden. Weitere Informationen finden Sie unter [Was ist Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/welcome.html)? im *Amazon Simple Notification Service Developer Guide*.
Um mit dieser Komponente in einem Amazon SNS SNS-Thema zu veröffentlichen, veröffentlichen Sie eine Nachricht zu dem Thema, das diese Komponente abonniert. Standardmäßig abonniert diese Komponente das `sns/message` [lokale](ipc-publish-subscribe.md) Thema „Veröffentlichen/Abonnieren“. Sie können andere Themen angeben, einschließlich AWS IoT Core MQTT-Themen, wenn Sie diese Komponente bereitstellen.
In Ihrer benutzerdefinierten Komponente möchten Sie möglicherweise eine Filter- oder Formatierungslogik implementieren, um Nachrichten aus anderen Quellen zu verarbeiten, bevor Sie sie in dieser Komponente veröffentlichen. Auf diese Weise können Sie Ihre Nachrichtenverarbeitungslogik in einer einzigen Komponente zentralisieren.
**Anmerkung**
Diese Komponente bietet ähnliche Funktionen wie der Amazon SNS SNS-Connector in AWS IoT Greengrass Version 1. Weitere Informationen finden Sie unter [Amazon SNS Connector](https://docs.aws.amazon.com/greengrass/latest/developerguide/sns-connector.html) im *AWS IoT Greengrass V1-Entwicklerhandbuch*.
**Topics**
+ [Versionen](#sns-component-versions)
+ [Typ](#sns-component-type)
+ [Betriebssystem](#sns-component-os-support)
+ [Voraussetzungen](#sns-component-requirements)
+ [Abhängigkeiten](#sns-component-dependencies)
+ [Konfiguration](#sns-component-configuration)
+ [Eingabedaten](#sns-component-input-data)
+ [Ausgabedaten](#sns-component-output-data)
+ [Lokale Protokolldatei](#sns-component-log-file)
+ [Lizenzen](#sns-component-licenses)
+ [Änderungsprotokoll](#sns-component-changelog)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 2.1.x
+ 2.0.x
## Typ
Diese Komponente ist eine Lambda-Komponente (`aws.greengrass.lambda`). [Der [Greengrass-Kern führt die](greengrass-nucleus-component.md) Lambda-Funktion dieser Komponente mithilfe der Lambda-Launcher-Komponente aus.](lambda-launcher-component.md)
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## Betriebssystem
Diese Komponente kann nur auf Linux-Kerngeräten installiert werden.
## Voraussetzungen
Für diese Komponente gelten die folgenden Anforderungen:
+ Ihr Kerngerät muss die Anforderungen für die Ausführung von Lambda-Funktionen erfüllen. Wenn Sie möchten, dass das Kerngerät containerisierte Lambda-Funktionen ausführt, muss das Gerät die entsprechenden Anforderungen erfüllen. Weitere Informationen finden Sie unter [Anforderungen an die Lambda-Funktion](setting-up.md#greengrass-v2-lambda-requirements).
+ [Python-Version](https://www.python.org/) 3.7 wurde auf dem Core-Gerät installiert und zur Umgebungsvariablen PATH hinzugefügt.
+ Amazon SNS-Thema. Weitere Informationen finden Sie unter [Amazon SNS-Thema anlegen](https://docs.aws.amazon.com/sns/latest/dg/sns-create-topic.html) im *Amazon Simple Notification Service-Entwicklerhandbuch*.
+ Die [Greengrass-Geräterolle](device-service-role.md) muss die `sns:Publish` Aktion zulassen, wie im folgenden Beispiel für eine IAM-Richtlinie gezeigt.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"sns:Publish"
],
"Effect": "Allow",
"Resource": [
"arn:aws:sns:us-east-1:123456789012:topic-name"
]
}
]
}
```
------
Sie können das Standardthema in der Nutzlast der Eingabenachricht für diese Komponente dynamisch überschreiben. Wenn Ihre Anwendung diese Funktion verwendet, muss die IAM-Richtlinie alle Zielthemen als Ressourcen enthalten. Sie können Ressourcen granularen oder bedingten Zugriff gewähren (etwa mit einem Benennungsschema mit Platzhaltern `*`).
+ Um Ausgabedaten von dieser Komponente zu erhalten, müssen Sie bei der Bereitstellung dieser Komponente das folgende Konfigurationsupdate für die [ältere Abonnement-Router-Komponente](legacy-subscription-router-component.md) (`aws.greengrass.LegacySubscriptionRouter`) zusammenführen. Diese Konfiguration gibt das Thema an, zu dem diese Komponente Antworten veröffentlicht.
------
#### [ Legacy subscription router v2.1.x ]
```
{
"subscriptions": {
"aws-greengrass-sns": {
"id": "aws-greengrass-sns",
"source": "component:aws.greengrass.SNS",
"subject": "sns/message/status",
"target": "cloud"
}
}
}
```
------
#### [ Legacy subscription router v2.0.x ]
```
{
"subscriptions": {
"aws-greengrass-sns": {
"id": "aws-greengrass-sns",
"source": "arn:aws:lambda:region:aws:function:aws-greengrass-sns:version",
"subject": "sns/message/status",
"target": "cloud"
}
}
}
```
+ *region*Ersetzen Sie es durch AWS-Region das, was Sie verwenden.
+ *version*Ersetzen Sie durch die Version der Lambda-Funktion, die diese Komponente ausführt. Um die Version der Lambda-Funktion zu finden, müssen Sie sich das Rezept für die Version dieser Komponente ansehen, die Sie bereitstellen möchten. Öffnen Sie die Detailseite dieser Komponente in der [AWS IoT Greengrass Konsole](https://console.aws.amazon.com//greengrass) und suchen Sie nach dem **Schlüssel-Wert-Paar der Lambda-Funktion**. Dieses Schlüssel-Wert-Paar enthält den Namen und die Version der Lambda-Funktion.
**Wichtig**
Sie müssen die Lambda-Funktionsversion auf dem Legacy-Abonnement-Router jedes Mal aktualisieren, wenn Sie diese Komponente bereitstellen. Dadurch wird sichergestellt, dass Sie die richtige Lambda-Funktionsversion für die Komponentenversion verwenden, die Sie bereitstellen.
------
Weitere Informationen finden Sie unter [Erstellen von Bereitstellungen](create-deployments.md).
+ Die Amazon SNS SNS-Komponente wird für die Ausführung in einer VPC unterstützt. Um diese Komponente in einer VPC bereitzustellen, ist Folgendes erforderlich.
+ Die Amazon SNS SNS-Komponente muss über Konnektivität verfügen`sns.region.amazonaws.com`, zu der der VPC-Endpunkt ist. `com.amazonaws.us-east-1.sns`
### 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](allow-device-traffic.md).
| Endpoint | Port | Erforderlich | Description |
| --- | --- | --- | --- |
| `sns.region.amazonaws.com` | 443 | Ja | Veröffentlichen Sie Nachrichten in Amazon SNS. |
## Abhängigkeiten
Wenn Sie eine Komponente bereitstellen, stellt sie 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](#sns-component-changelog) 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](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.
------
#### [ 2.1.10 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.10 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.16.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.1.9 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.9 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.15.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.1.8 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.8 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.14.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.1.7 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.7 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.1.6 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.6 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.1.5 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.5 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.1.4 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.4 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.1.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.1.2 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.2 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.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](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.0.8 - 2.1.0 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.0.8 und 2.1.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.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](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.0.6 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.6 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.0.5 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.5 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.0.4 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.4 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | ^2.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | ^2,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | ^2.0.0 | Hart |
------
#### [ 2.0.3 ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.3 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.3 <2.1.0 | Hart |
| [Lambda-Launcher](lambda-launcher-component.md) | >=1.0.0 | Hart |
| [Lambda-Laufzeiten](lambda-runtimes-component.md) | >=1,0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | >=1.0.0 | Hart |
------
Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den [Komponentenrezepten](component-recipe-reference.md#recipe-reference-component-dependencies).
## Konfiguration
Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.
**Anmerkung**
Die Standardkonfiguration dieser Komponente umfasst Lambda-Funktionsparameter. Wir empfehlen, dass Sie nur die folgenden Parameter bearbeiten, um diese Komponente auf Ihren Geräten zu konfigurieren.
`lambdaParams`
Ein Objekt, das die Parameter für die Lambda-Funktion dieser Komponente enthält. Dieses Objekt enthält die folgenden Informationen:
`EnvironmentVariables`
Ein Objekt, das die Parameter der Lambda-Funktion enthält. Dieses Objekt enthält die folgenden Informationen:
`DEFAULT_SNS_ARN`
Der ARN des Amazon SNS SNS-Standardthemas, in dem diese Komponente Nachrichten veröffentlicht. Sie können das Zielthema mit der `sns_topic_arn` Eigenschaft in der Nutzlast der Eingabenachricht überschreiben.
`containerMode`
(Optional) Der Containerisierungsmodus für diese Komponente. Wählen Sie aus den folgenden Optionen aus:
+ `NoContainer`— Die Komponente wird nicht in einer isolierten Laufzeitumgebung ausgeführt.
+ `GreengrassContainer`— Die Komponente läuft in einer isolierten Laufzeitumgebung innerhalb des AWS IoT Greengrass Containers.
Standard: `GreengrassContainer`
`containerParams`
(Optional) Ein Objekt, das die Container-Parameter für diese Komponente enthält. Die Komponente verwendet diese Parameter, wenn Sie `GreengrassContainer` für angeben`containerMode`.
Dieses Objekt enthält die folgenden Informationen:
`memorySize`
(Optional) Die Speichermenge (in Kilobyte), die der Komponente zugewiesen werden soll.
Der Standardwert ist 512 MB (525.312 KB).
`pubsubTopics`
(Optional) Ein Objekt, das die Themen enthält, in denen die Komponente den Empfang von Nachrichten abonniert. Sie können jedes Thema angeben und angeben, ob die Komponente MQTT-Themen von AWS IoT Core oder lokale Themen abonniert. publish/subscribe
Dieses Objekt enthält die folgenden Informationen:
`0`— Dies ist ein Array-Index als Zeichenfolge.
Ein Objekt, das die folgenden Informationen enthält:
`type`
(Optional) Der publish/subscribe Messaging-Typ, den diese Komponente verwendet, um Nachrichten zu abonnieren. Wählen Sie aus den folgenden Optionen aus:
+ `PUB_SUB` — Abonnieren Sie lokale Veröffentlichen/Abonnement-Nachrichten. Wenn Sie diese Option wählen, darf das Thema keine MQTT-Platzhalter enthalten. Weitere Informationen zum Senden von Nachrichten von einer benutzerdefinierten Komponente aus, wenn Sie diese Option angeben, finden Sie unter. [Lokale Nachrichten veröffentlichen/abonnieren](ipc-publish-subscribe.md)
+ `IOT_CORE`— Abonnieren Sie AWS IoT Core MQTT-Nachrichten. Wenn Sie diese Option wählen, kann das Thema MQTT-Platzhalter enthalten. Weitere Informationen zum Senden von Nachrichten aus benutzerdefinierten Komponenten, wenn Sie diese Option angeben, finden Sie unter. [MQTT-Nachrichten veröffentlichen/abonnieren AWS IoT Core](ipc-iot-core-mqtt.md)
Standard: `PUB_SUB`
`topic`
(Optional) Das Thema, das die Komponente abonniert, um Nachrichten zu empfangen. Wenn Sie `IotCore` für angeben`type`, können Sie in diesem Thema MQTT-Platzhalter (`+`und`#`) verwenden.
**Example Beispiel: Aktualisierung der Konfigurationszusammenführung (Container-Modus)**
```
{
"lambdaExecutionParameters": {
"EnvironmentVariables": {
"DEFAULT_SNS_ARN": "arn:aws:sns:us-west-2:123456789012:mytopic"
}
},
"containerMode": "GreengrassContainer"
}
```
**Example Beispiel: Aktualisierung der Konfigurationszusammenführung (kein Container-Modus)**
```
{
"lambdaExecutionParameters": {
"EnvironmentVariables": {
"DEFAULT_SNS_ARN": "arn:aws:sns:us-west-2:123456789012:mytopic"
}
},
"containerMode": "NoContainer"
}
```
## Eingabedaten
Diese Komponente akzeptiert Nachrichten zum folgenden Thema und veröffentlicht die Nachricht unverändert im Amazon SNS SNS-Zielthema. Standardmäßig abonniert diese Komponente lokale publish/subscribe Nachrichten. Weitere Informationen zum Veröffentlichen von Nachrichten aus Ihren benutzerdefinierten Komponenten in dieser Komponente finden Sie unter[Lokale Nachrichten veröffentlichen/abonnieren](ipc-publish-subscribe.md).
**Standardthema (lokales Veröffentlichen/Abonnieren):** `sns/message`
Die Nachricht akzeptiert die folgenden Eigenschaften. Eingabenachrichten müssen im JSON-Format vorliegen.
`request`
Die Informationen zu der Nachricht, die an das Amazon SNS SNS-Thema gesendet werden soll.
Typ: der `object` die folgenden Informationen enthält:
`message`
Der Inhalt der Nachricht als Zeichenfolge.
Um ein JSON-Objekt zu senden, serialisieren Sie es als Zeichenfolge und geben Sie es `json` für die `message_structure` Eigenschaft an.
Typ: `string`
`subject`
(Optional) Der Betreff der Nachricht.
Typ: `string`
Der Betreff kann aus ASCII-Text und bis zu 100 Zeichen bestehen. Er muss mit einem Buchstaben, einer Zahl oder einem Satzzeichen beginnen. Es darf keine Zeilenumbrüche oder Steuerzeichen enthalten.
`sns_topic_arn`
(Optional) Der ARN des Amazon SNS SNS-Themas, in dem diese Komponente die Nachricht veröffentlicht. Geben Sie diese Eigenschaft an, um das standardmäßige Amazon SNS SNS-Thema zu überschreiben.
Typ: `string`
`message_structure`
(Optional) Die Struktur der Nachricht. Geben Sie `json` in der `content` Eigenschaft an, dass eine JSON-Nachricht gesendet werden soll, die Sie als Zeichenfolge serialisieren.
Typ: `string`
Zulässige Werte: `json`
`id`
Eine willkürliche ID für die Anforderung. Verwenden Sie diese Eigenschaft, um eine Eingabeanforderung einer Ausgabeantwort zuzuordnen. Wenn Sie diese Eigenschaft angeben, setzt die Komponente die `id` Eigenschaft im Antwortobjekt auf diesen Wert.
Typ: `string`
**Anmerkung**
Die Nachrichtengröße kann maximal 256 KB betragen.
**Example Beispieleingabe: Zeichenfolgen-Nachricht**
```
{
"request": {
"subject": "Message subject",
"message": "Message data",
"sns_topic_arn": "arn:aws:sns:region:account-id:topic2-name"
},
"id": "request123"
}
```
**Example Beispieleingabe: JSON-Nachricht**
```
{
"request": {
"subject": "Message subject",
"message": "{ \"default\": \"Message data\" }",
"message_structure": "json"
},
"id": "request123"
}
```
## Ausgabedaten
Diese Komponente veröffentlicht standardmäßig Antworten als Ausgabedaten zum folgenden MQTT-Thema. Sie müssen dieses Thema `subject` in der Konfiguration für die [ältere Abonnement-Router-Komponente](legacy-subscription-router-component.md) angeben. Weitere Informationen zum Abonnieren von Nachrichten zu diesem Thema in Ihren benutzerdefinierten Komponenten finden Sie unter[MQTT-Nachrichten veröffentlichen/abonnieren AWS IoT Core](ipc-iot-core-mqtt.md).
**Standardthema (AWS IoT Core MQTT):** `sns/message/status`
**Example Beispielausgabe: Erfolg**
```
{
"response": {
"sns_message_id": "f80a81bc-f44c-56f2-a0f0-d5af6a727c8a",
"status": "success"
},
"id": "request123"
}
```
**Example Beispielausgabe: Fehler**
```
{
"response" : {
"error": "InvalidInputException",
"error_message": "SNS Topic Arn is invalid",
"status": "fail"
},
"id": "request123"
}
```
## Lokale Protokolldatei
Diese Komponente verwendet die folgende Protokolldatei.
```
/greengrass/v2/logs/aws.greengrass.SNS.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. `/greengrass/v2`Ersetzen Sie es durch den Pfad zum AWS IoT Greengrass Stammordner.
```
sudo tail -f /greengrass/v2/logs/aws.greengrass.SNS.log
```
## Lizenzen
Diese Komponente umfasst die folgende Software/Lizenzierung von Drittanbietern:
+ [AWS SDK für Python (Boto3)](https://pypi.org/project/boto3/)/Apache-Lizenz 2.0
+ [botocore](https://pypi.org/project/botocore/)/Apache-Lizenz 2.0
+ [dateutil](https://pypi.org/project/python-dateutil/1.4/)/PSF-Lizenz
+ [docutils](https://pypi.org/project/docutils/)/BSD-Lizenz, GNU General Public License (GPL), Python Software Foundation License, Public Domain
+ [jmespath](https://pypi.org/project/jmespath/)/MIT-Lizenz
+ [s3transfer](https://pypi.org/project/s3transfer/)/Apache-Lizenz 2.0
+ [urllib3](https://pypi.org/project/urllib3/)/MIT-Lizenz
Diese Komponente wird im Rahmen der [Greengrass Core Software-Lizenzvereinbarung](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf) veröffentlicht.
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| **Version** | **Änderungen** |
| --- | --- |
| 2.1.10 | Die Version wurde für die Version 2.15.0 von Greengrass Nucleus aktualisiert. |
| 2.1.9 | Die Version wurde für die Version 2.14.0 von Greengrass Nucleus aktualisiert. |
| 2.1.8 | Die Version wurde für die Version 2.13.0 von Greengrass Nucleus aktualisiert. |
| 2.1.7 | Die Version wurde für die Version 2.12.0 von Greengrass Nucleus aktualisiert. |
| 2.1.6 | Die Version wurde für die Version 2.11.0 von Greengrass Nucleus aktualisiert. |
| 2.1.5 | Die Version wurde für die Version 2.10.0 von Greengrass Nucleus aktualisiert. |
| 2.1.4 | Die Version wurde für die Version 2.9.0 von Greengrass Nucleus aktualisiert. |
| 2.1.3 | Die Version wurde für die Version 2.8.0 von Greengrass Nucleus aktualisiert. |
| 2.1.2 | Die Version wurde für die Version 2.7.0 von Greengrass Nucleus aktualisiert. |
| 2.1.1 | Die Version wurde für die Version 2.6.0 von Greengrass Nucleus aktualisiert. |
| 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/sns-component.html) |
| 2.0.8 | Die Version wurde für die Version 2.5.0 von Greengrass Nucleus aktualisiert. |
| 2.0.7 | Die Version wurde für die Version 2.4.0 von Greengrass Nucleus aktualisiert. |
| 2.0.6 | Die Version wurde für die Version 2.3.0 von Greengrass Nucleus aktualisiert. |
| 2.0.5 | Die Version wurde für die Version 2.2.0 von Greengrass Nucleus aktualisiert. |
| 2.0.4 | Die Version wurde für die Version 2.1.0 von Greengrass Nucleus aktualisiert. |
| 2.0.3 | Erste Version |
# 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 unter[Datenströme auf Greengrass-Kerngeräten verwalten](manage-data-streams.md).
**Topics**
+ [Versionen](#stream-manager-component-versions)
+ [Typ](#stream-manager-component-type)
+ [Betriebssystem](#stream-manager-component-os-support)
+ [Voraussetzungen](#stream-manager-component-requirements)
+ [Abhängigkeiten](#stream-manager-component-dependencies)
+ [Konfiguration](#stream-manager-component-configuration)
+ [Lokale Protokolldatei](#stream-manager-component-log-file)
+ [Änderungsprotokoll](#stream-manager-component-changelog)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 2.2.x
+ 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](greengrass-nucleus-component.md) führt die Lebenszyklusskripte der Komponente aus.
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## 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](device-service-role.md) muss den Zugriff auf die AWS Cloud Ziele ermöglichen, die Sie mit Stream Manager verwenden. Weitere Informationen finden Sie unter:
+ [AWS IoT Analytics Kanäle](stream-export-configurations.md#export-to-iot-analytics)
+ [Amazon Kinesis Kinesis-Datenströme](stream-export-configurations.md#export-to-kinesis)
+ [AWS IoT SiteWise Eigenschaften von Vermögenswerten](stream-export-configurations.md#export-to-iot-sitewise)
+ [Amazon-S3-Objekte](stream-export-configurations.md#export-to-s3)
+ Die Stream Manager-Komponente wird für die Ausführung 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 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 S3-VPC-Schnittstelle verfügbar. Weitere Informationen finden Sie unter [Einschränkungen und Einschränkungen von AWS PrivateLink für Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/privatelink-interface-endpoints.html#privatelink-limitations). 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-1` Region verwendet, indem Sie sie `-Daws.s3UseUsEast1RegionalEndpoint=regional` in einrichten`JVM_ARGS`.
+ Erstellen Sie einen Amazon S3 S3-Gateway-VPC-Endpunkt anstelle eines VPC-Endpunkts mit Amazon S3 S3-Schnittstelle. S3-Gateway-Endpunkte unterstützen den Zugriff auf den globalen S3-Endpunkt. Weitere Informationen finden Sie unter [Einen Gateway-Endpunkt erstellen](https://docs.aws.amazon.com/vpc/latest/privatelink/vpc-endpoints-s3.html#create-gateway-endpoint-s3).
### 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](allow-device-traffic.md).
| Endpoint | Port | Erforderlich | Description |
| --- | --- | --- | --- |
| `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](#stream-manager-component-changelog) 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](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.
------
#### [ 2.1.3 – 2.2.1 ]
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.1.3 bis 2.2.1 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.0.0 <3.0.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | >=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](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | >=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](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | >=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](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | >=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](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | >=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](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | >=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](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | >=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](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | >=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](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | >=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](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | >=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](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | >=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](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | >=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](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | >=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](greengrass-nucleus-component.md) | >=2.0.3 <2.1.0 | Weich |
| [Token-Austauschdienst](token-exchange-service-component.md) | >=0.0.0 | Hart |
------
Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den [Komponentenrezepten](component-recipe-reference.md#recipe-reference-component-dependencies).
## 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,](configure-greengrass-core-v2.md#configure-component-user) 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 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. 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](manage-data-streams.md#stream-manager-security-client-authentication).
Wenn Sie angeben`true`, erlaubt das Stream Manager SDK nur Greengrass-Komponenten als Clients.
Wenn Sie dies angeben`false`, lässt das Stream Manager SDK 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 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 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.
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 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 für den Start der Komponente. Der Status der Komponente ändert sich auf, `ERRORED` wenn dieser Timeout überschritten wird.
Standard: `120`
**Example Beispiel: Aktualisierung der Zusammenführung von Konfigurationen**
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:\$1greengrass\$1v2* durch den 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.2.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/stream-manager-component.html) |
| 2.2.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/stream-manager-component.html) |
| 2.1.13 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/stream-manager-component.html) |
| 2.1.12 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/stream-manager-component.html) |
| 2.1.11 | Die Version wurde für die Version 2.12.0 von Greengrass Nucleus aktualisiert. |
| 2.1.10 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/stream-manager-component.html) |
| 2.1.9 | Die Version wurde für die Version 2.11.0 von Greengrass Nucleus aktualisiert. |
| 2.1.8 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/stream-manager-component.html) |
| 2.1.7 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/stream-manager-component.html) |
| 2.1.6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/stream-manager-component.html) |
| 2.1.5 | Die Version wurde für die Version 2.10.0 von Greengrass Nucleus aktualisiert. |
| 2.1.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/stream-manager-component.html) |
| 2.1.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/stream-manager-component.html) |
| 2.1.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/stream-manager-component.html) |
| 2.1.1 | Die Version wurde für die Version 2.8.0 von Greengrass Nucleus aktualisiert. |
| 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/stream-manager-component.html) |
| 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 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/stream-manager-component.html) |
| 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 |
# Systemprotokollweiterleitung
Der System Log Forwarder (`aws.greengrass.SystemLogForwarder`) lädt aktive Systemprotokolle CloudWatch mithilfe der CloudWatch HTTPS-API direkt zu Amazon hoch.
**Wichtig**
Diese Komponente leitet nur Systemd-Journald-Protokolle weiter, die während der Laufzeit generiert wurden. [https://www.freedesktop.org/software/systemd/man/latest/systemd-journald.service.html](https://www.freedesktop.org/software/systemd/man/latest/systemd-journald.service.html)
**Anmerkung**
Diese Komponente benötigt spezielle Berechtigungen, um Protokollgruppen und Streams zu erstellen und zu verwalten. CloudWatch
**Topics**
+ [Versionen](#system-log-forwarder-component-versions)
+ [Typ](#system-log-forwarder-component-type)
+ [Betriebssystem](#system-log-forwarder-component-os-support)
+ [Voraussetzungen](#system-log-forwarder-component-requirements)
+ [Endpunkte und Ports](#system-log-forwarder-component-endpoints)
+ [Abhängigkeiten](#system-log-forwarder-component-dependencies)
+ [Konfiguration](#system-log-forwarder-component-configuration)
+ [Änderungsprotokoll](#system-log-forwarder-component-changelog)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 2.1.x
+ 2.0.x
## Typ
Diese Komponente ist eine generische Komponente (`aws.greengrass.generic`). Der [Greengrass-Kern](greengrass-nucleus-component.md) führt die Lebenszyklusskripte der Komponente aus.
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## Betriebssystem
Diese Komponente muss auf systemd-basierten Linux-Systemen installiert werden.
## Voraussetzungen
Für diese Komponente gelten die folgenden Anforderungen:
Die Komponente benötigt Zugriff zum Erstellen von Log- und Stream-Gruppen CloudWatch sowie die Erlaubnis, den PutLogEvents HTTP-Aufruf durchzuführen. Sie müssen dem Rollenalias Ihres Greengrass-Geräts mindestens die folgenden Richtlinienberechtigungen hinzufügen:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": ["logs:CreateLogGroup"],
"Resource": "arn:aws:logs:us-east-1:111122223333:log-group:greengrass/systemLogs:*"
},
{
"Effect": "Allow",
"Action": ["logs:CreateLogStream", "logs:PutLogEvents"],
"Resource": "arn:aws:logs:us-east-1:111122223333:log-group:greengrass/systemLogs:log-stream:${credentials-iot:ThingName}"
}
]
}
```
------
**Anmerkung**
Weitere Informationen finden Sie auf der [Github-Seite](https://github.com/aws-greengrass/aws-greengrass-system-log-forwarder) von System Log Forwarder.
## 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](allow-device-traffic.md).
| Endpoint | Port | Erforderlich | Description |
| --- | --- | --- | --- |
| `logs.region.amazonaws.com` | 443 | Nein | Erforderlich, wenn Sie Protokolle in Logs schreiben. CloudWatch |
## 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](#system-log-forwarder-component-changelog) 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](https://console.aws.amazon.com//greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der **Abhängigkeiten**.
------
#### [ 2.1.x ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.1.x dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Token-Austauschdienst](token-exchange-service-component.md) | >=2.0.0 | Hart |
| [Greengrass Nucleus Lite](greengrass-nucleus-lite-component.md) | >=2.3.0 | Weich |
------
#### [ 2.0.x ]
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.x dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Token-Austauschdienst](token-exchange-service-component.md) | >=2.0.0 | Hart |
------
## Konfiguration
Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.
------
#### [ 2.0.x-2.1.x ]
`maxUploadIntervalSec`
Der maximale Zeitraum, in dem der System-Log-Forwarder versucht, Protokolle hochzuladen. Da die Protokollweiterleitung Protokolle hochlädt, wenn der Speicher voll ist, kann es dennoch vorkommen, dass sie öfter als die konfigurierte maximale Schrittfrequenz hochlädt.
`maxRetriesCount`
Gibt an, wie oft der System-Log-Forwarder versucht, einen vorübergehenden HTTP-Fehler zu wiederholen.
`bufferCapacity`
Die Größe des Ringpuffers für die Speicherung von Protokollen im Arbeitsspeicher.
`logGroup`
Der Protokollpfad in CloudWatch.
`logStream`
Der CloudWatch LogStream.
`filters`
Eine Übersicht der Filterkonfigurationen für das Kerngerät.
`services`
Eine Liste von Dienstnamenfiltern, anhand derer System Log Forwarder bestimmt, welche Protokolle hochgeladen werden. Ein Protokoll wird nur hochgeladen, wenn der Dienst, von dem es stammt, mindestens einem der Filter in dieser Liste entspricht. Bei den Filtern in dieser Liste kann es sich entweder um eine Zeichenfolge handeln, der der Dienstname vollständig entsprechen muss, oder um eine Zeichenfolge, die mit \$1 endet, was bedeutet, dass das Präfix übereinstimmen muss.
Standard: `[ggl.*]`
Ein Protokoll wird nur hochgeladen, wenn der Dienst, von dem es stammt, mindestens einem der Filter in dieser Liste entspricht.
Wenn Sie den Wert \$1 verwenden, werden alle verfügbaren Dienste berücksichtigt.
**Example Beispielkonfiguration:**
Das folgende Beispiel filtert Logs nach allen Diensten, die in Greengrass Nucleus Lite enthalten sind.
```
{
"maxUploadIntervalSec": 300,
"maxRetriesCount": 3,
"bufferCapacity": 1048576,
"logGroup": "greengrass/systemLogs",
"logStream": "deviceName",
"filters": {
"services": ["ggl.*"]
}
}
```
------
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| **Version** | **Änderungen** |
| --- | --- |
| 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/system-log-forwarder-component.html) |
| 2.0.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/system-log-forwarder-component.html) |
| 2.0.0 | Erste Version |
# Systemmanager-Agent
Die AWS Systems Manager Agent-Komponente (`aws.greengrass.SystemsManagerAgent`) installiert den Systems Manager Agent, sodass Sie Kerngeräte mit Systems Manager verwalten können. Systems Manager ist ein AWS Service, mit dem Sie Ihre Infrastruktur anzeigen und steuern können AWS, einschließlich EC2 Amazon-Instances, lokalen Servern und virtuellen Maschinen (VMs) sowie Edge-Geräten. Systems Manager ermöglicht es Ihnen, Betriebsdaten einzusehen, Betriebsaufgaben zu automatisieren und Sicherheit und Compliance aufrechtzuerhalten. Weitere Informationen finden Sie unter [Was ist AWS Systems Manager?](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html) und [Über Systems Manager Agent](https://docs.aws.amazon.com/systems-manager/latest/userguide/prereqs-ssm-agent.html) im *AWS Systems Manager Benutzerhandbuch*.
Die Tools und Funktionen von Systems Manager werden *Funktionen* genannt. Greengrass-Kerngeräte unterstützen alle Systems Manager Manager-Funktionen. Weitere Informationen zu diesen Funktionen und zur Verwendung von Systems Manager zur Verwaltung von Kerngeräten finden Sie unter [Systems Manager Manager-Funktionen](https://docs.aws.amazon.com/systems-manager/latest/userguide/features.html) im *AWS Systems Manager Benutzerhandbuch*.
**Topics**
+ [Versionen](#systems-manager-agent-component-versions)
+ [Typ](#systems-manager-agent-component-type)
+ [Betriebssystem](#systems-manager-agent-component-os-support)
+ [Voraussetzungen](#systems-manager-agent-component-requirements)
+ [Abhängigkeiten](#systems-manager-agent-component-dependencies)
+ [Konfiguration](#systems-manager-agent-component-configuration)
+ [Lokale Protokolldatei](#systems-manager-agent-component-log-file)
+ [Weitere Informationen finden Sie auch unter](#systems-manager-agent-component-see-also)
+ [Änderungsprotokoll](#systems-manager-agent-component-changelog)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 1.3.x
+ 1.2.x
+ 1.1.x
+ 1.0.x
## Typ
Diese Komponente ist eine generische Komponente (`aws.greengrass.generic`). Der [Greengrass-Kern](greengrass-nucleus-component.md) führt die Lebenszyklusskripte der Komponente aus.
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## Betriebssystem
Diese Komponente kann nur auf Linux-Core-Geräten installiert werden.
## Voraussetzungen
Für diese Komponente gelten die folgenden Anforderungen:
+ Ein Greengrass-Core-Gerät, das auf einer 64-Bit-Linux-Plattform läuft: Armv8 (AArch64) oder x86\$164.
+ Sie müssen über eine AWS Identity and Access Management (IAM-) Servicerolle verfügen, die Systems Manager übernehmen kann. Diese Rolle muss die von [Amazon SSMManaged InstanceCore](https://console.aws.amazon.com/iam/home#/policies/arn:aws:iam::aws:policy/AmazonSSMManagedInstanceCore) verwaltete Richtlinie oder eine benutzerdefinierte Richtlinie enthalten, die entsprechende Berechtigungen definiert. Weitere Informationen finden Sie unter [Erstellen einer IAM-Servicerolle für Edge-Geräte](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-edge-devices.html#systems-manager-setting-up-edge-devices-service-role) im *AWS Systems Manager Benutzerhandbuch*.
Wenn Sie diese Komponente bereitstellen, müssen Sie den Namen dieser Rolle für den `SSMRegistrationRole` Konfigurationsparameter angeben.
+ Die [Greengrass-Geräterolle](device-service-role.md) muss die `ssm:RegisterManagedInstance` Aktionen `ssm:AddTagsToResource` und zulassen. Die Geräterolle muss auch die `iam:PassRole` Aktion für die IAM-Servicerolle zulassen, die die vorherige Anforderung erfüllt. Die folgende Beispiel-IAM-Richtlinie gewährt diese Berechtigungen.
```
{
"Version": "2012-10-17",
"Statement": [
{
"Action": [
"iam:PassRole"
],
"Effect": "Allow",
"Resource": [
"arn:aws:iam::account-id:role/SSMServiceRole"
]
},
{
"Action": [
"ssm:AddTagsToResource",
"ssm:RegisterManagedInstance"
],
"Effect": "Allow",
"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](allow-device-traffic.md).
| Endpoint | Port | Erforderlich | Description |
| --- | --- | --- | --- |
| `ec2messages.region.amazonaws.com` | 443 | Ja | Kommunizieren Sie mit dem Systems Manager Manager-Dienst in der AWS Cloud. |
| `ssm.region.amazonaws.com` | 443 | Ja | Registrieren Sie das Kerngerät als von Systems Manager verwalteten Knoten. |
| `ssmmessages.region.amazonaws.com` | 443 | Ja | Kommunizieren Sie mit Session Manager, einer Funktion von Systems Manager, in der AWS Cloud. |
*Weitere Informationen finden Sie unter [Referenz: ec2messages, ssmmessages und andere API-Aufrufe im Benutzerhandbuch](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-messageAPIs.html).AWS Systems Manager *
## Abhängigkeiten
Wenn Sie eine Komponente bereitstellen, stellt sie 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](#systems-manager-agent-component-changelog) 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](https://console.aws.amazon.com//greengrass) 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 1.0.0 bis 1.3.0 dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Token-Austauschdienst](token-exchange-service-component.md) | >=2.0.0 <3.0.0 | Hart |
[Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den Komponentenrezepten.](component-recipe-reference.md#recipe-reference-component-dependencies)
## Konfiguration
Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.
`SSMRegistrationRole`
Die IAM-Servicerolle, die Systems Manager übernehmen kann und die die von [Amazon SSMManaged InstanceCore](https://console.aws.amazon.com/iam/home#/policies/arn:aws:iam::aws:policy/AmazonSSMManagedInstanceCore) verwaltete Richtlinie oder eine benutzerdefinierte Richtlinie umfasst, die entsprechende Berechtigungen definiert. Weitere Informationen finden Sie im *AWS Systems Manager Benutzerhandbuch* unter [Erstellen einer IAM-Servicerolle für Edge-Geräte](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-edge-devices-service-role.html).
`SSMOverrideExistingRegistration`
(Optional) Wenn auf dem Kerngerät bereits der Systems Manager Agent ausgeführt wird, der mit einer Hybrid-Aktivierung registriert ist, können Sie die bestehende Systems Manager Agent-Registrierung des Geräts überschreiben. Stellen Sie diese Option auf ein`true`, um das Kerngerät mithilfe des Systems Manager Agents, den diese Komponente bereitstellt, als verwalteten Knoten zu registrieren.
Diese Option gilt nur für Geräte, die mit einer Hybridaktivierung registriert wurden. Wenn das Kerngerät auf einer EC2 Amazon-Instance läuft, auf der der Systems Manager Agent installiert und eine Instance-Profilrolle konfiguriert ist, beginnt die bestehende verwaltete Knoten-ID der EC2 Amazon-Instance mit`i-`. Wenn Sie die Systems Manager Agent-Komponente installieren, registriert der Systems Manager Agent einen neuen verwalteten Knoten, dessen ID mit `mi-` statt mit beginnt`i-`. Anschließend können Sie den verwalteten Knoten, dessen ID mit beginnt, verwenden`mi-`, um das Kerngerät mit Systems Manager zu verwalten.
Standard: `false`
`SSMResourceTags`
(Optional) Die Tags, die dem verwalteten Systems Manager Manager-Knoten hinzugefügt werden sollen, den diese Komponente für das Kerngerät erstellt. Sie können diese Tags verwenden, um Gruppen von Kerngeräten mit Systems Manager zu verwalten. Sie können beispielsweise einen Befehl auf allen Geräten ausführen, die über ein von Ihnen angegebenes Tag verfügen.
Geben Sie eine Liste an, in der jedes Tag ein Objekt mit einem `Key` und a ist`Value`. Der folgende Wert für `SSMResourceTags` weist diese Komponente beispielsweise an, das **Owner** Tag auf dem verwalteten Knoten des Kerngeräts **richard-roe** auf zu setzen.
```
[
{
"Key": "Owner",
"Value": "richard-roe"
}
]
```
Diese Komponente ignoriert diese Tags, wenn der verwaltete Knoten bereits existiert und `SSMOverrideExistingRegistration` existiert. `false`
**Example Beispiel: Aktualisierung der Konfigurationszusammenführung**
In der folgenden Beispielkonfiguration wird die Verwendung einer Servicerolle mit `SSMServiceRole` dem Namen so angegeben, dass sich das Kerngerät registrieren und mit Systems Manager kommunizieren kann.
```
{
"SSMRegistrationRole": "SSMServiceRole",
"SSMOverrideExistingRegistration": false,
"SSMResourceTags": [
{
"Key": "Owner",
"Value": "richard-roe"
},
{
"Key": "Team",
"Value": "solar"
}
]
}
```
## Lokale Protokolldatei
Die Systems Manager Agent-Software schreibt Protokolle in einen Ordner außerhalb des Greengrass-Stammordners. Weitere Informationen finden Sie im *AWS Systems Manager Benutzerhandbuch* unter [Anzeigen von Systems Manager Agent-Protokollen](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-agent-logs.html).
Die Systems Manager Agent-Komponente verwendet Shell-Skripts, um den Systems Manager Agent zu installieren, zu starten und zu beenden. Die Ausgabe dieser Skripts finden Sie in der folgenden Protokolldatei.
```
/greengrass/v2/logs/aws.greengrass.SystemsManagerAgent.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. `/greengrass/v2`Ersetzen Sie es durch den Pfad zum AWS IoT Greengrass Stammordner.
```
sudo tail -f /greengrass/v2/logs/aws.greengrass.SystemsManagerAgent.log
```
## Weitere Informationen finden Sie auch unter
+ [Verwalten Sie Greengrass-Kerngeräte mit AWS Systems Manager](manage-with-systems-manager.md)
+ [Was ist AWS Systems Manager?](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html) im *AWS Systems Manager Benutzerhandbuch*
+ [Informationen zum Systems Manager Agent](https://docs.aws.amazon.com/systems-manager/latest/userguide/prereqs-ssm-agent.html) im *AWS Systems Manager Benutzerhandbuch*
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| **Version** | **Änderungen** |
| --- | --- |
| 1.3.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/systems-manager-agent-component.html) |
| 1.2.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/systems-manager-agent-component.html) |
| 1.2.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/systems-manager-agent-component.html) |
| 1.1.0 | Diese Version enthält Fehlerkorrekturen und Verbesserungen. |
| 1.0.0 | Erste Version |
# Token-Austauschdienst
Die Token-Exchange-Dienstkomponente (`aws.greengrass.TokenExchangeService`) stellt AWS Anmeldeinformationen bereit, mit denen Sie mit AWS Diensten in Ihren benutzerdefinierten Komponenten interagieren können.
Der Token-Austauschdienst wird als lokaler Server ausgeführt. Dieser lokale Server stellt über den AWS IoT Rollenalias, den Sie in der [Greengrass Core Nucleus-Komponente](greengrass-nucleus-component.md) konfigurieren, eine Verbindung zum Anbieter für AWS IoT Anmeldeinformationen her. Die Komponente stellt zwei Umgebungsvariablen bereit, `AWS_CONTAINER_CREDENTIALS_FULL_URI` und`AWS_CONTAINER_AUTHORIZATION_TOKEN`. `AWS_CONTAINER_CREDENTIALS_FULL_URI`definiert den URI zu diesem lokalen Server. Wenn eine Komponente einen AWS SDK-Client erstellt, erkennt der Client diese URI-Umgebungsvariable und verwendet das darin enthaltene Token, `AWS_CONTAINER_AUTHORIZATION_TOKEN` um eine Verbindung zum Token-Austauschdienst herzustellen und AWS Anmeldeinformationen abzurufen. Auf diese Weise können Greengrass-Kerngeräte den AWS Servicebetrieb anrufen. Weitere Informationen zur Verwendung dieser Komponente in benutzerdefinierten Komponenten finden Sie unter[Interagieren Sie mit AWS Diensten](interact-with-aws-services.md).
**Wichtig**
Die Support für den Erwerb von AWS Anmeldeinformationen auf diese Weise wurde AWS SDKs am 13. Juli 2016 hinzugefügt. Ihre Komponente muss eine AWS SDK-Version verwenden, die an oder nach diesem Datum erstellt wurde. Weitere Informationen finden Sie unter [Verwenden eines unterstützten AWS SDK](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-iam-roles.html#task-iam-roles-minimum-sdk) im *Amazon Elastic Container Service Developer Guide*.
**Anmerkung**
Komponenten, die die AWS Standard-Credential-Kette verwenden, können andere Quellen von Anmeldeinformationen erkennen und verwenden, sofern sie existieren. Innerhalb des Amazon Amazon Elastic Container Service (Amazon ECS) haben Container-Anmeldeinformationen `AWS_CONTAINER_CREDENTIALS_RELATIVE_URI` Vorrang vor dem`AWS_CONTAINER_CREDENTIALS_FULL_URI`, was bedeutet, dass Anmeldeinformationen für den Token-Austausch-Service innerhalb von Amazon Elastic Container Service (Amazon ECS) möglicherweise nicht funktionieren. Weitere Informationen finden Sie unter Anbieter von [standardisierten Anmeldeinformationen](https://docs.aws.amazon.com/sdkref/latest/guide/standardized-credentials.html)
**Topics**
+ [Versionen](#token-exchange-service-component-versions)
+ [Typ](#token-exchange-service-component-type)
+ [Betriebssystem](#token-exchange-service-component-os-support)
+ [Abhängigkeiten](#token-exchange-service-component-dependencies)
+ [Konfiguration](#token-exchange-service-component-configuration)
+ [Lokale Protokolldatei](#token-exchange-service-component-log-file)
+ [Änderungsprotokoll](#token-exchange-service-component-changelog)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 2.0.x
## Typ
Diese Komponente ist eine generische Komponente (`aws.greengrass.generic`). Der [Greengrass-Kern](greengrass-nucleus-component.md) führt die Lebenszyklusskripte der Komponente aus.
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## Betriebssystem
Diese Komponente kann auf Kerngeräten installiert werden, auf denen die folgenden Betriebssysteme ausgeführt werden:
+ Linux
+ Windows
## Abhängigkeiten
Diese Komponente hat keine Abhängigkeiten.
## Konfiguration
Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.
`port`
Der Port, der für Verbindungen mit dem Token-Exchange-Dienst verwendet werden soll. Der Token-Austauschdienst wird neu gestartet, nachdem sich die Portkonfiguration geändert hat.
`credentialRetryInSec`
Gibt die Wiederholungsintervalle in Sekunden an, wenn der Token-Exchange-Dienst auf Fehler bei der Anforderung von Anmeldeinformationen stößt.
`clientError`
Das Wiederholungsintervall in Sekunden für Clientfehler (4xx-HTTP-Statuscodes).
Standard: `120`
Gültige Werte: `10` bis `42900`
`serverError`
Das Wiederholungsintervall in Sekunden für Serverfehler (5xx HTTP-Statuscodes).
Standard: `60`
Gültige Werte: `10` bis `42900`
`unknownError`
Das Wiederholungsintervall in Sekunden für unbekannte Fehler (Verbindungsfehler und HTTP-Statuscodes außerhalb der Bereiche 4xx und 5xx).
Standard: `300`
Gültige Werte: `10` bis `42900`
**Example Beispiel: Aktualisierung der Zusammenführung von Konfigurationen**
```
{
"port": 2020,
"credentialRetryInSec": {
"clientError": 30,
"serverError": 45,
"unknownError": 60
}
}
```
## Lokale Protokolldatei
Diese Komponente verwendet dieselbe Protokolldatei wie die [Greengrass Nucleus-Komponente](greengrass-nucleus-component.md).
------
#### [ Linux ]
```
/greengrass/v2/logs/greengrass.log
```
------
#### [ Windows ]
```
C:\greengrass\v2\logs\greengrass.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:\$1greengrass\$1v2* durch den Pfad zum AWS IoT Greengrass Stammordner.
------
#### [ Linux ]
```
sudo tail -f /greengrass/v2/logs/greengrass.log
```
------
#### [ Windows (PowerShell) ]
```
Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
```
------
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| **Version** | **Änderungen** |
| --- | --- |
| 2.0.3 | Erste Version |
# SiteWise IoT-OPC-UA-Kollektor
Die SiteWise IoT-OPC-UA-Sammlerkomponente (`aws.iot.SiteWiseEdgeCollectorOpcua`) ermöglicht es AWS IoT SiteWise Gateways, Daten von lokalen OPC UA-Servern zu sammeln.
Mit dieser Komponente können AWS IoT SiteWise Gateways eine Verbindung zu mehreren OPC UA-Servern herstellen. *Weitere Informationen zu AWS IoT SiteWise Gateways finden Sie unter [Using AWS IoT SiteWise at the Edge](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/gateways-ggv2.html) im AWS IoT SiteWise Benutzerhandbuch.*
**Topics**
+ [Versionen](#iotsitewise-opcua-collector-component-versions)
+ [Typ](#iotsitewise-opcua-collector-component-type)
+ [Betriebssystem](#iotsitewise-opcua-collector-component-os-support)
+ [Voraussetzungen](#iotsitewise-opcua-collector-component-requirements)
+ [Abhängigkeiten](#iotsitewise-opcua-collector-component-dependencies)
+ [Konfiguration](#iotsitewise-opcua-collector-component-configuration)
+ [Eingabedaten](#iotsitewise-opcua-collector-component-input-data)
+ [Ausgabedaten](#iotsitewise-opcua-collector-component-output-data)
+ [Lokale Protokolldatei](#iotsitewise-opcua-collector-component-log-file)
+ [Lizenzen](#iotsitewise-opcua-collector-component-licenses)
+ [Änderungsprotokoll](#iotsitewise-opcua-collector-component-changelog)
+ [Weitere Informationen finden Sie auch unter](#iotsitewise-opcua-collector-component-see-also)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 3.1.x
+ 3.0.x
+ 2.6.x
+ 2.5.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](greengrass-nucleus-component.md) führt die Lebenszyklusskripte der Komponente aus.
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## 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 höher
Architektur: x86\$164 () oder (Aarch64) AMD64 ARMv8
+ Betriebssystem: Red Hat Enterprise Linux (RHEL) 8
Architektur: x86\$164 (AMD64) oder (Aarch64) ARMv8
+ Betriebssystem: Amazon Linux 2
Architektur: x86\$164 (AMD64) oder ARMv8 (Aarch64)
+ Betriebssystem: Debian 11
Architektur: x86\$164 (AMD64) oder ARMv8 (Aarch64)
+ Betriebssystem: Windows Server 2019 oder später
Architektur: x86\$164 () AMD64
+ Das Greengrass-Core-Gerät muss ausgehende Netzwerkkonnektivität zu OPC UA-Servern ermöglichen.
## Abhängigkeiten
Wenn Sie eine Komponente bereitstellen, stellt es 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](#iotsitewise-opcua-collector-component-changelog) 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](https://console.aws.amazon.com//greengrass) 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 alle Versionen dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.3.0 <3.0.0 | Hart |
| [Stream-Manager](stream-manager-component.md) | >=2.3.0 2.0.10<3.0.0 | Hart |
| [Geheimer Manager](secret-manager-component.md) | >2,0,10 =2,0,8 <3,0,0 | Hart |
[Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den Komponentenrezepten.](component-recipe-reference.md#recipe-reference-component-dependencies)
## Konfiguration
Diese Komponente hat keine Konfigurationsparameter.
Sie können die AWS IoT SiteWise Konsole oder API verwenden, um die IoT SiteWise OPC UA-Collector-Komponente zu konfigurieren. Weitere Informationen finden Sie unter [Schritt 4: Datenquellen hinzufügen — optional](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/create-gateway-ggv2.html#add-data-sources-console) im *AWS IoT SiteWise Benutzerhandbuch*.
## Eingabedaten
Diese Komponente akzeptiert nur Daten in den folgenden Formaten, alle anderen werden ignoriert und verworfen. In der folgenden Tabelle werden die OPC UA-Datentypen ihren entsprechenden Datentypen zugeordnet. SiteWise
| **SiteWise Datentyp** | **OPC UA-Datentyp** | **Beschreibung** |
| --- | --- | --- |
| `STRING` | `String` `Guid` `XmlElement` | Eine Zeichenfolge mit einer maximalen Länge von 1024 Byte. |
| `INTEGER` | `SByte` `Byte` `Int16` `UInt16` `Int32` `UInt32`\$1 `Int64`\$1 | Eine 32-Bit-Ganzzahl mit Vorzeichen und einem Bereich von`-2,147,483,648 to 2,147,483,647`. |
| `DOUBLE` | `UInt32`\$1 `Int64`\$1 `Float` `Double` | Eine Fließkommazahl mit einem Bereich von `–10^100 to 10^100` und `IEEE 754` doppelter Genauigkeit. |
| `BOOLEAN` | `Boolean` | `true` oder `false`. |
\$1 Bei OPC UA-Datentypen `UInt32` und ist der SiteWise Datentyp`Int64`, `INTEGER` wenn er in der Lage SiteWise ist, seinen Wert darzustellen, andernfalls ist es der Fall. `DOUBLE`
## Ausgabedaten
Diese Komponente schreibt `BatchPutAssetPropertyValue` Nachrichten in den AWS IoT Greengrass Stream-Manager. Weitere Informationen finden Sie unter [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html) in der *AWS IoT SiteWise -API-Referenz*.
## Lokale Protokolldatei
Diese Komponente verwendet die folgende Protokolldatei.
------
#### [ Linux ]
```
/greengrass/v2/logs/aws.iot.SiteWiseEdgeCollectorOpcua.log
```
------
#### [ Windows ]
```
C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeCollectorOpcua.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:\$1greengrass\$1v2* durch den Pfad zum AWS IoT Greengrass Stammordner.
------
#### [ Linux ]
```
sudo tail -f /greengrass/v2/logs/aws.iot.SiteWiseEdgeCollectorOpcua.log
```
------
#### [ Windows (PowerShell) ]
```
Get-Content C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeCollectorOpcua.log -Tail 10 -Wait
```
------
## Lizenzen
Diese Komponente wird im Rahmen der [Greengrass Core Software-Lizenzvereinbarung](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf) veröffentlicht.
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| **Version** | **Änderungen** |
| --- | --- |
| 3.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) |
| 3.0.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) |
| 3.0.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) |
| 3.0.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) |
| 3.0.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) |
| 2.6.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) |
| 2.5.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) |
| 2.5.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) |
| 2.4.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) |
| 2.4.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) |
| 2.4.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) |
| 2.3.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) |
| 2.2.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) |
| 2.1.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) |
| 2.1.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) |
| 2.0.3 | Fehlerkorrekturen und Verbesserungen. |
| 2.0.2 | Fehlerkorrekturen und Verbesserungen bei der prioritären Synchronisierung von Vermögenswerten mit Edge. |
| 2.0.1 | Erste Version |
## Weitere Informationen finden Sie auch unter
+ [Was ist AWS IoT SiteWise?](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/what-is-sitewise.html) im *AWS IoT SiteWise Benutzerhandbuch*.
# IoT SiteWise OPC UA-Datenquellensimulator
Die SiteWise IoT-OPC-UA-Datenquellensimulatorkomponente (`aws.iot.SiteWiseEdgeOpcuaDataSourceSimulator`) startet einen lokalen OPC UA-Server, der Beispieldaten generiert. Verwenden Sie diesen OPC UA-Server, um eine Datenquelle zu simulieren, die von der [ SiteWise IoT-OPC-UA-Kollektorkomponente](iotsitewise-opcua-collector-component.md) auf einem AWS IoT SiteWise Gateway gelesen wird. Anschließend können Sie anhand dieser AWS IoT SiteWise Beispieldaten Funktionen untersuchen. Weitere Informationen zu AWS IoT SiteWise Gateways finden Sie im *AWS IoT SiteWise Benutzerhandbuch* unter [Using AWS IoT SiteWise at the Edge](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/gateways-ggv2.html).
**Topics**
+ [Versionen](#iotsitewise-opcua-data-source-simulator-component-versions)
+ [Typ](#iotsitewise-opcua-data-source-simulator-component-type)
+ [Betriebssystem](#iotsitewise-opcua-data-source-simulator-component-os-support)
+ [Voraussetzungen](#iotsitewise-opcua-data-source-simulator-component-requirements)
+ [Abhängigkeiten](#iotsitewise-opcua-data-source-simulator-component-dependencies)
+ [Konfiguration](#iotsitewise-opcua-data-source-simulator-component-configuration)
+ [Lokale Protokolldatei](#iotsitewise-opcua-data-source-simulator-component-log-file)
+ [Änderungsprotokoll](#iotsitewise-opcua-data-source-simulator-component-changelog)
+ [Weitere Informationen finden Sie auch unter](#iotsitewise-opcua-data-source-simulator-component-see-also)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 1.0.x
## Typ
Diese Komponente ist eine generische Komponente (`aws.greengrass.generic`). Der [Greengrass-Kern](greengrass-nucleus-component.md) führt die Lebenszyklusskripte der Komponente aus.
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## 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 in der Lage sein, Port 4840 auf dem lokalen Host zu verwenden. Der lokale OPC UA-Server dieser Komponente läuft an diesem Port.
## 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](#iotsitewise-opcua-data-source-simulator-component-changelog) 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](https://console.aws.amazon.com//greengrass) 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 alle Versionen dieser Komponente aufgeführt.
| -Abhängigkeit | Kompatible Versionen | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.3.0 <3.0.0 | Hart |
[Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den Komponentenrezepten.](component-recipe-reference.md#recipe-reference-component-dependencies)
## Konfiguration
Diese Komponente hat keine Konfigurationsparameter.
## Lokale Protokolldatei
Diese Komponente verwendet die folgende Protokolldatei.
------
#### [ Linux ]
```
/greengrass/v2/logs/aws.iot.SiteWiseEdgeOpcuaDataSourceSimulator.log
```
------
#### [ Windows ]
```
C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeOpcuaDataSourceSimulator.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:\$1greengrass\$1v2* durch den Pfad zum AWS IoT Greengrass Stammordner.
------
#### [ Linux ]
```
sudo tail -f /greengrass/v2/logs/aws.iot.SiteWiseEdgeOpcuaDataSourceSimulator.log
```
------
#### [ Windows (PowerShell) ]
```
Get-Content C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeOpcuaDataSourceSimulator.log -Tail 10 -Wait
```
------
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| **Version** | **Änderungen** |
| --- | --- |
| 1.0.0 | Erste Version Fügt Unterstützung für Windows Server 2016 oder höher hinzu. |
## Weitere Informationen finden Sie auch unter
+ [Was ist AWS IoT SiteWise?](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/what-is-sitewise.html) im *AWS IoT SiteWise Benutzerhandbuch*.
# SiteWise IoT-Herausgeber
Die SiteWise IoT-Publisher-Komponente (`aws.iot.SiteWiseEdgePublisher`) ermöglicht es AWS IoT SiteWise Gateways, Daten vom Edge zum AWS Cloud zu exportieren.
Weitere Informationen zu AWS IoT SiteWise Gateways finden Sie im *AWS IoT SiteWise Benutzerhandbuch* [unter AWS IoT SiteWise Using at the Edge](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/gateways-ggv2.html).
**Topics**
+ [Versionen](#iotsitewise-publisher-component-versions)
+ [Typ](#iotsitewise-publisher-component-type)
+ [Betriebssystem](#iotsitewise-publisher-component-os-support)
+ [Voraussetzungen](#iotsitewise-publisher-component-requirements)
+ [Abhängigkeiten](#iotsitewise-publisher-component-dependencies)
+ [Konfiguration](#iotsitewise-publisher-component-configuration)
+ [Eingabedaten](#iotsitewise-publisher-component-input-data)
+ [Lokale Protokolldatei](#iotsitewise-publisher-component-log-file)
+ [Problembehandlung und Debugging](#iotsitewise-publisher-component-debug)
+ [Lizenzen](#iotsitewise-publisher-component-licenses)
+ [Änderungsprotokoll](#iotsitewise-publisher-component-changelog)
+ [Weitere Informationen finden Sie auch unter](#iotsitewise-publisher-component-see-also)
## 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](greengrass-nucleus-component.md) führt die Lebenszyklusskripte der Komponente aus.
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## 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\$164 () oder (Aarch64) AMD64 ARMv8
+ Betriebssystem: Red Hat Enterprise Linux (RHEL) 8
Architektur: x86\$164 (AMD64) oder (Aarch64) ARMv8
+ Betriebssystem: Amazon Linux 2
Architektur: x86\$164 (AMD64) oder ARMv8 (Aarch64)
+ Betriebssystem: Debian 11
Architektur: x86\$164 (AMD64) oder ARMv8 (Aarch64)
+ Betriebssystem: Windows Server 2019 oder später
Architektur: x86\$164 () AMD64
+ Das Greengrass Core-Gerät muss eine Verbindung zum Internet herstellen.
+ Das Greengrass Core-Gerät muss für die Ausführung der `iotsitewise:BatchPutAssetPropertyValue` Aktion autorisiert sein. Weitere Informationen finden Sie unter [Autorisieren von Kerngeräten für die Interaktion mit AWS Diensten](https://docs.aws.amazon.com/greengrass/v2/developerguide/device-service-role.html).
**Example 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](allow-device-traffic.md).
| Endpoint | Port | Erforderlich | Description |
| --- | --- | --- | --- |
| `data.iotsitewise.region.amazonaws.com` | 443 | Ja | Daten veröffentlichen in. AWS IoT SiteWise |
## Abhängigkeiten
Wenn Sie eine Komponente bereitstellen, stellt sie 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](#iotsitewise-publisher-component-changelog) 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](https://console.aws.amazon.com//greengrass) 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 | Art der Abhängigkeit |
| --- | --- | --- |
| [Grüngraskern](greengrass-nucleus-component.md) | >=2.3.0<3.0.0 | Hart |
| [Stream-Manager](stream-manager-component.md) | >=2.3.0 =2.0.10<3.0.0 | Hart |
[Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den Komponentenrezepten.](component-recipe-reference.md#recipe-reference-component-dependencies)
## 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](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/create-gateway-ggv2.html#configure-publisher) im *AWS IoT SiteWise Benutzerhandbuch*.
## Eingabedaten
Diese Komponente liest `PutAssetPropertyValueEntry` Nachrichten aus dem AWS IoT Greengrass Stream-Manager. Weitere Informationen finden Sie unter [PutAssetPropertyValueEntry](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_PutAssetPropertyValueEntry.html) 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:\$1greengrass\$1v2* 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, mit dem Kunden Probleme identifizieren und beheben können. Die Protokolldatei ist von der lokalen Protokolldatei getrennt und befindet sich am folgenden Speicherort. Ersetzen Sie `/greengrass/v2` oder *C:\$1greengrass\$1v2* 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 Fehlerbehebung. 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. Die Diagnoseinformationen umfassen Folgendes:
+ Schweregrad
+ Zeitstempel
+ Zusätzliche ereignisspezifische Informationen
**Example 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 der [Greengrass Core Software-Lizenzvereinbarung](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf) veröffentlicht.
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| **Version** | **Änderungen** |
| --- | --- |
| 4.1.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-publisher-component.html) |
| 4.1.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-publisher-component.html) |
| 4.1.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-publisher-component.html) |
| 4.1.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-publisher-component.html) |
| 4.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-publisher-component.html) [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-publisher-component.html) |
| 4.0.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-publisher-component.html) |
| 4.0.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-publisher-component.html) |
| 4.0.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-publisher-component.html) |
| 4.0.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-publisher-component.html) |
| 3.2.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-publisher-component.html) |
| 3.1.4 | Version 3.1.4 wurde am 20. Februar 2025 eingestellt. Die Verbesserungen in dieser Version sind in späteren Versionen dieser Komponente verfügbar. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-publisher-component.html) |
| 3.1.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-publisher-component.html) |
| 3.1.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-publisher-component.html) |
| 3.1.1 | 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. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-publisher-component.html) |
| 3.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-publisher-component.html) |
| 3.0.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-publisher-component.html) |
| 2.4.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-publisher-component.html) |
| 2.4.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-publisher-component.html) |
| 2.3.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-publisher-component.html) |
| 2.3.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-publisher-component.html) |
| 2.3.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-publisher-component.html) |
| 2.2.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-publisher-component.html) |
| 2.2.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-publisher-component.html) |
| 2.2.1 | Diese Version unterstützt keine HTTP-Proxykonfiguration. Version 2.2.2 und höher führt die Unterstützung für diese Funktion wieder ein. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-publisher-component.html) |
| 2.2.0 | Diese Version unterstützt keine HTTP-Proxykonfiguration. Version 2.2.2 und höher führt die Unterstützung für diese Funktion wieder ein. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-publisher-component.html) |
| 2.1.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-publisher-component.html) |
| 2.1.3 | Diese Version ist nicht mehr verfügbar, außer in den Regionen USA Ost (Ohio), Kanada (Mitte) und AWS GovCloud (USA Ost). 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. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-publisher-component.html) |
| 2.1.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-publisher-component.html) |
| 2.1.1 | Fehlerkorrekturen und Verbesserungen. |
| 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-publisher-component.html) |
| 2.0.2 | Fehlerkorrekturen und Verbesserungen. |
| 2.0.1 | Erste Version |
## Weitere Informationen finden Sie auch unter
+ [Was ist AWS IoT SiteWise?](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/what-is-sitewise.html) im *AWS IoT SiteWise Benutzerhandbuch*.
# SiteWise IoT-Prozessor
Die SiteWise IoT-Prozessorkomponente (`aws.iot.SiteWiseEdgeProcessor`) ermöglicht AWS IoT SiteWise Classic Streams und V2-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](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/gateways-ggv2.html) im *AWS IoT SiteWise Benutzerhandbuch*.
**Anmerkung**
Die Funktion Data Processing Pack (DPP) steht Neukunden ab dem 7. November 2025 nicht mehr zur Verfügung. Wenn Sie DPP nutzen möchten, melden Sie sich vor diesem Datum an. Bestandskunden können den Service weiterhin wie gewohnt nutzen. Weitere Informationen finden Sie unter [Änderung der Verfügbarkeit von Datenverarbeitungspaketen](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-dpp-availability-change.html) im *AWS IoT SiteWise Benutzerhandbuch*.
**Topics**
+ [Versionen](#iotsitewise-processor-component-versions)
+ [Typ](#iotsitewise-processor-component-type)
+ [Betriebssystem](#iotsitewise-processor-component-os-support)
+ [Voraussetzungen](#iotsitewise-processor-component-requirements)
+ [Abhängigkeiten](#iotsitewise-processor-component-dependencies)
+ [Konfiguration](#iotsitewise-processor-component-configuration)
+ [Lokale Protokolldatei](#iotsitewise-processor-component-log-file)
+ [Lizenzen](#iotsitewise-processor-component-licenses)
+ [Änderungsprotokoll](#iotsitewise-processor-component-changelog)
+ [Weitere Informationen finden Sie auch unter](#iotsitewise-processor-component-see-also)
## Versionen
Diese Komponente hat die folgenden Versionen:
+ 3.5.x
+ 3.4.x
+ 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](greengrass-nucleus-component.md) führt die Lebenszyklusskripte der Komponente aus.
Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).
## 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 höher
Architektur: x86\$164 () AMD64
+ Betriebssystem: RedHat Enterprise Linux (RHEL) 8
Architektur: x86\$164 () AMD64
+ Betriebssystem: Amazon Linux 2
Architektur: x86\$164 () AMD64
+ Betriebssystem: Windows Server 2019 oder später
Architektur: x86\$164 () AMD64
+ Betriebssystem: Debian 11 (Bullseye) oder später
Architektur: x86\$164 () 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](https://docs.aws.amazon.com/greengrass/v2/developerguide/device-service-role.html) 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](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-gateway-ggv2.html#gateway-requirements) 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 [Geräteverkehr über einen Proxy oder eine Firewall zulassen](allow-device-traffic.md).
| Endpoint | Port | Erforderlich | Description |
| --- | --- | --- | --- |
| `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](#iotsitewise-processor-component-changelog) 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](https://console.aws.amazon.com//greengrass) 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](token-exchange-service-component.md) | >=2.0.3 <3.0.0 | Hart |
| [Stream-Manager](stream-manager-component.md) | >=2,0.3 =2.0.10 <3.0.0 | Hart |
| [Greengrass CLI](greengrass-cli-component.md) | >=2.3.0 <3.0.0 | Hart |
[Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den Komponentenrezepten.](component-recipe-reference.md#recipe-reference-component-dependencies)
## 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:\$1greengrass\$1v2* durch den 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:
### Lizenzen von Drittanbietern
+ Apache-2.0
+ MIT
+ BSD-2-Klausel
+ BSD-3-Klausel
+ CDDL-1.0
+ CDDL-1,1
+ DISC
+ Zlib
+ GPL-3.0 mit GCC-Ausnahme
+ Öffentliche Domäne
+ Python-2.0
+ Unicode-DFS-2015
+ BSD-1-Klausel
+ OpenSSL
+ 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](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf) veröffentlicht.
## Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
| **Version** | **Änderungen** |
| --- | --- |
| 3.5.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-processor-component.html) |
| 3.4.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-processor-component.html) |
| 3.3.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-processor-component.html) |
| 3.3.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-processor-component.html) [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-processor-component.html) |
| 3.2.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-processor-component.html) |
| 3.2.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-processor-component.html) |
| 3.1.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-processor-component.html) |
| 3.1.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-processor-component.html) |
| 3.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-processor-component.html) |
| 3.0.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-processor-component.html) |
| 2.2.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-processor-component.html) |
| 2.1.37 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-processor-component.html) |
| 2.1.35 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-processor-component.html) |
| 2.1.34 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-processor-component.html) |
| 2.1.33 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-processor-component.html) |
| 2.1.32 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-processor-component.html) |
| 2.1.31 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-processor-component.html) |
| 2.1.29 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-processor-component.html) |
| 2.1.28 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-processor-component.html) |
| 2.1.24 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-processor-component.html) |
| 2.1.23 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-processor-component.html) |
| 2.1.21 | Ein Upgrade von 2.0.x auf 2.1.x führt zum Verlust lokaler Daten. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-processor-component.html) |
| 2.0.16 | Diese Version enthält Fehlerkorrekturen und Verbesserungen. |
| 2.0.15 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-processor-component.html) |
| 2.0.14 | Diese Version enthält Fehlerkorrekturen und Verbesserungen. |
| 2.0.13 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-processor-component.html) |
| 2.0.9 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-processor-component.html) |
| 2.0.7 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-processor-component.html) |
| 2.0.6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-processor-component.html) |
| 2.0.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/greengrass/v2/developerguide/iotsitewise-processor-component.html) |
| 2.0.2 | Erste Version |
## Weitere Informationen finden Sie auch unter
+ [Was ist AWS IoT SiteWise?](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/what-is-sitewise.html) im *AWS IoT SiteWise Benutzerhandbuch*.