Compartilhar via

Solucionar problemas da Sincronização de Arquivos do Azure

  • Artigo

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.

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 (v17.3 ou posterior), você pode enfrentar 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 cmdlet Register-AzStorageSyncServer 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

Esse problema ocorre porque o agente de Sincronização de Arquivos do Azure tem uma dependência de 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:

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

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.