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.

# Systemprotokollweiterleitung
<a name="system-log-forwarder-component"></a>

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
<a name="system-log-forwarder-component-versions"></a>

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

## Typ
<a name="system-log-forwarder-component-type"></a>

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

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

## Betriebssystem
<a name="system-log-forwarder-component-os-support"></a>

Diese Komponente muss auf systemd-basierten Linux-Systemen installiert werden.

## Voraussetzungen
<a name="system-log-forwarder-component-requirements"></a>

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
<a name="system-log-forwarder-component-endpoints"></a>

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
<a name="system-log-forwarder-component-dependencies"></a>

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
<a name="system-log-forwarder-component-configuration"></a>

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
<a name="system-log-forwarder-component-changelog"></a>

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  |