Memecahkan masalah saat menggunakan Emulator Azure Cosmos DB

BERLAKU UNTUK: Nosql MongoDB Cassandra Gremlin Meja

Emulator Azure Cosmos DB menyediakan lingkungan lokal yang meniru layanan Azure Cosmos DB untuk tujuan pengembangan. Gunakan tips dalam artikel ini untuk membantu memecahkan masalah yang Anda temui saat memasang atau menggunakan Emulator Azure Cosmos DB.

Jika Anda memasang emulator versi baru dan mengalami kesalahan konektivitas, pastikan Anda mengatur ulang data. Anda dapat mengatur ulang data dengan mengeklik kanan ikon Emulator Azure Cosmos DB pada baki sistem, lalu mengeklik Atur Ulang Data…. Jika langkah tersebut tidak memperbaiki kesalahan, Anda dapat menghapus emulator dan versi emulator yang lebih lama jika ditemukan, hapus direktori C:\Program files\Azure Cosmos DB Emulator dan pasang ulang emulator. Lihat Menghapus emulator lokal untuk mendapatkan instruksi. Atau jika mengatur ulang data tidak berfungsi, navigasi ke %LOCALAPPDATA%\CosmosDBEmulatorlokasi dan hapus folder.

Memecahkan masalah penghitung kinerja jendela yang rusak

  • Jika Emulator Azure Cosmos DB mengalami crash, kumpulkan file dump dari %LOCALAPPDATA%\CrashDumps folder, kompres, dan buka tiket dukungan dari portal Microsoft Azure.

  • Jika Anda mengalami crash di Microsoft.Azure.Cosmos.ComputeServiceStartupEntryPoint.exe, ini mungkin gejala saat Penghitung Kinerja berada dalam keadaan rusak. Biasanya menjalankan perintah berikut dari perintah admin memperbaiki masalah:

    lodctr /R
    

Memecahkan masalah konektivitas

  • Jika Anda mengalami masalah konektivitas, kumpulkan file pelacakan,kompres, dan buka tiket dukungan di portal Microsoft Azure.

  • Jika Anda menerima pesan Layanan Tidak Tersedia, emulator mungkin gagal menginisialisasi tumpukan jaringan. Periksa apakah Anda memiliki klien aman Pulse atau klien jaringan Juniper yang terpasang, karena driver filter jaringan mereka dapat menyebabkan masalah. Menghapus driver filter jaringan pihak ketiga biasanya dapat memperbaiki masalah. Atau, mulai emulator dengan /DisableRIO, yang akan mengalihkan komunikasi jaringan emulator ke Winsock reguler.

  • Jika Anda menemukan "Forbidden","message":"Permintaan sedang dibuat dengan enkripsi terlarang dalam protokol transit atau sandi. Periksa pengaturan protokol minimum SSL/TLS yang diizinkan..." masalah konektivitas, ini mungkin disebabkan oleh perubahan global di OS (misalnya, Insider Preview Build 20170) atau pengaturan browser yang memungkinkan TLS 1.3 sebagai default. Kesalahan serupa mungkin terjadi saat menggunakan SDK untuk menjalankan permintaan terhadap emulator Azure Cosmos DB, seperti Microsoft. Azure.Documents.DocumentClientException: Permintaan sedang dibuat dengan enkripsi terlarang dalam protokol transit atau cipher. Periksa pengaturan protokol minimum SSL/TLS akun yang diizinkan. Ini diharapkan saat ini karena emulator Azure Cosmos DB hanya menerima dan bekerja dengan protokol TLS 1.2. Solusi yang disarankan adalah mengubah pengaturan dan default ke TLS 1.2; misalnya di IIS Manager, navigasi ke "Situs" -> "Situs Web Default" dan temukan "Pengikatan Situs" untuk port 8081 dan edit untuk menonaktifkan TLS 1.3. Operasi serupa dapat dilakukan untuk browser Web melalui opsi "Pengaturan".

  • Saat emulator berjalan, jika komputer Anda masuk ke mode tidur atau menjalankan pembaruan OS apa pun, Anda mungkin melihat pesan Layanan saat ini tidak tersedia. Atur ulang data emulator, dengan mengeklik kanan ikon yang muncul di baki notifikasi jendela dan pilih Atur Ulang Data.

Mengumpulkan file pelacakan

Untuk mengumpulkan jejak penelusuran kesalahan, jalankan perintah berikut ini dari perintah administratif:

  1. Arahkan ke jalur tempat emulator terpasang:

    cd /d "%ProgramFiles%\Azure Cosmos DB Emulator"
    
  2. Matikan emulator dan perhatikan baki sistem untuk memastikan program telah dimatikan. Mungkin perlu waktu sebentar untuk menyelesaikannya. Anda juga dapat memilih Keluar di antarmuka pengguna Emulator Azure Cosmos DB.

    Microsoft.Azure.Cosmos.Emulator.exe /shutdown
    
  3. Mulai pengelogan dengan perintah berikut:

    Microsoft.Azure.Cosmos.Emulator.exe /startwprtraces
    
  4. Luncurkan emulator

    Microsoft.Azure.Cosmos.Emulator.exe
    
  5. Reproduksi masalah. Jika penjelajah data tidak berfungsi, Anda hanya perlu menunggu browser terbuka selama beberapa detik untuk menangkap kesalahan.

  6. Mulai pengelogan dengan perintah berikut:

    Microsoft.Azure.Cosmos.Emulator.exe /stopwprtraces
    
  7. Navigasi ke %ProgramFiles%\Azure Cosmos DB Emulator jalur dan temukan file docdbemulator_000001.etl.

  8. Buka tiket dukungan di portal Microsoft Azure dan sertakan file .etl bersama dengan langkah-langkah reproduksi.

Langkah berikutnya

Dalam artikel ini, Anda telah mempelajari cara men-debug masalah dengan emulator lokal. Sekarang Anda dapat melanjutkan ke artikel berikutnya: