IP-Detektor - AWS IoT Greengrass
VersionenTypBetriebssystemVoraussetzungenAbhängigkeitenKonfigurationLokale ProtokolldateiÄnderungsprotokoll

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.

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 tätig ist.

  • 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.

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.

Versionen

Diese Komponente hat die folgenden Versionen:

  • 2.2.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 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 Überwachen von AWS IoT Greengrass Protokollen.

Weitere Informationen finden Sie unter Komponententypen.

Betriebssystem

Diese Komponente kann auf Kerngeräten installiert werden, auf denen die folgenden Betriebssysteme ausgeführt werden:

  • Linux

  • Windows

Voraussetzungen

Für diese Komponente gelten die folgenden Anforderungen:

  • Die Greengrass-Servicerolle 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 Operationen auf Datenebene und Minimale AWS IoT Richtlinie zur Unterstützung von Client-Geräten.

  • 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 das Gerät 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.

  • Die IP-Detektorkomponente wird für die Ausführung in einem 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 dieser Komponente sowie die semantischen Versionseinschränkungen aufgeführt, die die Komponentenversionen für jede Abhängigkeit definieren. Sie können auch die Abhängigkeiten für jede Version der Komponente in der AWS IoT Greengrass Konsole anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der Abhängigkeiten.

2.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 >=2.2.0 <2.14.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 >=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 >=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 >=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 >=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 >=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 >=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 >=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 >=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 >=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 >=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 >=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 >=2.2.0 <2.3.0 Weich

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

Konfiguration

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

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

(Optional) Sie können diese Option aktivieren, um IPv4 verknüpfungslokale Adressen zu erkennen und zu melden. Verwenden Sie diese Option, wenn das Netzwerk des Kerngeräts nicht über das Dynamic Host Configuration Protocol (DHCP) 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 einstellenincludeIPv6Addrs, true um diese Option verwenden zu können.

Standard: false

(Optional) Sie können diese Option aktivieren, um IPv6 verknüpfungslokale Adressen zu erkennen und zu melden. Verwenden Sie diese Option, wenn das Netzwerk des Kerngeräts nicht über das Dynamic Host Configuration Protocol (DHCP) oder statisch zugewiesene IP-Adressen verfügt. Sie müssen includeIPv4Addrs auf false und auf einstellen, includeIPv6Addrs true um diese Option verwenden zu können.

Standard: false

includeIPv4Addrs

(Optional) Die Standardeinstellung ist auf eingestellttrue. 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

(Optional) Sie können diese Option aktivieren, um IPv4 verknüpfungslokale Adressen zu erkennen und zu melden. Verwenden Sie diese Option, wenn das Netzwerk des Kerngeräts nicht über das Dynamic Host Configuration Protocol (DHCP) 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

(Optional) Sie können diese Option aktivieren, um IPv4 verknüpfungslokale Adressen zu erkennen und zu melden. Verwenden Sie diese Option, wenn das Netzwerk des Kerngeräts nicht über das Dynamic Host Configuration Protocol (DHCP) oder statisch zugewiesene IP-Adressen verfügt.

Standard: false

Lokale Protokolldatei

Diese Komponente verwendet dieselbe Protokolldatei wie die Greengrass Nucleus-Komponente.

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 /greengrass/v2 oder C:\greengrass\v2 mit dem 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.0

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

Neue Features

  • Ergänzt Unterstützung für IPv6. Sie können es jetzt IPv6 für lokale Nachrichten verwenden.

2.1.9
Fehlerkorrekturen und Verbesserungen

  • Passt den Schritt zur Erfassung der IP-Adresse so an, dass nur Protokolle auf Debug-Protokollebene gesendet werden.

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
Fehlerkorrekturen und Verbesserungen

  • Verbessert die Fehlermeldungen, die diese Komponente in bestimmten Szenarien protokolliert.

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

2.1.1

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

2.1.0
Verbesserungen

  • Fügt den defaultPort Parameter hinzu, der es Ihnen ermöglicht, einen nicht standardmäßigen MQTT Broker-Port zu verwenden.

  • Aktualisierungen, um Protokollnachrichten übersichtlicher zu machen.

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