Rilevatore IP - AWS IoT Greengrass
VersioniTypeSistema operativoRequisitiDipendenzeConfigurazioneFile di registro localeChangelog

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à.

Rilevatore IP

Il componente del rilevatore IP (aws.greengrass.clientdevices.IPDetector) esegue le seguenti operazioni:

  • Monitora le informazioni sulla connettività di rete del dispositivo principale Greengrass. Queste informazioni includono gli endpoint di rete del dispositivo principale e la porta su cui opera un broker MQTT.

  • Aggiorna le informazioni di connettività del dispositivo principale nel AWS IoT Greengrass servizio cloud.

I dispositivi client possono utilizzare Greengrass cloud discovery per recuperare le informazioni di connettività dei dispositivi principali associati. Quindi, i dispositivi client possono provare a connettersi a ciascun dispositivo principale finché non si connettono correttamente.

Nota

I dispositivi client sono dispositivi IoT locali che si connettono a un dispositivo core Greengrass per inviare messaggi MQTT e dati da elaborare. Per ulteriori informazioni, consulta Interagisci con dispositivi IoT locali.

Il componente del rilevatore IP sostituisce le informazioni di connettività esistenti di un dispositivo principale con le informazioni rilevate. Poiché questo componente rimuove le informazioni esistenti, è possibile utilizzare il componente del rilevatore IP o gestire manualmente le informazioni di connettività.

Nota

Il componente del rilevatore IP rileva solo gli indirizzi IPv4.

Versioni

Questo componente ha le seguenti versioni:

  • 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, consultare 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:

  • Il ruolo del servizio Greengrass deve essere associato al tuo Account AWS e consentire le autorizzazioni iot:GetThingShadow eiot:UpdateThingShadow.

  • La AWS IoT politica del dispositivo principale deve consentire l'greengrass:UpdateConnectivityInfoautorizzazione. Per ulteriori informazioni, consulta Policy AWS IoT per operazioni del piano dei dati e AWS IoTPolitica minima per supportare i dispositivi client.

  • Se si configura il componente broker MQTT del dispositivo principale per utilizzare una porta diversa dalla porta predefinita 8883, è necessario utilizzare IP detector v2.1.0 o versione successiva. Configuralo per segnalare la porta in cui opera il broker.

  • Se disponi di una configurazione di rete complessa, il componente del rilevatore IP potrebbe non essere in grado di identificare gli endpoint in cui i dispositivi client possono connettersi al dispositivo principale. Se il componente del rilevatore IP non è in grado di gestire gli endpoint, devi invece gestire manualmente gli endpoint principali del dispositivo. Ad esempio, se il dispositivo principale si trova dietro un router che gli inoltra la porta del broker MQTT, è necessario specificare l'indirizzo IP del router come endpoint per il dispositivo principale. Per ulteriori informazioni, consulta Gestisci gli endpoint principali dei dispositivi.

  • Il componente del rilevatore IP è supportato per l'esecuzione 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.1.8 – 2.1.9

La tabella seguente elenca le dipendenze per le versioni 2.1.8 e 2.1.9 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.2.0 <2.13.0 Flessibili
2.1.7

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

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.2.0 <2.12.0 Flessibili
2.1.6

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

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.2.0 <2.11.0 Flessibili
2.1.5

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

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.2.0 <2.10.0 Flessibili
2.1.4

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

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.2.0 <2.9.0 Flessibili
2.1.3

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

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.2.0 <2.8.0 Flessibili
2.1.2

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

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.2.0 <2.7.0 Flessibili
2.1.1

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

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.2.0 <2.6.0 Flessibili
2.1.0 and 2.0.2

La tabella seguente elenca le dipendenze per le versioni 2.1.0 e 2.0.2 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.2.0 <2.5.0 Flessibili
2.0.1

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

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.2.0 <2.4.0 Flessibili
2.0.0

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

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass >=2.2.0 <2.3.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.

2.1.x
defaultPort

(Facoltativo) La porta del broker MQTT da segnalare quando questo componente rileva indirizzi IP. È necessario specificare questo parametro se si configura il broker MQTT per utilizzare una porta diversa dalla porta predefinita 8883.

Impostazione predefinita: 8883

includeIPv4LoopbackAddrs

(Facoltativo) È possibile abilitare questa opzione per rilevare e segnalare gli indirizzi di loopback IPv4. Si tratta di indirizzi IP, ad esempio quelli in cui un dispositivo può comunicare con se stessolocalhost. Utilizzate questa opzione in ambienti di test in cui il dispositivo principale e il dispositivo client funzionano sullo stesso sistema.

Impostazione predefinita: false

(Facoltativo) È possibile abilitare questa opzione per rilevare e segnalare gli indirizzi locali del collegamento IPv4. Utilizzate questa opzione se la rete del dispositivo principale non dispone di indirizzi IP assegnati staticamente o del Dynamic Host Configuration Protocol (DHCP).

Impostazione predefinita: false

2.0.x
includeIPv4LoopbackAddrs

(Facoltativo) È possibile abilitare questa opzione per rilevare e segnalare gli indirizzi di loopback IPv4. Si tratta di indirizzi IP, ad esempio quelli in cui un dispositivo può comunicare con se stessolocalhost. Utilizzate questa opzione in ambienti di test in cui il dispositivo principale e il dispositivo client funzionano sullo stesso sistema.

Impostazione predefinita: false

(Facoltativo) È possibile abilitare questa opzione per rilevare e segnalare gli indirizzi locali del collegamento IPv4. Utilizzate questa opzione se la rete del dispositivo principale non dispone di indirizzi IP assegnati staticamente o del Dynamic Host Configuration Protocol (DHCP).

Impostazione predefinita: false

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 in ogni versione del componente.

Versione

Modifiche

2.1.9
Correzioni di bug e miglioramenti

  • Regola la fase di acquisizione dell'IP in modo da inviare i log solo a livello di registro di debug.

2.1.8

 Versione aggiornata per la versione 2.12.0 di Greengrass nucleus.

2.1.7

 Versione aggiornata per la versione 2.11.0 di Greengrass nucleus.

2.1.6

 Versione aggiornata per la versione 2.10.0 di Greengrass nucleus.

2.1.5

 Versione aggiornata per la versione 2.9.0 di Greengrass nucleus.

2.1.4

 Versione aggiornata per la versione 2.8.0 di Greengrass nucleus.

2.1.3

Versione aggiornata per la versione 2.7.0 di Greengrass nucleus.

2.1.2
Correzioni di bug e miglioramenti

  • Migliora i messaggi di errore registrati da questo componente in determinati scenari.

  • Versione aggiornata per la versione 2.6.0 di Greengrass nucleus.

2.1.1

Versione aggiornata per la versione 2.5.0 di Greengrass nucleus.

2.1.0
Miglioramenti

  • Aggiunge il defaultPort parametro, che consente di utilizzare una porta broker MQTT non predefinita.

  • Aggiornamenti per rendere più chiari i messaggi di registro.

2.0.2

Versione aggiornata per la versione 2.4.0 di Greengrass nucleus.

2.0.1

Versione aggiornata per la versione 2.3.0 di Greengrass nucleus.

2.0.0

Versione iniziale.