Como Coletar Diagnósticos de Sincronização do OneDrive para o Suporte Microsoft

Quando a sincronização do OneDrive falha com erros como arquivos travados, sincronização constante ou exclusões inesperadas, o Suporte Microsoft geralmente solicita logs de diagnóstico para identificar a causa raiz. Esses logs contêm registros detalhados das operações de sincronização, conflitos de arquivos e eventos do sistema que mensagens de erro genéricas não mostram. Este artigo explica como coletar diagnósticos de sincronização do OneDrive manualmente e por meio da ferramenta de relatório integrada. Você aprenderá as etapas exatas para gerar, localizar e exportar os arquivos de diagnóstico que o Suporte Microsoft solicita.

O que os Diagnósticos de Sincronização do OneDrive Incluem

Os diagnósticos de sincronização do OneDrive são uma coleção de arquivos de log e dados do sistema que registram cada ação executada pelo mecanismo de sincronização. Esses logs ajudam os engenheiros da Microsoft a identificar por que os arquivos não estão sincronizando, por que a sincronização está lenta ou por que arquivos estão sendo excluídos inesperadamente. O pacote de diagnóstico normalmente inclui:

Logs do mecanismo de sincronização: Esses arquivos, armazenados na pasta de logs do OneDrive, contêm carimbos de data/hora, caminhos de arquivos, códigos de erro e o status de cada operação de sincronização. Eles mostram se um arquivo foi enviado, baixado, ignorado ou entrou em conflito.

Logs de rastreamento de eventos: O Rastreamento de Eventos do Windows para o OneDrive captura eventos de baixo nível do sistema, como desconexões de rede, falhas de autenticação e travamentos do serviço. Eles não são visíveis na interface do usuário.

Instantâneos do registro: Os diagnósticos exportam chaves de registro relevantes em HKEY_CURRENT_USER\Software\Microsoft\OneDrive. Essas chaves armazenam configurações da conta, valores de limitação e caminhos raiz de sincronização.

Informações do sistema: Detalhes básicos sobre a versão do Windows, número de compilação do OneDrive e atualizações instaladas são incluídos para confirmar que o ambiente atende aos requisitos de compatibilidade.

Rastreamentos de rede: Quando coletados com a ferramenta de diagnóstico avançada, os cabeçalhos de requisição e resposta HTTP para chamadas da API do OneDrive são capturados. Esses dados revelam problemas como bloqueios de proxy ou erros de certificado.

Método 1: Coletar Diagnósticos pelas Configurações do OneDrive

Este é o método mais simples e funciona para a maioria dos problemas de sincronização. Não requer privilégios de administrador nem ferramentas de linha de comando. O processo é executado em segundo plano e gera um arquivo compactado que você pode enviar diretamente para um chamado de suporte.

1. Abra as configurações do OneDrive
   Clique com o botão direito no ícone de nuvem do OneDrive na bandeja do sistema, próximo ao relógio. Selecione Configurações no menu. Se o ícone estiver ausente, abra o OneDrive pelo menu Iniciar.
2. Navegue até a guia Sincronizar e backup
   Na janela de Configurações, clique na guia Sincronizar e backup na parte superior. Esta guia contém opções para gerenciar pastas e solucionar problemas.
3. Clique em Configurações avançadas
   Na guia Sincronizar e backup, encontre o link Configurações avançadas e clique nele. Uma nova seção aparece com opções de diagnóstico.
4. Selecione Coletar diagnósticos
   Role para baixo até a seção Diagnóstico. Clique no botão Coletar diagnósticos. Uma caixa de diálogo de confirmação aparece informando que os logs serão coletados.
5. Aguarde a conclusão da coleta de diagnósticos
   O OneDrive começa a coletar logs em segundo plano. Um indicador de progresso mostra o status. O processo normalmente leva de 10 a 20 minutos, dependendo do volume de atividade de sincronização. Não feche o OneDrive nem reinicie o computador durante esse período.
6. Abra o local do arquivo de diagnóstico
   Quando a coleta for concluída, uma notificação aparece. Clique na notificação para abrir a pasta que contém o arquivo .zip de diagnóstico. O arquivo é nomeado OneDriveDiagnostics-AAAA-MM-DD-HHMMSS.zip.
7. Anexe o arquivo .zip ao seu chamado de suporte
   Envie o arquivo .zip gerado para o caso de suporte. Não modifique nem extraia o conteúdo. O Suporte Microsoft usa o formato compactado original para processar os logs.

Método 2: Exportar Arquivos de Log Manualmente

Se a ferramenta de diagnóstico integrada falhar ou você precisar de logs de um período específico, pode exportar manualmente os arquivos de log brutos. Este método também funciona quando o OneDrive não está respondendo e você não consegue acessar o menu Configurações.

1. Abra o Explorador de Arquivos
   Pressione Windows + E para abrir o Explorador de Arquivos. Digite o seguinte caminho na barra de endereços e pressione Enter:
   %localappdata%\Microsoft\OneDrive\logs
2. Identifique os arquivos de log relevantes
   A pasta contém vários arquivos .log nomeados com carimbos de data/hora. Procure arquivos com a data e hora em que o problema de sincronização ocorreu. Os arquivos mais recentes geralmente são os mais relevantes.
3. Copie os arquivos de log para uma nova pasta
   Crie uma nova pasta na área de trabalho chamada OneDriveLogs. Selecione os arquivos .log relevantes, pressione Ctrl + C para copiá-los e Ctrl + V para colá-los na nova pasta.
4. Compacte a pasta em um arquivo .zip
   Clique com o botão direito na pasta OneDriveLogs, selecione Enviar para e depois escolha Pasta compactada (zipada). Um arquivo .zip com o mesmo nome é criado na área de trabalho.
5. Anexe o arquivo .zip ao seu chamado de suporte
   Envie o arquivo .zip para o caso de suporte. Inclua uma nota descrevendo a hora e data exatas do problema de sincronização para que o engenheiro de suporte possa localizar as entradas relevantes.

Método 3: Usar a Ferramenta de Diagnóstico do OneDrive para Rastreamentos de Rede

Para problemas envolvendo conectividade de rede, autenticação de proxy ou erros de certificado, o Suporte Microsoft pode solicitar um rastreamento de rede. A ferramenta de diagnóstico do OneDrive odls.exe captura o tráfego HTTP entre o OneDrive e os servidores do Microsoft 365.

1. Abra o Prompt de Comando como administrador
   Digite cmd na barra de pesquisa do Windows, clique com o botão direito em Prompt de Comando e selecione Executar como administrador. Confirme o prompt do Controle de Conta de Usuário.
2. Navegue até a pasta de instalação do OneDrive
   Digite o seguinte comando e pressione Enter:
   cd %programfiles%\Microsoft OneDrive\
   Se o OneDrive estiver instalado na pasta Program Files (x86), use cd %programfiles(x86)%\Microsoft OneDrive\.
3. Execute a ferramenta de diagnóstico
   Digite o seguinte comando e pressione Enter:
   odls.exe /collect
   A ferramenta começa a capturar rastreamentos de rede e logs de sincronização. Uma janela de comando mostra o progresso.
4. Reproduza o problema de sincronização
   Enquanto a ferramenta estiver em execução, execute a ação que desencadeia o problema de sincronização. Por exemplo, tente sincronizar um arquivo ou pasta específica que está falhando. A ferramenta captura o tráfego de rede durante essa interação.
5. Pare a coleta de diagnóstico
   Pressione Ctrl + C na janela do Prompt de Comando para interromper o rastreamento. A ferramenta salva a saída na pasta de logs padrão em %localappdata%\Microsoft\OneDrive\logs.
6. Localize e compacte a saída
   Abra a pasta de logs conforme descrito no Método 2. Encontre os arquivos criados durante a sessão de rastreamento. Eles são nomeados com o carimbo de data/hora do início do rastreamento. Compacte-os em um arquivo .zip e anexe ao seu chamado de suporte.

Problemas Comuns ao Coletar Diagnósticos

O botão de coleta de diagnóstico está desabilitado

Isso ocorre quando o OneDrive não está totalmente conectado ou quando o mecanismo de sincronização está em um estado de erro crítico. Saia do OneDrive e faça login novamente. Se o botão continuar desabilitado, reinicie o processo do OneDrive clicando com o botão direito no ícone de nuvem e selecionando Fechar OneDrive, depois reinicie-o pelo menu Iniciar.

O arquivo .zip de diagnóstico está vazio ou muito pequeno

Um arquivo vazio ou pequeno geralmente significa que a coleta de diagnóstico foi interrompida. Feche todos os outros aplicativos que possam interferir no acesso aos arquivos, como software antivírus. Execute a coleta novamente sem abrir ou salvar arquivos no OneDrive durante o processo.

A pasta de logs do OneDrive está ausente

Se a pasta de logs não existir, o OneDrive pode não ter iniciado corretamente. Inicie o OneDrive manualmente pelo menu Iniciar e aguarde a sincronização de pelo menos um arquivo. A pasta de logs é criada automaticamente após a primeira operação de sincronização. Se ainda assim não aparecer, reinstale o OneDrive baixando a versão mais recente do centro de administração do Microsoft 365.

Métodos de Coleta de Diagnóstico do OneDrive: Comparação

Item	Coleta pelas Configurações	Exportação Manual	Ferramenta odls.exe
Facilidade de uso	Um clique, sem linha de comando	Requer navegação no Explorador de Arquivos	Requer Prompt de Comando como administrador
Dados incluídos	Logs de sincronização, rastreamentos de eventos, registro	Apenas logs de sincronização	Logs de sincronização e rastreamentos de rede
Tempo para concluir	10 a 20 minutos	2 a 5 minutos	5 a 15 minutos dependendo do rastreamento
Melhor para	Erros gerais de sincronização	Logs rápidos para problemas recentes	Problemas de rede e autenticação

Agora você tem três métodos para coletar diagnósticos de sincronização do OneDrive para o Suporte Microsoft. Comece com a coleta integrada pelas Configurações na maioria dos casos. Use a exportação manual quando a ferramenta de Configurações não estiver disponível. Use a ferramenta odls.exe apenas quando orientado por um engenheiro de suporte para problemas relacionados à rede. Após enviar os diagnósticos, verifique o chamado de suporte para uma resposta dentro de 24 a 48 horas. Para agilizar o processo, inclua uma descrição detalhada das etapas que você seguiu para reproduzir o problema.