A hálózati Azure Cosmos DB Emulator

A következőkre vonatkozik: SQL API CASSANDRA API Gremlin API Table API Azure Cosmos db API a MongoDB

Az Azure Cosmos DB Emulator helyi környezetet biztosít, amely az Azure Cosmos DB szolgáltatást emulálja a fejlesztéshez. Az ebben a cikkben olvasható tippek segítenek elhárítani a telepítéskor vagy a használat során felmerülő Azure Cosmos DB Emulator.

Ha az emulátor új verzióját telepítette, és hibákat tapasztal, állítsa vissza az adatokat. Az adatok visszaállításához kattintson a jobb gombbal a Azure Cosmos DB Emulator ikonjára a rendszertálcán, majd kattintson az Adatok alaphelyzetbe állítása... elemre. Ha ez nem oldja meg a hibákat, eltávolíthatja az emulátort és az emulátor régebbi verzióit, ha megtalálta, eltávolíthatja a C:\Program files\Azure Cosmos DB Emulator könyvtárat, és újratelepítheti az emulátort. Útmutatásért lásd: A helyi emulátor eltávolítása. Ha az adatok visszaállítása nem működik, lépjen a helyre, és törölje %LOCALAPPDATA%\CosmosDBEmulator a mappát.

Sérült Windows-teljesítményszámlálók hibaelhárítása

  • Ha a Azure Cosmos DB Emulator összeomlik, gyűjtse össze a memóriaképfájlokat a mappából, tömörítse őket, és nyisson meg egy %LOCALAPPDATA%\CrashDumps támogatási jegyet a Azure Portal.

  • Ha összeomlásokat tapasztal a -ban, ez olyan jelenség lehet, amikor a teljesítményszámlálók Microsoft.Azure.Cosmos.ComputeServiceStartupEntryPoint.exe sérült állapotban vannak. A következő parancs rendszergazdai parancssorból való futtatása általában megoldja a problémát:

    lodctr /R
    

Kapcsolati problémák hibaelhárítása

  • Ha kapcsolódási problémába ütközik, gyűjtsebe a nyomkövetési fájlokat, tömörítse őket, és nyisson meg egy támogatási jegyet a Azure Portal.

  • Ha A szolgáltatás nem érhető el üzenetet kap, előfordulhat, hogy az emulátor nem tudja elindítani a hálózati vermet. Ellenőrizze, hogy telepítve van-e a Pulse Secure ügyfél vagy a Juniper Networks ügyfél, mert ezek hálózatszűrő illesztőprogramjai okozhatják a problémát. A külső gyártótól származó hálózatszűrő illesztőprogramok eltávolítása általában kijavítja a problémát. Másik lehetőségként indítsa el az emulátort a /DisableRIO kapcsolóval, amely az emulátor hálózati kommunikációját normál Winsockra váltja.

  • Ha "Tiltott", "message": "A kérelem az átvitel protokollja vagy titkosítása során tiltott titkosítással lett elküldve. Ellenőrizze a fiók SSL/TLS minimálisan engedélyezett protokollbeállítását..." kapcsolati problémákat. Ezt az operációs rendszer globális változásai (például Insider Preview Build 20170) vagy a TLS 1.3 alapértelmezett használatát engedélyező böngészőbeállítások okozhatják. Hasonló hiba fordulhat elő, ha az SDK-val hajt végre kérést a Cosmos Emulatorhoz, példáulMicrosoft.Azure.Documents.DocumentClientException: A kérés tiltott titkosítással történik az átvitel protokollja vagy titkosítása során. Ellenőrizze a fiók SSL/TLS minimálisan engedélyezett protokollbeállítását. Jelenleg ez a várható működés, mert a Cosmos Emulator csak a TLS 1.2 protokollt fogadja el, és ezzel működik együtt. Az ajánlott módszer a beállítások módosítása, és az alapértelmezett beállítás a TLS 1.2; Például az IIS-kezelőben lépjen a "Helyek" -> "Alapértelmezett webhelyek" elemre, keresse meg a 8081-es porthoz a "Helykötések" helyét, és szerkessze őket a TLS 1.3 letiltásához. Hasonló művelet hajtható végre a webböngészőre vonatkozóan a „Beállítások” lehetőség használatával.

  • Amennyiben az emulátor futtatása közben a számítógép alvó állapotba lép vagy frissül az operációs rendszere, a Szolgáltatás jelenleg nem érhető el üzenet jelenik meg. Állítsa alaphelyzetbe az emulátor adatait. Kattintson a jobb gombbal a Windows értesítési tálcán megjelenő ikonra, és válassza az Adatok alaphelyzetbe állítása lehetőséget.

Profilelemzési fájlok gyűjtése

Hibakeresési nyomok begyűjtéséhez futtassa a következő parancsokat egy rendszergazdai parancssorból:

  1. Lépjen arra az elérési útra, ahová az emulátor telepítve van:

    cd /d "%ProgramFiles%\Azure Cosmos DB Emulator"
    
  2. Állítsa le az emulátort, és figyelje a rendszertálcát, hogy a program leállt-e. A folyamat egy percet is igénybe vehet. A felhasználói felületen a Kilépés Azure Cosmos DB Emulator is választhat.

    Microsoft.Azure.Cosmos.Emulator.exe /shutdown
    
  3. Kezdje meg a naplózást a következő paranccsal:

    Microsoft.Azure.Cosmos.Emulator.exe /startwprtraces
    
  4. Az emulátor elindítása

    Microsoft.Azure.Cosmos.Emulator.exe
    
  5. Hozza létre ismét a problémát. Ha az adatkezelő nem működik, csak néhány másodpercig kell várnia, amíg megnyílik a böngésző, hogy elfogja a hibát.

  6. Állítsa le a naplózást a következő paranccsal:

    Microsoft.Azure.Cosmos.Emulator.exe /stopwprtraces
    
  7. Lépjen az elérési útra, és %ProgramFiles%\Azure Cosmos DB Emulator keresse meg docdbemulator_000001.etl fájlt.

  8. Nyisson meg egy támogatási jegyet a Azure Portal, és foglalja bele az .etl fájlt a reprodukálás lépéseibe.

Következő lépések

Ebben a cikkben megtanulta, hogyan lehet hibakeresést végezni a helyi emulátoron. Továbbléphet a következő cikkekre: