Visualizzare le informazioni sul dispositivo

  • Articolo

Un tenant Azure Sphere può contenere migliaia di dispositivi e la gestione dei dispositivi richiede un metodo per ottenere informazioni dettagliate su ognuno di essi. Usando i comandi CLI, è possibile elencare le informazioni su dispositivi, prodotti e gruppi di dispositivi in un tenant. È anche possibile reindirizzare l'output standard di un comando a un file per una revisione dettagliata.

È anche possibile usare i comandi CLI per scaricare informazioni di diagnostica e configurazione, dati sugli errori e altri eventi che interessano i dispositivi.

Reindirizzare o impaginare i risultati

L'interfaccia da riga di comando (CLI) Azure Sphere fornisce i comandi seguenti per elencare le informazioni sui dispositivi, i prodotti e i gruppi di dispositivi in un tenant.

Questi comandi possono restituire un elenco di elementi di grandi dimensioni che possono essere reindirizzati o impaginati. Questa sezione descrive i diversi modi per reindirizzare o impaginare l'output da entrambi gli indicatori CLIs.

Azure Sphere CLI

Azure Sphere CLI non supporta l'impaginazione interattiva. Tuttavia, è possibile impaginare l'output sullo schermo eseguendo il piping su strumenti di impaginazione esistenti.

Per esempio:

  • In PowerShell (Windows): azsphere device list | Out-Host –Paging
  • Al prompt dei comandi (Windows): azsphere device list | more
  • Shell In Bash (Linux): azsphere device list | less

Nota

Questa operazione può essere lenta a seconda della quantità di dati restituiti.

È anche possibile reindirizzare l'output standard di un comando a un file. Nell'esempio seguente, l'output standard viene inviato a output.txt e l'errore standard viene inviato a logs.txt.

azsphere device list --verbose > output.txt 2> logs.txt

Azure Sphere Classic CLI

L'azione predefinita di questi comandi consiste nel restituire una pagina di record contemporaneamente, in cui le dimensioni della pagina sono in genere impostate su 100 record. Nella parte inferiore di ogni pagina dei risultati è presente un messaggio per premere qualsiasi tasto per continuare la visualizzazione con la pagina successiva dei risultati. Le dimensioni della pagina vengono regolate automaticamente in base a fattori come l'attività del database e la larghezza di banda di rete disponibile.

È possibile reindirizzare i risultati di un comando di elenco a un file con valori delimitati da virgole (CSV) per una revisione approfondita specificando un percorso e un nome file per --output il parametro e aggiungendo il --noninteractive parametro al comando. Il --noninteractive parametro rimuove l'impaginazione dai risultati in modo che l'intero elenco venga acquisito nel file CSV senza dover continuare manualmente alla fine di ogni pagina.

Visualizzare informazioni per il supporto

I comandi usati per ottenere informazioni di supporto dipendono dalla raccolta dei dati del supporto tecnico per un singolo dispositivo Azure Sphere quando si lavora con il supporto Microsoft o dalla restituzione di dati sulle condizioni di errore che coinvolgono le applicazioni in esecuzione nei dispositivi all'interno di un tenant. Nella maggior parte degli scenari, verranno eseguite query sul tenant per verificare le condizioni di errore in tutti i dispositivi usando il comando azsfera tenant download-error-report . Questo metodo dipenderà dalla comunicazione del servizio di sicurezza Azure Sphere con i dispositivi tramite una connessione Internet per raccogliere gli eventi corrispondenti.

get-support-data

Il comando get-support-data dell'azsfera raccoglie e genera file di log contenenti informazioni di diagnostica e di configurazione dal computer, dal cloud e dal dispositivo Azure Sphere allegato. Le informazioni contenute in questi file di log possono essere usate per aiutare l'utente o il team di supporto tecnico ad analizzare e risolvere i problemi. Usare il --destination parametro per specificare il percorso e il nome file del file .zip in cui salvare i dati di supporto. È possibile fornire un percorso relativo o assoluto.

download-error-report

Il comando azsfera tenant download-error-report restituisce informazioni sugli errori segnalati dai dispositivi all'interno di un tenant. I dati degli eventi vengono recuperati dal cloud Azure Sphere Security Service e non richiedono una connessione fisica a un particolare dispositivo. Il comando funziona nel contesto del tenant corrente e restituisce report degli errori per tutti i dispositivi all'interno del tenant.

Usare il --destination parametro per specificare il percorso e il nome file del file .csv in cui salvare i dati di supporto. È possibile fornire un percorso relativo o assoluto.