Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Redirecteur de journal du système
<a name="system-log-forwarder-component"></a>

Le redirecteur de journal système (`aws.greengrass.SystemLogForwarder`) télécharge les journaux système actifs directement sur Amazon à CloudWatch l'aide de l'API CloudWatch HTTPS.

**Important**  
Ce composant ne transmettra que les journaux systemd-journald générés pendant l'exécution. [Pour plus d'informations sur les journaux systemd-journald, consultez [systemd-journald](https://www.freedesktop.org/software/systemd/man/latest/systemd-journald.service.html) et journalctl.](https://www.freedesktop.org/software/systemd/man/latest/journalctl.html#)

**Note**  
Ce composant nécessite des autorisations spécifiques pour créer et gérer des groupes de CloudWatch journaux et des flux.

**Topics**
+ [Versions](#system-log-forwarder-component-versions)
+ [Type](#system-log-forwarder-component-type)
+ [Système d’exploitation](#system-log-forwarder-component-os-support)
+ [Exigences](#system-log-forwarder-component-requirements)
+ [Points de terminaison et ports](#system-log-forwarder-component-endpoints)
+ [Dépendances](#system-log-forwarder-component-dependencies)
+ [Configuration](#system-log-forwarder-component-configuration)
+ [Journal des modifications](#system-log-forwarder-component-changelog)

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

Les versions de ce composant sont les suivantes :
+ 2.1.x
+ 2.0.x

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

<a name="public-component-type-generic"></a>Ce <a name="public-component-type-generic-phrase"></a>composant est un composant générique (`aws.greengrass.generic`). Le [noyau Greengrass](greengrass-nucleus-component.md) exécute les scripts de cycle de vie du composant.

<a name="public-component-type-more-information"></a>Pour de plus amples informations, veuillez consulter [Types de composants](develop-greengrass-components.md#component-types).

## Système d’exploitation
<a name="system-log-forwarder-component-os-support"></a>

Ce composant doit être installé sur les systèmes Linux basés sur Systemd.

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

Ce composant répond aux exigences suivantes :

Le composant nécessite un accès pour créer des groupes de journaux et de flux, CloudWatch ainsi que l'autorisation d'effectuer l'appel PutLogEvents HTTP. Vous devez au minimum ajouter les autorisations politiques suivantes à l'alias de rôle de votre appareil Greengrass :

------
#### [ 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}"
    }
  ]
}
```

------

**Note**  
Pour plus d'informations, consultez la page [Github](https://github.com/aws-greengrass/aws-greengrass-system-log-forwarder) du System Log Forwarder.

## Points de terminaison et ports
<a name="system-log-forwarder-component-endpoints"></a>

Ce composant doit être capable d'effectuer des demandes sortantes vers les points de terminaison et les ports suivants, en plus des points de terminaison et des ports requis pour le fonctionnement de base. Pour de plus amples informations, veuillez consulter [Autoriser le trafic des appareils via un proxy ou un pare-feu](allow-device-traffic.md).


| Endpoint |  Port | Obligatoire | Description | 
| --- | --- | --- | --- | 
|  `logs.region.amazonaws.com`  | 443 | Non |  Obligatoire si vous écrivez des journaux dans CloudWatch Logs.  | 

## Dépendances
<a name="system-log-forwarder-component-dependencies"></a>

Lorsque vous déployez un composant, il déploie AWS IoT Greengrass également des versions compatibles de ses dépendances. Cela signifie que vous devez satisfaire aux exigences relatives au composant et à toutes ses dépendances pour réussir le déploiement du composant. Cette section répertorie les dépendances des [versions publiées](#system-log-forwarder-component-changelog) de ce composant et les contraintes de version sémantiques qui définissent les versions des composants pour chaque dépendance. Vous pouvez également consulter les dépendances de chaque version du composant dans la [AWS IoT Greengrass console](https://console.aws.amazon.com//greengrass). Sur la page de détails du composant, recherchez la liste des **dépendances**.

------
#### [ 2.1.x ]

Le tableau suivant répertorie les dépendances pour la version 2.1.x de ce composant.


| Dépendance | Versions compatibles | Type de dépendance | 
| --- | --- | --- | 
| [Service d'échange de jetons](token-exchange-service-component.md) | >=2,0.0 | Stricte | 
| [Greengrass Nucleus Lite](greengrass-nucleus-lite-component.md) | >=2,3,0 | Flexible | 

------
#### [ 2.0.x ]

Le tableau suivant répertorie les dépendances pour la version 2.0.x de ce composant.


| Dépendance | Versions compatibles | Type de dépendance | 
| --- | --- | --- | 
| [Service d'échange de jetons](token-exchange-service-component.md) | >=2,0.0 | Stricte | 

------

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

Ce composant fournit les paramètres de configuration suivants que vous pouvez personnaliser lorsque vous déployez le composant.

------
#### [ 2.0.x-2.1.x ]

`maxUploadIntervalSec`  
Période maximale pendant laquelle le redirecteur des journaux du système tentera de télécharger les journaux. Étant donné que le redirecteur de journaux télécharge les journaux lorsque la mémoire est pleine, il se peut qu'il soit chargé plus souvent que la cadence maximale configurée.

`maxRetriesCount`  
Nombre de fois où le redirecteur de journal du système tente de retenter une erreur HTTP transitoire.

`bufferCapacity`  
Taille de la mémoire tampon en anneau pour le stockage des journaux en mémoire.

`logGroup`  
Le chemin du journal dans CloudWatch.

`logStream`  
Le CloudWatch LogStream.

`filters`  
Carte des configurations de filtre pour le périphérique principal.    
`services`  
Liste des filtres de nom de service que System Log Forwarder utilisera pour déterminer quels journaux seront téléchargés. Un journal ne sera chargé que si le service dont il provient correspond à au moins un des filtres de cette liste. Les filtres de cette liste peuvent être soit une chaîne à laquelle le nom du service doit correspondre entièrement, soit une chaîne se terminant par \$1, ce qui signifie que le préfixe doit correspondre.  
Valeur par défaut : `[ggl.*]`  
Un journal ne sera chargé que si le service dont il provient correspond à au moins un des filtres de cette liste.
L'utilisation de la valeur \$1 inclura tous les services disponibles.

**Example Exemple de configuration :**  
L'exemple ci-dessous filtrera les journaux en fonction de tous les services inclus dans Greengrass Nucleus Lite.  

```
{
    "maxUploadIntervalSec": 300,
    "maxRetriesCount": 3,
    "bufferCapacity": 1048576,
    "logGroup": "greengrass/systemLogs",
    "logStream": "deviceName",
    "filters": {
        "services": ["ggl.*"]
    }
}
```

------

## Journal des modifications
<a name="system-log-forwarder-component-changelog"></a>

Le tableau suivant décrit les modifications apportées à chaque version du composant.


|  **Version**  |  **Modifications**  | 
| --- | --- | 
|  2.1.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/greengrass/v2/developerguide/system-log-forwarder-component.html)  | 
|  2.0.1  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/greengrass/v2/developerguide/system-log-forwarder-component.html)  | 
|  2.0.0  |  Première version.  |