Raccogliere in remoto i log di diagnostica dai dispositivi usando l'aggiornamento dei dispositivi per hub IoT

Informazioni su come avviare un aggiornamento del dispositivo per hub IoT operazione di log e visualizzare i log raccolti all'interno dell'archiviazione BLOB di Azure.

Prerequisiti

Collegare l'account di archiviazione BLOB di Azure all'istanza di Aggiornamento dispositivi

Per usare la funzionalità di raccolta log remota, è prima necessario collegare un account di archiviazione BLOB di Azure all'istanza di Aggiornamento dispositivo. Questo account di archiviazione BLOB di Azure è il luogo in cui i dispositivi caricheranno i log di diagnostica.

az iot device-update instance update --account <account_name> --instance <instance_name> --set enableDiagnostics=true diagnosticStorageProperties.resourceId=<storage_id>

Configurare la raccolta log

L'agente di aggiornamento del dispositivo fa riferimento a un file di configurazione nel dispositivo, situato in /etc/adu/du-diagnostics-config.json nell'agente di riferimento.

Percorsi file di raccolta log

L'agente di aggiornamento del dispositivo in un dispositivo raccoglierà i file da percorsi di file specifici nel dispositivo quando riceve un segnale di avvio del caricamento del log dal servizio Aggiornamento dispositivi. Questi percorsi di file sono definiti nel file di configurazione di diagnostica.

All'interno del file di configurazione, ogni file di log da raccogliere e caricare viene rappresentato come logComponent oggetto con proprietà componentName e logPath. Questa configurazione può essere modificata in base alle esigenze.

Dimensioni massime del file di log

L'agente di aggiornamento del dispositivo raccoglierà solo i file di log in base a una determinata dimensione del file. Questa dimensione massima di file è definita nel file di configurazione di diagnostica.

Il parametro pertinente "maxKilobytesToUploadPerLogPath" verrà applicato a ogni oggetto logComponent e può essere modificato come desiderato.

Creare un'operazione di log

Le operazioni di log sono un'azione basata sul servizio che è possibile indicare ai dispositivi IoT di eseguire tramite il servizio Aggiornamento dispositivi. Per una spiegazione più dettagliata del funzionamento delle operazioni di log, vedere Diagnostica degli aggiornamenti del dispositivo.

1. Passare alla hub IoT e selezionare la scheda Aggiornamenti nella sezione Gestione dispositivi del riquadro di spostamento.

2. Selezionare la scheda Diagnostica nell'interfaccia utente. Se non viene visualizzata una scheda Diagnostica, assicurarsi di usare la versione più recente dell'aggiornamento del dispositivo per hub IoT interfaccia utente. Se viene visualizzato "La diagnostica deve essere abilitata per questa istanza di Aggiornamento dispositivo", assicurarsi di aver collegato un account di archiviazione BLOB di Azure con l'istanza di Aggiornamento dispositivi.

3. Selezionare Aggiungi operazione di caricamento log per passare alla pagina di creazione dell'operazione di log.

4. Immettere un nome (ID) e una descrizione per la nuova operazione di log, quindi selezionare Aggiungi dispositivi per selezionare i dispositivi IoT da cui raccogliere i log di diagnostica.

5. Selezionare Aggiungi.

6. Una volta tornata alla scheda Diagnostica, selezionare Aggiorna finché non viene visualizzata l'operazione di log elencata nella tabella operazioni.

7. Dopo aver completato lo stato dell'operazione o Nonriuscito, selezionare il nome dell'operazione per visualizzarne i dettagli. Un'operazione verrà contrassegnata "Successed" solo se tutti i dispositivi di destinazione hanno completato correttamente il caricamento del log. Se alcuni dispositivi di destinazione hanno avuto esito positivo e alcuni non sono riusciti, l'operazione di log verrà contrassegnata "Non riuscita". È possibile usare la pagina dei dettagli dell'operazione di log per visualizzare i dispositivi che hanno avuto esito positivo e che non sono riusciti.

8. Nei dettagli dell'operazione di log è possibile visualizzare lo stato specifico del dispositivo e visualizzare il percorso del percorso del log. Questo percorso corrisponde al percorso della directory virtuale all'interno dell'account di archiviazione BLOB di Azure in cui sono stati caricati i log di diagnostica.

Visualizzare ed esportare i log di diagnostica raccolti

1. Dopo aver completato l'operazione di log, passare all'account di archiviazione BLOB di Azure.

2. Selezionare Contenitori nella sezione Archiviazione dati del riquadro di spostamento.

3. Selezionare il contenitore con lo stesso nome dell'istanza di Aggiornamento dispositivo.

4. Usare il percorso del log dai dettagli dell'operazione di log per passare alla directory corretta contenente i log. Per impostazione predefinita, la funzionalità raccolta log remota indica ai dispositivi di destinazione di caricare i log di diagnostica usando il modello di percorso directory seguente: Contenitore di archiviazione BLOB/ID dispositivo di destinazione/ID operazione log/Percorso log del dispositivo on-device

5. Se non è stato modificato il componente di diagnostica dell'agente DU, il dispositivo risponderà a qualsiasi operazione di log tentando di caricare due file di log non crittografati: il log di diagnostica dell'agente DU ("aduc.log") e il log di diagnostica dell'agente DO ("do-agent.log"). Per altre informazioni, vedere i file di log raccolti dall'agente di riferimento DU leggendo la pagina del concetto di diagnostica dell'aggiornamento del dispositivo .

6. È possibile visualizzare il contenuto del file di log selezionando il nome del file, quindi selezionando l'elemento del menu (puntini di sospensione) e facendo clic su Visualizza/modifica. È anche possibile scaricare o eliminare il file di log selezionando rispettivamente le opzioni etichettate.

   

Passaggi successivi

Per altre informazioni sulle funzionalità di diagnostica di Device Update, vedere Panoramica della funzionalità di diagnostica dell'aggiornamento dei dispositivi