Memantau Azure Cosmos DB

  • Artikel

Artikel ini menjelaskan:

  • Jenis data pemantauan yang dapat Anda kumpulkan untuk layanan ini.
  • Cara menganalisis data tersebut.

Catatan

Jika Anda sudah terbiasa dengan layanan ini dan/atau Azure Monitor dan hanya ingin tahu cara menganalisis data pemantauan, lihat bagian Analisis di dekat akhir artikel ini.

Ketika Anda memiliki aplikasi penting dan proses bisnis yang mengandalkan sumber daya Azure, Anda perlu memantau dan mendapatkan pemberitahuan untuk sistem Anda. Layanan Azure Monitor mengumpulkan dan menggabungkan metrik dan log dari setiap komponen sistem Anda. Azure Monitor memberi Anda tampilan ketersediaan, performa, dan ketahanan, serta memberi tahu Anda tentang masalah. Anda dapat menggunakan pustaka portal Azure, PowerShell, Azure CLI, REST API, atau klien untuk menyiapkan dan melihat data pemantauan.

Insights

Beberapa layanan di Azure memiliki dasbor pemantauan bawaan di portal Azure yang menyediakan titik awal untuk memantau layanan Anda. Dasbor ini disebut wawasan, dan Anda dapat menemukannya di Insights Hub Azure Monitor di portal Azure.

Wawasan Azure Cosmos DB

Wawasan Azure Cosmos DB adalah fitur berdasarkan fitur buku kerja Azure Monitor. Gunakan wawasan Azure Cosmos DB untuk melihat performa keseluruhan, kegagalan, kapasitas, dan kesehatan operasional semua sumber daya Azure Cosmos DB Anda dalam pengalaman interaktif terpadu.

Untuk informasi selengkapnya tentang wawasan Azure Cosmos DB, lihat artikel berikut ini:

Jenis Sumber Daya

Azure menggunakan konsep jenis sumber daya dan ID untuk mengidentifikasi semuanya dalam langganan. Azure Monitor juga mengatur data pemantauan inti ke dalam metrik dan log berdasarkan jenis sumber daya, juga disebut namespace layanan. Metrik dan log yang berbeda tersedia untuk berbagai jenis sumber daya. Layanan Anda mungkin dikaitkan dengan lebih dari satu jenis sumber daya.

Jenis sumber daya juga merupakan bagian dari ID sumber daya untuk setiap sumber daya yang berjalan di Azure. Misalnya, satu jenis sumber daya untuk komputer virtual adalah Microsoft.Compute/virtualMachines. Untuk daftar layanan dan jenis sumber daya terkait, lihat Penyedia sumber daya.

Untuk informasi selengkapnya tentang jenis sumber daya untuk Azure Cosmos DB, lihat Referensi data pemantauan Azure Cosmos DB.

Penyimpanan data

Untuk Azure Monitor:

  • Data metrik disimpan dalam database metrik Azure Monitor.
  • Data log disimpan di penyimpanan log Azure Monitor. Log Analytics adalah alat di portal Azure yang dapat mengkueri penyimpanan ini.
  • Log aktivitas Azure adalah penyimpanan terpisah dengan antarmukanya sendiri di portal Azure.

Anda dapat secara opsional merutekan metrik dan data log aktivitas ke penyimpanan log Azure Monitor. Anda kemudian dapat menggunakan Analitik Log untuk mengkueri data dan menghubungkannya dengan data log lainnya.

Banyak layanan dapat menggunakan pengaturan diagnostik untuk mengirim metrik dan data log ke lokasi penyimpanan lain di luar Azure Monitor. Contohnya termasuk Azure Storage, sistem mitra yang dihosting, dan sistem mitra non-Azure, dengan menggunakan Azure Event Hubs.

Untuk informasi terperinci tentang cara Azure Monitor menyimpan data, lihat Platform data Azure Monitor.

Metrik platform Azure Monitor

Azure Monitor menyediakan metrik platform untuk sebagian besar layanan. Metrik ini adalah:

  • Didefinisikan secara individual untuk setiap namespace layanan.
  • Disimpan dalam database metrik rangkaian waktu Azure Monitor.
  • Ringan dan mampu mendukung peringatan mendekati real-time.
  • Digunakan untuk melacak performa sumber daya dari waktu ke waktu.

Koleksi: Azure Monitor mengumpulkan metrik platform secara otomatis. Tidak diperlukan konfigurasi.

Perutean: Anda juga biasanya dapat merutekan metrik platform ke Log Azure Monitor /Log Analytics sehingga Anda dapat mengkuerinya dengan data log lainnya. Untuk informasi selengkapnya, lihat pengaturan diagnostik Metrik. Untuk cara mengonfigurasi pengaturan diagnostik untuk layanan, lihat Membuat pengaturan diagnostik di Azure Monitor.

Untuk daftar semua metrik yang mungkin dikumpulkan untuk semua sumber daya di Azure Monitor, lihat Metrik yang didukung di Azure Monitor.

Azure Monitor mengumpulkan metrik Azure Cosmos DB secara default. Anda tidak perlu mengonfigurasi apa pun secara eksplisit. Sebagian besar metrik tersedia dari halaman portal Azure Cosmos DB atau dari halaman Azure Monitor. Secara default, metrik dikumpulkan dengan granularitas satu menit. Granularitas mungkin bervariasi berdasarkan metrik yang Anda pilih. Metrik ini memiliki periode retensi 30 hari secara default.

Metrik sisi server Azure Cosmos DB mencakup metrik throughput, penyimpanan, ketersediaan, latensi, konsistensi, dan tingkat sistem. Di sisi klien, Anda dapat mengumpulkan detail untuk biaya permintaan, ID aktivitas, informasi pelacakan pengecualian dan tumpukan, status HTTP dan kode substatus, dan string diagnostik. Metrik ini memiliki periode retensi tujuh hari secara default. Anda dapat menggunakan data ini untuk men-debug masalah atau jika Anda perlu menghubungi tim dukungan Azure Cosmos DB.

Nilai dimensi untuk metrik, seperti nama kontainer, tidak peka huruf besar/kecil. Situasi ini dapat mengakibatkan kebingungan atau tabrakan telemetri dan tindakan pada kontainer dengan nama tersebut. Perbandingan tidak peka huruf besar/kecil saat melakukan perbandingan string pada nilai dimensi ini.

Untuk daftar metrik yang tersedia untuk Azure Cosmos DB, lihat Referensi data pemantauan Azure Cosmos DB.

Metrik berbasis Non-Azure Monitor

Layanan ini menyediakan metrik lain yang tidak disertakan dalam database metrik Azure Monitor.

Log sumber daya Azure Monitor

Log sumber daya memberikan wawasan tentang operasi yang dilakukan oleh sumber daya Azure. Log dihasilkan secara otomatis, tetapi Anda harus merutekannya ke log Azure Monitor untuk menyimpan atau mengkuerinya. Log diatur dalam kategori. Namespace tertentu mungkin memiliki beberapa kategori log sumber daya.

Koleksi: Log sumber daya tidak dikumpulkan dan disimpan hingga Anda membuat pengaturan diagnostik dan merutekan log ke satu atau beberapa lokasi. Saat membuat pengaturan diagnostik, Anda menentukan kategori log yang akan dikumpulkan. Ada beberapa cara untuk membuat dan memelihara pengaturan diagnostik, termasuk portal Azure, terprogram, dan meskipun Azure Policy.

Perutean: Default yang disarankan adalah merutekan log sumber daya ke Log Azure Monitor sehingga Anda dapat mengkuerinya dengan data log lainnya. Lokasi lain seperti Azure Storage, Azure Event Hubs, dan mitra pemantauan Microsoft tertentu juga tersedia. Untuk informasi selengkapnya, lihat Log sumber daya Azure dan Tujuan log sumber daya.

Untuk informasi terperinci tentang mengumpulkan, menyimpan, dan merutekan log sumber daya, lihat Pengaturan diagnostik di Azure Monitor.

Untuk daftar semua kategori log sumber daya yang tersedia di Azure Monitor, lihat Log sumber daya yang didukung di Azure Monitor.

Semua log sumber daya di Azure Monitor memiliki bidang header yang sama, diikuti oleh bidang khusus layanan. Skema umum diuraikan dalam skema log sumber daya Azure Monitor.

Anda dapat memantau log diagnostik dari akun Azure Cosmos DB Anda dan membuat dasbor dari Azure Monitor. Telemetri, seperti peristiwa dan jejak yang terjadi pada granularitas kedua, disimpan sebagai log. Misalnya, jika throughput kontainer berubah, properti akun Azure Cosmos DB berubah. Log menangkap peristiwa ini. Anda dapat menganalisis log ini dengan menjalankan kueri pada data yang dikumpulkan.

Untuk kategori log sumber daya yang tersedia, tabel Analitik Log terkait, dan skema log untuk Azure Cosmos DB, lihat Referensi data pemantauan Azure Cosmos DB.

Log aktivitas Azure

Log aktivitas berisi peristiwa tingkat langganan yang melacak operasi untuk setiap sumber daya Azure seperti yang terlihat dari luar sumber daya tersebut; misalnya, membuat sumber daya baru atau memulai komputer virtual.

Koleksi: Peristiwa log aktivitas secara otomatis dihasilkan dan dikumpulkan di penyimpanan terpisah untuk dilihat di portal Azure.

Perutean: Anda dapat mengirim data log aktivitas ke Log Azure Monitor sehingga Anda dapat menganalisisnya bersama data log lainnya. Lokasi lain seperti Azure Storage, Azure Event Hubs, dan mitra pemantauan Microsoft tertentu juga tersedia. Untuk informasi selengkapnya tentang cara merutekan log aktivitas, lihat Gambaran Umum log aktivitas Azure.

Menganalisis data pemantauan

Ada banyak alat untuk menganalisis data pemantauan.

Alat Azure Monitor

Azure Monitor mendukung alat dasar berikut:

  • Penjelajah metrik, alat di portal Azure yang memungkinkan Anda melihat dan menganalisis metrik untuk sumber daya Azure. Untuk informasi selengkapnya, lihat Menganalisis metrik dengan penjelajah metrik Azure Monitor.

  • Log Analytics, alat di portal Azure yang memungkinkan Anda mengkueri dan menganalisis data log dengan menggunakan bahasa kueri Kusto (KQL). Untuk informasi selengkapnya, lihat Mulai menggunakan kueri Log di Azure Monitor.

  • Log aktivitas, yang memiliki antarmuka pengguna di portal Azure untuk melihat dan pencarian dasar. Untuk melakukan analisis yang lebih mendalam, Anda harus merutekan data ke log Azure Monitor dan menjalankan kueri yang lebih kompleks di Analitik Log.

Alat yang memungkinkan visualisasi yang lebih kompleks meliputi:

  • Dasbor yang memungkinkan Anda menggabungkan berbagai jenis data ke dalam satu panel di portal Azure.
  • Buku kerja, laporan yang dapat disesuaikan yang bisa Anda buat di portal Azure. Buku kerja dapat menyertakan kueri teks, metrik, dan log.
  • Grafana, alat platform terbuka yang unggul di dasbor operasional. Anda dapat menggunakan Grafana untuk membuat dasbor yang menyertakan data dari beberapa sumber selain Azure Monitor.
  • Power BI, layanan analitik bisnis yang menyediakan visualisasi interaktif di berbagai sumber data. Anda dapat mengonfigurasi Power BI untuk mengimpor data log secara otomatis dari Azure Monitor untuk memanfaatkan visualisasi ini.

Alat ekspor Azure Monitor

Anda bisa mendapatkan data dari Azure Monitor ke alat lain dengan menggunakan metode berikut:

  • Metrik: Gunakan REST API untuk metrik untuk mengekstrak data metrik dari database metrik Azure Monitor. API mendukung ekspresi filter untuk menyempurnakan data yang diambil. Untuk informasi selengkapnya, lihat Referensi REST API Azure Monitor.

  • Log: Gunakan REST API atau pustaka klien terkait.

  • Opsi lain adalah ekspor data ruang kerja.

Untuk mulai menggunakan REST API untuk Azure Monitor, lihat Panduan REST API pemantauan Azure.

Menganalisis metrik Azure Cosmos DB

Anda dapat menggunakan Azure Monitor Metrics Explorer untuk menganalisis metrik untuk Azure Cosmos DB dengan metrik dari layanan Azure lainnya dengan memilih Metrik di bawah Pemantauan di navigasi portal akun Azure Cosmos DB Anda. Untuk informasi selengkapnya tentang cara menggunakan penjelajah metrik, lihat Menganalisis metrik dengan penjelajah metrik Azure Monitor.

Anda dapat memantau latensi sisi server, penggunaan unit permintaan, dan penggunaan unit permintaan yang dinormalisasi untuk sumber daya Azure Cosmos DB Anda. Anda dapat memilih metrik khusus untuk meminta unit, penyimpanan, latensi, ketersediaan, Cassandra, dan lainnya.

Di sisi klien, Anda dapat men-debug masalah dengan mengumpulkan metrik untuk biaya permintaan, ID aktivitas, pengecualian dan informasi pelacakan tumpukan, status HTTP dan kode substatus, dan string diagnostik.

Untuk informasi selengkapnya dan instruksi terperinci, lihat artikel berikut ini:

Untuk daftar semua metrik sumber daya yang didukung di Azure Monitor, lihat Metrik Azure Monitor yang didukung. Untuk daftar metrik platform yang dikumpulkan untuk Azure Cosmos DB, lihat Memantau metrik referensi data Azure Cosmos DB.

Memantau Azure Cosmos DB secara terprogram

Metrik tingkat akun yang tersedia di portal, seperti penggunaan penyimpanan akun dan total permintaan, tidak tersedia dengan menggunakan API untuk NoSQL. Namun, Anda dapat mengambil data penggunaan di tingkat pengumpulan dengan menggunakan API untuk NoSQL. Untuk mengambil data tingkat pengumpulan, gunakan salah satu pendekatan berikut:

Untuk mengakses metrik lainnya, gunakan Azure Monitor SDK. Definisi metrik yang tersedia dapat diambil dengan menggunakan format ini:

https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroup}/providers/Microsoft.DocumentDb/databaseAccounts/{DocumentDBAccountName}/providers/microsoft.insights/metricDefinitions?api-version=2018-01-01

Untuk mengambil metrik individual, gunakan format berikut:

https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroup}/providers/Microsoft.DocumentDb/databaseAccounts/{DocumentDBAccountName}/providers/microsoft.insights/metrics?timespan={StartTime}/{EndTime}&interval={AggregationInterval}&metricnames={MetricName}&aggregation={AggregationType}&`$filter={Filter}&api-version=2018-01-01

Untuk mempelajari selengkapnya, lihat Rest API pemantauan Azure.

Menganalisis log Azure Cosmos DB

Data di Log Azure Monitor disimpan dalam tabel. Setiap tabel memiliki sekumpulan properti uniknya sendiri. Semua log sumber daya di Azure Monitor memiliki bidang yang sama diikuti dengan bidang khusus layanan. Skema umum diuraikan dalam skema log sumber daya Azure Monitor.

Untuk jenis log sumber daya yang dikumpulkan untuk Azure Cosmos DB, lihat Referensi data pemantauan Azure Cosmos DB.

Lihat artikel berikut ini untuk informasi selengkapnya tentang bekerja dengan Log Azure Monitor untuk Azure Cosmos DB:

Kueri Kusto

Anda dapat menganalisis data pemantauan di penyimpanan Log Azure Monitor / Analitik Log dengan menggunakan bahasa kueri Kusto (KQL).

Penting

Saat Anda memilih Log dari menu layanan di portal, Analitik Log terbuka dengan cakupan kueri yang diatur ke layanan saat ini. Cakupan ini berarti bahwa kueri log hanya akan menyertakan data dari jenis sumber daya tersebut. Jika Anda ingin menjalankan kueri yang menyertakan data dari layanan Azure lainnya, pilih Log dari menu Azure Monitor . Lihat Cakupan kueri log dan rentang waktu di Azure Monitor Log Analytics untuk rinciannya.

Untuk daftar kueri umum untuk layanan apa pun, lihat antarmuka kueri Analitik Log.

Sebelum menggunakan Log Analytics untuk mengeluarkan kueri Kusto, Anda harus mengaktifkan log diagnostik untuk operasi sarana kontrol. Saat mengaktifkan log diagnostik, Anda memilih antara menyimpan data Anda dalam tabel khusus sumber daya atau tabel AzureDiagnostics tunggal (warisan). Teks kueri Kusto yang tepat tergantung pada mode koleksi yang Anda pilih.

Berikut adalah beberapa kueri yang dapat Anda masukkan ke bilah pencarian Log untuk membantu Anda memantau sumber daya Azure Cosmos DB Anda.

Untuk mengkueri semua log sarana kontrol dari Azure Cosmos DB:

CDBControlPlaneRequests

Untuk mengkueri semua log data plane dari Azure Cosmos DB:

CDBDataPlaneRequests

Untuk mengkueri daftar log data plane yang difilter, khusus untuk satu sumber daya:

CDBDataPlaneRequests
| where AccountName=="<account-name>"

Untuk mendapatkan hitungan log data plane, dikelompokkan menurut sumber daya:

CDBDataPlaneRequests
| summarize count() by AccountName

Untuk menghasilkan bagan pada log data plane, dikelompokkan menurut jenis operasi:

CDBDataPlaneRequests
| summarize count() by OperationName
| render piechart

Untuk kueri Kusto yang bisa Anda gunakan untuk memecahkan masalah dengan Azure Cosmos DB, lihat artikel berikut ini:

Contoh-contoh ini hanyalah pengambilan sampel kecil dari kueri kaya yang dapat Anda jalankan di Azure Monitor dengan menggunakan Bahasa Kueri Kusto (KQL). Untuk contoh selengkapnya, lihat sampel untuk kueri Kusto.

Peringatan

Pemberitahuan Azure Monitor secara proaktif memberi tahu Anda saat kondisi tertentu ditemukan di data pemantauan Anda. Pemberitahuan memungkinkan Anda mengidentifikasi dan mengatasi masalah di sistem Anda sebelum pelanggan Anda memperhatikannya. Untuk informasi selengkapnya, lihat Pemberitahuan Azure Monitor.

Ada banyak sumber pemberitahuan umum untuk sumber daya Azure. Untuk contoh pemberitahuan umum untuk sumber daya Azure, lihat Contoh kueri pemberitahuan log. Situs Azure Monitor Baseline Alerts (AMBA) menyediakan metode semi-otomatis untuk menerapkan pemberitahuan, dasbor, dan panduan metrik platform penting. Situs ini berlaku untuk subset layanan Azure yang terus berkembang, termasuk semua layanan yang merupakan bagian dari Zona Pendaratan Azure (ALZ).

Skema pemberitahuan umum menstandarkan konsumsi pemberitahuan pemberitahuan Azure Monitor. Untuk informasi selengkapnya, lihat Skema pemberitahuan umum.

Jenis peringatan

Anda dapat memperingatkan metrik atau sumber data log apa pun di platform data Azure Monitor. Ada banyak jenis pemberitahuan yang berbeda tergantung pada layanan yang Anda pantau dan data pemantauan yang Anda kumpulkan. Berbagai jenis pemberitahuan memiliki berbagai manfaat dan kelemahan. Untuk informasi selengkapnya, lihat Memilih jenis pemberitahuan pemantauan yang tepat.

Daftar berikut ini menjelaskan jenis pemberitahuan Azure Monitor yang bisa Anda buat:

  • Pemberitahuan metrik mengevaluasi metrik sumber daya secara berkala. Metrik dapat berupa metrik platform, metrik kustom, log dari Azure Monitor yang dikonversi ke metrik, atau metrik Application Insights. Pemberitahuan metrik juga dapat menerapkan beberapa kondisi dan ambang batas dinamis.
  • Pemberitahuan log memungkinkan pengguna menggunakan kueri Analitik Log untuk mengevaluasi log sumber daya pada frekuensi yang telah ditentukan sebelumnya.
  • Pemberitahuan log aktivitas memicu ketika peristiwa log aktivitas baru terjadi yang cocok dengan kondisi yang ditentukan. Pemberitahuan Resource Health dan pemberitahuan Service Health adalah pemberitahuan log aktivitas yang melaporkan layanan dan kesehatan sumber daya Anda.

Beberapa layanan Azure juga mendukung pemberitahuan deteksi pintar, pemberitahuan Prometheus, atau aturan pemberitahuan yang direkomendasikan.

Untuk beberapa layanan, Anda dapat memantau dalam skala besar dengan menerapkan aturan pemberitahuan metrik yang sama ke beberapa sumber daya dengan jenis yang sama yang ada di wilayah Azure yang sama. Pemberitahuan individual dikirim untuk setiap sumber daya yang dipantau. Untuk layanan dan cloud Azure yang didukung, lihat Memantau beberapa sumber daya dengan satu aturan pemberitahuan.

Aturan pemberitahuan Azure Cosmos DB

Tabel berikut ini mencantumkan beberapa aturan pemberitahuan umum dan yang direkomendasikan untuk Azure Cosmos DB.

Jenis pemberitahuan Kondisi Deskripsi
Pembatasan kecepatan pada unit permintaan (peringatan metrik) Nama dimensi: StatusCode, Operator: Sama dengan, Nilai dimensi: 429 Memperingatkan jika kontainer atau database telah melampaui batas throughput yang tersedia.
Wilayah gagal Operator: Lebih besar dari, Jenis agregasi: Hitungan, Nilai ambang batas: 1 Ketika wilayah tunggal gagal. Peringatan ini berguna jika Anda tidak mengaktifkan failover otomatis.
Memutar kunci (pemberitahuan log aktivitas) Tingkat peristiwa: Informasi, Status: dimulai Memperingatkan ketika tombol akun diputar. Anda dapat memperbarui aplikasi dengan kunci baru.

Untuk informasi selengkapnya dan instruksi tentang membuat pemberitahuan untuk Azure Cosmos DB, lihat Membuat pemberitahuan tentang metrik. Untuk membuat pemberitahuan untuk memantau apakah penyimpanan untuk kunci partisi logis mendekati 20 GB, lihat Membuat pemberitahuan pada ukuran kunci partisi logis.

Rekomendasi Advisor

Untuk beberapa layanan, jika kondisi penting atau perubahan segera terjadi selama operasi sumber daya, pemberitahuan ditampilkan di halaman Gambaran Umum layanan di portal. Anda dapat menemukan informasi selengkapnya dan perbaikan yang direkomendasikan untuk pemberitahuan di rekomendasi Advisor di bawah Pemantauan di menu sebelah kiri. Selama operasi normal, tidak ada rekomendasi advisor yang ditampilkan.

Untuk informasi selengkapnya tentang Azure Advisor, lihat Gambaran umum Azure Advisor.

Konten terkait