Memantau data Azure Cosmos DB menggunakan pengaturan diagnostik Analitik Log Azure Monitor
Artikel
BERLAKU UNTUK: NoSQL MongoDB Cassandra Gremlin Meja
Pengaturan diagnostik di Azure digunakan untuk mengumpulkan log sumber daya. Sumber daya memancarkan Log sumber daya Azure dan menyediakan data yang kaya dan sering tentang pengoperasian sumber daya tersebut. Log ini diambil per permintaan dan juga disebut sebagai log sarana data. Beberapa contoh operasi bidang data termasuk menghapus, menyisipkan, dan membaca Umpan. Isi log ini bervariasi menurut jenis sumber daya.
Sebaiknya buat pengaturan diagnostik dalam mode khusus sumber daya (untuk semua API kecuali API untuk Tabel) mengikuti instruksi di tab REST API . Opsi ini menyediakan pengoptimalan biaya tambahan dengan tampilan yang ditingkatkan untuk menangani data.
Prasyarat
Akun Azure Cosmos DB yang sudah ada.
Jika Anda memiliki langganan Azure, buat akun baru.
Jika Anda tidak memiliki langganan Azure, buat akun gratis sebelum Anda memulai.
Ruang kerja Analitik Log Azure Monitor yang sudah ada.
Peringatan
Jika Anda perlu menghapus sumber daya, mengganti nama, atau memindahkan sumber daya, atau memigrasikannya di seluruh grup sumber daya atau langganan, pertama-tama hapus pengaturan diagnostiknya. Jika tidak, jika Anda membuat ulang sumber daya ini, pengaturan diagnostik untuk sumber daya yang dihapus dapat disertakan dengan sumber daya baru, tergantung pada konfigurasi sumber daya untuk setiap sumber daya. Jika pengaturan diagnostik disertakan dengan sumber daya baru, ini melanjutkan pengumpulan log sumber daya seperti yang didefinisikan dalam pengaturan diagnostik dan mengirim metrik dan data log yang berlaku ke tujuan yang dikonfigurasi sebelumnya.
Selain itu, ini adalah praktik yang baik untuk menghapus pengaturan diagnostik untuk sumber daya yang akan Anda hapus dan tidak berencana menggunakan lagi untuk menjaga lingkungan Anda tetap bersih.
Membuat pengaturan diagnostik
Di sini, kami menelusuri proses pembuatan pengaturan diagnostik untuk akun Anda.
Catatan
Metrik untuk mengekspor log sebagai kategori saat ini tidak didukung.
Navigasikan ke akun Azure Cosmos DB Anda yang sudah ada.
Di bagian Pemantauan dari menu sumber daya, pilih Pengaturan diagnostik. Kemudian, pilih opsi Tambahkan pengaturan diagnostik.
Penting
Anda mungkin melihat perintah untuk "mengaktifkan kueri teks lengkap [...] untuk pengelogan yang lebih rinci" jika fitur kueri teks lengkap tidak diaktifkan di akun Anda. Anda dapat mengabaikan peringatan ini dengan aman jika Anda tidak ingin mengaktifkan fitur ini. Untuk informasi selengkapnya, lihat mengaktifkan kueri teks lengkap.
Di panel Pengaturan diagnostik, beri nama pengaturan contoh pengaturan lalu pilih kategori QueryRuntimeStatistics. Aktifkan kotak centang Kirim ke Ruang Kerja Analitik Log, memilih ruang kerja yang sudah ada. Terakhir, pilih Sumber Daya khusus sebagai opsi tujuan.
az monitor diagnostic-settings create Gunakan perintah untuk membuat pengaturan diagnostik dengan Azure CLI. Lihat dokumentasi untuk perintah ini untuk deskripsi parameternya.
Pastikan Anda masuk ke Azure CLI. Untuk informasi selengkapnya, lihat masuk dengan Azure CLI.
Gunakan az monitor diagnostic-settings create untuk membuat pengaturan.
az deployment group create \
--resource-group "<resource-group-name>" \
--template-file azuredeploy.json \
--parameters \
azureCosmosDbAccountName="<azure-cosmos-db-account-name>" \
logAnalyticsWorkspaceName="<log-analytics-workspace-name>"
Tip
az bicep decompile Gunakan perintah untuk mengonversi templat Azure Resource Manager menjadi templat Bicep.
Mengaktifkan kueri teks lengkap untuk mencatat teks kueri
Azure Cosmos DB menyediakan logging lanjutan untuk pemecahan masalah terperinci. Dengan mengaktifkan kueri teks lengkap, Anda dapat menampilkan kueri deobfuscated untuk semua permintaan dalam akun Azure Cosmos DB Anda. Anda juga memberikan izin bagi Azure Cosmos DB untuk mengakses dan menampilkan data ini di log Anda.
Peringatan
Mengaktifkan fitur ini dapat menimbulkan biaya pengelogan tambahan, untuk rincian harga kunjungi harga Azure Monitor. Disarankan untuk menonaktifkan fitur ini setelah pemecahan masalah.
Pada halaman akun Azure Cosmos DB yang sudah ada, pilih opsi Fitur di dalam bagian Pengaturan menu sumber daya. Kemudian, pilih fitur kueri teks lengkap Diagnostik.
Dalam dialog, pilih Enable. Pengaturan ini diterapkan dalam beberapa menit. Semua log yang baru diserap sekarang memiliki teks lengkap atau teks PIICommand untuk setiap permintaan.
Gunakan Azure CLI untuk mengaktifkan kueri teks lengkap untuk akun Azure Cosmos DB Anda.
Aktifkan kueri teks lengkap menggunakan az rest lagi dengan kata kerja HTTP PATCH dan payload JSON.