Console di debug locale - AWS IoT Greengrass

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Console di debug locale

Il componente della console di debug locale (aws.greengrass.LocalDebugConsole) fornisce una dashboard locale che mostra informazioni sui dispositivi AWS IoT Greengrass principali e sui relativi componenti. È possibile utilizzare questa dashboard per eseguire il debug del dispositivo principale e gestire i componenti locali.

Importante

Ti consigliamo di utilizzare questo componente solo in ambienti di sviluppo, non in ambienti di produzione. Questo componente fornisce l'accesso a informazioni e operazioni che in genere non sono necessarie in un ambiente di produzione. Segui il principio del privilegio minimo distribuendo questo componente solo sui dispositivi principali dove ne hai bisogno.

Versioni

Questo componente ha le seguenti versioni:

  • 2.4.x

  • 2.3.x

  • 2.2.x

  • 2.1.x

  • 2,0x

Type

Questo componente è un componente del plugin ()aws.greengrass.plugin. Il nucleo Greengrass esegue questo componente nella stessa Java Virtual Machine (JVM) del nucleo. Il nucleo si riavvia quando si modifica la versione di questo componente sul dispositivo principale.

Questo componente utilizza lo stesso file di registro del nucleo Greengrass. Per ulteriori informazioni, consulta Monitora AWS IoT Greengrass i registri.

Per ulteriori informazioni, consulta Tipi di componenti.

Sistema operativo

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:

  • Linux

  • Windows

Requisiti

Questo componente presenta i seguenti requisiti:

  • Utilizzi un nome utente e una password per accedere alla dashboard. Il nome utente, che èdebug, viene fornito all'utente. È necessario utilizzare il AWS IoT Greengrass CLI per creare una password temporanea che ti autentichi con la dashboard su un dispositivo principale. È necessario essere in grado di utilizzare il per AWS IoT Greengrass CLI utilizzare la console di debug locale. Per ulteriori informazioni, consulta i requisiti di Greengrass CLI. Per ulteriori informazioni su come generare la password e accedere, vedere Utilizzo dei componenti della console di debug locale.

  • È supportata l'esecuzione del componente della console di debug locale in un. VPC

Dipendenze

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le versioni rilasciate di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass Nella pagina dei dettagli del componente, cerca l'elenco delle dipendenze.

2.4.3

La tabella seguente elenca le dipendenze per la versione 2.4.3 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.10.0 <2.14.0 Rigidi
Greengrass CLI >=2.10.0 <2.14.0 Rigidi
2.4.3

La tabella seguente elenca le dipendenze per la versione 2.4.3 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.10.0 <2.14.0 Rigidi
Greengrass CLI >=2.10.0 <2.14.0 Rigidi
2.4.1 – 2.4.2

La tabella seguente elenca le dipendenze per le versioni da 2.4.1 a 2.4.2 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.10.0 <2.13.0 Rigidi
Greengrass CLI >=2.10.0 <2.13.0 Rigidi
2.4.0

La tabella seguente elenca le dipendenze per la versione 2.4.0 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.10.0 <2.12.0 Rigidi
Greengrass CLI >=2.10.0 <2.12.0 Rigidi
2.3.0 and 2.3.1

La tabella seguente elenca le dipendenze per le versioni 2.3.0 e 2.3.1 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.10.0 <2.12.0 Rigidi
Greengrass CLI >=2.10.0 <2.12.0 Rigidi
2.2.9

La tabella seguente elenca le dipendenze per la versione 2.2.9 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.1.0 <2.12.0 Rigidi
Greengrass CLI >=2.1.0 <2.12.0 Rigidi
2.2.8

La tabella seguente elenca le dipendenze per la versione 2.2.8 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.1.0 <2.11.0 Rigidi
Greengrass CLI >=2.1.0 <2.11.0 Rigidi
2.2.7

La tabella seguente elenca le dipendenze per la versione 2.2.7 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.1.0 <2.10.0 Rigidi
Greengrass CLI >=2.1.0 <2.10.0 Rigidi
2.2.6

La tabella seguente elenca le dipendenze per la versione 2.2.6 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.1.0 <2.9.0 Rigidi
Greengrass CLI >=2.1.0 <2.9.0 Rigidi
2.2.5

La tabella seguente elenca le dipendenze per la versione 2.2.5 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.1.0 <2.8.0 Rigidi
Greengrass CLI >=2.1.0 <2.8.0 Rigidi
2.2.4

La tabella seguente elenca le dipendenze per la versione 2.2.4 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.1.0 <2.7.0 Rigidi
Greengrass CLI >=2.1.0 <2.7.0 Rigidi
2.2.3

La tabella seguente elenca le dipendenze per la versione 2.2.3 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.1.0 <2.6.0 Rigidi
Greengrass CLI >=2.1.0 <2.6.0 Rigidi
2.2.2

La tabella seguente elenca le dipendenze per la versione 2.2.2 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.1.0 <2.5.0 Rigidi
Greengrass CLI >=2.1.0 <2.5.0 Rigidi
2.2.1

La tabella seguente elenca le dipendenze per la versione 2.2.1 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.1.0 <2.4.0 Rigidi
Greengrass CLI >=2.1.0 <2.4.0 Rigidi
2.2.0

La tabella seguente elenca le dipendenze per la versione 2.2.0 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.1.0 <2.3.0 Rigidi
Greengrass CLI >=2.1.0 <2.3.0 Rigidi
2.1.0

La tabella seguente elenca le dipendenze per la versione 2.1.0 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.1.0 <2.2.0 Rigidi
Greengrass CLI >=2.1.0 <2.2.0 Rigidi
2.0.x

La tabella seguente elenca le dipendenze per la versione 2.0.x di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.0.3 <2.1.0 Flessibili
Greengrass CLI >=2.0.3 <2.1.0 Flessibili

Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.

Configurazione

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

v2.1.x - v2.4.x
httpsEnabled

(Facoltativo) È possibile abilitare la HTTPS comunicazione per la console di debug locale. Se si abilita la HTTPS comunicazione, la console di debug locale crea un certificato autofirmato. I browser Web mostrano avvisi di sicurezza per i siti Web che utilizzano certificati autofirmati, pertanto è necessario verificare manualmente il certificato. È quindi possibile ignorare l'avviso. Per ulteriori informazioni, consulta Utilizzo.

Default: true

port

(Facoltativo) La porta alla quale fornire la console di debug locale.

Impostazione predefinita: 1441

websocketPort

(Facoltativo) La porta websocket da utilizzare per la console di debug locale.

Impostazione predefinita: 1442

bindHostname

(Facoltativo) Il nome host da utilizzare per la console di debug locale.

Se esegui il software AWS IoT Greengrass Core in un contenitore Docker, imposta questo parametro su, in modo da 0.0.0.0 poter aprire la console di debug locale all'esterno del contenitore Docker.

Impostazione predefinita: localhost

Esempio: aggiornamento basato sull'unione della configurazione

La configurazione di esempio seguente specifica di aprire la console di debug locale su porte non predefinite e disabilitarla. HTTPS

{ "httpsEnabled": false, "port": "10441", "websocketPort": "10442" }
v2.0.x
port

(Facoltativo) La porta alla quale fornire la console di debug locale.

Impostazione predefinita: 1441

websocketPort

(Facoltativo) La porta websocket da utilizzare per la console di debug locale.

Impostazione predefinita: 1442

bindHostname

(Facoltativo) Il nome host da utilizzare per la console di debug locale.

Se esegui il software AWS IoT Greengrass Core in un contenitore Docker, imposta questo parametro su, in modo da 0.0.0.0 poter aprire la console di debug locale all'esterno del contenitore Docker.

Impostazione predefinita: localhost

Esempio: aggiornamento basato sull'unione della configurazione

La configurazione di esempio seguente specifica di aprire la console di debug locale su porte non predefinite.

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

Utilizzo

Per utilizzare la console di debug locale, create una sessione da GreengrassCLI. Quando si crea una sessione, Greengrass CLI fornisce un nome utente e una password temporanea che è possibile utilizzare per accedere alla console di debug locale.

Segui queste istruzioni per aprire la console di debug locale sul tuo dispositivo principale o sul tuo computer di sviluppo.

v2.1.x - v2.4.x

Nelle versioni 2.1.0 e successive, la console di debug locale utilizza HTTPS per impostazione predefinita. Quando HTTPS è abilitata, la console di debug locale crea un certificato autofirmato per proteggere la connessione. Il browser Web mostra un avviso di sicurezza quando si apre la console di debug locale a causa di questo certificato autofirmato. Quando crei una sessione con GreengrassCLI, l'output include le impronte digitali del certificato, in modo da poter verificare che il certificato sia legittimo e che la connessione sia sicura.

È possibile disabilitare. HTTPS Per ulteriori informazioni, vedere Configurazione della console di debug locale.

Per aprire la console di debug locale
  1. (Facoltativo) Per visualizzare la console di debug locale sul tuo computer di sviluppo, puoi inoltrare la porta della console. SSH Tuttavia, dovete prima abilitare l'AllowTcpForwardingopzione nel file di SSH configurazione del dispositivo principale. Per impostazione predefinita, questa opzione è abilitata. Esegui il comando seguente sul tuo computer di sviluppo per visualizzare la dashboard localhost:1441 sul tuo computer di sviluppo.

    ssh -L 1441:localhost:1441 -L 1442:localhost:1442 username@core-device-ip-address
    Nota

    È possibile modificare le porte predefinite da 1441 e1442. Per ulteriori informazioni, vedere Configurazione della console di debug locale.

  2. Crea una sessione per utilizzare la console di debug locale. Quando si crea una sessione, si genera una password da utilizzare per l'autenticazione. La console di debug locale richiede una password per aumentare la sicurezza, poiché è possibile utilizzare questo componente per visualizzare informazioni importanti ed eseguire operazioni sul dispositivo principale. La console di debug locale crea anche un certificato per proteggere la connessione, se abilitato HTTPS nella configurazione del componente. HTTPSè abilitato per impostazione predefinita.

    Usa il AWS IoT Greengrass CLI per creare la sessione. Questo comando genera una password casuale di 43 caratteri che scade dopo 8 ore. Sostituisci o /greengrass/v2 C:\greengrass\v2 con il percorso della cartella AWS IoT Greengrass V2 principale.

    Linux or UnixWindows
    Linux or Unix
    sudo /greengrass/v2/bin/greengrass-cli get-debug-password
    Windows
    C:\greengrass\v2\bin\greengrass-cli get-debug-password

    L'output del comando è simile al seguente esempio se è stata configurata la console di debug locale per l'utilizzoHTTPS. Le impronte digitali del certificato vengono utilizzate per verificare che la connessione sia sicura quando si apre la console di debug 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

    Il componente debug view crea una sessione che dura 8 ore. Dopodiché, è necessario generare una nuova password per visualizzare nuovamente la console di debug locale.

  3. Apri e accedi alla dashboard. Visualizza la dashboard sul tuo dispositivo principale Greengrass o sul tuo computer di sviluppo se inoltri la porta. SSH Esegui una di queste operazioni:

    • Se l'opzione è abilitata HTTPS nella console di debug locale, che è l'impostazione predefinita, procedi come segue:

      1. Apri https://localhost:1441 sul tuo dispositivo principale o sul tuo computer di sviluppo se hai inoltrato la porta. SSH

        Il tuo browser potrebbe mostrare un avviso di sicurezza relativo a un certificato di sicurezza non valido.

      2. Se il tuo browser mostra un avviso di sicurezza, verifica che il certificato sia legittimo e ignora l'avviso di sicurezza. Esegui questa operazione:

        1. Trova l'impronta digitale SHA -256 o SHA -1 per il certificato e verifica che corrisponda all'impronta digitale SHA -256 o SHA -1 stampata in precedenza dal comando. get-debug-password Il tuo browser potrebbe fornire una o entrambe le impronte digitali. Consulta la documentazione del tuo browser per visualizzare il certificato e le relative impronte digitali. In alcuni browser, l'impronta digitale del certificato viene chiamata impronta digitale.

          Nota

          Se l'impronta digitale del certificato non corrisponde, vai Passo 2 a creare una nuova sessione. Se l'impronta digitale del certificato continua a non corrispondere, la connessione potrebbe non essere sicura.

        2. Se l'impronta digitale del certificato corrisponde, ignora l'avviso di sicurezza del browser per aprire la console di debug locale. Consultate la documentazione del browser per aggirare l'avviso di sicurezza del browser.

      3. Accedi al sito Web utilizzando il nome utente e la password stampati in precedenza con il get-debug-password comando.

        Si apre la console di debug locale.

      4. Se la console di debug locale mostra un errore che indica che non è possibile connettersi al a WebSocket causa di un TLS handshake non riuscito, è necessario ignorare l'avviso di sicurezza autofirmato per. WebSocket URL

        L'errore di WebSocket TLS handshake nella console di debug locale.

        Esegui questa operazione:

        1. Apri https://localhost:1442 nello stesso browser in cui hai aperto la console di debug locale.

        2. Verifica il certificato e ignora l'avviso di sicurezza.

          Il tuo browser potrebbe mostrare una pagina HTTP 404 dopo aver ignorato l'avviso.

        3. https://localhost:1441Riapri.

          La console di debug locale mostra informazioni sul dispositivo principale.

    • Se l'opzione è stata disattivata HTTPS nella console di debug locale, procedi come segue:

      1. http://localhost:1441Apritelo sul dispositivo principale oppure sul computer di sviluppo se avete inoltrato la porta. SSH

      2. Accedi al sito Web utilizzando il nome utente e la password stampati in precedenza con il get-debug-password comando.

        Si apre la console di debug locale.

v2.0.x
Per aprire la console di debug locale
  1. (Facoltativo) Per visualizzare la console di debug locale sul tuo computer di sviluppo, puoi inoltrare la porta della console. SSH Tuttavia, dovete prima abilitare l'AllowTcpForwardingopzione nel file di SSH configurazione del dispositivo principale. Per impostazione predefinita, questa opzione è abilitata. Esegui il comando seguente sul tuo computer di sviluppo per visualizzare la dashboard localhost:1441 sul tuo computer di sviluppo.

    ssh -L 1441:localhost:1441 -L 1442:localhost:1442 username@core-device-ip-address
    Nota

    È possibile modificare le porte predefinite da 1441 e1442. Per ulteriori informazioni, vedere Configurazione della console di debug locale.

  2. Crea una sessione per utilizzare la console di debug locale. Quando si crea una sessione, si genera una password da utilizzare per l'autenticazione. La console di debug locale richiede una password per aumentare la sicurezza, poiché è possibile utilizzare questo componente per visualizzare informazioni importanti ed eseguire operazioni sul dispositivo principale.

    Utilizzate il AWS IoT Greengrass CLI per creare la sessione. Questo comando genera una password casuale di 43 caratteri che scade dopo 8 ore. Sostituisci o /greengrass/v2 C:\greengrass\v2 con il percorso della cartella AWS IoT Greengrass V2 principale.

    Linux or UnixWindows
    Linux or Unix
    sudo /greengrass/v2/bin/greengrass-cli get-debug-password
    Windows
    C:\greengrass\v2\bin\greengrass-cli get-debug-password

    L'output del comando è simile al seguente esempio.

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

    Il componente debug view crea una sessione della durata di 4 ore, quindi è necessario generare una nuova password per visualizzare nuovamente la console di debug locale.

  3. Apri http://localhost:1441 sul tuo dispositivo principale o sul tuo computer di sviluppo se hai inoltrato la porta. SSH

  4. Accedi al sito Web utilizzando il nome utente e la password stampati in precedenza con il get-debug-password comando.

    Si apre la console di debug locale.

File di registro locale

Questo componente utilizza lo stesso file di registro del componente Greengrass nucleus.

Linux
/greengrass/v2/logs/greengrass.log
Windows
C:\greengrass\v2\logs\greengrass.log
Per visualizzare i log di questo componente
  • Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci /greengrass/v2 o C:\greengrass\v2 con il percorso della cartella AWS IoT Greengrass principale.

    Linux
    sudo tail -f /greengrass/v2/logs/greengrass.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait

Changelog

La tabella seguente descrive le modifiche apportate a ciascuna versione del componente.

Versione

Modifiche

2.4.3

Versione aggiornata per la versione 2.13.0 di Greengrass nucleus.

Correzioni di bug e miglioramenti
  • Risolve un problema che impediva la visualizzazione corretta STREAM_MANAGER_EXPORTER_MAX_BANDWIDTH in megabit al secondo (Mbps) anziché in byte al secondo (Bps).

2.4.2

Correzioni di bug e miglioramenti
  • Correzioni di bug generali e miglioramenti.

2.4.1

Versione aggiornata per la versione 2.12.0 di Greengrass nucleus.

2.4.0

Nuove funzionalità
  • Aggiunge la console di debug dello stream manager.

2.3.1

Versione aggiornata per la versione 2.11.0 di Greengrass nucleus.

2.3.0

Versione aggiornata per la versione 2.10.0 di Greengrass nucleus.
Nuove funzionalità
  • Include un client di debug PubSub . AWS IoT Core MQTT

2.2.7

Versione aggiornata per la versione 2.9.0 di Greengrass nucleus.

2.2.6

Versione aggiornata per la versione 2.8.0 di Greengrass nucleus.

2.2.5

Versione aggiornata per la versione 2.7.0 di Greengrass nucleus.

2.2.4

Versione aggiornata per la versione 2.6.0 di Greengrass nucleus.

2.2.3

Correzioni di bug e miglioramenti
  • Risolve un problema che impediva l'avvio quando il componente non riusciva a decrittografare il keystore che contiene la chiave privata. SSL

  • Versione aggiornata per la versione 2.5.0 di Greengrass nucleus.

2.2.2

Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.

2.2.1

Versione aggiornata per la versione 2.3.0 di Greengrass nucleus.

2.2.0

Versione aggiornata per la versione 2.2.0 di Greengrass nucleus.

2.1.0

Nuove funzionalità
  • Viene utilizzato HTTPS per proteggere la connessione alla console di debug locale. HTTPSè abilitato per impostazione predefinita.

Correzioni di bug e miglioramenti
  • Puoi eliminare i messaggi della flashbar nell'editor di configurazione.

2.0.3

Versione iniziale.