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.

Transmetteur de journaux système

Le System log forwarder (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 composant.

Système d’exploitation

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

Exigences

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 moins ajouter les autorisations de politique 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 requêtes sortantes vers les terminaux 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, déploie AWS IoT Greengrass également des versions compatibles de ses dépendances. Cela signifie que vous devez répondre aux exigences relatives au composant et à toutes ses dépendances pour pouvoir le déployer avec succès. Cette section répertorie les dépendances pour les 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 pour chaque version du composant dans la AWS IoT Greengrass console. Sur la page des détails des composants, 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

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

maxRetriesCount

Nombre de fois que le gestionnaire de journaux système tentera de réessayer 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 chargés. Un journal ne sera téléchargé que si le service dont il provient correspond à au moins l'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.

Valeur par défaut : [ggl.*]

Important

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

Note

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

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