Condividi tramite

Monitorare le distribuzioni IoT Edge

  • Articolo

Si applica a: Segno di spunta IoT Edge 1.5 IoT Edge 1.5 Segno di spunta IoT Edge 1.4 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à la fine del servizio il 12 novembre 2024. Se si usa una versione precedente, vedere Aggiornare IoT Edge.

Azure IoT Edge fornisce funzionalità di creazione di report che consentono di monitorare le informazioni in tempo reale nei moduli distribuiti nei dispositivi IoT Edge. Il servizio hub IoT recupera le informazioni sullo stato dai dispositivi e le rende disponibili all'operatore. Il monitoraggio è importante anche per le distribuzioni su larga scala che includono distribuzioni automatiche e distribuzioni a livelli.

Sia i dispositivi che i moduli hanno dati simili, ad esempio per quanto riguarda la connettività, quindi i valori vengono ottenuti in base all'ID dispositivo o all'ID modulo.

Il servizio hub IoT raccoglie i dati segnalati da dispositivi e moduli gemelli e fornisce i conteggi dei vari stati che i dispositivi possono avere. Il servizio hub IoT organizza questi dati in quattro gruppi di metriche:

Tipo Descrizione
Assegnato Mostra i dispositivi IoT Edge che soddisfano la condizione di destinazione della distribuzione.
Applicato Mostra i dispositivi IoT Edge di destinazione che non rappresentano la destinazione di un'altra distribuzione con priorità più alta.
Riuscite Mostra i dispositivi IoT Edge che hanno segnalato che i moduli sono stati distribuiti correttamente.
Con errori Mostra i dispositivi IoT Edge che hanno segnalato che uno o più moduli non sono stati distribuiti correttamente. Per esaminare ulteriormente questo errore, connettersi in remoto a tali dispositivi e visualizzare i file di log.

Il servizio hub IoT rende disponibili i dati per il monitoraggio nel portale di Azure e nell'interfaccia della riga di comando di Azure.

Monitorare una distribuzione nel portale di Azure

Per visualizzare i dettagli di una distribuzione e monitorare i dispositivi che la eseguono, seguire questa procedura:

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

  2. Selezionare Configurazioni + Distribuzioni al menu Gestione dispositivi.

  3. Esaminare l'elenco delle distribuzioni. Per ogni distribuzione, è possibile visualizzare i dettagli seguenti:

    Colonna Descrizione
    ID Nome della distribuzione.
    Type Tipo di distribuzione, ovvero Distribuzione o Distribuzione a livelli.
    Target Condition (Condizione di destinazione) Tag usato per definire 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 specifica il numero di dispositivi ai cui moduli gemelli nell'hub IoT è stato applicato il contenuto della distribuzione.
    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 Numero di dispositivi IoT Edge che segnalano i dati per le metriche definite per la distribuzione.
    Data di creazione Timestamp relativo alla creazione della distribuzione. Questo timestamp viene usato per stabilire la prevalenza quando due distribuzioni hanno la stessa priorità.

  4. Selezionare la distribuzione che si vuole monitorare.

  5. Nella pagina Dettagli della distribuzione scorrere fino alla sezione inferiore e selezionare la scheda Condizione di destinazione. Selezionare Visualizza per elencare i dispositivi che soddisfano la condizione di destinazione. È possibile modificare sia la condizione che il valore di Priorità. Se sono state apportate modifiche, selezionare Salva.

    Screenshot che mostra i dispositivi di destinazione per una distribuzione.

  6. Selezionare la scheda Metriche. Se si sceglie una metrica nell'elenco a discesa Seleziona metrica, viene visualizzato un pulsante Visualizza che consente di visualizzare i risultati. È anche possibile selezionare Modifica metriche per modificare i criteri per le metriche personalizzate definite. Se sono state apportate modifiche, selezionare Salva.

    Screenshot che mostra le metriche di una distribuzione.

Per apportare modifiche alla 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 comando deployment show accetta i parametri seguenti:

  • --deployment-id: nome della distribuzione esistente nell'hub IoT. Parametro obbligatorio.
  • --hub-name: nome dell'hub IoT in cui si trova la distribuzione. L'hub deve trovarsi nella sottoscrizione corrente. Per passare alla sottoscrizione desiderata, usare il comando az account set -s [subscription name].

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

  • targetedCount: metrica di sistema che specifica il numero di dispositivi gemelli presenti nell'hub IoT che corrispondono alla condizione di destinazione.
  • appliedCount: metrica di sistema che specifica il numero di dispositivi ai cui moduli gemelli nell'hub IoT è stato applicato il contenuto della distribuzione.
  • reportedSuccessfulCount - Metrica del dispositivo che specifica il numero di dispositivi IoT Edge presenti nella distribuzione che segnalano l'esito positivo dal runtime client IoT Edge.
  • reportedFailedCount - Metrica del dispositivo che specifica il numero di dispositivi IoT Edge presenti nella distribuzione che segnalano l'esito negativo dal runtime client IoT Edge.

È possibile visualizzare un elenco di oggetti o ID dispositivo per ognuna delle metriche tramite 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 comando deployment show-metric accetta i parametri seguenti:

  • --deployment-id: nome della distribuzione esistente nell'hub IoT.
  • --metric-id - Nome della metrica per cui visualizzare l'elenco di ID dispositivo, ad esempio reportedFailedCount.
  • --hub-name: nome dell'hub IoT in cui si trova la distribuzione. L'hub deve trovarsi nella sottoscrizione corrente. Per passare alla sottoscrizione desiderata, usare il comando 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 agente di IoT Edge e hub di IoT Edge, per la connettività e l'integrità delle distribuzioni Edge.