Azure Filesでの ClientOtherErrors のトラブルシューティング

[アーティクル]
04/10/2024

この記事では、SMB Azure ファイル共有を使用するときに発生する可能性がある ClientOtherErrors の一覧を示します。一般に、ClientOtherErrors は主に無害で、予期されるエラーです。要求は失敗しますが、システムは引き続き期待どおりに動作します。これらのエラーが大量に記録されるのは通常です。

適用対象

ファイル共有の種類	SMB	Nfs
標準ファイル共有 (GPv2)、LRS/ZRS
標準ファイル共有 (GPv2)、GRS/GZRS
Premium ファイル共有 (FileStorage)、LRS/ZRS

ClientOtherErrors とは

ClientOtherError は通常、"見つかりません" や "リソースが既に存在する" など、クライアント側の予期されるエラーを意味します。サーバー側のストレージログファイルでは、これらの操作は ClientOtherErrors のトランザクション状態で記録されます。

たとえば、リモートファイルシステムと対話する Windows SMB クライアントは、リモートファイルシステムの機能を常に認識しているとは限りません。これは、Windows Server、Azure Files、またはその他の SMB サーバーの実装です。そのため、SMB クライアントは、特定の API を使用してリモートファイルサーバーを呼び出します。これらの API が失敗した場合は、別の API の使用にフォールバックするか、これらのエラーを無視します。 SMB の要求/応答プロトコルによっては、システムが正しく動作していても多数の要求が失敗することが予想されます。これは、承認エラー、既に存在する名前のファイルの作成、または存在しないファイルの開き方が原因である可能性があります。

ログ記録とレポート

ClientOtherErrors のトラブルシューティングを行うには、診断設定を作成し、レポートに Azure Monitor を使用します。また、ログを分析して、失敗した要求 (ClientOtherErrors など) を表示したり、Kusto クエリを使用したりすることもできます。

ログに表示される IP アドレスと一致するクライアントから ProcMon トレースを収集することもできます。 Azure Filesへのトラフィックのみを表示するフィルターを追加します。

Common ClientOtherErrors

次の表に、一般的な ClientOtherErrors と各エラーの説明を示します。

操作名	状態	エラーの説明
QueryFullEaInformation	STATUS_NOT_IMPLEMENTED	このエラーは、Azure Filesがこの API を実装していないために返されます。 Azure Filesでは、現在拡張属性はサポートされていません。
UnknownFileClass=48	STATUS_NOT_SUPPORTED	これは API 呼び出しです `FileNormalizedNameInformation` 。これは Windows Server の新しいサポートであり、現在Azure Filesはこの API をサポートしていません。
Fileopen	492 STATUS_ACCESS_DENIED	呼び出し元には、ファイルを開くために必要なアクセス許可がありません。 Kerberos アクセスの場合、ACL は呼び出し元のアクセスを拒否します。
Fileopen	257 STATUS_OBJECT_NAME_INVALID	開いている要求のパスが無効です (パスが長すぎる、深すぎるなど)。
Fileopen	12 STATUS_FILE_IS_ADIRECTORY	呼び出し元は、正しい `CreateFile` パラメーター (バックアップ意図など) を使用せずにディレクトリを開いています。
Fileopen	8 STATUS_SHARING_VIOLATION	呼び出し元は、既に制限付きで開かれているファイルを開いています (たとえば、排他的なファイルや、他のファイルは読み取り専用など)。
Fileopen	6 STATUS_OBJECT_NAME_NOT_FOUND	呼び出し元が、存在しないファイルを開いています。
FSCTL_QUERY_NETWORK_INTERFACE_INFO (IOCTL)	STATUS_INVALID_DEVICE_REQUEST	これは、お客様がマルチチャネル機能を有効にした場合のAzure Filesにのみ使用されます。それ以外の場合は不要であり、クライアントからクエリを実行すると無効なデバイス要求が返されます。
QueryStreamInformation	STATUS_NOT_IMPLEMENTED	一部のファイルシステムには、代替データストリームや、再解析ポイントストリームなどの他のストリームの概念があります。 Azure Filesにはこの概念がないため、API はサポートされていません。
予期しない (IOCTL)	STATUS_INVALID_DEVICE_REQUEST	これは、`FSCTL_QUERY_FILE_REGIONS`NTFS/refs に固有であり、Azure Filesに関連して意味をなさないリージョンの概念です。そのため、この FSCTL コードは実装しません。
ChangeNotify	STATUS_CANCELLED	Windows Shell などのアプリケーションでは、ファイルの変更通知をサブスクライブエクスプローラー。これにより、ファイルのプロパティが変更されると、Windows Shell エクスプローラービューで自動的に更新されます。クライアントは、このサブスクリプションを取り消すことができます (たとえば、ユーザーがエクスプローラーのビューを変更し、不要になった場合)。その場合は、サブスクリプションが取り消されたことを確認するためにクライアントに返送 `STATUS_CANCELLED` します。
FSCTL_DFS_GET_REFERRALS (IOCTL)	STATUS_FS_DRIVER_REQUIRED	これは DFS 紹介要求です。 Azure Filesは DFS をサポートしていません。これは、システムが DFS をサポートしていない場合に返される正しい状態です。
FileSupersede	STATUS_ACCESS_DENIED	ファイル置き換えは、既存のファイルが削除され、新しいファイルがその場所に配置される操作です。呼び出し元に既存のファイルを削除するアクセス許可がない場合、呼び出しは失敗します。
FileCreate	7 STATUS_OBJECT_NAME_INVALID	これは、新しいファイルの作成要求に無効な要求された名前 (サポートされていない文字の使用など) がある場合に発生します。
FileCreate	3 STATUS_OBJECT_NAME_COLLISION	これは、新しいファイルの作成要求に、既存のファイルと一致する要求された名前が含まれる場合に発生します。
読み取り	STATUS_ACCESS_DENIED	これは、読み取りアクセス権が付与されていないハンドルを持つファイルに対して読み取り要求が実行された場合に発生します (たとえば、ファイルは目的の書き込みアクセスで開かれました)。
TreeConnect	STATUS_ACCESS_DENIED	Kerberos 認証のコンテキストでは、呼び出し元には RBAC または "既定の共有アクセス許可" 機能を使用して割り当てられた共有レベルのアクセス許可がありません。 "既定の共有アクセス許可" 機能が設定されていない場合、コンピューター ID である呼び出し元は、共有でこのアクセスエラーを一貫して受け取ります。

お問い合わせはこちらから

質問がある場合やヘルプが必要な場合は、サポート要求を作成するか、Azure コミュニティサポートにお問い合わせください。 Azure フィードバックコミュニティに製品フィードバックを送信することもできます。