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

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.

Versions

Les versions de ce composant sont les suivantes :

Type

Ce composant est un composant générique (aws.greengrass.generic). Le noyau Greengrass exécute les scripts de cycle de vie du composant.

Pour de plus amples informations, veuillez consulter Types de composants.

Système d’exploitation

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

Prérequis

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}"
    }
  ]
}

Points de terminaison et ports

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.

Dépendances

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 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. 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	>=2,0.0	Stricte
Greengrass Nucleus Lite	>=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	>=2,0.0	Stricte

Configuration

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 *, ce qui signifie que le préfixe doit correspondre.

Par défaut : [ggl.*]

Important

Un journal ne sera chargé que si le service dont il provient correspond à au moins un des filtres de cette liste.

Note

L'utilisation de la valeur * inclura tous les services disponibles.

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

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