

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.

# Console de débogage locale
<a name="local-debug-console-component"></a>

Le composant de la console de débogage locale (`aws.greengrass.LocalDebugConsole`) fournit un tableau de bord local qui affiche des informations sur vos appareils AWS IoT Greengrass principaux et leurs composants. Vous pouvez utiliser ce tableau de bord pour déboguer votre appareil principal et gérer les composants locaux.

**Important**  
 <a name="local-dev-tools-production-environment-warning"></a>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 à des informations et à des 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 où vous en avez besoin.  

**Topics**
+ [Versions](#local-debug-console-component-versions)
+ [Type](#local-debug-console-component-type)
+ [Système d’exploitation](#local-debug-console-component-os-support)
+ [Exigences](#local-debug-console-component-requirements)
+ [Dépendances](#local-debug-console-component-dependencies)
+ [Configuration](#local-debug-console-component-configuration)
+ [Usage](#local-debug-console-component-usage)
+ [Fichier journal local](#local-debug-console-component-log-file)
+ [Journal des modifications](#local-debug-console-component-changelog)

## Versions
<a name="local-debug-console-component-versions"></a>

Les versions de ce composant sont les suivantes :
+ 2.4.x
+ 2.3.x
+ 2.2.x
+ 2.1.x
+ 2.0.x

## Type
<a name="local-debug-console-component-type"></a>

<a name="public-component-type-plugin-para1"></a>Ce composant est un composant de plug-in (`aws.greengrass.plugin`). Le noyau [ Greengrass ](greengrass-nucleus-component.md) exécute ce composant dans la même machine virtuelle Java (JVM) que le noyau. Le noyau redémarre lorsque vous modifiez la version de ce composant sur le périphérique principal.

<a name="public-component-type-plugin-para2"></a>Ce composant utilise le même fichier journal que le noyau Greengrass. Pour de plus amples informations, veuillez consulter [AWS IoT Greengrass Journaux de surveillance](monitor-logs.md).

<a name="public-component-type-more-information"></a>Pour de plus amples informations, veuillez consulter [Types de composant](develop-greengrass-components.md#component-types).

## Système d’exploitation
<a name="local-debug-console-component-os-support"></a>

Ce composant peut être installé sur les appareils principaux qui exécutent les systèmes d'exploitation suivants :
+ Linux
+ Windows

## Exigences
<a name="local-debug-console-component-requirements"></a>

Ce composant répond aux exigences suivantes :
+ Vous utilisez un nom d'utilisateur et un mot de passe pour vous connecter au tableau de bord. Le nom d'utilisateur, qui est`debug`, vous est fourni. Vous devez utiliser l' AWS IoT Greengrass interface de ligne de commande pour créer un mot de passe temporaire qui vous authentifie auprès du tableau de bord d'un appareil principal. Vous devez être en mesure d'utiliser la AWS IoT Greengrass CLI pour utiliser la console de débogage locale. Pour plus d'informations, consultez les exigences [ de la CLI ](greengrass-cli-component.md#greengrass-cli-component-requirements) Greengrass. Pour plus d'informations sur la génération du mot de passe et la connexion, consultez la section Utilisation [ des composants de la console de débogage ](#local-debug-console-component-usage) locale.
+ Le composant de la console de débogage locale est pris en charge pour fonctionner dans un VPC.

## Dépendances
<a name="local-debug-console-component-dependencies"></a>

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 ](#local-debug-console-component-changelog) 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](https://console.aws.amazon.com/greengrass). Sur la page des détails des composants, recherchez la ** liste des ** dépendances.

------
#### [ 2.4.6 ]

Le tableau suivant répertorie les dépendances de la version 2.4.6 de ce composant.


| Dépendance | Versions compatibles | Type de dépendance | 
| --- | --- | --- | 
| [Noyau Greengrass ](greengrass-nucleus-component.md) | > = 2,10,0 < 2,17,0 | Stricte | 
| [Greengrass CLI ](greengrass-cli-component.md) | > = 2,10,0 < 2,17,0 | Stricte | 

------
#### [ 2.4.5 ]

Le tableau suivant répertorie les dépendances pour la version 2.4.5 de ce composant.


| Dépendance | Versions compatibles | Type de dépendance | 
| --- | --- | --- | 
| [Noyau Greengrass ](greengrass-nucleus-component.md) | > = 2,1,0 < 2,16,0 | Stricte | 
| [Greengrass CLI ](greengrass-cli-component.md) | > = 2,1,0 < 2,16,0 | Stricte | 

------
#### [ 2.4.4 ]

Le tableau suivant répertorie les dépendances pour la version 2.4.4 de ce composant.


| Dépendance | Versions compatibles | Type de dépendance | 
| --- | --- | --- | 
| [Noyau Greengrass ](greengrass-nucleus-component.md) | > = 2,10,0 < 2,15,0 | Stricte | 
| [Greengrass CLI ](greengrass-cli-component.md) | > = 2,10,0 < 2,15,0 | Stricte | 

------
#### [ 2.4.3 ]

Le tableau suivant répertorie les dépendances pour la version 2.4.3 de ce composant.


| Dépendance | Versions compatibles | Type de dépendance | 
| --- | --- | --- | 
| [Noyau Greengrass ](greengrass-nucleus-component.md) | > = 2,1,0 < 2,14,0 | Stricte | 
| [Greengrass CLI ](greengrass-cli-component.md) | > = 2,1,0 < 2,14,0 | Stricte | 

------
#### [ 2.4.1 – 2.4.2 ]

Le tableau suivant répertorie les dépendances pour les versions 2.4.1 à 2.4.2 de ce composant.


| Dépendance | Versions compatibles | Type de dépendance | 
| --- | --- | --- | 
| [Noyau Greengrass ](greengrass-nucleus-component.md) | > = 2,1,0 < 2,13,0 | Stricte | 
| [Greengrass CLI ](greengrass-cli-component.md) | > = 2,1,0 < 2,13,0 | Stricte | 

------
#### [ 2.4.0 ]

Le tableau suivant répertorie les dépendances pour la version 2.4.0 de ce composant.


| Dépendance | Versions compatibles | Type de dépendance | 
| --- | --- | --- | 
| [Noyau Greengrass ](greengrass-nucleus-component.md) | > = 2,10,0 < 2,12,0 | Stricte | 
| [Greengrass CLI ](greengrass-cli-component.md) | > = 2,10,0 < 2,12,0 | Stricte | 

------
#### [ 2.3.0 and 2.3.1 ]

Le tableau suivant répertorie les dépendances pour les versions 2.3.0 et 2.3.1 de ce composant.


| Dépendance | Versions compatibles | Type de dépendance | 
| --- | --- | --- | 
| [Noyau Greengrass ](greengrass-nucleus-component.md) | > = 2,10,0 < 2,12,0 | Stricte | 
| [Greengrass CLI ](greengrass-cli-component.md) | > = 2,10,0 < 2,12,0 | Stricte | 

------
#### [ 2.2.9 ]

Le tableau suivant répertorie les dépendances pour la version 2.2.9 de ce composant.


| Dépendance | Versions compatibles | Type de dépendance | 
| --- | --- | --- | 
| [Noyau Greengrass ](greengrass-nucleus-component.md) | > = 2,1,0 < 2,12,0 | Stricte | 
| [Greengrass CLI ](greengrass-cli-component.md) | > = 2,1,0 < 2,12,0 | Stricte | 

------
#### [ 2.2.8 ]

Le tableau suivant répertorie les dépendances de la version 2.2.8 de ce composant.


| Dépendance | Versions compatibles | Type de dépendance | 
| --- | --- | --- | 
| [Noyau Greengrass ](greengrass-nucleus-component.md) | > = 2,11,0 < 2,11,0 | Stricte | 
| [Greengrass CLI ](greengrass-cli-component.md) | > = 2,11,0 < 2,11,0 | Stricte | 

------
#### [ 2.2.7 ]

Le tableau suivant répertorie les dépendances pour la version 2.2.7 de ce composant.


| Dépendance | Versions compatibles | Type de dépendance | 
| --- | --- | --- | 
| [Noyau Greengrass ](greengrass-nucleus-component.md) | > = 2,1,0 < 2,10,0 | Stricte | 
| [Greengrass CLI ](greengrass-cli-component.md) | > = 2,1,0 < 2,10,0 | Stricte | 

------
#### [ 2.2.6 ]

Le tableau suivant répertorie les dépendances pour la version 2.2.6 de ce composant.


| Dépendance | Versions compatibles | Type de dépendance | 
| --- | --- | --- | 
| [Noyau Greengrass ](greengrass-nucleus-component.md) | > = 2,1,0 < 2,9,0 | Stricte | 
| [Greengrass CLI ](greengrass-cli-component.md) | > = 2,1,0 < 2,9,0 | Stricte | 

------
#### [ 2.2.5 ]

Le tableau suivant répertorie les dépendances pour la version 2.2.5 de ce composant.


| Dépendance | Versions compatibles | Type de dépendance | 
| --- | --- | --- | 
| [Noyau Greengrass ](greengrass-nucleus-component.md) | > = 2,1,0 < 2,8,0 | Stricte | 
| [Greengrass CLI ](greengrass-cli-component.md) | > = 2,1,0 < 2,8,0 | Stricte | 

------
#### [ 2.2.4 ]

Le tableau suivant répertorie les dépendances pour la version 2.2.4 de ce composant.


| Dépendance | Versions compatibles | Type de dépendance | 
| --- | --- | --- | 
| [Noyau Greengrass ](greengrass-nucleus-component.md) | > = 2,1,0 < 2,7,0 | Stricte | 
| [Greengrass CLI ](greengrass-cli-component.md) | > = 2,1,0 < 2,7,0 | Stricte | 

------
#### [ 2.2.3 ]

Le tableau suivant répertorie les dépendances pour la version 2.2.3 de ce composant.


| Dépendance | Versions compatibles | Type de dépendance | 
| --- | --- | --- | 
| [Noyau Greengrass ](greengrass-nucleus-component.md) | > = 2,1,0 < 2,6,0 | Stricte | 
| [Greengrass CLI ](greengrass-cli-component.md) | > = 2,1,0 < 2,6,0 | Stricte | 

------
#### [ 2.2.2 ]

Le tableau suivant répertorie les dépendances pour la version 2.2.2 de ce composant.


| Dépendance | Versions compatibles | Type de dépendance | 
| --- | --- | --- | 
| [Noyau Greengrass ](greengrass-nucleus-component.md) | > = 2,1,0 < 2,5,0 | Stricte | 
| [Greengrass CLI ](greengrass-cli-component.md) | > = 2,1,0 < 2,5,0 | Stricte | 

------
#### [ 2.2.1 ]

Le tableau suivant répertorie les dépendances pour la version 2.2.1 de ce composant.


| Dépendance | Versions compatibles | Type de dépendance | 
| --- | --- | --- | 
| [Noyau Greengrass ](greengrass-nucleus-component.md) | > = 2,1,0 < 2,4,0 | Stricte | 
| [Greengrass CLI ](greengrass-cli-component.md) | > = 2,1,0 < 2,4,0 | Stricte | 

------
#### [ 2.2.0 ]

Le tableau suivant répertorie les dépendances pour la version 2.2.0 de ce composant.


| Dépendance | Versions compatibles | Type de dépendance | 
| --- | --- | --- | 
| [Noyau Greengrass ](greengrass-nucleus-component.md) | > = 2,1,0 < 2,3,0 | Stricte | 
| [Greengrass CLI ](greengrass-cli-component.md) | > = 2,1,0 < 2,3,0 | Stricte | 

------
#### [ 2.1.0 ]

Le tableau suivant répertorie les dépendances pour la version 2.1.0 de ce composant.


| Dépendance | Versions compatibles | Type de dépendance | 
| --- | --- | --- | 
| [Noyau Greengrass ](greengrass-nucleus-component.md) | > = 2,1,0 < 2,2,0 | Stricte | 
| [Greengrass CLI ](greengrass-cli-component.md) | > = 2,1,0 < 2,2,0 | Stricte | 

------
#### [ 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 | 
| --- | --- | --- | 
| [Noyau Greengrass ](greengrass-nucleus-component.md) |  > = 2,0,3 < 2,1,0  | Flexible | 
| [Greengrass CLI ](greengrass-cli-component.md) |  > = 2,0,3 < 2,1,0  | Flexible | 

------

Pour plus d'informations sur les dépendances des composants, consultez la référence des recettes des [ composants](component-recipe-reference.md#recipe-reference-component-dependencies).

## Configuration
<a name="local-debug-console-component-configuration"></a>

Ce composant fournit les paramètres de configuration suivants que vous pouvez personnaliser lorsque vous déployez le composant.

------
#### [ v2.1.x - v2.4.x ]

`httpsEnabled`  
(Facultatif) Vous pouvez activer la communication HTTPS pour la console de débogage locale. Si vous activez la communication HTTPS, la console de débogage locale crée un certificat auto-signé. Les navigateurs Web affichent des avertissements de sécurité pour les sites Web qui utilisent des certificats auto-signés. Vous devez donc vérifier le certificat manuellement. Vous pouvez ensuite contourner l'avertissement. Pour de plus amples informations, veuillez consulter [Usage](#local-debug-console-component-usage).  
Par défaut: `true`

`port`  <a name="local-debug-console-component-configuration-port"></a>
(Facultatif) Port sur lequel fournir la console de débogage locale.  
Valeur par défaut : `1441`

`websocketPort`  <a name="local-debug-console-component-configuration-websocket-port"></a>
(Facultatif) Le port Websocket à utiliser pour la console de débogage locale.  
Valeur par défaut : `1442`

`bindHostname`  <a name="local-debug-console-component-configuration-bind-hostname"></a>
(Facultatif) Le nom d'hôte à utiliser pour la console de débogage locale.  
Si vous [ exécutez le logiciel AWS IoT Greengrass Core dans un conteneur Docker](run-greengrass-docker.md), définissez ce paramètre sur`0.0.0.0`, afin de pouvoir ouvrir la console de débogage locale en dehors du conteneur Docker.  
Valeur par défaut : `localhost`

**Example Exemple : fusion de configuration et mise à jour**  
L'exemple de configuration suivant indique d'ouvrir la console de débogage locale sur des ports autres que ceux par défaut et de désactiver le protocole HTTPS.  

```
{
  "httpsEnabled": false,
  "port": "10441",
  "websocketPort": "10442"
}
```

------
#### [ v2.0.x ]

`port`  <a name="local-debug-console-component-configuration-port"></a>
(Facultatif) Port sur lequel fournir la console de débogage locale.  
Valeur par défaut : `1441`

`websocketPort`  <a name="local-debug-console-component-configuration-websocket-port"></a>
(Facultatif) Le port Websocket à utiliser pour la console de débogage locale.  
Valeur par défaut : `1442`

`bindHostname`  <a name="local-debug-console-component-configuration-bind-hostname"></a>
(Facultatif) Le nom d'hôte à utiliser pour la console de débogage locale.  
Si vous [ exécutez le logiciel AWS IoT Greengrass Core dans un conteneur Docker](run-greengrass-docker.md), définissez ce paramètre sur`0.0.0.0`, afin de pouvoir ouvrir la console de débogage locale en dehors du conteneur Docker.  
Valeur par défaut : `localhost`

**Example Exemple : fusion de configuration et mise à jour**  
L'exemple de configuration suivant indique d'ouvrir la console de débogage locale sur des ports autres que ceux par défaut.  

```
{
  "port": "10441",
  "websocketPort": "10442"
}
```

------

## Usage
<a name="local-debug-console-component-usage"></a>

Pour utiliser la console de débogage locale, créez une session à partir de la CLI Greengrass. Lorsque vous créez une session, la CLI Greengrass fournit un nom d'utilisateur et un mot de passe temporaire que vous pouvez utiliser pour vous connecter à la console de débogage locale.

Suivez ces instructions pour ouvrir la console de débogage locale sur votre appareil principal ou sur votre ordinateur de développement.

------
#### [ v2.1.x - v2.4.x ]

Dans les versions 2.1.0 et ultérieures, la console de débogage locale utilise le protocole HTTPS par défaut. Lorsque HTTPS est activé, la console de débogage locale crée un certificat auto-signé pour sécuriser la connexion. Votre navigateur Web affiche un avertissement de sécurité lorsque vous ouvrez la console de débogage locale en raison de ce certificat auto-signé. Lorsque vous créez une session avec la CLI Greengrass, la sortie inclut les empreintes digitales du certificat, afin que vous puissiez vérifier que le certificat est légitime et que la connexion est sécurisée.

Vous pouvez désactiver le protocole HTTPS. Pour plus d'informations, consultez Configuration [ de la console de débogage ](#local-debug-console-component-configuration) locale.

**Pour ouvrir la console de débogage locale**

1. <a name="local-debug-console-component-usage-forward-port"></a>(Facultatif) Pour afficher la console de débogage locale sur votre ordinateur de développement, vous pouvez transférer le port de la console via SSH. Cependant, vous devez d'abord activer l'`AllowTcpForwarding`option dans le fichier de configuration SSH de votre appareil principal. Cette option est activée par défaut. Exécutez la commande suivante sur votre ordinateur de développement pour afficher le tableau de bord `localhost:1441` sur votre ordinateur de développement.

   ```
   ssh -L 1441:localhost:1441 -L 1442:localhost:1442 {{username}}@{{core-device-ip-address}}
   ```
**Note**  
Vous pouvez modifier les ports par défaut depuis `1441` et`1442`. Pour plus d'informations, consultez Configuration [ de la console de débogage ](#local-debug-console-component-configuration) locale.

1. <a name="local-debug-console-component-create-session-step"></a>Créez une session pour utiliser la console de débogage locale. Lorsque vous créez une session, vous générez un mot de passe que vous utilisez pour vous authentifier. La console de débogage locale nécessite un mot de passe pour renforcer la sécurité, car vous pouvez utiliser ce composant pour afficher des informations importantes et effectuer des opérations sur le périphérique principal. La console de débogage locale crée également un certificat pour sécuriser la connexion si vous activez HTTPS dans la configuration du composant. HTTPS est activé par défaut.

   Utilisez l' AWS IoT Greengrass interface de ligne de commande pour créer la session. Cette commande génère un mot de passe aléatoire de 43 caractères qui expire au bout de 8 heures. Remplacez `{{/greengrass/v2}}` ou {{C:\\greengrass\\v2}} par le chemin d'accès au dossier AWS IoT Greengrass V2 racine.

------
#### [ Linux or Unix ]

   ```
   sudo {{/greengrass/v2}}/bin/greengrass-cli get-debug-password
   ```

------
#### [ Windows ]

   ```
   {{C:\greengrass\v2}}\bin\greengrass-cli get-debug-password
   ```

------

   La sortie de la commande ressemble à l'exemple suivant si vous avez configuré la console de débogage locale pour utiliser le protocole HTTPS. Vous utilisez les empreintes digitales du certificat pour vérifier que la connexion est sécurisée lorsque vous ouvrez la console de débogage locale.

   ```
   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
   ```

   Le composant Debug View crée une session d'une durée de 8 heures. Ensuite, vous devez générer un nouveau mot de passe pour afficher à nouveau la console de débogage locale. 

1. Ouvrez le tableau de bord et connectez-vous à celui-ci. Consultez le tableau de bord sur votre appareil principal Greengrass ou sur votre ordinateur de développement si vous transférez le port via SSH. Effectuez l’une des actions suivantes :
   + Si vous avez activé le protocole HTTPS dans la console de débogage locale, qui est le paramètre par défaut, procédez comme suit :

     1. Ouvrez `https://localhost:1441` sur votre appareil principal ou sur votre ordinateur de développement si vous avez transféré le port via SSH.

        Votre navigateur peut afficher un avertissement de sécurité concernant un certificat de sécurité non valide.

     1. Si votre navigateur affiche un avertissement de sécurité, vérifiez que le certificat est légitime et contournez-le. Procédez comme suit :

        1. Recherchez l' SHA-1 empreinte digitale SHA-256 ou du certificat et vérifiez qu'elle correspond à l' SHA-1 empreinte digitale SHA-256 ou que la `get-debug-password` commande a précédemment imprimée. Votre navigateur peut fournir une ou les deux empreintes digitales. Consultez la documentation de votre navigateur pour consulter le certificat et ses empreintes digitales. Dans certains navigateurs, l'empreinte digitale du certificat est appelée empreinte digitale.
**Note**  
Si l'empreinte digitale du certificat ne correspond pas, rendez-vous [Step 2](#local-debug-console-component-create-session-step) sur pour créer une nouvelle session. Si l'empreinte digitale du certificat ne correspond toujours pas, votre connexion n'est peut-être pas sécurisée.

        1. Si l'empreinte du certificat correspond, contournez l'avertissement de sécurité de votre navigateur pour ouvrir la console de débogage locale. Consultez la documentation de votre navigateur pour contourner l'avertissement de sécurité du navigateur.

     1. Connectez-vous au site Web en utilisant le nom d'utilisateur et le mot de passe que la `get-debug-password` commande a imprimés précédemment.

        La console de débogage locale s'ouvre.

     1. Si la console de débogage locale affiche une erreur indiquant qu'elle ne peut pas se connecter à WebSocket cause d'un échec d'établissement de liaison TLS, vous devez contourner l'avertissement de sécurité auto-signé pour l'URL. WebSocket   
![Erreur d' WebSocket établissement de liaison TLS dans la console de débogage locale.](https://docs.aws.amazon.com/fr_fr/greengrass/v2/developerguide/images/local-debug-console/websocket-tls-handshake-error.png)

        Procédez comme suit :

        1. Ouvrez `https://localhost:1442` dans le même navigateur que celui dans lequel vous avez ouvert la console de débogage locale.

        1. Vérifiez le certificat et contournez l'avertissement de sécurité.

           Votre navigateur peut afficher une page HTTP 404 si vous avez contourné l'avertissement.

        1. Ouvrez `https://localhost:1441` à nouveau.

           La console de débogage locale affiche des informations sur le périphérique principal.
   + Si vous avez désactivé le protocole HTTPS dans la console de débogage locale, procédez comme suit :

     1. <a name="local-debug-console-component-usage-open-localhost-http"></a>`http://localhost:1441`Ouvrez-le sur votre appareil principal, ou ouvrez-le sur votre ordinateur de développement si vous avez transféré le port via SSH.

     1. <a name="local-debug-console-component-usage-sign-in"></a>Connectez-vous au site Web en utilisant le nom d'utilisateur et le mot de passe que la `get-debug-password` commande a précédemment imprimés.

        La console de débogage locale s'ouvre.

------
#### [ v2.0.x ]

**Pour ouvrir la console de débogage locale**

1. <a name="local-debug-console-component-usage-forward-port"></a>(Facultatif) Pour afficher la console de débogage locale sur votre ordinateur de développement, vous pouvez transférer le port de la console via SSH. Cependant, vous devez d'abord activer l'`AllowTcpForwarding`option dans le fichier de configuration SSH de votre appareil principal. Cette option est activée par défaut. Exécutez la commande suivante sur votre ordinateur de développement pour afficher le tableau de bord `localhost:1441` sur votre ordinateur de développement.

   ```
   ssh -L 1441:localhost:1441 -L 1442:localhost:1442 {{username}}@{{core-device-ip-address}}
   ```
**Note**  
Vous pouvez modifier les ports par défaut depuis `1441` et`1442`. Pour plus d'informations, consultez Configuration [ de la console de débogage ](#local-debug-console-component-configuration) locale.

1. Créez une session pour utiliser la console de débogage locale. Lorsque vous créez une session, vous générez un mot de passe que vous utilisez pour vous authentifier. La console de débogage locale nécessite un mot de passe pour renforcer la sécurité, car vous pouvez utiliser ce composant pour afficher des informations importantes et effectuer des opérations sur le périphérique principal.

   Utilisez l' AWS IoT Greengrass interface de ligne de commande pour créer la session. Cette commande génère un mot de passe aléatoire de 43 caractères qui expire au bout de 8 heures. Remplacez `{{/greengrass/v2}}` ou {{C:\\greengrass\\v2}} par le chemin d'accès au dossier AWS IoT Greengrass V2 racine.

------
#### [ Linux or Unix ]

   ```
   sudo {{/greengrass/v2}}/bin/greengrass-cli get-debug-password
   ```

------
#### [ Windows ]

   ```
   {{C:\greengrass\v2}}\bin\greengrass-cli get-debug-password
   ```

------

   La sortie de la commande ressemble à l'exemple suivant.

   ```
   Username: debug
   Password: bEDp3MOHdj8ou2w5de_sCBI2XAaguy3a8XxREXAMPLE
   Password will expire at: 2021-04-01T17:01:43.921999931-07:00
   ```

   Le composant Debug View crée une session qui dure 4 heures, puis vous devez générer un nouveau mot de passe pour afficher à nouveau la console de débogage locale.

1. <a name="local-debug-console-component-usage-open-localhost-http"></a>`http://localhost:1441`Ouvrez-le sur votre appareil principal, ou ouvrez-le sur votre ordinateur de développement si vous avez transféré le port via SSH.

1. <a name="local-debug-console-component-usage-sign-in"></a>Connectez-vous au site Web en utilisant le nom d'utilisateur et le mot de passe que la `get-debug-password` commande a précédemment imprimés.

   La console de débogage locale s'ouvre.

------

## Fichier journal local
<a name="local-debug-console-component-log-file"></a>

Ce composant utilise le même fichier journal que le [ composant ](greengrass-nucleus-component.md) Greengrass Nucleus.

------
#### [ Linux ]

```
{{/greengrass/v2}}/logs/greengrass.log
```

------
#### [ Windows ]

```
{{C:\greengrass\v2}}\logs\greengrass.log
```

------

**Pour afficher les journaux de ce composant**
+ Exécutez la commande suivante sur le périphérique principal pour afficher le fichier journal de ce composant en temps réel. Remplacez `{{/greengrass/v2}}` ou {{C:\\greengrass\\v2}} par le chemin du dossier AWS IoT Greengrass racine.

------
#### [ Linux ]

  ```
  sudo tail -f {{/greengrass/v2}}/logs/greengrass.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content {{C:\greengrass\v2}}\logs\greengrass.log -Tail 10 -Wait
  ```

------

## Journal des modifications
<a name="local-debug-console-component-changelog"></a>

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


|  **Version**  |  **Modifications**  | 
| --- | --- | 
| 2.4.8 | Met à jour la version du composant pour la version 2.18.0 de Greengrass Nucleus. | 
| 2.4.7 | Met à jour la version du composant pour la version 2.17.0 de Greengrass Nucleus. | 
| 2.4.6 | Version mise à jour pour la version 2.16.0 de Greengrass Nucleus. | 
| 2.4.5 | Version mise à jour pour la version 2.15.0 de Greengrass Nucleus. | 
| 2.4.4 | Version mise à jour pour la version 2.14.0 de Greengrass Nucleus. | 
| 2.4.3 |  Version mise à jour pour la version 2.13.0 de Greengrass Nucleus. **Corrections de bugs et améliorations**<br />   Résout un problème d'affichage incorrect `STREAM_MANAGER_EXPORTER_MAX_BANDWIDTH` en mégabits par seconde (Mbit/s) au lieu d'octets par seconde (Mbit/s).     | 
| 2.4.2 |  **Corrections de bugs et améliorations**<br />   Correction et amélioration de bogues généraux     | 
| 2.4.1 |  Version mise à jour pour la version 2.12.0 de Greengrass Nucleus.  | 
| 2.4.0 |  <a name="changelog-local-debug-console-2.4.0"></a>**Nouvelles fonctionnalités**<br />   Ajoute une console de débogage du gestionnaire de flux.     | 
| 2.3.1 |  Version mise à jour pour la version 2.11.0 de Greengrass Nucleus.  | 
| 2.3.0 | Version mise à jour pour la version 2.10.0 de Greengrass Nucleus. **Nouvelles fonctionnalités**<br />    PubSub Inclut un client de débogage AWS IoT Core MQTT.    | 
| 2.2.7 | Version mise à jour pour la version 2.9.0 de Greengrass Nucleus. | 
| 2.2.6 | Version mise à jour pour la version 2.8.0 de Greengrass Nucleus. | 
| 2.2.5 | Version mise à jour pour la version 2.7.0 de Greengrass Nucleus. | 
| 2.2.4 | Version mise à jour pour la version 2.6.0 de Greengrass Nucleus. | 
| 2.2.3 |  **Corrections de bugs et améliorations**<br />   Résout un problème qui empêchait le démarrage du composant lorsqu'il était impossible de déchiffrer le keystore contenant la clé privée SSL.   Version mise à jour pour la version 2.5.0 de Greengrass Nucleus.     | 
| 2.2.2 | Version mise à jour pour la version 2.4.0 de Greengrass Nucleus. | 
| 2.2.1 | Version mise à jour pour la version 2.3.0 de Greengrass Nucleus. | 
| 2.2.0 | Version mise à jour pour la version 2.2.0 de Greengrass Nucleus. | 
| 2.1.0 |  <a name="changelog-local-debug-console-2.1.0"></a>**Nouvelles fonctionnalités**<br />   Utilise le protocole HTTPS pour sécuriser votre connexion à la console de débogage locale. HTTPS est activé par défaut.   <br />**Corrections de bugs et améliorations**<br />   Vous pouvez ignorer les messages de la barre d'outils dans l'éditeur de configuration.     | 
| 2.0.3 | Première version. | 