Azure File Sync のトラブルシューティング
Azure File Sync を使用すると、オンプレミスのファイル サーバーの柔軟性、パフォーマンス、互換性を維持しながら、組織のファイル共有を Azure Files に一元化できます。 この記事は、Azure File Sync デプロイで発生する可能性のある問題のトラブルシューティングと解決に役立つよう設計されています。 また、問題のより深い調査が必要な場合に、システムから重要なログを収集する方法についても説明します。
一般的なトラブルシューティング ドキュメント
発生している問題に基づいて、適切なトラブルシューティング ドキュメントを確認してください。
問題 | トラブルシューティングに関するドキュメント |
---|---|
エージェントのインストールまたはサーバーの登録に関する問題 | Azure File Sync エージェントのインストールとサーバー登録のトラブルシューティング |
クラウド エンドポイントまたはサーバー エンドポイントの作成に関する問題、または登録済みサーバーがオフラインである | Azure File Sync 同期グループ管理のトラブルシューティング |
サーバー エンドポイントの状態がエラーであるか、ファイルが同期に失敗する | Azure File Sync 同期の正常性とエラーのトラブルシューティング |
ファイルの階層化または呼び出しに失敗する | Azure File Sync クラウドの階層化のトラブルシューティング |
サーバーでのメモリ使用量が多い | Azure File Sync のトラブルシューティング |
どこから始めればいいのか不明な場合は、「 一般的なトラブルシューティングの最初の手順」を参照してください。
一般的なトラブルシューティングの最初の手順
Azure File Sync で問題が発生している場合は、まず次の手順を実行します。
- Azure portal またはサーバー上のイベント ログを使用してエラーがないか確認します。 Azure portal またはイベント ログを使用して Azure File Sync 環境の正常性を表示する方法については、「 Azure File Sync の監視」を参照してください。
- サーバーで Azure File Sync サービスが実行されていることを確認します。
- Services MMC スナップインを開き、ストレージ同期エージェント サービス (FileSyncSvc) が実行されていることを確認します。
- Azure File Sync フィルター ドライバー (StorageSync.sys と StorageSyncGuard.sys) がサーバーで実行されていることを確認します。
- 管理者特権のコマンド プロンプトで を実行
fltmc
します。 StorageSync.sys と StorageSyncGuard.sys ファイル システム フィルター ドライバーが一覧表示されていることを確認します。
- 管理者特権のコマンド プロンプトで を実行
- サーバー上 の 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 を実行するには、次の手順を実行します。
管理者特権の 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 File Sync では、同期とクラウドの階層化に拡張可能ストレージ エンジン (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 フィードバック コミュニティに製品フィードバックを送信することもできます。
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示