Solucionar problemas comuns no Azure DocumentDB

Este guia é personalizado para ajudá-lo a resolver problemas que você pode encontrar ao usar o Azure DocumentDB. O guia fornece soluções para problemas de conectividade, cenários de erro e desafios de otimização, oferecendo insights práticos para melhorar sua experiência.

Erros e soluções comuns

Não é possível conectar-se ao Azure DocumentDB – Erro de tempo limite

Esse problema pode ocorrer quando o cluster não tem as regras de firewall corretas habilitadas. Se você estiver tentando acessar o cluster de um intervalo de IP não Azure, precisará adicionar regras de firewall extras. Consulte as opções e recursos de segurança – Azure DocumentDB para obter etapas detalhadas. As regras de firewall podem ser configuradas na configuração de Rede do portal para o cluster. As opções incluem adicionar um endereço IP/intervalo conhecido ou habilitar o acesso ip público.

Não é possível conectar devido ao erro DNSClient.DnsResponseException

Solução de problemas de conectividade:

Usuário do Windows:
PsPing não funciona. O uso do nslookup confirma a acessibilidade e a descoberta do cluster, indicando que problemas de rede são improváveis.

Usuários do Unix:
Para exceções relacionadas a soquetes/redes, possíveis problemas de conectividade de rede podem estar impedindo o aplicativo de estabelecer uma conexão com o ponto de extremidade da API Mongo do Azure DocumentDB.

Para verificar a conectividade, siga estas etapas:

nc -v <accountName>.mongocluster.cosmos.azure.com 10260

Se a conexão TCP à porta 10260 falhar, um firewall de ambiente poderá estar bloqueando a conexão do Azure DocumentDB. Role para baixo até a parte inferior da página para abrir um ticket de suporte.

Verifique sua cadeia de conexão:

Use apenas a cadeia de conexão fornecida no portal do Azure. Verifique se ele inclui o protocolo mongodb+srv://, pois isso é necessário para conectividade adequada. Evite usar quaisquer variações ou prefixos como c. Se você encontrar problemas de conectividade, compartilhe os logs do aplicativo ou do driver do lado do cliente para depuração enviando um tíquete de suporte.

Códigos de erro

Esta tabela lista os códigos de erro retornados pelo Azure DocumentDB para ajudar a identificar e resolver problemas. Eles também são úteis para solucionar problemas usando logs de diagnóstico.

Próximas etapas

• Se você seguiu todas as etapas de solução de problemas e ainda não conseguiu resolver o problema, abra uma solicitação de suporte para obter mais assistência.
• Se você estiver solucionando problemas de replicação entre regiões, consulte o guia de solução de problemas para replicação entre regiões.