Rozwiązywanie typowych problemów w usłudze Azure DocumentDB

Ten przewodnik jest dostosowany do ułatwienia rozwiązywania problemów, które mogą wystąpić podczas korzystania z usługi Azure DocumentDB. Przewodnik zawiera rozwiązania problemów z łącznością, scenariuszy błędów i wyzwań związanych z optymalizacją, oferując praktyczne szczegółowe informacje w celu ulepszenia środowiska użytkownika.

Typowe błędy i rozwiązania

Nie można nawiązać połączenia z usługą Azure DocumentDB — błąd przekroczenia limitu czasu

Ten problem może wystąpić, gdy klaster nie ma włączonych prawidłowych reguł zapory. Jeśli próbujesz uzyskać dostęp do klastra z zakresu adresów IP spoza platformy Azure, musisz dodać dodatkowe reguły zapory. Aby uzyskać szczegółowe instrukcje , zobacz Opcje i funkcje zabezpieczeń — Azure DocumentDB . Reguły zapory można skonfigurować w ustawieniach Sieci portalu dla klastra. Opcje obejmują dodawanie znanego adresu IP/zakresu lub włączanie dostępu do publicznego adresu IP.

Nie można nawiązać połączenia z powodu błędu DNSClient.DnsResponseException.

Debugowanie problemów z łącznością:

Użytkownik systemu Windows:
PsPing nie działa. Użycie polecenia nslookup potwierdza osiągalność klastra i możliwość odnajdywania, co wskazuje, że problemy z siecią są mało prawdopodobne.

Użytkownicy systemu Unix:
W przypadku wyjątków związanych z gniazdami/sieci potencjalne problemy z łącznością sieciową mogą utrudniać aplikacji nawiązywanie połączenia z punktem końcowym interfejsu API Mongo usługi Azure DocumentDB.

Aby sprawdzić łączność, wykonaj następujące kroki:

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

Jeśli połączenie TCP z portem 10260 zakończy się niepowodzeniem, zapora środowiska może blokować połączenie usługi Azure DocumentDB. Przewiń stronę do dołu, aby przesłać zgłoszenie do pomocy technicznej.

Sprawdź parametry połączenia:

Użyj tylko parametrów połączenia podanych w witrynie Azure Portal. Upewnij się, że zawiera on protokół mongodb+srv://, ponieważ jest to wymagane do prawidłowej łączności. Unikaj używania wszelkich odmian lub prefiksów, takich jak c. Jeśli wystąpią problemy z łącznością, udostępnij dzienniki sterowników po stronie klienta lub aplikacji na potrzeby debugowania, przesyłając bilet pomocy technicznej.

Kody błędów

W tej tabeli wymieniono kody błędów zwracane przez usługę Azure DocumentDB, aby ułatwić identyfikowanie i rozwiązywanie problemów. Są one również przydatne do rozwiązywania problemów z używaniem dzienników diagnostycznych.

Dalsze kroki

• Jeśli wykonano wszystkie kroki rozwiązywania problemów i nadal nie można rozwiązać problemu , możesz otworzyć wniosek o pomoc techniczną w celu uzyskania dalszej pomocy.
• Jeśli rozwiązujesz problemy z replikacją między regionami, zobacz Przewodnik rozwiązywania problemów z replikacją między regionami.