Condividi tramite


Gestire i file di log

Importante

Questa è la documentazione di Azure Sphere (legacy). Azure Sphere (legacy) viene ritirato il 27 settembre 2027 e gli utenti devono eseguire la migrazione ad Azure Sphere (integrato) entro questo periodo. Usare il selettore di versione posizionato sopra il sommario per visualizzare la documentazione di Azure Sphere (integrata).

L'interfaccia della riga di comando di Azure Sphere consente di decidere se includere informazioni di diagnostica e configurazione dal computer, dal cloud e dal dispositivo Azure Sphere collegato in un file di log. È possibile abilitare o disabilitare la registrazione usando l'interfaccia della riga di comando per una sessione specifica o in modo permanente impostando la variabile di ambiente.

Nota

  • Questa funzionalità non è supportata nell'interfaccia della riga di comando classica di Azure Sphere.
  • Per impostazione predefinita, se la variabile di ambiente non è impostata, la registrazione è disabilitata.

Configurare la registrazione nell'interfaccia della riga di comando

La registrazione viene configurata impostando la variabile AZSPHERE_FILE_LOGGING_DISABLEDdi ambiente . Quando la registrazione è abilitata, viene creato un file di log nella directory C:\Users<user.azsphere>\logs in Windows e ~/.azsphere/logs in Linux. Inoltre, le informazioni vengono incluse anche nel file .zip creato quando si esegue il azsphere get-support-data comando .

Esempio

Ecco un esempio per configurare la registrazione usando l'interfaccia della riga di comando:

Nota

Le preferenze impostate si applicano solo alla sessione corrente dell'interfaccia della riga di comando in cui ci si trova e non è persistente tra le sessioni. Per impostare in modo permanente le preferenze, vedere la documentazione fornita per il sistema operativo.

I valori supportati sono:

  • 0 per abilitare la registrazione
  • 1 per disabilitare la registrazione
  • Se non è impostato, la registrazione è disabilitata

Prompt dei comandi di Windows

Per abilitare la registrazione:

set AZSPHERE_FILE_LOGGING_DISABLED=0

Per disabilitare la registrazione:

set AZSPHERE_FILE_LOGGING_DISABLED=1

Per cancellare l'impostazione:

set AZSPHERE_FILE_LOGGING_DISABLED=

Per visualizzare il valore della variabile di ambiente, digitare set AZSPHERE_FILE_LOGGING_DISABLED nel prompt dei comandi.

Windows PowerShell

È possibile eseguire il comando dal prompt dei comandi di Windows e da Windows PowerShell:

Per abilitare la registrazione:

$env:AZSPHERE_FILE_LOGGING_DISABLED=0

Per disabilitare la registrazione:

$env:AZSPHERE_FILE_LOGGING_DISABLED=1

Per cancellare l'impostazione:

Remove-Item -Path Env:AZSPHERE_FILE_LOGGING_DISABLED

Per visualizzare il valore della variabile di ambiente, digitare dir env: PowerShell e individuare AZSPHERE_FILE_LOGGING_DISABLED nell'elenco.