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. # Interface de ligne de commande Greengrass L'interface de ligne de commande (CLI) Greengrass vous permet d'interagir avec AWS IoT Greengrass Core sur votre appareil pour développer des composants et résoudre des problèmes localement. Par exemple, vous pouvez utiliser la CLI Greengrass pour créer un déploiement local et redémarrer un composant sur le périphérique principal. Déployez le [composant Greengrass CLI](greengrass-cli-component.md) (`aws.greengrass.Cli`) pour installer la Greengrass CLI sur votre appareil principal. **Important** Nous vous recommandons d'utiliser ce composant uniquement dans les environnements de développement, et non dans les environnements de production. Ce composant permet d'accéder aux informations et aux opérations dont vous n'avez généralement pas besoin dans un environnement de production. Suivez le principe du moindre privilège en déployant ce composant uniquement sur les appareils principaux là où vous en avez besoin. **Topics** + [Installation de la CLI Greengrass](install-gg-cli.md) + [Commandes Greengrass CLI](gg-cli-reference.md) # Installation de la CLI Greengrass Vous pouvez installer la CLI Greengrass de l'une des manières suivantes : + Utilisez `--deploy-dev-tools` cet argument lorsque vous configurez le logiciel AWS IoT Greengrass Core pour la première fois sur votre appareil. Vous devez également spécifier `--provision true` d'appliquer cet argument. + Déployez le composant Greengrass CLI (`aws.greengrass.Cli`) sur votre appareil. Cette section décrit les étapes de déploiement du composant Greengrass CLI. Pour plus d'informations sur l'installation de la CLI Greengrass lors de la configuration initiale, consultez. [Tutoriel : Débuter avec AWS IoT Greengrass V2](getting-started.md) ## Conditions préalables Pour déployer le composant Greengrass CLI, vous devez répondre aux exigences suivantes : + AWS IoT Greengrass Logiciel de base installé et configuré sur votre appareil principal. Pour de plus amples informations, veuillez consulter [Tutoriel : Débuter avec AWS IoT Greengrass V2](getting-started.md). + Pour utiliser le AWS CLI pour déployer la Greengrass CLI, vous devez avoir installé et configuré le. AWS CLI Pour plus d'informations, veuillez consulter [configuration de l'outil AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) dans le *guide de l'utilisateur de l'outil AWS Command Line Interface *. + Vous devez être autorisé à utiliser la CLI Greengrass pour interagir avec le logiciel AWS IoT Greengrass principal. Pour utiliser la CLI Greengrass, effectuez l'une des opérations suivantes : + Utilisez l'utilisateur du système qui exécute le logiciel AWS IoT Greengrass Core. + Utilisez un utilisateur doté d'autorisations root ou administratives. Sur les appareils principaux de Linux, vous pouvez l'utiliser `sudo` pour obtenir des autorisations root. + Utilisez un utilisateur système appartenant à un groupe que vous spécifiez dans les paramètres de `AuthorizedWindowsGroups` configuration `AuthorizedPosixGroups` ou lorsque vous déployez le composant. Pour plus d'informations, consultez la section Configuration des [composants de la CLI Greengrass](greengrass-cli-component.md#greengrass-cli-component-configuration). ## Déployer le composant Greengrass CLI Procédez comme suit pour déployer le composant Greengrass CLI sur votre appareil principal : ### Pour déployer le composant Greengrass CLI (console) 1. Connectez-vous à la [console AWS IoT Greengrass](https://console.aws.amazon.com/greengrass). 1. Dans le menu de navigation, sélectionnez **Composants**. 1. Sur la page **Components (Composants)**, sous l'onglet **Public components (Composants publics)**, choisissez `aws.greengrass.Cli`. 1. Sur la page **aws.greengrass.Cli**, choisissez **Deploy (Déployer)**. 1. Dans **Ajouter au déploiement**, choisissez **Créer un nouveau déploiement**. 1. **Sur la page **Spécifier la cible**, sous **Cibles de déploiement**, dans la liste **Nom de la cible**, choisissez le groupe Greengrass vers lequel vous souhaitez effectuer le déploiement, puis cliquez sur Next.** 1. Sur la page **Sélectionner les composants**, vérifiez que le **aws.greengrass.Cli**composant est sélectionné, puis choisissez **Next**. 1. Sur la page **Configurer les composants**, conservez les paramètres de configuration par défaut et choisissez **Next**. 1. Sur la page **Configurer les paramètres avancés**, conservez les paramètres de configuration par défaut et choisissez **Next**. 1. Sur la page de **révision**, cliquez sur **Déployer** ### Pour déployer le composant Greengrass CLI ()AWS CLI 1. Sur votre appareil, créez un `deployment.json` fichier pour définir la configuration de déploiement du composant Greengrass CLI. Ce fichier doit ressembler à ce qui suit : ``` { "targetArn":"targetArn", "components": { "aws.greengrass.Cli": { "componentVersion": "2.16.1", "configurationUpdate": { "merge": "{\"AuthorizedPosixGroups\":\",,...,\",\"AuthorizedWindowsGroups\":\",,...,\"}" } } } } ``` + Dans le champ `target`, remplacez `targetArn` par l'Amazon Resource Name (ARN) de l'objet ou du groupe d'objets à cibler pour le déploiement, au format suivant : + Objet : `arn:aws:iot:region:account-id:thing/thingName` + Groupe d'objets : `arn:aws:iot:region:account-id:thinggroup/thingGroupName` + Dans l'objet `aws.greengrass.Cli` composant, spécifiez les valeurs comme suit : `version` Version du composant Greengrass CLI. `configurationUpdate.AuthorizedPosixGroups` (Facultatif) Chaîne contenant une liste de groupes de systèmes séparés par des virgules. Vous autorisez ces groupes de systèmes à utiliser la CLI Greengrass pour interagir avec le logiciel AWS IoT Greengrass principal. Vous pouvez spécifier des noms de groupes ou des groupes IDs. Par exemple, `group1,1002,group3` autorise trois groupes de systèmes (`group1``1002`, et`group3`) à utiliser la CLI Greengrass. Si vous ne spécifiez aucun groupe à autoriser, vous pouvez utiliser la CLI Greengrass en tant qu'utilisateur root (`sudo`) ou en tant qu'utilisateur système qui exécute le logiciel AWS IoT Greengrass Core. `configurationUpdate.AuthorizedWindowsGroups` (Facultatif) Chaîne contenant une liste de groupes de systèmes séparés par des virgules. Vous autorisez ces groupes de systèmes à utiliser la CLI Greengrass pour interagir avec le logiciel AWS IoT Greengrass principal. Vous pouvez spécifier des noms de groupes ou des groupes IDs. Par exemple, `group1,1002,group3` autorise trois groupes de systèmes (`group1``1002`, et`group3`) à utiliser la CLI Greengrass. Si vous ne spécifiez aucun groupe à autoriser, vous pouvez utiliser la CLI Greengrass en tant qu'administrateur ou en tant qu'utilisateur du système qui exécute le logiciel AWS IoT Greengrass principal. 1. Exécutez la commande suivante pour déployer le composant Greengrass CLI sur le périphérique : ``` $ aws greengrassv2 create-deployment --cli-input-json file://path/to/deployment.json ``` Pendant l'installation, le composant ajoute un lien symbolique `greengrass-cli` dans le `/greengrass/v2/bin` dossier de votre appareil, et vous exécutez la CLI Greengrass à partir de ce chemin. Pour exécuter la CLI Greengrass sans son chemin absolu, ajoutez votre `/greengrass/v2/bin` dossier à votre variable PATH. Pour vérifier l'installation de Greengrass CLI, exécutez la commande suivante : ------ #### [ Linux or Unix ] ``` /greengrass/v2/bin/greengrass-cli help ``` ------ #### [ Windows ] ``` C:\greengrass\v2\bin\greengrass-cli help ``` ------ Vous devriez voir la sortie suivante : ``` Usage: greengrass-cli [-hV] [--ggcRootPath=] [COMMAND] Greengrass command line interface --ggcRootPath= The AWS IoT Greengrass V2 root directory. -h, --help Show this help message and exit. -V, --version Print version information and exit. Commands: help Show help information for a command. component Retrieve component information and stop or restart components. deployment Create local deployments and retrieve deployment status. logs Analyze Greengrass logs. get-debug-password Generate a password for use with the HTTP debug view component. ``` S'il `greengrass-cli` n'est pas trouvé, le déploiement n'a peut-être pas réussi à installer la CLI Greengrass. Pour de plus amples informations, veuillez consulter [Résolution des problèmes AWS IoT Greengrass V2](troubleshooting.md). # Commandes Greengrass CLI La CLI Greengrass fournit une interface de ligne de commande pour interagir localement avec votre appareil AWS IoT Greengrass principal. Les commandes Greengrass CLI utilisent le format suivant. ``` $ greengrass-cli [arguments] ``` Par défaut, le fichier `greengrass-cli` exécutable du `/greengrass/v2/bin/` dossier interagit avec la version du logiciel AWS IoT Greengrass Core exécutée dans le `/greengrass/v2` dossier. Si vous appelez un exécutable qui n'est pas placé à cet emplacement, ou si vous souhaitez interagir avec le logiciel AWS IoT Greengrass Core à un autre emplacement, vous devez utiliser l'une des méthodes suivantes pour spécifier explicitement le chemin racine du logiciel AWS IoT Greengrass Core avec lequel vous souhaitez interagir : + Définissez la variable d'environnement `GGC_ROOT_PATH` sur `/greengrass/v2`. + Ajoutez l'`--ggcRootPath /greengrass/v2`argument à votre commande comme indiqué dans l'exemple suivant. ``` greengrass-cli --ggcRootPath /greengrass/v2 [arguments] ``` Vous pouvez utiliser les arguments suivants avec n'importe quelle commande : + À utiliser `--help` pour obtenir des informations sur une commande Greengrass CLI spécifique. + À utiliser `--version` pour obtenir des informations sur la version de Greengrass CLI. Cette section décrit les commandes de la CLI Greengrass et fournit des exemples de ces commandes. Le synopsis de chaque commande montre ses arguments et leur utilisation. Les arguments facultatifs sont indiqués entre crochets. **Topics** + [composant](gg-cli-component.md) + [déploiement](gg-cli-deployment.md) + [journaux](gg-cli-logs.md) + [get-debug-password](gg-cli-get-debug-password.md) # composant Utilisez la `component` commande pour interagir avec les composants locaux de votre appareil principal. **Sous-commandes** + [détails](#component-details) + [liste](#component-list) + [redémarrer](#component-restart) + [stop](#component-stop) ## détails Récupérez la version, le statut et la configuration d'un composant. **Résumé** ``` greengrass-cli component details --name ``` **Arguments** `--name`,`-n`. Le nom du composant. **Sortie** L'exemple suivant montre le résultat produit lorsque vous exécutez cette commande. ``` $ sudo greengrass-cli component details --name MyComponent Component Name: MyComponent Version: 1.0.0 State: RUNNING Configuration: null ``` ## liste Récupérez le nom, la version, l'état et la configuration de chaque composant installé sur le périphérique. **Résumé** ``` greengrass-cli component list ``` **Arguments** Aucun **Sortie** L'exemple suivant montre le résultat produit lorsque vous exécutez cette commande. ``` $ sudo greengrass-cli component list Components currently running in Greengrass: Component Name: FleetStatusService Version: 0.0.0 State: RUNNING Configuration: {"periodicUpdateIntervalSec":86400.0} Component Name: UpdateSystemPolicyService Version: 0.0.0 State: RUNNING Configuration: null Component Name: aws.greengrass.Nucleus Version: 2.0.0 State: FINISHED Configuration: {"awsRegion":"region","runWithDefault":{"posixUser":"ggc_user:ggc_group"},"telemetry":{}} Component Name: DeploymentService Version: 0.0.0 State: RUNNING Configuration: null Component Name: TelemetryAgent Version: 0.0.0 State: RUNNING Configuration: null Component Name: aws.greengrass.Cli Version: 2.0.0 State: RUNNING Configuration: {"AuthorizedPosixGroups":"ggc_user"} ``` ## redémarrer Redémarrez les composants. **Résumé** ``` greengrass-cli component restart --names ,... ``` **Arguments** `--names`,`-n`. Le nom du composant. Au moins un nom de composant est requis. Vous pouvez spécifier des noms de composants supplémentaires, en séparant chaque nom par une virgule. **Sortie** Aucun ## stop Arrêtez d'exécuter les composants. **Résumé** ``` greengrass-cli component stop --names ,... ``` **Arguments** `--names`,`-n`. Le nom du composant. Au moins un nom de composant est requis. Vous pouvez spécifier des noms de composants supplémentaires si nécessaire, en séparant chaque nom par une virgule. **Sortie** Aucun # déploiement Utilisez la `deployment` commande pour interagir avec les composants locaux de votre appareil principal. Pour suivre la progression d'un déploiement local, utilisez la `status` sous-commande. Vous ne pouvez pas suivre la progression d'un déploiement local à l'aide de la console. **Sous-commandes** + [créer](#deployment-create) + [annuler](#deployment-cancel) + [liste](#deployment-list) + [status](#deployment-status) ## créer Créez ou mettez à jour un déploiement local à l'aide de recettes de composants, d'artefacts et d'arguments d'exécution spécifiés. **Résumé** ``` greengrass-cli deployment create --recipeDir path/to/component/recipe [--artifactDir path/to/artifact/folder ] [--update-config {component-configuration}] [--groupId ] [--merge "="]... [--runWith ":posixUser=[:]"]... [--systemLimits "{component-system-resource-limits}]"]... [--remove ,...] [--failure-handling-policy ] ``` **Arguments** + `--recipeDir`,`-r`. Le chemin complet du dossier contenant les fichiers de recette des composants. + `--artifactDir`,`-a`. Le chemin complet du dossier contenant les fichiers d'artefacts que vous souhaitez inclure dans votre déploiement. Le dossier des artefacts doit contenir la structure de répertoire suivante : ``` /path/to/artifact/folder/// ``` + `--update-config`,`-c`. Les arguments de configuration pour le déploiement, fournis sous forme de chaîne JSON ou de fichier JSON. La chaîne JSON doit être au format suivant : ``` { \ "componentName": { \ "MERGE": {"config-key": "config-value"}, \ "RESET": ["path/to/reset/"] \ } \ } ``` `MERGE`et `RESET` distinguent les majuscules des minuscules et doivent être en majuscules. + `--groupId`,`-g`. Le groupe d'objets cible pour le déploiement. + `--merge`,`-m`. Le nom et la version du composant cible que vous souhaitez ajouter ou mettre à jour. Vous devez fournir les informations du composant dans le format`=`. Utilisez un argument distinct pour chaque composant supplémentaire à spécifier. Si nécessaire, utilisez l'`--runWith`argument pour fournir les `windowsUser` informations `posixUser``posixGroup`, et pour exécuter le composant. + `--runWith`. Les `posixUser` `windowsUser` informations et relatives à l'exécution d'un composant générique ou Lambda. `posixGroup` Vous devez fournir ces informations dans le format`:{posixUser|windowsUser}=[:<=posixGroup>]`. Par exemple, vous pouvez spécifier **HelloWorld:posixUser=ggc\$1user:ggc\$1group** ou**HelloWorld:windowsUser=ggc\$1user**. Utilisez un argument distinct pour chaque option supplémentaire à spécifier. Pour de plus amples informations, veuillez consulter [Configurer l'utilisateur qui exécute les composants](configure-greengrass-core-v2.md#configure-component-user). + `--systemLimits`. Les limites de ressources du système à appliquer aux processus des composants Lambda génériques et non conteneurisés sur le périphérique principal. Vous pouvez configurer la quantité maximale d'utilisation du processeur et de la RAM que les processus de chaque composant peuvent utiliser. Spécifiez un objet JSON sérialisé ou un chemin d'accès à un fichier JSON. L'objet JSON doit avoir le format suivant. ``` { \ "componentName": { \ "cpus": cpuTimeLimit, \ "memory": memoryLimitInKb \ } \ } ``` Vous pouvez configurer les limites de ressources système suivantes pour chaque composant : + `cpus`— Le temps processeur maximal que les processus de ce composant peuvent utiliser sur le périphérique principal. Le temps processeur total d'un appareil principal est équivalent au nombre de cœurs processeurs de l'appareil. Par exemple, sur un périphérique principal doté de 4 cœurs de processeur, vous pouvez définir cette valeur `2` pour limiter les processus de ce composant à 50 % d'utilisation de chaque cœur de processeur. Sur un appareil doté d'un cœur de processeur, vous pouvez définir cette valeur `0.25` pour limiter les processus de ce composant à 25 % d'utilisation du processeur. Si vous définissez cette valeur sur un nombre supérieur au nombre de cœurs de processeur, le logiciel AWS IoT Greengrass Core ne limite pas l'utilisation du processeur par le composant. + `memory`— La quantité maximale de RAM (en kilo-octets) que les processus de ce composant peuvent utiliser sur le périphérique principal. Pour de plus amples informations, veuillez consulter [Configuration des limites de ressources système pour les composants](configure-greengrass-core-v2.md#configure-component-system-resource-limits). Cette fonctionnalité est disponible pour les versions 2.4.0 et ultérieures du [composant Greengrass nucleus et de la CLI Greengrass](greengrass-nucleus-component.md) sur les appareils principaux Linux. AWS IoT Greengrass ne prend actuellement pas en charge cette fonctionnalité sur les appareils Windows principaux. + `--remove`. Nom du composant cible que vous souhaitez supprimer d'un déploiement local. Pour supprimer un composant qui a été fusionné d'un déploiement dans le cloud, vous devez fournir l'ID de groupe du groupe d'objets cible au format suivant : ------ #### [ Greengrass nucleus v2.4.0 and later ] ``` --remove --groupId ``` ------ #### [ Earlier than v2.4.0 ] ``` --remove --groupId thinggroup/ ``` ------ + `--failure-handling-policy`. Définit l'action entreprise en cas d'échec d'un déploiement. Vous pouvez définir deux actions : + `ROLLBACK` – + `DO_NOTHING` – Cette fonctionnalité est disponible pour les versions 2.11.0 et ultérieures du. [Noyau de Greengrass](greengrass-nucleus-component.md) **Sortie** L'exemple suivant montre le résultat produit lorsque vous exécutez cette commande. ``` $ sudo greengrass-cli deployment create \ --merge MyApp1=1.0.0 \ --merge MyApp2=1.0.0 --runWith MyApp2:posixUser=ggc_user \ --remove MyApp3 \ --recipeDir recipes/ \ --artifactDir artifacts/ Local deployment has been submitted! Deployment Id: 44d89f46-1a29-4044-ad89-5151213dfcbc ``` ## annuler Annule le déploiement spécifié. Résumé ``` greengrass-cli deployment cancel -i ``` Arguments `-i`. Identifiant unique du déploiement à annuler. L'ID de déploiement est renvoyé dans la sortie de la `create` commande. Sortie + Aucun ## liste Récupérez l'état des 10 derniers déploiements locaux. **Résumé** ``` greengrass-cli deployment list ``` **Arguments** Aucun **Sortie** L'exemple suivant montre le résultat produit lorsque vous exécutez cette commande. En fonction de l'état de votre déploiement, la sortie affiche l'une des valeurs d'état suivantes : `IN_PROGRESS``SUCCEEDED`, ou`FAILED`. ``` $ sudo greengrass-cli deployment list 44d89f46-1a29-4044-ad89-5151213dfcbc: SUCCEEDED Created on: 6/27/23 11:05 AM ``` ## status Récupérez l'état d'un déploiement spécifique. **Résumé** ``` greengrass-cli deployment status -i ``` **Arguments** `-i`. ID du déploiement. **Sortie** L'exemple suivant montre le résultat produit lorsque vous exécutez cette commande. En fonction de l'état de votre déploiement, la sortie affiche l'une des valeurs d'état suivantes : `IN_PROGRESS``SUCCEEDED`, ou`FAILED`. ``` $ sudo greengrass-cli deployment status -i 44d89f46-1a29-4044-ad89-5151213dfcbc 44d89f46-1a29-4044-ad89-5151213dfcbc: FAILED Created on: 6/27/23 11:05 AM Detailed Status: Deployment Error Stack: List of error codes Deployment Error Types: List of error types Failure Cause: Cause ``` # journaux Utilisez la `logs` commande pour analyser les journaux Greengrass sur votre appareil principal. **Sous-commandes** + [get](#logs-get) + [listez les mots clés](#logs-list-keywords) + [list-log-files](#logs-list-log-files) ## get Collectez, filtrez et visualisez les fichiers journaux de Greengrass. Cette commande prend uniquement en charge les fichiers journaux au format JSON. Vous pouvez spécifier le [format de journalisation](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-logging-format) 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 ] [--time-window , ] [--verbose ] [--no-color ] [--before ] [--after ] [--syslog ] [--max-long-queue-size ] ``` **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 fonctionner 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`,`. 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 :. `+|-[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 à l'aide du protocole syslog défini par. 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 Greengrass ne 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. ``` # get-debug-password Utilisez la `get-debug-password` commande pour imprimer un mot de passe généré aléatoirement pour le [composant de console de débogage local](local-debug-console-component.md) (`aws.greengrass.LocalDebugConsole`). Le mot de passe expire 8 heures après sa création. **Résumé** ``` greengrass-cli get-debug-password ``` **Arguments** Aucun **Sortie** L'exemple suivant montre le résultat produit lorsque vous exécutez cette commande. ``` $ sudo greengrass-cli get-debug-password Username: debug Password: bEDp3MOHdj8ou2w5de_sCBI2XAaguy3a8XxREXAMPLE Password expires at: 2021-04-01T17:01:43.921999931-07:00 The local debug console is configured to use TLS security. The certificate is self-signed so you will need to bypass your web browser's security warnings to open the console. Before you bypass the security warning, verify that the certificate fingerprint matches the following fingerprints. SHA-256: 15 0B 2C E2 54 8B 22 DE 08 46 54 8A B1 2B 25 DE FB 02 7D 01 4E 4A 56 67 96 DA A6 CC B1 D2 C4 1B SHA-1: BC 3E 16 04 D3 80 70 DA E0 47 25 F9 90 FA D6 02 80 3E B5 C1 ```