Solucionar problemas da Sincronização de Arquivos do Azure

Você pode usar a Sincronização de Arquivos do Azure para centralizar os compartilhamentos de arquivos da sua organização no serviço Arquivos do Azure sem abrir mão da flexibilidade, do desempenho e da compatibilidade de um servidor de arquivos local. Este artigo foi projetado para ajudá-lo a solucionar problemas e resolver problemas encontrados com a implantação da Sincronização de arquivos do Azure. Nós também descrevemos como coletar logs importantes do sistema para ajudar em uma investigação mais profunda dos problemas.

Documentação comum de solução de problemas

Com base no problema que você está enfrentando, examine a documentação de solução de problemas apropriada:

Problemas	Documentação de solução de problemas
Problemas de instalação do agente ou registro do servidor	Solucionar problemas na instalação do agente e no registro do servidor da Sincronização de Arquivos do Azure
Problemas de criação de endpoint de nuvem ou endpoint de servidor ou o servidor registrado está offline	Solução de problemas do Gerenciamento de Grupos de Sincronização da Sincronização de Arquivos do Azure
O endpoint do servidor tem um status de erro ou os arquivos não são sincronizados	Solucionar problemas de integridade e erros de sincronização da Sincronização de Arquivos do Azure
Os arquivos não conseguem classificar ou recuperar	Solucionar de problemas de camada de nuvem da Sincronização de Arquivos do Azure
O serviço do Agente de Sincronização de Armazenamento (FileSyncSvc) falha ao iniciar	Solucionar problemas da Sincronização de Arquivos do Azure
Alto uso de memória no servidor	Solucionar problemas da Sincronização de Arquivos do Azure

Se você não souber por onde começar, consulte Primeiras etapas gerais de solução de problemas.

Dica

Você pode usar o Microsoft Copilot no Azure para ajudar a diagnosticar e corrigir seu ambiente de Sincronização de Arquivos do Azure. Para obter mais informações, consulte Gerenciar e solucionar problemas de contas de armazenamento usando o Microsoft Copilot no Azure.

Primeiras etapas da solução de problemas gerais

Se você estiver enfrentando problemas com a Sincronização de Arquivos do Azure, comece concluindo as seguintes etapas:

1. Verifique se há erros usando o portal do Azure ou os logs de eventos no servidor. Para obter informações sobre como exibir a integridade do ambiente de Sincronização de Arquivos do Azure usando o portal do Azure ou os logs de eventos, consulte Monitorar a Sincronização de Arquivos do Azure.
2. Verifique se o serviço de Sincronização de Arquivos do Azure está em execução no servidor:
   • Abra o snap-in MMC de serviços e verifique se que o serviço de agente de sincronização de armazenamento (FileSyncSvc) está em execução. Se o serviço não estiver em execução e não for iniciado, consulte Falha ao iniciar o serviço do Agente de Sincronização de Armazenamento (FileSyncSvc).
3. Verifique se os drivers de filtro da Sincronização de Arquivos do Azure (StorageSync.sys e StorageSyncGuard.sys) estão em execução no servidor:
   • Em um prompt de comandos com privilégios elevados, digite fltmc. Verifique se os drivers de filtro do sistema de arquivos StorageSync.sys e StorageSyncGuard.sys estão listados.
4. Use o cmdlet Debug-StorageSyncServer no servidor para verificar se há problemas comuns.

Cmdlet Debug-StorageSyncServer

O Debug-StorageSyncServer cmdlet diagnosticará problemas comuns no servidor de Sincronização de Arquivos do Azure, como configuração incorreta de certificado e hora incorreta do servidor. Também simplificamos a solução de problemas da Sincronização de Arquivos do Azure mesclando a funcionalidade de alguns scripts e cmdlets existentes (AFSDiag.ps1, FileSyncErrorsReport.ps1 e Test-StorageSyncNetworkConnectivity) no Debug-StorageSyncServer cmdlet.

Para executar o diagnóstico no servidor, execute os seguintes comandos do PowerShell:

Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Debug-StorageSyncServer -Diagnose

Para testar a conectividade de rede no servidor, execute os seguintes comandos do PowerShell:

Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Debug-StorageSyncServer -TestNetworkConnectivity

Para identificar arquivos que não são sincronizados no servidor, execute os seguintes comandos do PowerShell:

Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Debug-StorageSyncServer -FileSyncErrorsReport

Para coletar logs e rastreamentos no servidor, execute os seguintes comandos do PowerShell:

Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Debug-StorageSyncServer -AFSDiag -OutputDirectory C:\output -KernelModeTraceLevel Verbose -UserModeTraceLevel Verbose

Como coletar logs e rastreamentos no servidor de Sincronização de Arquivos do Azure

Se o problema não for resolvido depois de seguir as etapas na documentação de solução de problemas, execute a ferramenta AFSDiag e envie a saída do arquivo .zip para o engenheiro de suporte atribuído ao seu caso para um diagnóstico mais aprofundado.

Para executar o AFSDiag, realize as etapas abaixo:

1. Abra uma janela do PowerShell com privilégios elevados e execute os seguintes comandos (pressione Enter após cada comando):

   Observação

   O AFSDiag criará o diretório de saída e uma pasta temporária dentro dele antes de coletar logs e excluirá a pasta temporária após a execução. Especifique um local de saída que não contenha dados.

   Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
   Debug-StorageSyncServer -AFSDiag -OutputDirectory C:\output -KernelModeTraceLevel Verbose -UserModeTraceLevel Verbose
   

2. Reproduza o problema. Quando terminar, digite D.

3. Um arquivo. zip que contém logs e arquivos de rastreamento é salvo no diretório de saída que você especificou.

O serviço do Agente de Sincronização de Armazenamento (FileSyncSvc) falha ao iniciar

Depois de instalar ou atualizar o agente de Sincronização de Arquivos do Azure (v18 ou posterior), você poderá experimentar um dos seguintes sintomas:

• O serviço do Agente de Sincronização de Armazenamento (FileSyncSvc) falha ao iniciar com o seguinte erro:

  Error 0x80070057: The parameter is incorrect. 
  

• O registro de um servidor usando o Register-AzStorageSyncServer cmdlet falha com o seguinte erro:

  Register-AzStorageSyncServer: Exception of type 'Commands.StorageSync.Interop.Exceptions.ServerRegistrationException' was thrown.
  

• ServerRegistration.exe ou AfsUpdater.exe não abre

• A instalação do agente falha. O log de instalação mostra o código de erro 0x80c84111 com a seguinte mensagem:

  Exception occurred while configuring MitigationRedirection policy. This could indicate that required windows updates not installed on the computer.
  

Esses problemas ocorrem porque o agente de Sincronização de Arquivos do Azure tem uma dependência em um recurso de segurança do Windows e as atualizações para esse recurso de segurança não estão instaladas.

Para resolver esse problema, verifique se o Windows Server tem as seguintes atualizações instaladas:

• Catálogo do Microsoft Update do Windows Server 2016 (atualização cumulativa mais recente)

• Catálogo do Microsoft Update do Windows Server 2019 (atualização cumulativa mais recente)

  As atualizações cumulativas são lançadas mensalmente. Para implantar a atualização mais recente, você pode usar o Windows Update ou baixá-la no Catálogo do Microsoft Update. Antes da instalação manual, examine o artigo da Base de Dados de Conhecimento (KB) associada para garantir que todos os pré-requisitos sejam atendidos.Se as atualizações do Windows não estiverem instaladas antes de instalar o agente de Sincronização de Arquivos do Azure, o serviço Agente de Sincronização de Armazenamento (FileSyncSvc) não será iniciado.

A Atualização Automática não pode atualizar um agente do Azure File Sync prestes a expirar ou expirado.

Se a Atualização Automática falhar ao atualizar seu agente de Sincronização de Arquivos do Azure que está prestes a expirar ou expirou, verifique se as informações de expiração do agente são aplicadas corretamente ao servidor. Os metadados de expiração são necessários para que a Atualização Automática funcione conforme o esperado.

Para verificar se os AgentExpirationDate metadados estão definidos, execute o seguinte comando em uma sessão do PowerShell com privilégios elevados:

Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Get-StorageSyncServer

Se os AgentExpirationDate metadados não estiverem definidos ou seu valor estiver vazio, poderá haver um problema de rede que impeça o servidor de receber os dados de expiração. Para testar a conectividade de rede, execute o seguinte comando:

Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Test-StorageSyncNetworkConnectivity

Se problemas de conectividade de rede forem relatados, você poderá atualizar manualmente o agente baixando-o do Catálogo do Microsoft Update.

Depois de baixar a versão apropriada do agente, consulte o artigo específico do KB no catálogo para obter instruções de instalação passo a passo.

Se não houver problemas de conectividade e os AgentExpirationDate metadados ainda não estiverem definidos, entre em contato com o suporte da Sincronização de Arquivos do Azure para obter mais assistência.

Alto uso de memória no servidor

A Sincronização de Arquivos do Azure usa bancos de dados ESE (Mecanismo de Armazenamento Extensível) para sincronização e camadas de nuvem. Os bancos de dados ESE podem consumir até 80% da memória do sistema para melhorar o desempenho. Para limitar a quantidade de memória usada pelos bancos de dados ESE, você pode definir a configuração do MaxESEDbCachePercent Registro no servidor.

Para reduzir o limite de uso de memória do ESE para 60%, que é um bom equilíbrio entre a utilização de memória e cache suficiente para manter um desempenho decente dos bancos de dados, execute o seguinte comando em um prompt de comando com privilégios elevados:

REG ADD HKLM\Software\Microsoft\Azure\StorageSync /v MaxESEDbCachePercent /t REG_DWORD /d 60

Depois que a configuração do MaxESEDbCachePercent Registro for criada, reinicie o serviço Agente de Sincronização de Armazenamento (FileSyncSvc).

Confira também

• Monitorar a Sincronização de Arquivos do Azure
• Solucionar problemas dos Arquivos do Azure
• Solução de problemas de desempenho dos Arquivos do Azure

Entre em contato conosco para obter ajuda

Se você tiver dúvidas ou precisar de ajuda, crie uma solicitação de suporte ou peça ajuda à comunidade de suporte do Azure. Você também pode enviar comentários sobre o produto para a comunidade de comentários do Azure.