journaux - AWS IoT Greengrass
getlistez les mots cléslist-log-files

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.

journaux

Utilisez la logs commande pour analyser les journaux Greengrass sur votre appareil principal.

Sous-commandes

get

Collectez, filtrez et visualisez les fichiers journaux de Greengrass. Cette commande ne prend en charge que les fichiers journaux au format JSON. Vous pouvez spécifier le format de journalisation dans la configuration du noyau.

Résumé
greengrass-cli logs get
    [--log-dir path/to/a/log/folder]
    [--log-file path/to/a/log/file]
    [--follow true | false ]
    [--filter <filter> ]
    [--time-window <start-time>,<end-time> ]
    [--verbose ]
    [--no-color ]
    [--before <value> ]
    [--after <value> ]
    [--syslog ]
    [--max-long-queue-size <value> ]
Arguments

  • --log-dir,-ld. Le chemin d'accès au répertoire dans lequel vérifier la présence de fichiers journaux, tels que/greengrass/v2/logs. Ne pas utiliser avec --syslog Utilisez un argument distinct pour chaque répertoire supplémentaire à spécifier. Vous devez utiliser au moins l'un des --log-dir ou--log-file. Vous pouvez également utiliser les deux arguments dans une seule commande.

  • --log-file,-lf. Les chemins d'accès aux répertoires de journaux que vous souhaitez utiliser. Utilisez un argument distinct pour chaque répertoire supplémentaire à spécifier. Vous devez utiliser au moins l'un des --log-dir ou--log-file. Vous pouvez également utiliser les deux arguments dans une seule commande.

  • --follow,-fol. Afficher les mises à jour du journal dès qu'elles se produisent. Greengrass CLI continue de s'exécuter et lit les journaux spécifiés. Si vous spécifiez une fenêtre temporelle, Greengrass CLI arrête de surveiller les journaux une fois toutes les fenêtres temporelles terminées.

  • --filter,-f. Le mot clé, les expressions régulières ou la paire clé-valeur à utiliser comme filtre. Fournissez cette valeur sous forme de chaîne, d'expression régulière ou de paire clé-valeur. Utilisez un argument distinct pour chaque filtre supplémentaire à spécifier.

    Lors de l'évaluation, plusieurs filtres spécifiés dans un seul argument sont séparés par des opérateurs OR, et les filtres spécifiés dans des arguments supplémentaires sont combinés avec des opérateurs ET. Par exemple, si votre commande inclut--filter "installed" --filter "name=alpha,name=beta", la CLI Greengrass filtrera et affichera les messages de journal contenant à la fois le mot clé installed et une name clé contenant les valeurs alpha ou. beta

  • --time-window,-t. La fenêtre temporelle pour laquelle les informations du journal doivent être affichées. Vous pouvez utiliser à la fois des horodatages exacts et des décalages relatifs. Vous devez fournir ces informations dans le format<begin-time>,<end-time>. Si vous ne spécifiez ni l'heure de début ni l'heure de fin, la valeur de cette option est par défaut la date et l'heure actuelles du système. Utilisez un argument distinct pour chaque fenêtre temporelle supplémentaire à spécifier.

    Greengrass CLI prend en charge les formats d'horodatage suivants :

    • yyyy-MM-DD, par exemple,2020-06-30. L'heure par défaut est 00:00:00 lorsque vous utilisez ce format.

      yyyyMMDD, par exemple,20200630. L'heure par défaut est 00:00:00 lorsque vous utilisez ce format.

      HH:mm:ss, par exemple,15:30:45. La date par défaut est la date système actuelle lorsque vous utilisez ce format.

      HH:mm:ssSSS, par exemple,15:30:45. La date correspond par défaut à la date système actuelle lorsque vous utilisez ce format.

      YYYY-MM-DD'T'HH:mm:ss'Z', par exemple,2020-06-30T15:30:45Z.

      YYYY-MM-DD'T'HH:mm:ss, par exemple,2020-06-30T15:30:45.

      yyyy-MM-dd'T'HH:mm:ss.SSS, par exemple,2020-06-30T15:30:45.250.

    Les décalages relatifs spécifient un décalage de période par rapport à l'heure actuelle du système. Greengrass CLI prend en charge le format suivant pour les décalages relatifs :. +|-[<value>h|hr|hours][valuem|min|minutes][value]s|sec|seconds

    Par exemple, l'argument suivant pour spécifier une fenêtre horaire comprise entre 1 heure et 2 heures 15 minutes avant l'heure actuelle--time-window -2h15min,-1hr.

  • --verbose. Afficher tous les champs des messages du journal. Ne pas utiliser avec --syslog

  • --no-color,-nc. Supprimez le code couleur. Le code couleur par défaut pour les messages du journal utilise du texte rouge en gras. Supporte uniquement les terminaux de type Unix car il utilise des séquences d'échappement ANSI.

  • --before,-b. Le nombre de lignes à afficher avant une entrée de journal correspondante. La valeur par défaut est 0.

  • --after,-a. Le nombre de lignes à afficher après une entrée de journal correspondante. La valeur par défaut est 0.

  • --syslog. Traitez tous les fichiers journaux en utilisant le protocole syslog défini par la RFC3164. Ne pas utiliser avec --log-dir et--verbose. Le protocole Syslog utilise le format suivant : "<$Priority>$Timestamp $Host $Logger ($Class): $Message" Si vous ne spécifiez pas de fichier journal, Greengrass CLI lit les messages de journal depuis les emplacements suivants : /var/log/messages/var/log/syslog, ou le. /var/log/system.log

    AWS IoT Greengrassne prend actuellement pas en charge cette fonctionnalité sur les appareils Windows principaux.

  • --max-log-queue-size,-m. Nombre maximal d'entrées de journal à allouer à la mémoire. Utilisez cette option pour optimiser l'utilisation de la mémoire. La valeur par défaut est 100.

Sortie

L'exemple suivant montre le résultat produit lorsque vous exécutez cette commande.

$ sudo greengrass-cli logs get --verbose \
    --log-file /greengrass/v2/logs/greengrass.log \
    --filter deployment,serviceName=DeploymentService \
    --filter level=INFO \
    --time-window 2020-12-08T01:11:17,2020-12-08T01:11:22

2020-12-08T01:11:17.615Z [INFO] (pool-2-thread-14) com.aws.greengrass.deployment.DeploymentService: Current deployment finished. {DeploymentId=44d89f46-1a29-4044-ad89-5151213dfcbc, serviceName=DeploymentService, currentState=RUNNING}
2020-12-08T01:11:17.675Z [INFO] (pool-2-thread-14) com.aws.greengrass.deployment.IotJobsHelper: Updating status of persisted deployment. {Status=SUCCEEDED, StatusDetails={detailed-deployment-status=SUCCESSFUL}, ThingName=MyThing, JobId=22d89f46-1a29-4044-ad89-5151213dfcbc

listez les mots clés

Afficher les mots clés suggérés que vous pouvez utiliser pour filtrer les fichiers journaux.

Résumé
greengrass-cli logs list-keywords [arguments]
Arguments

Aucun

Sortie

Les exemples suivants montrent le résultat produit lorsque vous exécutez cette commande.

$ sudo greengrass-cli logs list-keywords

Here is a list of suggested keywords for Greengrass log:
level=$str
thread=$str
loggerName=$str
eventType=$str
serviceName=$str
error=$str
$ sudo greengrass-cli logs list-keywords --syslog

Here is a list of suggested keywords for syslog:
priority=$int
host=$str
logger=$str
class=$str

list-log-files

Afficher les fichiers journaux situés dans un répertoire spécifié.

Résumé
greengrass-cli logs list-log-files [arguments]
Arguments

--log-dir,-ld. Le chemin d'accès au répertoire dans lequel vérifier la présence de fichiers journaux.

Sortie

L'exemple suivant montre le résultat produit lorsque vous exécutez cette commande.

$ sudo greengrass-cli logs list-log-files -ld /greengrass/v2/logs/

/greengrass/v2/logs/aws.greengrass.Nucleus.log
/greengrass/v2/logs/main.log
/greengrass/v2/logs/greengrass.log
Total 3 files found.