View a markdown version of this page

IP-Detektor - AWS IoT Greengrass
VersionenTypBetriebssystemVoraussetzungenAbhängigkeitenKonfigurationLokale LogdateiÄ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 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 Konnektivitätsinformationen der zugehörigen Kerngeräte abzurufen. Anschließend können Client-Geräte versuchen, eine Verbindung zu jedem Kerngerät herzustellen, bis sie erfolgreich eine Verbindung herstellen.

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.1.x

  • 2.0.x

Typ

Diese Komponente ist eine Plugin-Komponente (aws.greengrass.plugin). Der Greengrass-Nukleus führt diese Komponente in derselben Java Virtual Machine (JVM) aus wie der Nucleus. Der Nucleus wird neu gestartet, wenn Sie die Version dieser Komponente auf dem Kerngerät ändern.

Diese Komponente verwendet dieselbe Protokolldatei wie der Greengrass-Nucleus. Weitere Informationen finden Sie unter AWS IoT Greengrass Protokolle überwachen.

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 Ihren Berechtigungen zugeordnet sein AWS-Konto und die iot:UpdateThingShadow Berechtigungen iot:GetThingShadow und zulassen.

  • Die AWS IoT Richtlinie des Hauptgeräts muss die greengrass:UpdateConnectivityInfo Erlaubnis zulassen. Weitere Informationen erhalten Sie unter AWS IoT Richtlinien für den Betrieb 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 IP Detector v2.1.0 oder höher verwenden. Konfigurieren Sie es so, dass es den Port meldet, 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 des Kerngeräts manuell verwalten. Befindet sich das Kerngerät beispielsweise hinter einem Router, 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.

  • Die Ausführung der IP-Detektorkomponente in einer VPC wird unterstützt.

Abhängigkeiten

Wenn Sie eine Komponente bereitstellen, werden AWS IoT Greengrass auch kompatible Versionen ihrer Abhängigkeiten bereitgestellt. Das bedeutet, dass Sie die Anforderungen für die Komponente und alle ihre Abhängigkeiten erfüllen müssen, um die Komponente erfolgreich bereitzustellen. In diesem Abschnitt werden die Abhängigkeiten für die veröffentlichten Versionen dieser Komponente sowie die semantischen Versionseinschränkungen aufgeführt, die die Komponentenversionen für jede Abhängigkeit definieren. Sie können die Abhängigkeiten für jede Version der Komponente auch in der AWS IoT Greengrass Konsole 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 Typ der Abhängigkeit
Nukleus von Greengrass > =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 Typ der Abhängigkeit
Nukleus von Greengrass > =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 Typ der Abhängigkeit
Nukleus von Greengrass > =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 Typ der Abhängigkeit
Nukleus von Greengrass > =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 Typ der Abhängigkeit
Nukleus von Greengrass > =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 Typ der Abhängigkeit
Nukleus von Greengrass > =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 Typ der Abhängigkeit
Nukleus von Greengrass > =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 Typ der Abhängigkeit
Nukleus von Greengrass > =2,2,0 <2,1,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 Typ der Abhängigkeit
Nukleus von Greengrass > =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 Typ der Abhängigkeit
Nukleus von Greengrass > =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 Typ der Abhängigkeit
Nukleus von Greengrass > =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 Typ der Abhängigkeit
Grüngras-Kern > =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 Typ der Abhängigkeit
Nukleus von Greengrass > =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 Typ der Abhängigkeit
Nukleus von Greengrass > =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 Typ der Abhängigkeit
Nukleus von Greengrass > =2,2,0 <2,3,0 Weich

Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Komponentenrezeptreferenz.

Konfiguration

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

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, z. B. localhost über die ein Gerät 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 verknüpfungslokale IPv4-Adressen zu erkennen und zu melden. Verwenden Sie diese Option, wenn das Netzwerk des Kerngeräts weder über DHCP (Dynamic Host Configuration Protocol) noch über 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, z. B. localhost über die ein Gerät 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 setzenincludeIPv6Addrs, true um diese Option verwenden zu können.

Standard: false

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

Standard: false

includeIPv4Addrs

(Optional) Die Standardeinstellung ist auf festgelegttrue. Sie können diese Option aktivieren, um IPv4-Adressen zu veröffentlichen, die auf dem Kerngerä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, z. B. localhost über die ein Gerät 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 verknüpfungslokale IPv4-Adressen zu erkennen und zu melden. Verwenden Sie diese Option, wenn das Netzwerk des Kerngeräts weder über DHCP (Dynamic Host Configuration Protocol) noch über 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, z. B. localhost über die ein Gerät 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 verknüpfungslokale IPv4-Adressen zu erkennen und zu melden. Verwenden Sie diese Option, wenn das Netzwerk des Kerngeräts weder über DHCP (Dynamic Host Configuration Protocol) noch über statisch zugewiesene IP-Adressen verfügt.

Standard: false

Lokale Logdatei

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 Sie /greengrass/v2 oder C:\greengrass\v2 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.5

Aktualisiert die Komponentenversion für die Greengrass Nucleus-Version 2.18.0.

2.2.4

Aktualisiert die Komponentenversion für die Greengrass Nucleus-Version 2.17.0.

2.2.3

Die Version wurde für die Greengrass Nucleus-Version 2.16.0 aktualisiert.

2.2.2

 Version für Greengrass Nucleus Version 2.15.0 aktualisiert.

2.2.1

 Version für Greengrass Nucleus Version 2.14.0 aktualisiert.

2.2.0

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

Neue Features

  • Fügt Unterstützung für IPv6 hinzu. Sie können IPv6 jetzt für lokales Messaging verwenden.

2.1.9
Fehlerbehebungen und Verbesserungen

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

2.1.8

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

2.1.7

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

2.1.6

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

2.1.5

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

2.1.4

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

2.1.3

Version für die Greengrass Nucleus-Version 2.7.0 aktualisiert.

2.1.2
Fehlerbehebungen und Verbesserungen

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

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

2.1.1

Die Version wurde für die Greengrass Nucleus-Version 2.5.0 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 Greengrass Nucleus-Version 2.4.0 aktualisiert.

2.0.1

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

2.0.0

Erste Version