Compartilhar via


Gerenciar arquivos de log

Importante

Esta é a documentação do Azure Sphere (herdado). O Azure Sphere (herdado) será desativado em 27 de setembro de 2027 e os usuários devem migrar para o Azure Sphere (integrado) até esse momento. Use o seletor de versão localizado acima do sumário para exibir a documentação do Azure Sphere (Integrado).

A CLI do Azure Sphere permite que você decida se deseja incluir informações de diagnóstico e configuração do seu computador, da nuvem e do dispositivo do Azure Sphere anexado em um arquivo de log. Você pode habilitar ou desabilitar o registro usando a CLI para uma sessão específica ou permanentemente definindo a variável de ambiente.

Observação

  • Não há suporte para esse recurso na CLI clássica do Azure Sphere.
  • Por padrão, se a variável de ambiente não estiver definida, o registro será desabilitado.

Configurar o registro em log na CLI

O registro é configurado definindo a variável AZSPHERE_FILE_LOGGING_DISABLEDde ambiente . Quando o log está habilitado, um arquivo de log é criado no diretório C:\Users<user.azsphere>\logs no Windows e ~/.azsphere/logs no Linux. Além disso, as informações também são incluídas no arquivo .zip criado quando você executa o azsphere get-support-data comando.

Exemplo

Aqui está um exemplo para configurar o registro em log usando a CLI:

Observação

As preferências definidas se aplicam somente à sessão CLI atual em que você está e não são persistentes entre as sessões. Para definir permanentemente sua preferência, consulte a documentação fornecida para o seu sistema operacional.

Os valores com suporte são:

  • 0 para habilitar o registro
  • 1 para desativar o registro
  • Se não estiver definido, o registro será desativado

Prompt de Comando do Windows

Para habilitar o registro em log:

set AZSPHERE_FILE_LOGGING_DISABLED=0

Para desabilitar o registro em log:

set AZSPHERE_FILE_LOGGING_DISABLED=1

Para limpar a configuração:

set AZSPHERE_FILE_LOGGING_DISABLED=

Para exibir o valor da variável de ambiente, digite set AZSPHERE_FILE_LOGGING_DISABLED no prompt de comando.

Windows PowerShell

Você pode executar o comando no Prompt de Comando do Windows e no Windows PowerShell:

Para habilitar o registro em log:

$env:AZSPHERE_FILE_LOGGING_DISABLED=0

Para desabilitar o registro em log:

$env:AZSPHERE_FILE_LOGGING_DISABLED=1

Para limpar a configuração:

Remove-Item -Path Env:AZSPHERE_FILE_LOGGING_DISABLED

Para exibir o valor da variável de ambiente, digite dir env: PowerShell e localize AZSPHERE_FILE_LOGGING_DISABLED na lista.