

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 IoT Device Defender
<a name="device-defender-component"></a>

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
<a name="device-defender-component-versions"></a>

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
<a name="device-defender-component-type"></a>

------
#### [ v3.x ]

<a name="public-component-type-generic"></a>Diese <a name="public-component-type-generic-phrase"></a>Komponente ist eine generische Komponente (`aws.greengrass.generic`). Der [Greengrass-Kern](greengrass-nucleus-component.md) führt die Lebenszyklusskripte der Komponente aus.

------
#### [ v2.x ]

<a name="public-component-type-lambda"></a>Diese <a name="public-component-type-lambda-phrase"></a>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)

------

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

## Betriebssystem
<a name="device-defender-component-os-support"></a>

------
#### [ 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
<a name="device-defender-component-requirements"></a>

Für diese Komponente gelten die folgenden Anforderungen:

------
#### [ v3.x ]
+ <a name="public-component-python3-requirement"></a>[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 ]
+ <a name="core-device-lambda-function-requirements"></a>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).
+ <a name="public-component-python3-requirement"></a>[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.
+ <a name="connector-component-legacy-subscription-router-dependency"></a>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"
      }
    }
  }
  ```<a name="connector-component-legacy-subscription-router-dependency-replace"></a>
  + *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**  <a name="connector-component-legacy-subscription-router-dependency-note"></a>
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.

------

  <a name="connector-component-create-deployments"></a>Weitere Informationen finden Sie unter [Erstellen von Bereitstellungen](create-deployments.md).

------

## Abhängigkeiten
<a name="device-defender-component-dependencies"></a>

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
<a name="device-defender-component-configuration"></a>

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**  <a name="connector-component-lambda-parameters"></a>
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`  
<a name="connector-component-container-params-description"></a>(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`  
<a name="connector-component-container-params-memory-size-description"></a>(Optional) Die Speichermenge (in Kilobyte), die der Komponente zugewiesen werden soll.  
Der Standardwert ist 50.000 KB.

`pubsubTopics`  <a name="connector-component-pubsub-topics-parameter"></a>
(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
<a name="device-defender-component-input-data"></a>

Diese Komponente akzeptiert keine Nachrichten als Eingabedaten.

## Ausgabedaten
<a name="device-defender-component-output-data"></a>

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
<a name="device-defender-component-log-file"></a>

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
<a name="device-defender-component-licenses"></a>

<a name="component-core-software-license"></a>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
<a name="device-defender-component-changelog"></a>

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  | 

------