Informazioni sui limiti e le restrizioni di Azure IoT Edge

Si applica a: IoT Edge 1.5 IoT Edge 1.4

Importante

IoT Edge 1.5 LTS e IoT Edge 1.4 LTS sono versioni supportate. IoT Edge 1.4 LTS raggiungerà il fine vita il 12 novembre 2024. Se si usa una versione precedente, vedere Aggiornare IoT Edge.

Questo articolo illustra i limiti e le restrizioni quando si usa IoT Edge.

Limiti

Numero di elementi figlio nella gerarchia del gateway

Ogni dispositivo padre IoT Edge nelle gerarchie del gateway può avere fino a 100 dispositivi figlio connessi per impostazione predefinita.

Tuttavia, è importante sapere che ogni dispositivo IoT Edge in una topologia annidata deve aprire una connessione logica separata all'hub edge padre (o hub IoT) per conto di ogni client connesso (dispositivo o modulo), più una connessione per se stessa. Le connessioni a ogni livello non vengono quindi aggregate, ma aggiunte.

Ad esempio, se sono presenti 2 dispositivi figlio IoT Edge in un livello L4, ognuno a sua volta ha 100 client, il dispositivo IoT Edge padre nel livello superiore A5 avrà 202 connessioni in ingresso totali da L4.

Questo limite può essere modificato impostando la variabile di ambiente MaxConnectedClients nel modulo edgeHub del dispositivo padre. Tuttavia, IoT Edge può verificarsi problemi con la segnalazione dello stato nelle proprietà segnalate dal gemello se il numero di client supera alcune centinaia a causa del limite di dimensioni del dispositivo gemello hub IoT. In generale, prestare attenzione quando si aumenta il limite modificando questa variabile di ambiente.

Per altre informazioni, vedere Creare una gerarchia di gateway.

Dimensioni delle proprietà desiderate

hub IoT applica le restrizioni seguenti:

• Limite di dimensioni di 8 kb per il valore dei tag.
• Limite di dimensioni di 32 KB per il valore di properties/desired e properties/reported.

Per altre informazioni, vedere Dimensioni del modulo gemello.

Numero di livelli gerarchia annidati

Un dispositivo IoT Edge ha un limite di cinque livelli di dispositivi IoT Edge collegati come elementi figlio.

Per altre informazioni, vedere Relazioni padre e figlio.

Numero di moduli in una distribuzione

hub IoT sono previste le restrizioni seguenti per le distribuzioni automatiche di IoT Edge:

• 50 moduli per distribuzione
  • Questo limite viene sostituito dal limite di dimensioni del modulo gemello di 32 KB hub IoT. Per altre informazioni, vedere Tenere presente i limiti delle dimensioni dei dispositivi gemelli quando si usano moduli personalizzati.
• 100 distribuzioni (incluse le distribuzioni a più livelli per hub SKU a pagamento)
• 10 distribuzioni per hub SKU gratuito

Restrizioni

Certificati

I certificati IoT Edge hanno le restrizioni seguenti:

• Il nome comune (CN) non può essere uguale al nome host usato nel file di configurazione nel dispositivo IoT Edge.
• Il nome usato dai client per connettersi a IoT Edge non può corrispondere al nome comune usato nel certificato della CA Edge.

Per altre informazioni, vedere Certificati per la sicurezza dei dispositivi.

Attestazione TPM

Quando si usa l'attestazione TPM con il servizio device provisioning, è necessario usare TPM 2.0.

Per altre informazioni, vedere Requisiti dei dispositivi di attestazione TPM.

Sintassi di routing

IoT Edge e hub IoT sintassi di routing è quasi identica. Sintassi di query supportata:

• Query di routing dei messaggi basata sulle proprietà del messaggio
• Query di routing dei messaggi basata sul corpo del messaggio

Sintassi di query non supportata:

• Query di routing dei messaggi basata sul dispositivo gemello

Criteri di riavvio

Non usare on-unhealthy o on-failure come valori nei moduli' restartPolicy perché non sono implementati e non avvieranno un riavvio. Vengono implementati solo never i criteri di riavvio e always .

In questa soluzione alternativa è indicato il modo consigliato per riavviare automaticamente i moduli IoT Edge non integri. Configurare la Healthcheck proprietà nel modulo createOptions per gestire un controllo di integrità non riuscito.

Log di risoluzione dei problemi

L'accesso ai log dei moduli da portale di Azure potrebbe essere ritardato durante l'aggiornamento dei moduli.

Se si visualizza la scheda Risoluzione dei problemi dal dispositivo in IoT Edge nella portale di Azure, potrebbe essere visualizzato il messaggio "Impossibile recuperare i log. La richiesta non è riuscita con codice di stato 504". Il timeout della richiesta e lo stato del runtime potrebbe essere visualizzato come "Errore" per tutti i moduli.

Questa possibilità di visualizzare i log riprenderà in tempo. Il motivo per cui l'accesso è ritardato è dovuto al fatto che edgeAgent potrebbe essere occupato dai moduli iniziali in modo che non possa recuperare contemporaneamente i log. I log vengono estratti da Moby/Docker, quindi questo processo richiede tempo e la richiesta può verificarsi un timeout se edgeAgent è occupato.

Caricamento file

hub IoT supporta solo le API di caricamento di file per le identità dei dispositivi, non le identità del modulo. Poiché IoT Edge usa esclusivamente moduli, il caricamento di file non è supportato in modo nativo in IoT Edge.

Per altre informazioni sul caricamento di file con hub IoT, vedere Caricare file con hub IoT.

Variabili di ambiente dell'agente Edge

Le modifiche apportate alle config.toml edgeAgent variabili di ambiente, ad esempio , hostname non vengono applicate a edgeAgent se il contenitore esiste già. Per applicare queste modifiche, rimuovere il edgeAgent contenitore usando il comando sudo docker rm -f edgeAgent. Il daemon IoT Edge ricrea il contenitore e avvia edgeAgent in circa un minuto.

Autenticazione NTLM

L'autenticazione NTLM non è supportata. I proxy configurati con l'autenticazione NTLM non funzioneranno.

IoT Edge ha un supporto limitato per l'autenticazione proxy. Sono supportati solo i proxy configurati per l'autenticazione con nome utente e password.

Passaggi successivi

Per altre informazioni, vedere hub IoT altri limiti.