Memantau Azure Cosmos DB

Artikel ini menjelaskan:

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

Nota

Jika Anda sudah familiar 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 portal Azure, PowerShell, Azure CLI, REST API, atau pustaka klien untuk mengatur 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 insights, 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 semua yang ada dalam sebuah langganan. Jenis sumber daya juga merupakan bagian dari ID sumber daya untuk setiap sumber daya yang berjalan di Azure. Misalnya, salah satu jenis sumber daya untuk mesin virtual adalah Microsoft.Compute/virtualMachines. Untuk daftar layanan dan jenis sumber daya terkait, lihat Penyedia sumber daya.

Azure Monitor juga mengatur data pemantauan inti ke dalam metrik dan log berdasarkan tipe sumber daya, yang juga disebut namespace. Metrik dan log yang berbeda tersedia untuk berbagai jenis sumber daya. Layanan Anda mungkin terkait dengan lebih dari satu jenis 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.
  • Catatan aktivitas Azure adalah penyimpanan terpisah dengan antarmuka sendiri di portal Azure.

Anda dapat memilih untuk mengarahkan data metrik dan log aktivitas ke penyimpanan log Azure Monitor. Anda kemudian dapat menggunakan Log Analytics untuk mengkueri data dan menghubungkannya dengan data log lainnya.

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

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

Metrik pada platform Azure Monitor

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

  • Didefinisikan secara individual untuk setiap namespace.
  • Disimpan dalam database metrik rangkaian waktu Azure Monitor.
  • Sistem ini ringan dan dapat mendukung peringatan hampir secara waktu nyata.
  • Digunakan untuk melacak kinerja sumber daya dari waktu ke waktu.

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

Routing: Anda juga dapat merutekan beberapa metrik platform ke Azure Monitor Logs / Log Analytics sehingga Anda dapat melakukan query dengan data log lainnya. Periksa pengaturan ekspor DS untuk setiap metrik guna menentukan apakah Anda dapat menggunakan pengaturan diagnostik untuk merutekan metrik tersebut ke Azure Monitor Logs atau Log Analytics.

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. Untuk informasi selengkapnya tentang periode retensi default, lihat Retensi metrik Azure Monitor

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 permohonan, ID aktivitas, informasi pengecualian dan pelacakan tumpukan, kode status HTTP dan 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. Gunakan perbandingan yang tidak peka terhadap huruf besar/kecil saat melakukan perbandingan string pada nilai-nilai dimensi ini.

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

Metrik yang tidak berbasis Azure Monitor

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

log sumber daya di 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 setelan diagnostik dan mengarahkan log ke satu atau beberapa lokasi. Ketika Anda membuat pengaturan diagnostik, Anda menentukan kategori log mana yang akan dikumpulkan. Ada beberapa cara untuk membuat dan memelihara pengaturan diagnostik, termasuk melalui portal Azure, secara programatik, dan melalui Azure Policy.

Routing: Pengaturan bawaan yang dianjurkan adalah merutekan log sumber daya ke Azure Monitor Logs agar Anda dapat melakukan kueri terhadapnya bersama 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 rinci tentang mengumpulkan, menyimpan, dan mengarahkan 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 spesifik 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. Data, seperti peristiwa dan jejak-jejak yang terjadi pada tingkat detik, disimpan sebagai log. Misalnya, jika throughput suatu kontainer berubah, maka properti dari akun Azure Cosmos DB juga mengalami perubahan. Log-log menangkap peristiwa-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 dalam log aktivitas dihasilkan secara otomatis dan dikumpulkan di penyimpanan terpisah untuk ditampilkan di portal Azure.

Routing: Anda dapat mengirim data log aktivitas ke Azure Monitor Logs agar 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.

Memeriksa tindakan pengembalian untuk mode pencadangan berkelanjutan

Dengan menggunakan log aktivitas, Anda dapat mencantumkan semua pemulihan titik waktu spesifik untuk mode kontinu yang dilakukan pada akun Azure Cosmos DB. Untuk mempelajari cara melihat operasi ini di portal Azure, lihat Pemeriksaan tindakan pemulihan titik-waktu untuk mode pencadangan kontinu.

Menganalisis data pemantauan

Ada banyak alat untuk menganalisis data pemantauan.

perangkat Azure Monitor

Azure Monitor mendukung alat dasar berikut:

Alat yang memungkinkan visualisasi yang lebih kompleks meliputi:

  • Dashboards 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 Microsoft Azure. Buku kerja dapat mencakup teks, metrik, dan kueri log.
  • Grafana, sebuah alat platform terbuka yang unggul dalam dashboard operasional. Anda dapat menggunakan Grafana untuk membuat dasbor yang menyertakan data dari berbagai sumber selain Azure Monitor.
  • Power BI, sebuah layanan analitik bisnis yang menyediakan visualisasi interaktif dari berbagai sumber data. Anda dapat mengonfigurasi Power BI untuk secara otomatis mengimpor data log dari Azure Monitor guna memanfaatkan visualisasi ini.

Alat untuk Mengekspor dari Azure Monitor

Anda dapat mengeluarkan data dari Azure Monitor ke alat lain dengan menggunakan metode berikut:

Untuk memulai dengan REST API untuk Azure Monitor, lihat Panduan penggunaan 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 unit permintaan, penyimpanan, latensi, ketersediaan, Cassandra, dan metrik lainnya.

Di sisi klien, Anda dapat men-debug masalah dengan cara mengumpulkan metrik untuk biaya permintaan, ID aktivitas, informasi pengecualian dan pelacakan tumpukan, status HTTP dan kode substatus, serta 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. Lihat daftar metrik platform yang dikumpulkan untuk Azure Cosmos DB di Referensi Metrik Pemantauan 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 lebih lanjut, lihat Azure Monitoring REST API.

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.

Untuk informasi selengkapnya tentang bekerja dengan Log Azure Monitor untuk Azure Cosmos DB, lihat artikel berikut ini:

Kusto kueri

Anda dapat menganalisis data pemantauan di Azure Monitor Logs / Log Analytics store dengan menggunakan bahasa kueri Kusto (KQL).

Important

Saat Anda memilih Logs dari menu layanan di portal, Log Analytics terbuka dengan cakupan kueri yang disesuaikan dengan 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 Logs dari menu Azure Monitor. Lihat Lingkup kueri log dan rentang waktu di Azure Monitor Log Analytics untuk detailnya.

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

Sebelum menggunakan Analitik Log 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 pengumpulan 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 meminta daftar log data plane yang telah difilter, khusus untuk satu sumber daya tertentu.

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

Untuk mendapatkan jumlah log data-plane, yang dikelompokkan berdasarkan sumber daya:

CDBDataPlaneRequests
| summarize count() by AccountName

Untuk menghasilkan bagan pada log jalur data, dikelompokkan menurut tipe 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 contoh kueri Kusto.

Alerts

Peringatan Azure Monitor memberi tahu Anda secara proaktif saat kondisi tertentu terdeteksi 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 peringatan umum untuk sumber daya Azure. Untuk contoh peringatan umum untuk sumber daya Azure, lihat Contoh kueri peringatan 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 peringatan umum menstandarisasi konsumsi notifikasi peringatan Azure Monitor. Untuk informasi selengkapnya, lihat Skema pemberitahuan umum.

Jenis peringatan

Anda dapat memberikan peringatan pada sumber data metrik atau 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. Jenis-jenis peringatan yang berbeda memiliki berbagai manfaat dan kelemahan. Untuk informasi selengkapnya, lihat Memilih jenis pemberitahuan pemantauan yang tepat.

Daftar berikut menjelaskan jenis-jenis peringatan Azure Monitor yang dapat Anda buat.

  • Notifikasi metrik mengevaluasi metrik sumber daya pada interval yang teratur. Metrik dapat berupa metrik platform, metrik khusus, log dari Azure Monitor yang diubah menjadi metrik, atau metrik Application Insights. Pemberitahuan metrik juga dapat menerapkan beberapa kondisi dan ambang batas dinamis.
  • Log alerts memungkinkan pengguna untuk menggunakan kueri Log Analytics untuk mengevaluasi log sumber daya pada frekuensi yang telah ditentukan sebelumnya.
  • Peringatan log aktivitas dipicu ketika terjadi peristiwa log aktivitas baru yang sesuai dengan kondisi yang telah ditentukan. Peringatan Kesehatan Sumber Daya dan Peringatan Kesehatan Layanan adalah peringatan log aktivitas yang melaporkan kesehatan layanan dan sumber daya Anda.

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

Untuk beberapa layanan, Anda dapat memantau secara besar-besaran dengan menerapkan aturan peringatan metrik yang sama pada beberapa sumber daya dengan tipe yang sama yang berada di wilayah Azure yang sama. Pemberitahuan individual dikirimkan untuk setiap sumber daya yang dipantau. Untuk layanan dan cloud Azure yang didukung, lihat Mengawasi beberapa sumber daya dengan satu aturan peringatan.

Aturan peringatan Azure Cosmos DB

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

Jenis pemberitahuan Keadaan Description
Pembatasan laju pada satuan permintaan (peringatan metrik) Nama dimensi: StatusCode, Operator: Sama dengan, Nilai dimensi: 429 Pemberitahuan jika kontainer atau database melebihi batas throughput yang disediakan.
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 yang dikelola layanan.
Rotasi kunci (pemberitahuan log aktivitas) Tingkat peristiwa: Informasi, Status: dimulai Peringatan ketika kunci 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 Penasehat

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 lebih lanjut dan perbaikan yang direkomendasikan untuk peringatan di Rekomendasi Penasehat di bawah Pemantauan pada menu sebelah kiri. Selama operasi normal, tidak ada rekomendasi penasihat yang ditampilkan.

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