Monitorare le distribuzioni IoT Edge

Si applica a: Edge 1.5

Azure IoT Edge offre informazioni in tempo reale sui moduli distribuiti nei dispositivi IoT Edge. Il servizio hub IoT ottiene lo stato dai dispositivi e lo mostra all'utente. Il monitoraggio è importante anche per le distribuzioni su larga scala che includono distribuzioni automatiche e distribuzioni a livelli.

I dispositivi e i moduli hanno dati simili, ad esempio la connettività, in modo da ottenere valori in base all'ID dispositivo o all'ID del modulo.

Il servizio hub IoT raccoglie i dati segnalati dai dispositivi e dai moduli gemelli e fornisce il conteggio dei diversi stati che i dispositivi possono avere. Il servizio hub IoT organizza questi dati in quattro gruppi di metriche:

È possibile monitorare questi dati nel portale di Azure o usare l'interfaccia della riga di comando di Azure.

Monitorare una distribuzione nel portale di Azure

Per visualizzare i dettagli della distribuzione e monitorare i dispositivi in esecuzione, seguire questa procedura:

1. Accedere al portale di Azure e quindi passare all'hub IoT.

2. Selezionare Configurazioni e distribuzioni in Gestione dei dispositivi.

3. Esaminare l'elenco di distribuzione. Per ogni distribuzione, vengono visualizzati i dettagli seguenti:

   Colonna	Descrizione
   Documento d'identità	Nome della distribuzione.
   Tipo	Tipo di distribuzione, ovvero Distribuzione o Distribuzione a livelli.
   Target Condition (Condizione di destinazione)	Tag che definisce i dispositivi di destinazione.
   Priorità	Valore di priorità assegnato alla distribuzione.
   Metriche di sistema	Numero di dispositivi gemelli nell'hub IoT che soddisfano la condizione di destinazione. Applicato mostra il numero di dispositivi con il contenuto della distribuzione applicato ai moduli gemelli nell'hub IoT.
   Metriche del dispositivo	Numero di dispositivi IoT Edge che segnalano il corretto completamento o la presenza di errori dal runtime client IoT Edge.
   Metriche personalizzate	Il numero di dispositivi IoT Edge che inviano i dati per le metriche che hai definito per la distribuzione.
   Data di creazione	L'orario in cui viene creata la distribuzione. Questo timestamp viene usato per stabilire la prevalenza quando due distribuzioni hanno la stessa priorità.

4. Selezionare la distribuzione da monitorare.

5. Nella pagina Dettagli distribuzione passare alla scheda Condizione di destinazione . Selezionare Visualizza per elencare i dispositivi che corrispondono alla condizione di destinazione. Modificare la condizione o Priorità in base alle esigenze, quindi selezionare Salva.

   

6. Selezionare la scheda Metriche . Quando si sceglie una metrica dall'elenco a discesa Seleziona metrica , viene visualizzato il pulsante Visualizza per visualizzare i risultati. Selezionare Modifica metriche per modificare i criteri per le metriche personalizzate definite. Selezionare Salva se si apportano modifiche.

   

Per modificare la distribuzione, vedere Modificare una distribuzione.

Monitorare una distribuzione con l'interfaccia della riga di comando di Azure

Usare il comando az iot edge deployment show per visualizzare i dettagli di una singola distribuzione:

az iot edge deployment show --deployment-id [deployment id] --hub-name [hub name]

Il deployment show comando usa questi parametri:

• --deployment-id : nome della distribuzione nell'hub IoT. Parametro obbligatorio.
• --hub-name : nome dell'hub IoT in cui è presente la distribuzione. L'hub deve trovarsi nella sottoscrizione corrente. Passare alla sottoscrizione con az account set -s [subscription name]

Controllare la distribuzione nella finestra di comando. La metrics proprietà elenca un conteggio per ogni metrica valutata da ogni hub:

• targetedCount : numero di dispositivi gemelli nell'hub IoT che corrispondono alla condizione di destinazione.
• appliedCount : numero di dispositivi con il contenuto della distribuzione applicato ai moduli gemelli nell'hub IoT.
• reportedSuccessfulCount : numero di dispositivi IoT Edge nella distribuzione che segnalano l'esito positivo del runtime del client IoT Edge.
• reportedFailedCount: numero di dispositivi IoT Edge nella distribuzione che segnalano un errore dal runtime del client IoT Edge.

Visualizzare un elenco di ID dispositivo o oggetti per ogni metrica con il comando az iot edge deployment show-metric :

az iot edge deployment show-metric --deployment-id [deployment id] --metric-id [metric id] --hub-name [hub name]

Il deployment show-metric comando usa questi parametri:

• --deployment-id : nome della distribuzione nell'hub IoT.
• --metric-id : nome della metrica per visualizzare l'elenco di ID dispositivo, ad esempio reportedFailedCount.
• --hub-name : nome dell'hub IoT in cui è presente la distribuzione. L'hub deve trovarsi nella sottoscrizione corrente. Passare alla sottoscrizione con az account set -s [subscription name]. Per apportare modifiche alla distribuzione, vedere Modificare una distribuzione.

Passaggi successivi

Informazioni su come monitorare i moduli gemelli, principalmente i moduli di runtime dell'agente IoT Edge e dell'hub IoT Edge, per controllare la connettività e l'integrità delle distribuzioni di IoT Edge.