Solucionar problemas de ClientOtherErrors no Arquivos do Azure

  • Artigo

Este artigo lista os ClientOtherErrors que você pode encontrar ao usar compartilhamentos de arquivos do SMB Azure. Em geral, ClientOtherErrors são erros inofensivos e esperados. As solicitações falham, mas o sistema continua a se comportar conforme o esperado. É normal ver uma quantidade significativa desses erros registrados.

Aplicável a

Tipo de compartilhamento de arquivo SMB NFS
Compartilhamentos de arquivo padrão (GPv2), LRS/ZRS
Compartilhamentos de arquivo padrão (GPv2), GRS/GZRS
Compartilhamentos de arquivo Premium (FileStorage), LRS/ZRS

O que são ClientOtherErrors?

ClientOtherError geralmente significa erros esperados do lado do cliente, como "não encontrado" e "recurso já existe". Nos arquivos de log de armazenamento do lado do servidor, essas operações são registradas com uma status de transação de ClientOtherErrors.

Por exemplo, o cliente SMB do Windows que interage com sistemas de arquivos remotos nem sempre sabe os recursos do sistema de arquivos remotos. Pode ser o Windows Server, Arquivos do Azure ou alguma outra implementação do servidor SMB. Portanto, o cliente SMB fará chamadas para o servidor de arquivos remoto com determinadas APIs. Se essas APIs falharem, ela voltará a usar uma API diferente ou até mesmo ignorará esses erros. Dependendo do protocolo de solicitação/resposta do SMB, espera-se que um grande número de solicitações falhe mesmo que o sistema tenha se comportado corretamente. Isso pode ser devido a falhas de autorização, tentativas de criar um arquivo com um nome que já existe ou tentativas de abrir um arquivo que não existe.

Registro em log e relatórios

Para solucionar problemas de ClientOtherErrors, você pode criar uma configuração de diagnóstico e usar o Azure Monitor para relatórios. Você também pode analisar logs para exibir solicitações com falha, incluindo ClientOtherErrors ou usar consultas Kusto.

Você também pode coletar um rastreamento ProcMon de um cliente que corresponda ao endereço IP mostrado nos logs. Adicione um filtro para ver apenas o tráfego para Arquivos do Azure.

Common ClientOtherErrors

A tabela a seguir lista ClientOtherErrors comuns, juntamente com uma explicação de cada erro.

Operação Status Explicação do erro
QueryFullEaInformation STATUS_NOT_IMPLEMENTED Essa falha é retornada porque Arquivos do Azure não implementa essa API. Arquivos do Azure não dá suporte a atributos estendidos no momento.
UnknownFileClass=48 STATUS_NOT_SUPPORTED Essa é a chamada de FileNormalizedNameInformation API. Esse é um novo suporte para o Windows Server e atualmente Arquivos do Azure não dá suporte a essa API.
Fileopen 492 STATUS_ACCESS_DENIED O chamador não tem as permissões necessárias para abrir o arquivo. No caso do acesso kerberos, a ACL nega o acesso ao chamador.
Fileopen 257 STATUS_OBJECT_NAME_INVALID O caminho para a solicitação aberta é inválido (por exemplo, o caminho é muito longo ou muito profundo).
Fileopen 12 STATUS_FILE_IS_ADIRECTORY O chamador está abrindo um diretório sem usar os parâmetros corretos CreateFile (por exemplo, intenção de backup).
Fileopen 8 STATUS_SHARING_VIOLATION O chamador está abrindo um arquivo que já está aberto com restrições (por exemplo, exclusivos ou outros só podem ler).
Fileopen 6 STATUS_OBJECT_NAME_NOT_FOUND O chamador está abrindo um arquivo que não existe.
FSCTL_QUERY_NETWORK_INTERFACE_INFO (IOCTL) STATUS_INVALID_DEVICE_REQUEST Isso é usado apenas para Arquivos do Azure quando os clientes habilitaram o recurso multicanal. Em outros casos, não é necessário e retornamos uma solicitação de dispositivo inválida quando consultados do cliente.
QueryStreamInformation STATUS_NOT_IMPLEMENTED Alguns sistemas de arquivos têm o conceito de fluxos de dados alternativos ou outros fluxos, como o fluxo de pontos de reparse. Arquivos do Azure não tem esse conceito, portanto, não damos suporte à API.
Inesperado (IOCTL) STATUS_INVALID_DEVICE_REQUEST Este é FSCTL_QUERY_FILE_REGIONS, um conceito de região específico para NTFS/refs e não faz sentido em relação a Arquivos do Azure. Portanto, não implementamos esse código FSCTL.
ChangeNotify STATUS_CANCELLED Aplicativos como o Windows Shell Explorer assinar notificações de alteração para arquivos. Dessa forma, quando as propriedades são alteradas em um arquivo, o Windows Shell Explorer é atualizado automaticamente no modo de exibição. O cliente pode optar por cancelar essa assinatura (por exemplo, se o usuário tiver visualizações alteradas no Explorer e não precisar mais dela). Nesse caso, enviamos de STATUS_CANCELLED volta ao cliente para reconhecer que a assinatura foi cancelada.
FSCTL_DFS_GET_REFERRALS (IOCTL) STATUS_FS_DRIVER_REQUIRED Essa é uma solicitação de indicação do DFS. Arquivos do Azure não dá suporte ao DFS, e essa é a status correta para retornar quando o sistema não dá suporte ao DFS.
FileSupersede STATUS_ACCESS_DENIED A substituição de arquivo é uma operação em que um arquivo existente é excluído e um novo arquivo é colocado em seu lugar. Se o chamador não tiver permissão para excluir o arquivo existente, a chamada falhará.
FileCreate 7 STATUS_OBJECT_NAME_INVALID Isso acontece quando uma solicitação para criar um novo arquivo tem um nome solicitado inválido (por exemplo, usando caracteres sem suporte).
FileCreate 3 STATUS_OBJECT_NAME_COLLISION Isso acontece quando uma solicitação para criar um novo arquivo tem um nome solicitado que corresponda a um arquivo existente.
Leitura STATUS_ACCESS_DENIED Isso acontece quando uma solicitação de leitura é feita em um arquivo com um identificador que não tem o acesso concedido de leitura (por exemplo, o arquivo foi aberto com o acesso de gravação desejado).
TreeConnect STATUS_ACCESS_DENIED No contexto da autenticação Kerberos, o chamador não tem permissões de nível de compartilhamento atribuídas por meio do RBAC ou do recurso "Permissões de Compartilhamento Padrão". Se o recurso "Permissões de Compartilhamento Padrão" não estiver definido, os chamadores que são identidades de computador receberão consistentemente essa falha de acesso no compartilhamento.

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.