Problemen oplossen bij het gebruik van de Azure Cosmos DB Emulator

VAN TOEPASSING OP: SQL-API Cassandra-API Gremlin-API Table-API Azure Cosmos DB-API voor MongoDB

De Azure Cosmos DB Emulator is een lokale omgeving waarin de Azure Cosmos DB-service wordt geëmuleerd voor ontwikkelingsdoeleinden. Gebruik de tips in dit artikel om problemen op te lossen die zich tijdens het installeren of gebruiken van de Azure Cosmos DB Emulator.

Als u een nieuwe versie van de emulator hebt geïnstalleerd en er fouten optreden, zorg dan dat u uw gegevens opnieuw instelt. U kunt uw gegevens opnieuw instellen door met de rechtermuisknop op het pictogram Azure Cosmos DB Emulator systeemvak te klikken en vervolgens op Gegevens opnieuw instellen... te klikken. Als de fouten hiermee niet worden opgelost, kunt u de emulator en eventuele oudere versies van de emulator verwijderen, indien gevonden, de map C:\Program files\Azure Cosmos DB Emulator verwijderen en de emulator opnieuw installeren. Zie De lokale emulator verwijderen voor instructies. Als het opnieuw instellen van de gegevens niet werkt, gaat u naar de %LOCALAPPDATA%\CosmosDBEmulator locatie en verwijdert u de map.

Problemen met beschadigde Windows-prestatiemeters oplossen

  • Als de Azure Cosmos DB Emulator vast loopt, verzamelt u de dumpbestanden uit de map, comprimeert u deze en opent u een ondersteuningsticket %LOCALAPPDATA%\CrashDumps vanuit de Azure Portal.

  • Als Microsoft.Azure.Cosmos.ComputeServiceStartupEntryPoint.exe vastloopt, kan dit een indicatie zijn dat de prestatiemeteritems beschadigd zijn. Dit probleem kunt u meestal oplossen door de volgende opdracht uit te voeren vanaf een opdrachtprompt met beheerdersrechten:

    lodctr /R
    

Verbindingsproblemen oplossen

  • Als er sprake is van een verbindingsprobleem, verzamelt u traceringsbestanden, comprimeert u de bestanden en opent u een ondersteuningsticket via de Azure-portal.

  • Als u het bericht Service niet beschikbaar krijgt, is het mogelijk dat de emulator de netwerkstack niet kan initialiseren. Controleer of de veilige Pulse-client of Juniper-netwerkclient is geïnstalleerd. De netwerkfilterstuurprogramma's van deze clients kunnen mogelijk de oorzaak zijn van het probleem. Doorgaans kan het probleem worden opgelost door stuurprogramma's voor netwerkfilters van derden te verwijderen. U kunt de emulator ook starten met/DisableRIO, waarmee de netwerkcommunicatie van de emulator wordt overgezet naar normale Winsock.

  • Als u 'Verboden', 'bericht':'Aanvraag wordt ingediend met een verboden versleuteling in transitprotocol of codering. Controleer de minimaal toegestane protocolinstelling voor account SSL/TLS... connectiviteitsproblemen. Dit kan worden veroorzaakt door algemene wijzigingen in het besturingssysteem (bijvoorbeeld Insider Preview Build 20170) of de browserinstellingen waarmee TLS 1.3 standaard is ingeschakeld. Er kan een vergelijkbare fout optreden wanneer u de SDK gebruikt om een aanvraag uit te voeren voor de Cosmos-emulator, zoalsMicrosoft.Azure.Documents.DocumentClientException: De aanvraag wordt ingediend met een niet-verboden versleuteling in transitprotocol of codering. Controleer de minimaal toegestane protocolinstelling voor account-SSL/TLS. Dit werkt op dit moment zoals verwacht, omdat de Cosmos Emulator alleen het TLS 1.2-protocol accepteert en gebruikt. De aanbevolen work-around is het wijzigen van de instellingen en de standaardinstelling in TLS 1.2; Navigeer bijvoorbeeld in IIS-manager naar Sites -> 'Standaardwebsites' en zoek de sitebindingen voor poort 8081 en bewerk deze om TLS 1.3 uit te schakelen. Een vergelijkbare bewerking kan worden uitgevoerd voor de webbrowser via de opties in Instellingen.

  • Als de emulator wordt uitgevoerd en uw computer naar de slaapstand gaat of er besturingssysteemupdates worden uitgevoerd, wordt mogelijk het bericht Service is momenteel niet beschikbaar weergegeven. Stel de gegevens van de emulator opnieuw in door met de rechtermuisknop op het pictogram te klikken dat wordt weergegeven in het Windows-systeemvak. Selecteer vervolgens Reset Data (Gegevens opnieuw instellen).

Traceringsbestanden verzamelen

Voor het verzamelen van foutopsporingsgegevens, voert u de volgende opdrachten uit vanaf een opdrachtprompt voor een beheerder:

  1. Navigeer naar het pad waar de emulator is geïnstalleerd:

    cd /d "%ProgramFiles%\Azure Cosmos DB Emulator"
    
  2. Sluit de emulator af en bekijk het systeemvak om te zien of het programma is afgesloten. Het kan een minuut duren om dit te voltooien. U kunt ook Afsluiten selecteren in Azure Cosmos DB Emulator gebruikersinterface.

    Microsoft.Azure.Cosmos.Emulator.exe /shutdown
    
  3. Start logboekregistratie met de volgende opdracht:

    Microsoft.Azure.Cosmos.Emulator.exe /startwprtraces
    
  4. De emulator starten

    Microsoft.Azure.Cosmos.Emulator.exe
    
  5. Reproduceer het probleem. Als de Data Explorer niet werkt, hoeft u slechts enkele seconden te wachten tot de browser is geopend om de fout te ondervangen.

  6. Stop logboekregistratie met de volgende opdracht:

    Microsoft.Azure.Cosmos.Emulator.exe /stopwprtraces
    
  7. %ProgramFiles%\Azure Cosmos DB EmulatorNavigeer naar het pad en zoek docdbemulator_000001.etl-bestand.

  8. Open een ondersteuningsticket via de Azure-portal en stuur het ETL-bestand mee, evenals de stappen om het probleem te reproduceren.

Volgende stappen

In dit artikel hebt u geleerd hoe u problemen met de lokale emulator kunt oplossen. U kunt nu doorgaan met de volgende artikelen: