Trovare e correggere i dispositivi mancanti in Aggiornamento dispositivi per hub IoT tramite il controllo dell'agente

Informazioni su come usare la funzionalità di controllo dell'agente per trovare, diagnosticare e correggere i dispositivi mancanti nell'aggiornamento dei dispositivi per hub IoT'istanza.

Prerequisiti

• Accesso a un hub IoT con Aggiornamento del dispositivo per hub IoT abilitato.
• Provisioning di un dispositivo IoT (o simulatore) per Aggiornamento del dispositivo e segnalazione di un ID modello Plug and Play (PnP) compatibile.

Nota

La funzionalità di controllo agente può eseguire solo controlli di convalida nei dispositivi in cui è installato l'agente di Aggiornamento dispositivi e segnala un ID modello PnP corrispondente a quelli compatibili con Aggiornamento dispositivi per hub IoT.

Azure portal

Browser supportati:

• Microsoft Edge
• Google Chrome

Interfaccia della riga di comando di Azure

Un ambiente dell'interfaccia della riga di comando di Azure:

• Usare l'ambiente Bash in Azure Cloud Shell.

  

• In alternativa, se si preferisce eseguire i comandi di riferimento dell'interfaccia della riga di comando in locale, installare l'interfaccia della riga di comando di Azure

  1. Accedere all'interfaccia della riga di comando di Azure usando il comando az login .
  2. Eseguire az version per trovare la versione e le librerie dipendenti installate. Per eseguire l'aggiornamento alla versione più recente, eseguire az upgrade.
  3. Quando richiesto, installare le estensioni dell'interfaccia della riga di comando di Azure al primo utilizzo. I comandi in questo articolo usano l'estensione azure-iot . Eseguire az extension update --name azure-iot per assicurarsi di usare la versione più recente dell'estensione.

Controlli di convalida supportati dal controllo dell'agente

La funzionalità di controllo dell'agente esegue attualmente i controlli di convalida seguenti in tutti i dispositivi che soddisfano i prerequisiti precedenti.

Controllo della convalida	Criteri
ID modello PnP	L'ID del modello PnP è una stringa segnalata dall'agente di Aggiornamento dispositivi al dispositivo gemello che descrive il modello PnP da usare per la comunicazione tra dispositivi e cloud. Questa stringa deve essere un DTMI (Digital Twin Model Identifier) valido che supporta l'interfaccia Device Update.
ID interfaccia	L'ID interfaccia è una stringa segnalata dall'agente di Aggiornamento dispositivi al dispositivo gemello che descrive quale versione dell'interfaccia di Aggiornamento dispositivi deve essere usata per la comunicazione del dispositivo/cloud. Questa stringa deve essere un DTMI valido che supporta l'interfaccia Device Update.
Nomi delle proprietà di compatibilità	CompatPropertyNames è un campo segnalato dall'agente di Aggiornamento dispositivi al dispositivo gemello che descrive i deviceProperties campi da usare per determinare la compatibilità del dispositivo con una determinata distribuzione. Il valore di questo campo deve essere una stringa di nomi delimitati da virgole. La stringa deve contenere almeno uno e non più di cinque nomi. Ogni nome deve essere di <32 caratteri.
Valori delle proprietà di compatibilità	I valori delle proprietà di compatibilità sono le coppie field:value specificate dal compatPropertyNames campo e segnalate dall'agente di Aggiornamento dispositivi al dispositivo gemello come deviceProperties. Ogni nome definito nei nomi delle proprietà di compatibilità deve avere una coppia field:value corrispondente segnalata. Il valore per ogni coppia è limitato a 64 caratteri.
Gruppo ADU	Il tag gruppo ADU è un tag facoltativo definito nel dispositivo gemello del dispositivo e determina il gruppo di dispositivi a cui appartiene il dispositivo. Se specificato, la stringa di tag è limitata a 255 caratteri e può contenere solo caratteri alfanumerici e i caratteri speciali seguenti: "." "-" "_" "~"

Se un dispositivo non riesce in uno di questi criteri, potrebbe non essere visualizzato correttamente in Aggiornamento dispositivi. La correzione del valore non valido per soddisfare i criteri specificati dovrebbe causare la corretta visualizzazione del dispositivo in Aggiornamento dispositivi. Se il dispositivo non viene visualizzato in Aggiornamento dispositivi né nel controllo dell'agente, potrebbe essere necessario eseguire la sincronizzazione del dispositivo per risolvere il problema.

Visualizzare i risultati del controllo dell'agente

Azure portal

I risultati del controllo dell'agente sono disponibili nella scheda Diagnostica di Aggiornamento dispositivi.

1. Nel portale di Azure passare all'hub IoT.
2. Selezionare Aggiornamenti dal menu di spostamento e quindi selezionare la scheda Diagnostica.
3. Espandere la sezione Trova dispositivi mancanti.

Interfaccia della riga di comando di Azure

Usare az iot du device health list per visualizzare l'integrità dei dispositivi.

Il device health list comando accetta gli argomenti seguenti:

• --account: nome dell'account di Aggiornamento dispositivi.
• --instance: nome dell'istanza di Aggiornamento dispositivi.
• --filter: filtro dell'integrità del dispositivo, filtro in base allo stato del dispositivo o ALL'ID dispositivo. Ad esempio:
  • Per elencare tutti i dispositivi integri, filtra per state eq 'Healthy'
  • Per elencare tutti i dispositivi non integri, filtra per state eq 'Unhealthy'
  • Per visualizzare lo stato di integrità di un dispositivo di destinazione, filtrare in base deviceId eq '<device_name>' a o deviceId eq '<device_name>' and moduleId eq '<module_name>'

az iot du device health list --account <Device Update account name> --instance <Device Update instance name> --filter "<filter query>"

Avviare un'operazione di sincronizzazione del dispositivo

La sincronizzazione dei dispositivi deve essere attivata se un dispositivo è stato registrato nell'hub IoT, ma non viene visualizzato in Aggiornamento dispositivi né nei risultati del controllo dell'agente.

Per ogni istanza di Aggiornamento dispositivi può essere attiva una sola operazione di sincronizzazione del dispositivo alla volta.

Azure portal

1. Nel portale di Azure passare all'hub IoT.
2. Selezionare Aggiornamenti dal menu di spostamento e quindi selezionare la scheda Diagnostica.
3. Espandere la sezione Visualizza integrità del dispositivo.
4. Selezionare Avvia sincronizzazione del dispositivo.

Interfaccia della riga di comando di Azure

Usare az iot du device import per importare dispositivi e moduli nell'istanza di Aggiornamento dispositivi da un hub IoT collegato.

az iot du device import --account <Device Update account name> --instance <Device Update instance name>

Passaggi successivi

Per altre informazioni sulle funzionalità di diagnostica di Aggiornamento dispositivi, vedere Panoramica delle funzionalità di diagnostica degli aggiornamenti dei dispositivi