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
<a name="ip-detector-component"></a>

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**  <a name="client-device-component-context"></a>
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 Logdatei](#ip-detector-component-log-file)
+ [Änderungsprotokoll](#ip-detector-component-changelog)

## Versionen
<a name="ip-detector-component-versions"></a>

Diese Komponente hat die folgenden Versionen:
+ 2.2.x
+ 2.1.x
+ 2.0.x

## Typ
<a name="ip-detector-component-type"></a>

<a name="public-component-type-plugin-para1"></a>Diese Komponente ist eine Plugin-Komponente (`aws.greengrass.plugin`). Der [ Greengrass-Nukleus ](greengrass-nucleus-component.md) 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.

<a name="public-component-type-plugin-para2"></a>Diese Komponente verwendet dieselbe Protokolldatei wie der Greengrass-Nucleus. Weitere Informationen finden Sie unter [AWS IoT Greengrass Protokolle überwachen](monitor-logs.md).

<a name="public-component-type-more-information"></a>Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).

## Betriebssystem
<a name="ip-detector-component-os-support"></a>

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

## Voraussetzungen
<a name="ip-detector-component-requirements"></a>

Für diese Komponente gelten die folgenden Anforderungen:
+ Die [ Greengrass-Servicerolle ](greengrass-service-role.md) 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](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 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](manage-core-device-endpoints.md).
+ Die Ausführung der IP-Detektorkomponente in einer VPC wird unterstützt.

## Abhängigkeiten
<a name="ip-detector-component-dependencies"></a>

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 ](#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 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.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 ](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 | Typ der Abhängigkeit | 
| --- | --- | --- | 
| [Nukleus von Greengrass ](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 | Typ der Abhängigkeit | 
| --- | --- | --- | 
| [Nukleus von Greengrass ](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 | Typ der Abhängigkeit | 
| --- | --- | --- | 
| [Nukleus von Greengrass ](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 | Typ der Abhängigkeit | 
| --- | --- | --- | 
| [Nukleus von Greengrass ](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 | Typ der Abhängigkeit | 
| --- | --- | --- | 
| [Nukleus von Greengrass ](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 | Typ der Abhängigkeit | 
| --- | --- | --- | 
| [Nukleus von Greengrass ](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 | Typ der Abhängigkeit | 
| --- | --- | --- | 
| [Nukleus von Greengrass ](greengrass-nucleus-component.md) | > =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 ](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 | Typ der Abhängigkeit | 
| --- | --- | --- | 
| [Nukleus von Greengrass ](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 | Typ der Abhängigkeit | 
| --- | --- | --- | 
| [Nukleus von Greengrass ](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 | Typ der Abhängigkeit | 
| --- | --- | --- | 
| [Grüngras-Kern ](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 | Typ der Abhängigkeit | 
| --- | --- | --- | 
| [Nukleus von Greengrass ](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 | Typ der Abhängigkeit | 
| --- | --- | --- | 
| [Nukleus von Greengrass ](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 | Typ der Abhängigkeit | 
| --- | --- | --- | 
| [Nukleus von Greengrass ](greengrass-nucleus-component.md) | > =2,2,0 <2,3,0 | Weich | 

------

Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der [ Komponentenrezeptreferenz. ](component-recipe-reference.md#recipe-reference-component-dependencies)

## Konfiguration
<a name="ip-detector-component-configuration"></a>

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

------
#### [ 2.2.x ]

`defaultPort`  <a name="ip-detector-component-configuration-default-port"></a>
<a name="ip-detector-component-configuration-default-port-definition"></a>(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`  <a name="ip-detector-component-configuration-include-ipv4-loopback-addrs"></a>
<a name="ip-detector-component-configuration-include-ipv4-loopback-addrs-definition"></a>(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`

`includeIPv4LinkLocalAddrs`  <a name="ip-detector-component-configuration-include-ipv4-link-local-addrs"></a>
<a name="ip-detector-component-configuration-include-ipv4-link-local-addrs-definition"></a>(Optional) Sie können diese Option aktivieren, um [ verknüpfungslokale IPv4-Adressen zu erkennen und zu melden. ](https://en.wikipedia.org/wiki/Link-local_address) 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`  <a name="ip-detector-component-configuration-include-ipv6-loopback-addrs"></a>
<a name="ip-detector-component-configuration-include-ipv6-loopback-addrs-definition"></a>(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 setzen`includeIPv6Addrs`, `true` um diese Option verwenden zu können.   
Standard: `false`

`includeIPv6LinkLocalAddrs`  <a name="ip-detector-component-configuration-include-ipv6-link-local-addrs"></a>
<a name="ip-detector-component-configuration-include-ipv6-link-local-addrs-definition"></a>(Optional) Sie können diese Option aktivieren, um [ verknüpfungslokale IPv6-Adressen zu erkennen und zu melden. ](https://en.wikipedia.org/wiki/Link-local_address) 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`  <a name="ip-detector-component-configuration-include-ipv4-addrs"></a>
<a name="ip-detector-component-configuration-include-ipv4-addrs-definition"></a>(Optional) Die Standardeinstellung ist auf festgelegt`true`. Sie können diese Option aktivieren, um IPv4-Adressen zu veröffentlichen, die auf dem Kerngerät gefunden wurden.   
Standard: `true`

`includeIPv6Addrs`  <a name="ip-detector-component-configuration-include-ipv6-addrs"></a>
<a name="ip-detector-component-configuration-include-ipv6-addrs-definition"></a>(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`  <a name="ip-detector-component-configuration-default-port"></a>
<a name="ip-detector-component-configuration-default-port-definition"></a>(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`  <a name="ip-detector-component-configuration-include-ipv4-loopback-addrs"></a>
<a name="ip-detector-component-configuration-include-ipv4-loopback-addrs-definition"></a>(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`

`includeIPv4LinkLocalAddrs`  <a name="ip-detector-component-configuration-include-ipv4-link-local-addrs"></a>
<a name="ip-detector-component-configuration-include-ipv4-link-local-addrs-definition"></a>(Optional) Sie können diese Option aktivieren, um [ verknüpfungslokale IPv4-Adressen zu erkennen und zu melden. ](https://en.wikipedia.org/wiki/Link-local_address) 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`  <a name="ip-detector-component-configuration-include-ipv4-loopback-addrs"></a>
<a name="ip-detector-component-configuration-include-ipv4-loopback-addrs-definition"></a>(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`

`includeIPv4LinkLocalAddrs`  <a name="ip-detector-component-configuration-include-ipv4-link-local-addrs"></a>
<a name="ip-detector-component-configuration-include-ipv4-link-local-addrs-definition"></a>(Optional) Sie können diese Option aktivieren, um [ verknüpfungslokale IPv4-Adressen zu erkennen und zu melden. ](https://en.wikipedia.org/wiki/Link-local_address) 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
<a name="ip-detector-component-log-file"></a>

Diese Komponente verwendet dieselbe Protokolldatei wie die [ Greengrass ](greengrass-nucleus-component.md) 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
<a name="ip-detector-component-changelog"></a>

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**<br />   Fügt Unterstützung für IPv6 hinzu. Sie können IPv6 jetzt für lokales Messaging verwenden.    | 
| 2.1.9 |  **Fehlerbehebungen und Verbesserungen**<br />   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**<br />   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**<br />   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 |