Behandeln häufiger Probleme in Azure DocumentDB

Dieses Handbuch ist darauf zugeschnitten, Sie bei der Behebung von Problemen zu unterstützen, die bei der Verwendung von Azure DocumentDB auftreten können. Der Leitfaden bietet Lösungen für Konnektivitätsprobleme, Fehlerszenarien und Optimierungsprobleme, die praktische Einblicke zur Verbesserung Ihrer Erfahrung bieten.

Häufige Fehler und Lösungen

Verbindung mit Azure DocumentDB nicht möglich – Timeoutfehler

Dieses Problem kann auftreten, wenn der Cluster nicht die richtigen Firewallregeln aktiviert hat. Wenn Sie versuchen, über einen Nicht-Azure-IP-Bereich auf den Cluster zuzugreifen, müssen Sie zusätzliche Firewallregeln hinzufügen. Ausführliche Schritte finden Sie unter "Sicherheitsoptionen und -features – Azure DocumentDB ". Firewallregeln können in der Netzwerkeinstellung des Portals für den Cluster konfiguriert werden. Zu den Optionen gehören das Hinzufügen einer bekannten IP-Adresse/eines bekannten Bereichs oder das Aktivieren des öffentlichen IP-Zugriffs.

Fehler beim Verbinden: Keine Verbindung möglich mit DNSClient.DnsResponseException.

Debuggen von Konnektivitätsproblemen:

Windows-Benutzer:
PsPing funktioniert nicht. Die Verwendung von nslookup bestätigt die Clusterreichbarkeit und Auffindbarkeit, was darauf hinweist, dass Netzwerkprobleme unwahrscheinlich sind.

Unix-Benutzer:
Bei Socket-/Netzwerk-bezogenen Ausnahmen könnten potenzielle Netzwerkverbindungsprobleme die Anwendung daran hindern, eine Verbindung zum Azure DocumentDB Mongo-API-Endpunkt herzustellen.

Führen Sie die folgenden Schritte aus, um die Konnektivität zu überprüfen:

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

Wenn eine TCP-Verbindung mit Port 10260 fehlschlägt, blockiert eine Umgebungsfirewall möglicherweise die Azure DocumentDB-Verbindung. Bitte scrollen Sie nach unten zum unteren Teil der Seite, um ein Supportticket zu übermitteln.

Überprüfen Sie Ihre Verbindungszeichenfolge:

Verwenden Sie nur die im Azure-Portal angegebene Verbindungszeichenfolge. Stellen Sie sicher, dass es das mongodb+srv://-Protokoll enthält, da dies für die ordnungsgemäße Konnektivität erforderlich ist. Vermeiden Sie die Verwendung von Variationen oder Präfixen wie „c“. Wenn Probleme mit der Konnektivität auftreten, geben Sie die Anwendungs- oder clientseitigen Treiberprotokolle für das Debuggen frei, indem Sie ein Supportticket übermitteln.

Fehlercodes

In dieser Tabelle sind Fehlercodes aufgeführt, die von Azure DocumentDB zurückgegeben werden, um Probleme zu identifizieren und zu beheben. Dies ist auch hilfreich für die Problembehandlung mithilfe von Diagnoseprotokollen.

Nächste Schritte

• Wenn Sie alle Schritte zur Problembehandlung befolgt haben und Ihr Problem dennoch nicht beheben können, können Sie eine Supportanfrage öffnen, um weitere Unterstützung zu erhalten.
• Informationen zur Problembehandlung bei der regionsübergreifenden Replikation finden Sie im Leitfaden zur Problembehandlung bei der regionsübergreifende Replikation.