Como Verificar os Logs do OneDrive no Windows e Mac

Quando o OneDrive falha ao sincronizar um arquivo, trava inesperadamente ou exibe uma mensagem de erro, o primeiro lugar para procurar a causa raiz são os arquivos de log do OneDrive. Esses logs registram cada operação de sincronização, conflito e erro que o cliente encontra. No Windows, os logs são armazenados em uma pasta oculta sob seu perfil de usuário. No Mac, os logs ficam no diretório Application Support. Este artigo explica exatamente onde encontrar esses logs em cada sistema operacional, como abri-los e como interpretar os códigos de erro mais comuns para resolver problemas de sincronização mais rápido.

O que os Arquivos de Log do OneDrive Registram e Por Que Você Precisa Deles

Os logs do OneDrive são arquivos de texto simples que o cliente de sincronização grava automaticamente durante cada sessão. Eles contêm carimbos de data/hora, IDs de operação, caminhos de arquivo, códigos de resposta HTTP e descrições de erro. Diferente das mensagens de erro genéricas mostradas na bandeja do sistema, esses logs revelam a etapa exata onde uma sincronização falhou, como um conflito de bloqueio de arquivo, um erro de permissão ou um tempo limite de rede.

Os dois principais arquivos de log são:

SyncDiagnostics.log
Este arquivo registra cada tentativa de upload, download, renomeação e exclusão de arquivo. Ele também registra os resultados da enumeração de pastas do servidor. Se um arquivo estiver travado com um ícone de sincronização pendente, o SyncDiagnostics.log mostrará a última solicitação e resposta HTTP para esse arquivo.

DeviceManager.log
Este arquivo registra eventos de registro de dispositivo, atualização de token de autenticação e aplicação de políticas de locatário. Erros neste arquivo geralmente apontam para credenciais expiradas, acesso de dispositivo bloqueado ou configurações incorretas de política de grupo do OneDrive.

Ambos os logs são rotacionados automaticamente quando atingem cerca de 5 MB. Arquivos de log mais antigos são compactados em arquivos .zip com um sufixo numérico, como SyncDiagnostics.1.log.zip. Você pode abrir arquivos .log com qualquer editor de texto, incluindo o Bloco de Notas no Windows e o TextEdit no Mac. Para arquivos .zip, extraia-os primeiro com as ferramentas integradas do sistema operacional.

Passos para Acessar os Logs do OneDrive no Windows

1. Abra a caixa de diálogo Executar
   Pressione Tecla Windows + R no teclado. A caixa de diálogo Executar aparece.
2. Cole o caminho da pasta de logs
   Digite %localappdata%\Microsoft\OneDrive\logs\ no campo Abrir e clique em OK. O Explorador de Arquivos abre diretamente na pasta de logs.
3. Classifique os arquivos por data de modificação
   Clique no cabeçalho da coluna Data de modificação para classificar os arquivos mais recentes no topo. As entradas de log mais recentes estão no arquivo com o sufixo numérico mais alto, por exemplo SyncDiagnostics.5.log.
4. Abra o arquivo de log
   Clique duas vezes em SyncDiagnostics.log ou na variante numerada mais recente. Se o Windows solicitar que você escolha um programa, selecione Bloco de Notas.
5. Pesquise códigos de erro
   Pressione Ctrl + F e digite o código de erro ou o nome do arquivo que está falhando. Procure linhas contendo “Error”, “Failed” ou “Conflict”. Cada linha começa com um carimbo de data/hora no formato AAAA-MM-DDTHH:MM:SS.

Se você não conseguir ver a pasta de logs, certifique-se de que os itens ocultos estão visíveis. No Explorador de Arquivos, clique em Exibir > Mostrar > Itens ocultos. A pasta AppData fica oculta por padrão no Windows.

Passos para Acessar os Logs do OneDrive no Mac

1. Abra o Finder
   Clique no ícone do Finder no Dock.
2. Vá para a pasta Library
   Na barra de menus do Finder, clique em Ir > Ir para Pasta. Um campo de texto aparece.
3. Cole o caminho da pasta de logs
   Digite ~/Library/Application Support/OneDrive/logs/ e pressione Return. Uma janela do Finder é aberta mostrando a pasta de logs.
4. Classifique os arquivos por data de adição
   Clique na coluna Data de adição ou Data de modificação para trazer os arquivos mais recentes ao topo. No Mac, o arquivo de log ativo geralmente é nomeado SyncDiagnostics.log.
5. Abra o arquivo de log
   Clique duas vezes em SyncDiagnostics.log. Ele abre no Console por padrão. Para visualizá-lo como texto simples, clique com o botão direito no arquivo, escolha Abrir com e selecione TextEdit.
6. Pesquise códigos de erro
   Pressione Command + F e digite o código de erro ou nome do arquivo. O Console destaca as linhas correspondentes em amarelo.

Se a pasta Library estiver oculta, mantenha pressionada a tecla Option enquanto clica no menu Ir no Finder. A opção Library aparece diretamente no menu Ir sem precisar digitar o caminho.

Como Ler as Entradas de Log do OneDrive

Cada entrada de log segue uma estrutura consistente. Uma linha típica se parece com isto:

2025-03-28T14:32:15.123Z [0x1A2B] [Info] Upload of file 'C:\Users\Name\OneDrive\report.xlsx' completed successfully (HTTP 200)

As partes são:

Carimbo de data/hora
A data e hora no Tempo Universal Coordenado (UTC). Converta para seu fuso horário local subtraindo ou adicionando horas.

ID da thread
O número hexadecimal entre colchetes, por exemplo [0x1A2B]. Isso identifica qual thread em segundo plano processou a operação. Você pode ignorar isso, a menos que esteja rastreando uma operação específica em várias linhas.

Nível de severidade
Um de Info, Warning, Error ou Critical. Concentre-se nas linhas Error e Critical primeiro. Linhas Warning indicam problemas recuperáveis, como uma instabilidade temporária de rede.

Mensagem
A descrição do evento. Mensagens comuns incluem “Upload of file”, “Download of file”, “Conflict detected”, “Token refresh failed” e “Server returned HTTP 409”.

Código de status HTTP
Números como 200 (sucesso), 403 (proibido), 404 (não encontrado), 409 (conflito), 423 (bloqueado), 429 (muitas solicitações) e 500 (erro do servidor). Um código 409 geralmente significa que o arquivo foi modificado no servidor enquanto uma alteração local estava em andamento.

Erros Comuns nos Logs do OneDrive e Seus Significados

0x8004de40 — Falha na atualização do token

Este erro aparece no DeviceManager.log quando o OneDrive não consegue renovar seu token de autenticação. A causa geralmente é uma credencial em cache que expirou ou uma alteração de senha que não foi sincronizada. Para corrigir, abra o Gerenciador de Credenciais no Windows ou o Acesso às Chaves no Mac, localize todas as entradas contendo “OneDrive” ou “MicrosoftAccount”, exclua-as e faça login novamente no OneDrive.

HTTP 409 — Conflito de arquivo detectado

Um código de status 409 no SyncDiagnostics.log significa que o arquivo foi alterado tanto localmente quanto no servidor ao mesmo tempo. O OneDrive cria uma cópia de conflito com o nome do computador anexado ao nome do arquivo. Abra ambas as versões e mescle as alterações manualmente, depois exclua a cópia de conflito.

0x8007016a — O provedor de arquivos na nuvem não está em execução

Este erro indica que o driver Windows Cloud Files Filter está desabilitado ou travou. Reinicie o processo do OneDrive clicando com o botão direito no ícone do OneDrive na bandeja do sistema e selecionando Fechar OneDrive, depois inicie o OneDrive novamente pelo menu Iniciar. Se o erro persistir, execute sfc /scannow em um Prompt de Comando elevado para reparar arquivos do sistema.

HTTP 423 — Arquivo bloqueado por outro processo

Um código de status 423 significa que o arquivo está aberto em outro aplicativo, como Microsoft Excel ou um leitor de PDF. Feche o aplicativo que mantém o bloqueio e aguarde o OneDrive tentar a sincronização novamente. Para forçar uma nova tentativa imediatamente, clique com o botão direito no arquivo no Explorador de Arquivos e selecione Sincronizar.

SyncDiagnostics.log vs DeviceManager.log: O Que Cada Log Cobre

Item	SyncDiagnostics.log	DeviceManager.log
Eventos registrados	Uploads, downloads, exclusões, renomeações e conflitos de arquivos	Registro de dispositivo, atualização de token, aplicação de políticas e eventos de login
Códigos de erro típicos	HTTP 200, 403, 404, 409, 423, 429, 500	0x8004de40, 0x8004de44, 0x8004de4c
Quando verificar	Um arquivo específico falha ao sincronizar ou mostra um ícone pendente	O OneDrive não inicia, mostra solicitação de login repetidamente ou relata um erro de licenciamento
Limite de tamanho do arquivo	5 MB por arquivo, depois rotacionado e compactado	5 MB por arquivo, depois rotacionado e compactado

Se você estiver solucionando uma falha de login ou um bloqueio de dispositivo, abra o DeviceManager.log primeiro. Se estiver solucionando um arquivo que não faz upload ou download, abra o SyncDiagnostics.log primeiro.

Se os Logs do OneDrive Estiverem Vazios ou Ausentes

Uma pasta de logs vazia ou um arquivo de log com apenas uma linha de cabeçalho geralmente significa que o OneDrive não ficou em execução tempo suficiente para gravar entradas, ou a rotação de logs excluiu arquivos antigos. Inicie o OneDrive, execute a ação que dispara o erro e verifique os logs novamente imediatamente. Se a pasta não existir, o OneDrive pode não estar instalado corretamente. Reinstale o OneDrive pelo portal do Microsoft 365 e reinicie o computador.

No Windows, se a pasta de logs estiver ausente, mas o OneDrive estiver em execução, o perfil de usuário pode estar corrompido. Crie um novo perfil de usuário no Windows e faça login no OneDrive lá. No Mac, certifique-se de que o OneDrive tenha permissões de acesso a disco em Ajustes do Sistema > Privacidade e Segurança > Arquivos e Pastas.

Agora você pode localizar, abrir e ler arquivos de log do OneDrive no Windows e Mac sem depender de mensagens de erro genéricas. Na próxima vez que uma sincronização falhar, verifique o SyncDiagnostics.log para códigos HTTP 409 ou 423, e verifique o DeviceManager.log para erros de token como 0x8004de40. Para solução de problemas mais rápida, mantenha um editor de texto aberto com o arquivo de log carregado para que você possa atualizá-lo após cada tentativa de sincronização.