AWS IoT Greengrass Version 1 est entré dans la phase de durée de vie prolongée le 30 juin 2023. Pour plus d'informations, consultez la politique de AWS IoT Greengrass V1 maintenance. Après cette date, AWS IoT Greengrass V1 ne publiera pas de mises à jour fournissant des fonctionnalités, des améliorations, des corrections de bogues ou des correctifs de sécurité. Les appareils qui fonctionnent AWS IoT Greengrass V1 sous tension ne seront pas perturbés et continueront à fonctionner et à se connecter au cloud. Nous vous recommandons vivement de migrer vers AWS IoT Greengrass Version 2, qui ajoute de nouvelles fonctionnalités importantes et prend en charge des plateformes supplémentaires.

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.

Surveillance avec les journaux AWS IoT Greengrass

AWS IoT Greengrass se compose du service cloud et du logiciel AWS IoT Greengrass Core. Le logiciel AWS IoT Greengrass Core peut écrire des journaux sur Amazon CloudWatch et dans le système de fichiers local de votre appareil principal. Les fonctions Lambda et les connecteurs exécutés sur le noyau peuvent également écrire des journaux dans Logs et dans le système de fichiers local. CloudWatch Vous pouvez utiliser les journaux pour surveiller les événements et résoudre les problèmes. Toutes les entrées de journal AWS IoT Greengrass comportent un horodatage, un niveau de journalisation, ainsi que des informations sur l'événement. Les modifications apportées aux paramètres de journalisation prennent effet après le déploiement du groupe.

La journalisation est configurée au niveau du groupe. Pour savoir comment configurer la journalisation pour un groupe Greengrass, veuillez consulter Configurer la journalisation pour AWS IoT Greengrass.

Accès aux CloudWatch journaux

Si vous configurez la CloudWatch journalisation, vous pouvez consulter les journaux sur la page Logs de la CloudWatch console Amazon. Les groupes de journaux pour les journaux AWS IoT Greengrass utilisent les conventions de dénomination suivantes :

/aws/greengrass/GreengrassSystem/greengrass-system-component-name
/aws/greengrass/Lambda/aws-region/account-id/lambda-function-name

Chaque groupe de journaux contient des flux de journaux qui utilisent la convention de dénomination suivante :

date/account-id/greengrass-group-id/name-of-core-that-generated-log

Les considérations suivantes s'appliquent lorsque vous utilisez CloudWatch des journaux :

Accès aux journaux du système de fichiers

Si vous configurez la journalisation de système de fichiers, les fichiers journaux sont stockés sous greengrass-root/ggc/var/log sur l'appareil principal. Voici la structure de répertoires de haut niveau :

greengrass-root/ggc/var/log
    - crash.log
    - system
        - log files for each Greengrass system component
    - user
        - region
            - account-id
                - log files generated by each user-defined Lambda function
            - aws
                - log files generated by each connector

Les considérations suivantes s'appliquent lorsque vous utilisez les journaux du système de fichiers :

Configuration de journalisation par défaut

Si les paramètres de journalisation ne sont pas configurés explicitement, AWS IoT Greengrass utilise la configuration de journalisation par défaut suivante après le déploiement du premier groupe.

Configurer la journalisation pour AWS IoT Greengrass

Vous pouvez utiliser la AWS IoT console ou les AWS IoT GreengrassAPI pour configurer la AWS IoT Greengrass journalisation.

Configurer la journalisation (console)

Vous pouvez configurer la journalisation sur la page Settings (Paramètres) du groupe.

Configurer la journalisation (API)

Vous pouvez utiliser les API de journalisation AWS IoT Greengrass pour configurer la journalisation par programmation. Par exemple, utilisez l'action CreateLoggerDefinition pour créer une définition d'enregistreur d'événements en fonction d'une charge utile LoggerDefinitionVersion, qui utilise la syntaxe suivante :

{
  "Loggers": [
    {
      "Id": "string",
      "Type": "FileSystem|AWSCloudWatch",
      "Component": "GreengrassSystem|Lambda",
      "Level": "DEBUG|INFO|WARN|ERROR|FATAL",
      "Space": "integer"
    },
    {
      "Id": "string",
      ...
    }
  ]
}

LoggerDefinitionVersion est un tableau d'un ou de plusieurs objets Logger dont les propriétés sont les suivantes :

Exemple de configuration

L'exemple LoggerDefinitionVersion suivant spécifie un fichier de configuration qui :

{
  "Name": "LoggingExample",
  "InitialVersion": {
    "Loggers": [
      {
        "Id": "1",
        "Component": "GreengrassSystem",
        "Level": "ERROR",
        "Space": 10240,
        "Type": "FileSystem"
      },
      {
        "Id": "2",
        "Component": "Lambda",
        "Level": "INFO",
        "Space": 10240,
        "Type": "FileSystem"
      },
      {
        "Id": "3",
        "Component": "Lambda",
        "Level": "INFO",
        "Type": "AWSCloudWatch"
      }
    ]
  }
}

Lorsque vous avez créé une version de la définition de l'enregistreur d'événements, vous pouvez utiliser son ARN de version pour créer une version de groupe avant de déployer le groupe.

Limites de la journalisation

AWS IoT Greengrass possède les limitations de journalisation suivantes.

Transactions par seconde

Lorsque la connexion à CloudWatch est activée, le composant de journalisation regroupe les événements du journal localement avant de les envoyer CloudWatch, de sorte que vous pouvez enregistrer à un rythme supérieur à cinq demandes par seconde et par flux de journal.

Mémoire

S'il AWS IoT Greengrass est configuré pour envoyer des journaux CloudWatch et qu'une fonction Lambda enregistre plus de 5 Mo/seconde pendant une période prolongée, le pipeline de traitement interne finit par se remplir. Le pire scénario théorique est de 6 Mo par fonction Lambda.

Décalage d'horloge

Lorsque la connexion à CloudWatch est activée, le composant de journalisation signe les demandes en CloudWatch utilisant le processus de signature normal de Signature Version 4. Si l'heure du système sur le périphérique AWS IoT Greengrass principal est désynchronisée de plus de 15 minutes, les demandes sont rejetées.

Utilisation du disque

Utilisez la formule suivante pour calculer le volume total maximal d'espace disque affecté à la journalisation.

greengrass-system-component-space * 8    // 7 if automatic IP detection is disabled
  + 128KB                                // the internal log for the local logging component
  + lambda-space * lambda-count          // different versions of a Lambda function are treated as one

Où :

Perte de journaux

Si votre appareil AWS IoT Greengrass principal est configuré pour se connecter uniquement à Internet CloudWatch et qu'il n'y a aucune connexion Internet, vous n'avez aucun moyen de récupérer les journaux actuellement en mémoire.

Lorsque les fonctions Lambda sont interrompues (par exemple, pendant le déploiement), les journaux de quelques secondes ne sont pas écrits. CloudWatch

CloudTrail journaux

AWS IoT Greengrassfonctionne avecAWS CloudTrail, un service qui fournit un enregistrement des actions entreprises par un utilisateur, un rôle ou un AWS service dansAWS IoT Greengrass. Pour plus d'informations, consultez Journalisation des appels d'API AWS IoT Greengrass avec AWS CloudTrail.