Azure File Sync のトラブルシューティング

  • [アーティクル]

Azure File Sync を使用すると、オンプレミスのファイル サーバーの柔軟性、パフォーマンス、互換性を維持したまま Azure Files で組織のファイル共有を一元化できます。 この記事は、Azure File Sync のデプロイで発生する可能性がある問題のトラブルシューティングと解決を支援することを目的としています。 問題をさらに調査する必要がある場合に、システムから重要なログを収集する方法についても説明します。

一般的なトラブルシューティングに関するドキュメント

発生している問題に基づいて、適切なトラブルシューティングドキュメントを確認してください。

問題 トラブルシューティングのドキュメント
エージェントのインストールまたはサーバーの登録に関する問題 Azure File Sync エージェントのインストールとサーバー登録のトラブルシューティング
クラウド エンドポイントまたはサーバー エンドポイントの作成に関する問題、または登録済みサーバーがオフラインである Azure File Sync 同期グループの管理に関するトラブルシューティング
サーバー エンドポイントにエラー状態がある、またはファイルの同期に失敗する Azure File Sync 同期の正常性とエラーのトラブルシューティング
ファイルの階層化または呼び戻しに失敗する Azure File Sync のクラウドを使った階層化に関するトラブルシューティング
ストレージ同期エージェント サービス (FileSyncSvc) の開始に失敗する Azure File Sync のトラブルシューティング
サーバーでのメモリ使用率が高い Azure File Sync のトラブルシューティング

どこから開始すればよいかわからない場合は、 General のトラブルシューティングの最初の手順を参照してください。

一般的なトラブルシューティングの最初の手順

Azure File Sync で問題が発生している場合は、まず次の手順を実行します。

  1. Azure portal またはサーバー上のイベント ログを使用してエラーがないか確認します。 Azure Portal またはイベント ログを使用して Azure File Sync 環境の正常性を表示する方法については、「 Monitor Azure File Sync」を参照してください。
  2. Azure File Sync サービスがサーバーで実行されていることを確認します。
  3. Azure File Sync フィルター ドライバー (StorageSync.sys と StorageSyncGuard.sys) がサーバー上で実行されていることを確認します。
    • 管理者特権でのコマンド プロンプトで、fltmc を実行します。 StorageSync.sysとStorageSyncGuard.sysファイル システム フィルター ドライバーが一覧表示されていることを確認します。
  4. サーバー上の Debug-StorageSyncServer コマンドレット を使用して、一般的な問題を確認します。

Debug-StorageSyncServer コマンドレット

Debug-StorageSyncServer コマンドレットは、証明書の構成ミスやサーバー時刻の間違いなど、Azure File Sync サーバーに関する一般的な問題を診断します。 また、いくつかの既存のスクリプトとコマンドレット (AFSDiag.ps1、 FileSyncErrorsReport.ps1、および Test-StorageSyncNetworkConnectivity) の機能を Debug-StorageSyncServer コマンドレットにマージすることで、Azure File Sync のトラブルシューティングも簡略化しました。

サーバーで診断を実行するには、次の 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 File Sync サーバーでログとトレースを収集する方法

トラブルシューティング ドキュメントの手順に従っても問題が解決しない場合は、AFSDiag ツールを実行し、その.zipファイルの出力をケースに割り当てられたサポート エンジニアに送信して、さらに診断します。

AFSDiag を実行するには、次の手順を実行します。

  1. 管理者特権の PowerShell ウィンドウを開き、次のコマンドを実行します (各コマンドの後 Enter キーを押 )。

    Note

    AFSDiag はログを収集する前に、出力ディレクトリとその中の一時フォルダーを作成し、実行後に一時フォルダーを削除します。 データが含まれていない出力場所を指定してください。

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

  2. 問題を再現します。 完了したら、「 D」と入力します。

  3. ログファイルとトレース ファイルを含む .zip ファイルが、指定した出力ディレクトリに保存されます。

ストレージ同期エージェント サービス (FileSyncSvc) の開始に失敗する

Azure File Sync エージェント (v17.3 以降) をインストールまたはアップグレードすると、次のいずれかの現象が発生する可能性があります。

  • ストレージ同期エージェント サービス (FileSyncSvc) は、次のエラーで開始できません。

    Error 0x80070057: The parameter is incorrect.

  • Register-AzStorageSyncServer コマンドレットを使用してサーバーを登録すると、次のエラーで失敗します。

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

  • ServerRegistration.exeまたはAfsUpdater.exeが開かない

この問題は、Azure File Sync エージェントが Windows セキュリティ機能に依存しており、このセキュリティ機能の更新プログラムがインストールされていないために発生します。

この問題を解決するには、Windows Server に次の更新プログラムがインストールされていることを確認します。

サーバーでのメモリ使用率が高い

Azure File Sync では、同期とクラウドの階層化に Extensible Storage Engine (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 フィードバック コミュニティに製品フィードバックを送信することもできます。