get-support-data
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).
Coleta e gera arquivos de log contendo informações de diagnóstico e configuração do seu computador, da nuvem e do dispositivo Azure Sphere anexado. As informações nesses arquivos de log podem ser usadas para ajudar você ou a equipe de suporte técnico a analisar e solucionar problemas. Para obter mais informações, consulte Gerenciar arquivos de log.
Parâmetros obrigatórios
| Parâmetro | Tipo | Descrição |
|---|---|---|
| --destino | Nome do arquivo | Especifica o caminho e o nome do arquivo .zip no qual salvar os dados de suporte. Você pode fornecer um caminho relativo ou absoluto. |
Parâmetros opcionais
| Parâmetro | Tipo | Descrição |
|---|---|---|
| -t, --inquilino | String | Especifica o locatário no qual executar essa operação. Substitui o locatário padrão selecionado. Você pode especificar a ID do locatário ou o nome do locatário. |
Parâmetros Globais
Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:
| Parâmetro | Descrição |
|---|---|
| --debug | Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs. |
| -h, --help | Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis. |
| --only-show-errors | Mostra apenas erros, suprimindo avisos. |
| -o, --output | Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere. |
| --query | Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos. |
| --verbose | Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos. |
Observação
Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.
Exemplo
azsphere get-support-data --destination logs.zip
Gathering device data.
Gathering Azure Sphere Security Service data.
Gathering computer setup data.
Created the support log archive at 'logs.zip'.
Note: This archive contains information about your system including the list of Wi-Fi networks the device can see, installation logs, Azure Sphere command-line activity logs, attached USB devices, and Azure Sphere local and cloud configuration.
If you choose to provide this data to Microsoft, please send an email to azsppgsup@microsoft.com and attach the generated archive. All data will be handled according to the Microsoft Privacy Statement: go.microsoft.com/fwlink/?linkid=528096
Observação
Os dados coletados podem conter informações que você deseja manter privadas. Revise a tabela para determinar se algum dos dados deve permanecer privado antes de compartilhar os arquivos de log.
A tabela a seguir lista os detalhes dos arquivos gerados e as informações que o comando azsphere get-support-data tenta coletar:
| Arquivo de log | Descrição |
|---|---|
| AzureSphere_ComputerSetup.log | Registra atividades relacionadas ao computador: - Definições de configuração interna do Azure Sphere. - Endereços IP de todos os adaptadores de rede local. - Todos os detalhes dos adaptadores de rede do Azure Sphere. - O status do serviço SLIP do Azure Sphere. |
| AzureSphere_Device_nnn.log | Registra atividades relacionadas ao dispositivo conectado: - Detalhes do dispositivo. - Status das imagens instaladas no dispositivo. - Componentes e recursos do dispositivo instalados no dispositivo. - Redes Wi-Fi salvas no dispositivo. - O status atual da rede e da interface do dispositivo. - Resultados da verificação de Wi-Fi do dispositivo. - Status da configuração atual do Wi-Fi no dispositivo. - Estado de fabricação do dispositivo. - Regras definidas para o firewall. |
| AzureSphere_DeviceLog_nnn.bin | Contém dados de diagnóstico, incluindo informações de conectividade e estado do dispositivo, para o dispositivo anexado. Um script Python que analisa os dados e os exibe em um formato fácil de ler está disponível na galeria de Exemplos do Azure Sphere. |
| AzureSphere_DeviceTechSupportData_nnn.bin | Contém informações de estado de fabricação para o dispositivo conectado. |
| AzureSphere_SecurityService_nnn.log | Registra informações sobre o serviço de segurança do Azure Sphere: - A configuração atual, incluindo o locatário atual do Azure Sphere. - Lista de locatários do Azure Sphere. - Configuração de implantação em nuvem, incluindo grupo de dispositivos e produto. - Status de configuração da nuvem, incluindo a versão atual do sistema operacional do dispositivo e a versão atual do sistema operacional disponível na nuvem. |
| ActivityLogs_AzureSphere.txt | Um arquivo de log contendo informações sobre os comandos executados. |
| InstallerLogs_AzureSphere | Lista os arquivos de log que contêm os dados do instalador do Azure Sphere dos últimos sete dias. |
| InstallerLogs_VisualStudio | Lista os arquivos de log que contêm os dados do instalador do Visual Studio dos últimos sete dias. |