Azure Cognitive Search Pemantauan
Azure Monitor diaktifkan dengan setiap langganan untuk menyediakan kemampuan pemantauan di semua sumber daya Azure, termasuk Cognitive Search. Saat Anda mendaftar untuk pencarian, Azure Monitor mengumpulkan log aktivitas dan metrik segera setelah Anda mulai menggunakan layanan.
Secara opsional, Anda dapat mengaktifkan pengaturan diagnostik untuk mengumpulkan log sumber daya. Log sumber daya berisi informasi terperinci tentang operasi layanan pencarian yang berguna untuk analisis dan penyelidikan yang lebih mendalam.
Artikel ini menjelaskan cara kerja pemantauan untuk Azure Cognitive Search. Ini juga menjelaskan API sistem yang mengembalikan informasi tentang layanan Anda.
Catatan
Cognitive Search tidak memantau akses pengguna individual ke konten di layanan pencarian. Jika Anda memerlukan tingkat pemantauan ini, Anda harus menerapkannya di aplikasi klien Anda.
Pemantauan di portal Azure
Di halaman layanan pencarian di portal Azure, Anda dapat menemukan status operasi dan kapasitas saat ini.
Pada halaman Gambaran Umum , tab Pemantauan meringkasmetrik kueri utama, termasuk volume kueri, latensi, dan kueri yang dibatasi. Pada tab berikutnya, Penggunaan melaporkan kapasitas yang tersedia dan kuantitas indeks, pengindeks, sumber data, dan set keterampilan relatif terhadap maksimum yang diizinkan untuk tingkat layanan Anda.
Di menu di sebelah kiri, buka halaman Log aktivitas untuk melihat operasi sarana kontrol.
Selanjutnya, bagian Pemantauan menyertakan tindakan untuk Azure Monitor, yang difilter untuk pencarian. Di sini, Anda dapat mengaktifkan pengaturan diagnostik dan pengelogan sumber daya, dan menentukan bagaimana Anda ingin data disimpan.
Catatan
Karena halaman portal di-refresh setiap beberapa menit, angka yang dilaporkan adalah perkiraan, yang dimaksudkan untuk memberi Anda rasa umum tentang seberapa baik sistem Anda menangani permintaan. Metrik aktual seperti kueri per detik (QPS) mungkin lebih tinggi atau lebih rendah dari angka yang ditampilkan di halaman. Jika yang dibutuhkan adalah presisi, pertimbangkan untuk menggunakan API.
Mendapatkan data sistem dari REST API
REST API Cognitive Search menyediakan data Penggunaan yang terlihat di portal. Informasi ini diambil dari layanan pencarian Anda, yang dapat Anda peroleh secara terprogram:
Untuk panggilan REST, gunakan kunci API admin dan Postman atau klien REST lain untuk mengkueri layanan pencarian Anda.
Memantau log aktivitas
Dalam Azure Cognitive Search, log aktivitas mencerminkan aktivitas sarana kontrol, seperti pembaruan layanan dan kapasitas, atau penggunaan atau manajemen kunci API. Log aktivitas dikumpulkan secara gratis, tanpa konfigurasi yang diperlukan. Retensi data adalah 90 hari, tetapi Anda dapat mengonfigurasi penyimpanan tahan lama untuk retensi yang lebih lama.
Di portal Azure, temukan layanan pencarian Anda. Dari menu di sebelah kiri, pilih Log aktivitas untuk melihat log untuk layanan pencarian Anda.
Entri akan sering mencakup Get Admin Key, satu entri untuk setiap panggilan yang menyediakan kunci API admin pada permintaan. Tidak ada detail tentang panggilan itu sendiri, hanya pemberitahuan bahwa kunci admin digunakan. Untuk wawasan tentang operasi konten (atau bidang data), Anda harus mengaktifkan pengaturan diagnostik dan mengumpulkan log sumber daya.
Lihat Log aktivitas Azure Monitor untuk panduan umum tentang bekerja dengan log aktivitas.
Lihat Referensi REST API manajemen untuk aktivitas sarana kontrol yang mungkin muncul di log.
Cuplikan layar berikut menunjukkan sinyal log aktivitas yang dapat dikonfigurasi dalam pemberitahuan. Sinyal ini mewakili entri yang mungkin Anda lihat di log aktivitas.
Metrik Azure Monitor
Dalam Azure Cognitive Search, metrik platform mengukur performa kueri, volume pengindeksan, dan pemanggilan set keterampilan.
Metrik dikumpulkan secara gratis, tanpa konfigurasi yang diperlukan. Metrik platform disimpan selama 93 hari. Namun, di portal Anda hanya dapat mengkueri data metrik senilai maksimum 30 hari pada bagan tunggal apa pun. Batasan ini tidak berlaku untuk metrik berbasis log.
Di portal Azure, temukan layanan pencarian Anda. Dari menu di sebelah kiri, di bawah Pemantauan, pilih Metrik untuk membuka penjelajah metrik.
Lihat Tutorial: Menganalisis metrik untuk sumber daya Azure untuk panduan umum tentang menggunakan penjelajah metrik.
Lihat Microsoft.Search/searchServices (Azure Monitor) untuk metrik platform Azure Cognitive Search.
Lihat Memantau referensi data untuk deskripsi dan dimensi tambahan.
Lihat Memantau kueri untuk detail tentang metrik kueri.
Menyiapkan pemberitahuan
Pemberitahuan membantu Anda mengidentifikasi dan mengatasi masalah sebelum menjadi masalah bagi pengguna aplikasi. Anda dapat mengatur pemberitahuan tentang metrik, log sumber daya, dan log aktivitas. Pemberitahuan dapat ditagih (lihat Model harga untuk detailnya).
Di portal Azure, temukan layanan pencarian Anda. Dari menu di sebelah kiri, di bawah Pemantauan, pilih Pemberitahuan untuk membuka penjelajah metrik.
Lihat Tutorial: Membuat pemberitahuan metrik untuk sumber daya Azure untuk panduan umum tentang menyiapkan pemberitahuan dari penjelajah metrik.
Tabel berikut ini menjelaskan beberapa aturan. Pada layanan pencarian, pembatasan atau latensi kueri yang melebihi ambang batas tertentu adalah pemberitahuan yang paling umum digunakan, tetapi Anda mungkin juga ingin diberi tahu jika layanan pencarian dihapus.
| Jenis pemberitahuan | Kondisi | Deskripsi |
|---|---|---|
| Latensi Pencarian (pemberitahuan metrik) | Setiap kali latensi pencarian rata-rata lebih besar dari ambang batas yang ditentukan pengguna (dalam detik) | Kirim pemberitahuan SMS saat waktu respons kueri rata-rata melebihi ambang batas. |
| Persentase kueri pencarian yang dibatasi (pemberitahuan metrik) | Setiap kali persentase total kueri pencarian yang dibatasi lebih besar dari atau sama dengan ambang yang ditentukan pengguna | Kirim pemberitahuan SMS saat kueri yang dihilangkan mulai melebihi ambang batas. |
| Hapus Layanan Pencarian (pemberitahuan log aktivitas) | Setiap kali Log Aktivitas memiliki peristiwa dengan Category='Administrative', Signal name='Delete Search Service (searchServices)', Level='critical' | Kirim email jika layanan pencarian dihapus dalam langganan. |
Catatan
Saat ini, tidak ada pemberitahuan terkait penyimpanan (data konsumsi penyimpanan tidak dikumpulkan atau masuk ke tabel AzureMetrics ). Untuk mendapatkan pemberitahuan penyimpanan, Anda dapat membangun solusi kustom yang memancarkan pemberitahuan terkait sumber daya, di mana kode Anda memeriksa ukuran penyimpanan dan menangani respons.
Mengaktifkan pengelogan sumber daya
Dalam Azure Cognitive Search, log sumber daya menangkap operasi pengindeksan dan kueri pada layanan pencarian itu sendiri.
Log Sumber Daya tidak dikumpulkan dan disimpan hingga Anda membuat pengaturan diagnostik. Pengaturan diagnostik menentukan pengumpulan dan penyimpanan data. Anda dapat membuat beberapa pengaturan jika ingin memisahkan metrik dan data log, atau jika Anda menginginkan lebih dari satu dari setiap jenis tujuan.
Pengelogan sumber daya dapat ditagih (lihat Model harga untuk detailnya), dimulai saat Anda membuat pengaturan diagnostik. Lihat Pengaturan diagnostik di Azure Monitor untuk panduan umum.
Di portal Azure, temukan layanan pencarian Anda. Dari menu di sebelah kiri, di bawah Pemantauan, pilih Pengaturan diagnostik.
Pilih + Tambah pengaturan diagnostik.
Beri nama pengaturan diagnostik. Gunakan nama granular dan deskriptif jika Anda membuat lebih dari satu pengaturan.
Pilih log dan metrik yang berada dalam cakupan untuk pengaturan ini. Pilihan termasuk "allLogs", "OperationLogs", "AllMetrics". Anda dapat mengecualikan log aktivitas dengan memilih kategori "OperationLogs".
Pilih Kirim ke ruang kerja Analitik Log. Kueri Kusto dan eksplorasi data akan menargetkan ruang kerja.
Secara opsional, pilih tujuan lain.
Pilih Simpan.
Setelah ruang kerja berisi data, Anda dapat menjalankan kueri log:
Lihat Tutorial: Mengumpulkan dan menganalisis log sumber daya dari sumber daya Azure untuk panduan umum tentang kueri log.
Lihat Menganalisis performa di Azure Cognitive Search untuk contoh dan panduan khusus untuk layanan pencarian.
Contoh kueri Kusto
Penting
Saat Anda memilih Log dari menu Azure Cognitive Search, Analitik Log dibuka dengan cakupan kueri yang diatur ke layanan pencarian saat ini. Hal ini berarti kueri log hanya akan menyertakan data dari sumber daya. Jika Anda ingin mengkueri beberapa layanan pencarian atau menggabungkan data dari layanan Azure lainnya, pilih Log dari menu Azure Monitor . Lihat Cakupan kueri log dan rentang waktu dalam Analitik Log Azure Monitor untuk mengetahui detailnya.
Kusto adalah bahasa kueri yang digunakan untuk Log Analytics. Di bawah ini adalah beberapa kueri untuk memulai. Lihat referensi data pemantauan Azure Cognitive Search untuk deskripsi elemen skema yang digunakan dalam kueri. Lihat Menganalisis performa di Azure Cognitive Search untuk contoh dan panduan selengkapnya khusus untuk layanan pencarian.
Mencantumkan metrik menurut nama
Mengembalikan daftar metrik dan agregasi terkait. Kueri dilingkup ke layanan pencarian saat ini selama rentang waktu yang Anda tentukan.
AzureMetrics
| project MetricName, Total, Count, Maximum, Minimum, Average
Mencantumkan operasi menurut nama
Menampilkan daftar operasi dan hitungan masing-masingnya.
AzureDiagnostics
| summarize count() by OperationName
Kueri yang berjalan lama
Kueri Kusto terhadap AzureDiagnostics ini mengembalikan Query.Search operasi, diurutkan menurut durasi (dalam milidetik). Untuk contoh Query.Search kueri lainnya, lihat Menganalisis performa di Azure Cognitive Search.
AzureDiagnostics
| project OperationName, resultSignature_d, DurationMs, Query_s, Documents_d, IndexName_s
| where OperationName == "Query.Search"
| sort by DurationMs
Status pengindeks
Kueri Kusto ini mengembalikan status operasi pengindeks. Hasilnya mencakup nama operasi, deskripsi permintaan (yang mencakup nama pengindeks), status hasil (Berhasil atau Gagal), dan kode status HTTP. Untuk informasi selengkapnya tentang eksekusi pengindeks, lihat Memantau status pengindeks.
AzureDiagnostics
| project OperationName, Description_s, Documents_d, ResultType, resultSignature_d
| where OperationName == "Indexers.Status"
Langkah berikutnya
Kerangka kerja pemantauan untuk Azure Cognitive Search disediakan oleh Azure Monitor. Jika Anda tidak terbiasa dengan layanan ini, mulailah dengan Memantau sumber daya Azure dengan Azure Monitor untuk meninjau konsep utama. Anda juga dapat meninjau artikel berikut untuk Azure Cognitive Search: