Como Comparar Logs da Ferramenta de Migração do OneDrive com Reclamações de Usuários

Ao migrar arquivos de uma unidade local ou outro serviço de nuvem para o OneDrive, os usuários frequentemente relatam arquivos ausentes, links quebrados ou permissões incorretas. Você precisa verificar se essas reclamações correspondem aos logs da ferramenta de migração. Este artigo explica como extrair entradas de log relevantes, cruzá-las com relatos de usuários e identificar falsos positivos versus falhas reais de migração. Você aprenderá um processo repetível usando o Migration Manager do Microsoft 365, PowerShell e Excel para reconciliar logs com reclamações de usuários de forma eficiente.

Como os Logs da Ferramenta de Migração São Estruturados

O Migration Manager do Microsoft 365 armazena logs em dois locais. O primeiro é o relatório no navegador em Migration Manager > Relatórios. Este relatório lista cada item de origem verificado, seu caminho de destino, tamanho e uma coluna de status que mostra Sucesso, Falha ou Pulado. O segundo local é o contêiner do Azure Storage que você especificou ao criar o agente de migração. O agente grava logs detalhados por item em um contêiner chamado migration-logs por padrão.

Cada entrada de log contém um timestamp, caminho do arquivo de origem, caminho do arquivo de destino, código de erro, mensagem de erro e um ID de correlação. O ID de correlação vincula um único arquivo em vários arquivos de log. Quando um usuário reclama de um arquivo específico, você pode pesquisar por esse nome ou caminho no CSV exportado ou nos logs do Azure Storage. O código de erro informa se a falha foi um problema de permissão, conflito de nome de arquivo, limite de tamanho ou tempo limite de rede.

Etapas para Cruzar Logs com Reclamações de Usuários

Siga estas etapas para comparar sistematicamente os logs da ferramenta de migração com as reclamações dos usuários. Você precisará de acesso ao centro de administração do Microsoft 365, à conta do Azure Storage usada para os logs de migração e ao Excel ou outro aplicativo de planilha.

1. Exporte o relatório do Migration Manager
   Faça login no centro de administração do Microsoft 365. Vá para Migration Manager > Relatórios. Clique em Exportar e escolha CSV. Salve o arquivo em sua máquina local. Este CSV contém todos os itens verificados com seu status final. Se você executou vários trabalhos de migração, exporte cada trabalho separadamente ou use o filtro para selecionar um ID de trabalho específico.
2. Colete as reclamações dos usuários em uma lista estruturada
   Crie uma planilha com colunas: Nome do Usuário, Caminho do Arquivo Relatado, Problema Relatado, Data do Relato e Prioridade. Peça aos usuários que forneçam o caminho exato do arquivo em seu OneDrive ou local do SharePoint. Por exemplo, Documentos/Financeiro/Q4_Relatorio.xlsx. Se o usuário não lembrar o caminho, pesquise no log de auditoria do OneDrive do usuário por tentativas de acesso recentes a arquivos ausentes.
3. Carregue ambos os conjuntos de dados no Excel
   Abra o CSV exportado no Excel. Em uma nova planilha, cole a lista de reclamações dos usuários. Certifique-se de que a coluna de caminho do arquivo em ambas as planilhas use o mesmo formato. Se o log de migração mostrar caminhos relativos e os usuários fornecerem caminhos absolutos, crie uma coluna auxiliar que remova o prefixo da pasta raiz.
4. Corresponda entradas usando PROCV
   Na planilha de reclamações dos usuários, adicione uma nova coluna chamada Status do Log. Use a fórmula =PROCV(B2; MigrationLogs!A:A; 1; FALSO) onde B2 é o caminho do arquivo relatado pelo usuário e MigrationLogs!A:A é a coluna que contém os caminhos de origem da exportação. Se a fórmula retornar um caminho, o arquivo foi verificado. Se retornar #N/D, o arquivo nunca foi migrado ou o caminho é diferente.
5. Investigue entradas correspondentes para detalhes do erro
   Para cada arquivo correspondido, observe a coluna Status correspondente no log de migração. Se o status for Falha, copie o código de erro e a mensagem de erro para a planilha de reclamações dos usuários. Se o status for Sucesso mas o usuário ainda relatar um problema, o problema provavelmente está fora da ferramenta de migração — por exemplo, permissões não herdadas, conflitos de versão de arquivo ou lacunas de treinamento do usuário.
6. Use o PowerShell para obter logs por item para arquivos não correspondidos
   Abra o SharePoint Online Management Shell. Execute Get-SPOMigrationJobProgress -Identity "JobID" para ver todos os itens em um trabalho específico. Envie a saída para Where-Object {$_.SourceFile -like "nome_do_arquivo"} para encontrar um arquivo específico. Este método funciona quando o arquivo foi migrado mas a exportação CSV foi filtrada ou truncada.
7. Verifique os logs do Azure Storage para erros de rede ou tempo limite
   Navegue até seu contêiner do Azure Storage. Baixe o conteúdo da pasta migration-logs. Pesquise pelo nome do arquivo relatado pelo usuário usando qualquer editor de texto ou analisador de log. Erros de tempo limite de rede aparecem como System.Net.WebException: A operação atingiu o tempo limite. Eles geralmente afetam vários arquivos no mesmo lote e podem exigir a reexecução do agente de migração fora do horário de pico.

Padrões Comuns Quando Logs e Reclamações Não Coincidem

Usuário diz que arquivo está faltando, log indica sucesso

Esta é a incompatibilidade mais frequente. O arquivo foi copiado corretamente, mas o usuário está procurando na biblioteca ou pasta errada. Peça ao usuário para mostrar a URL exata que está navegando. Compare o caminho de destino no log de migração com a URL do usuário. Frequentemente o usuário espera um arquivo em Documentos Compartilhados mas o log mostra que foi colocado em uma subpasta chamada Documentos da Equipe. Use a visualização Conteúdo e Estrutura do site do SharePoint para mostrar todos os locais.

Usuário diz que as permissões estão erradas, log não mostra erro

As ferramentas de migração copiam arquivos, mas nem sempre copiam permissões exclusivas. Se a origem tinha permissões personalizadas, você deve migrá-las separadamente usando o SharePoint Migration Tool com o sinalizador -IncludeUserPermissions. Sem este sinalizador, o arquivo herda as permissões da biblioteca de destino. O log mostrará sucesso porque a cópia do arquivo em si não falhou. Verifique a reclamação do usuário em relação às configurações de permissão da biblioteca de destino em Configurações da Biblioteca > Permissões para esta biblioteca de documentos.

Usuário diz que o arquivo está corrompido, log não mostra erro

Um arquivo que parece corrompido após a migração pode ter sido corrompido antes da migração. As ferramentas de migração calculam uma soma de verificação (hash MD5) durante a cópia. Se a soma de verificação corresponder, o arquivo é idêntico bit a bit. Peça ao usuário para baixar o arquivo original da fonte (se ainda disponível) e compare o tamanho do arquivo e o hash. No PowerShell, execute Get-FileHash -Path "caminho_do_arquivo" -Algorithm MD5 em ambas as cópias. Se os hashes corresponderem, a corrupção existia antes da migração.

Usuário relata conflito de nome de arquivo, log mostra pulado

Quando dois arquivos com o mesmo nome existem na origem, a ferramenta de migração pula o duplicado por padrão. O log mostra Pulado com o código de erro NameConflict. Explique ao usuário que o segundo arquivo não foi copiado porque um arquivo com esse nome já existe no destino. O usuário deve renomear um dos arquivos e executar uma migração incremental para copiar o arquivo renomeado. Use o log para mostrar os caminhos exatos dos arquivos duplicados.

Campos do Log de Migração vs Campos da Reclamação do Usuário: Tabela de Mapeamento

Campo	Entrada do Log de Migração	Entrada da Reclamação do Usuário
Identificador do arquivo	SourcePath ou TargetPath	Caminho ou nome do arquivo fornecido pelo usuário
Status	Sucesso, Falha, Pulado	Ausente, corrompido, erro de permissão ou link quebrado
Código de erro	Código numérico ou string como 0x80070002	Não fornecido — deve ser inferido da descrição do usuário
Timestamp	Timestamp UTC da tentativa de migração	Data em que o usuário notou o problema pela primeira vez
Contexto do usuário	Identidade do agente de migração ou administrador do tenant	E-mail ou nome de exibição do usuário afetado

Conclusão

Agora você pode exportar logs de migração do Migration Manager, coletar reclamações de usuários em uma planilha estruturada e correspondê-las usando PROCV ou consultas do PowerShell. Quando uma correspondência mostra sucesso mas o usuário ainda relata um problema, verifique a herança de permissões, hashes de arquivo ou o caminho da biblioteca de destino. Para arquivos não correspondidos, use os logs do contêiner do Azure Storage para encontrar erros de tempo limite ou rede. Uma dica avançada é automatizar o processo de correspondência escrevendo um script do PowerShell que leia tanto o CSV exportado quanto um CSV de reclamações de usuários e produza um relatório de reconciliação com status e detalhes de erro para cada arquivo.