排查 Azure 文件同步问题

项目
06/04/2024

可以使用 Azure 文件同步将组织的文件共享集中到 Azure 文件中，同时保持本地文件服务器的灵活性、性能和兼容性。本文旨在帮助排查和解决 Azure 文件同步部署中可能遇到的问题。我们还介绍了如果需要对问题进行更深入的调查，如何从系统收集重要日志。

常见故障排除文档

根据遇到的问题，查看相应的故障排除文档：

问题	故障排除文档
代理安装或服务器注册问题	排查 Azure 文件同步代理安装和服务器注册问题
云终结点或服务器终结点创建问题，或已注册的服务器脱机	排查 Azure 文件同步同步组管理问题
服务器终结点出现错误状态，或文件无法同步	排查 Azure 文件同步同步运行状况和错误
文件无法分层或召回	排查 Azure 文件同步云分层问题
服务器上的内存使用率过高	排查 Azure 文件同步问题

如果不确定从何处开始，请参阅常规故障排除第一步。

常规故障排除的第一步

如果遇到 Azure 文件同步问题，请首先完成以下步骤：

使用 Azure 门户或服务器上的事件日志检查是否存在任何错误。有关如何使用 Azure 门户或事件日志查看 Azure 文件同步环境的运行状况的信息，请参阅监视 Azure 文件同步。
验证 Azure 文件同步服务是否在服务器上运行：
- 打开服务 MMC 管理单元并验证存储同步代理服务 (FileSyncSvc) 是否正在运行。
验证 azure 文件同步筛选器驱动程序 (StorageSync.sys 和 StorageSyncGuard.sys) 是否在服务器上运行：
- 在提升的命令提示符下，运行 fltmc。验证 是否列出了StorageSync.sys 和 StorageSyncGuard.sys 文件系统筛选器驱动程序。
使用服务器上的 Debug-StorageSyncServer cmdlet 检查常见问题。

Debug-StorageSyncServer cmdlet

该 Debug-StorageSyncServer cmdlet 将诊断 Azure 文件同步服务器上的常见问题，例如证书配置错误和服务器时间不正确。我们还通过将一些现有脚本和 cmdlet 的功能（ (AFSDiag.ps1、 FileSyncErrorsReport.ps1和 Test-StorageSyncNetworkConnectivity) 合并到 cmdlet 中） Debug-StorageSyncServer 简化了 Azure 文件同步故障排除。

若要在服务器上运行诊断，请运行以下 PowerShell 命令：

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

若要测试服务器上的网络连接，请运行以下 PowerShell 命令：

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

若要识别服务器上无法同步的文件，请运行以下 PowerShell 命令：

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

若要收集服务器上的日志和跟踪，请运行以下 PowerShell 命令：

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

如何在 Azure 文件同步服务器上收集日志和跟踪

如果在按照故障排除文档中的步骤操作后问题未得到解决，请运行 AFSDiag 工具，并将其 .zip 文件输出发送给分配给案例的支持工程师，以便进一步诊断。

若要运行 AFSDiag，请执行以下步骤：

打开提升的 PowerShell 窗口，然后在每个命令) 后 (按 Enter 运行以下命令：

注意

AFSDiag 将在收集日志之前创建输出目录和其中一个临时文件夹，并在执行后删除临时文件夹。指定不包含数据的输出位置。
```
Import-Module "C:\Program Files\Azure\StorageSyncAgent\StorageSync.Management.ServerCmdlets.dll"
Debug-StorageSyncServer -AFSDiag -OutputDirectory C:\output -KernelModeTraceLevel Verbose -UserModeTraceLevel Verbose
```
重现问题。完成后，输入 D。
包含日志和跟踪文件的 .zip 文件将保存到指定的输出目录。

服务器上的内存使用率过高

Azure 文件同步使用可扩展存储引擎 (ESE) 数据库进行同步和云分层。 ESE 数据库最多可占用 80% 的系统内存以提高性能。若要限制 ESE 数据库使用的内存量，可以在服务器上配置 MaxESEDbCachePercent 注册表设置。

若要将 ESE 内存使用限制降低到 60%，这是内存利用率与足够的缓存之间的良好平衡，以保持数据库的良好性能，请从提升的命令提示符运行以下命令：

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

MaxESEDbCachePercent创建注册表设置后，重启存储同步代理 (FileSyncSvc) 服务。

另请参阅

联系我们寻求帮助

如果你有任何疑问或需要帮助，请创建支持请求或联系 Azure 社区支持。还可以向 Azure 反馈社区提交产品反馈。

通过