Memantau operasi dan aktivitas Azure Cognitive Search

Artikel ini adalah ringkasan konsep dan alat pemantauan untuk Azure Cognitive Search. Untuk pemantauan holistik, Anda harus menggunakan kombinasi fungsionalitas bawaan dan layanan add-on seperti Azure Monitor.

Secara keseluruhan, Anda dapat melacak hal-hal berikut:

  • Layanan pencarian: kesehatan dan perubahan konfigurasi layanan.
  • Konsumsi penyimpanan: baik yang digunakan maupun tersedia.
  • Batas objek pada indeks, pengindeks, dan objek lainnya, dengan jumlah untuk setiap jenis, relatif terhadap maksimum yang diizinkan untuk tingkat layanan.
  • Aktivitas kueri: volume, latensi, dan kueri yang dibatasi atau dihilangkan. Permintaan kueri yang dicatat memerlukan Azure Monitor.
  • Aktivitas pengindeksan: memerlukan pengelogan diagnostik dengan Azure Monitor.

Layanan pencarian tidak mendukung autentikasi per pengguna, jadi tidak ada informasi identitas pengguna yang akan ditemukan di log.

Pemantauan bawaan

Pemantauan bawaan mengacu pada aktivitas yang dicatat oleh layanan pencarian. Dengan pengecualian diagnostik, tidak ada konfigurasi yang diperlukan untuk tingkat pemantauan ini.

Azure Cognitive Search mempertahankan data internal pada jadwal 30 hari bergulir untuk melaporkan metrik kesehatan dan kueri layanan, yang dapat Anda temukan di portal atau melalui REST API ini.

Tangkapan layar berikut ini membantu Anda menemukan informasi pemantauan di portal. Data akan tersedia segera setelah Anda mulai menggunakan layanan. Halaman portal di-refresh setiap beberapa menit.

  • Tab Pemantauan, di halaman utama Ringkasan, memperlihatkan volume kueri, latensi, dan apakah layanan berada di bawah tekanan.

  • Log aktivitas, di panel navigasi kiri, terhubung ke Azure Resource Manager. Laporan log melaporkan tindakan yang dilakukan oleh Resource Manager: ketersediaan dan status layanan, perubahan kapasitas (replika dan partisi), dan aktivitas terkait kunci API.

  • Pengaturan Pemantauan, lebih jauh ke bawah, menyediakan pemberitahuan yang dapat dikonfigurasi, visualisasi metrik, dan log diagnostik. Buat pengaturan ini saat Anda membutuhkannya. Setelah data dikumpulkan dan disimpan, Anda dapat mengkueri atau memvisualisasikan informasi untuk mendapatkan wawasan.

    Integrasi Azure Monitor dalam layanan pencarian

Catatan

Karena halaman portal di-refresh setiap beberapa menit, angka yang dilaporkan adalah perkiraan, yang dimaksudkan untuk memberi Anda gambaran umum tentang seberapa baik sistem Anda melayani 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.

REST API berguna untuk pemantauan

Anda dapat menggunakan Postman dan API berikut untuk mengambil informasi yang sama yang ditemukan di tab Pemantauan dan Penggunaan di portal. Anda harus memberikan kunci API admin untuk mendapatkan informasi sistem.

Log aktivitas dan kesehatan layanan

Halaman Log aktivitas di portal mengumpulkan informasi dari Azure Resource Manager dan melaporkan perubahan pada kesehatan layanan. Anda dapat memantau log aktivitas untuk mengetahui kondisi kritis, kesalahan, dan pemberitahuan yang terkait dengan kesehatan layanan.

Entri umum mencakup referensi ke kunci API - pemberitahuan informasi umum seperti Dapatkan Kunci Admin dan Dapatkan Kunci Kueri. Aktivitas ini menunjukkan permintaan yang dibuat menggunakan kunci admin (membuat atau menghapus objek) atau kunci kueri, tetapi tidak menampilkan permintaan itu sendiri. Untuk informasi tentang detailnya, Anda harus mengonfigurasi pembuatan log diagnostik.

Anda bisa mengakses Log aktivitas dari panel navigasi kiri, atau dari Pemberitahuan di bilah perintah jendela atas, atau dari halaman Mendiagnosis dan menyelesaikan masalah.

Memantau penyimpanan di tab Penggunaan

Untuk pemantauan visual di portal, tab Penggunaan memperlihatkan ketersediaan sumber daya relatif terhadap batas saat yang diberlakukan oleh tingkat layanan. Jika Anda menyelesaikan keputusan tentang tingkat yang akan digunakan untuk beban kerja produksi, atau apakah harus menyesuaikan jumlah replika dan partisi aktif, metrik ini dapat membantu Anda membuat keputusan tersebut dengan menampilkan seberapa cepat sumber daya dikonsumsi dan seberapa baik konfigurasi saat ini dalam menangani beban yang ada.

Ilustrasi berikut untuk layanan gratis, yang dibatasi pada 3 objek dari setiap jenis dan penyimpanan 50 MB. Layanan Dasar atau Standar memiliki batas yang lebih tinggi, dan jika Anda meningkatkan jumlah partisi, penyimpanan maksimum akan naik secara proporsional.

Status penggunaan relatif terhadap batas tingkat

Catatan

Pemberitahuan yang terkait dengan penyimpanan saat ini tidak tersedia; konsumsi penyimpanan tidak digabungkan dan dicatat ke dalam tabel AzureMetrics di Azure Monitor. Untuk mendapatkan pemberitahuan penyimpanan, Anda harus membuat solusi kustom yang mencerminkan pemberitahuan terkait sumber daya, tempat kode Anda memeriksa ukuran penyimpanan dan menangani respons.

Pemantauan add-on dengan Azure Monitor

Banyak layanan, termasuk Azure Cognitive Search, terintegrasi dengan Azure Monitor untuk pemberitahuan tambahan, metrik, dan data diagnostik pengelogan.

Aktifkan pembuatan log diagnostik untuk layanan pencarian jika Anda ingin mengontrol pengumpulan dan penyimpanan data. Peristiwa yang dicatat yang diambil oleh Azure Monitor disimpan dalam tabel AzureDiagnostics dan terdiri dari data operasional yang terkait dengan kueri dan pengindeksan.

Azure Monitor dilengkapi dengan beberapa opsi penyimpanan, dan pilihan Anda menentukan cara Anda menggunakan data:

  • Pilih Azure Blob Storage jika ingin memvisualisasikan data log dalam laporan Power BI.
  • Pilih Log Analytics jika Anda ingin menjelajahi data melalui kueri Kusto.

Azure Monitor memiliki struktur tagihan sendiri dan log diagnostik yang direferensikan di bagian ini memiliki biaya terkait. Untuk informasi selengkapnya, lihat Penggunaan dan estimasi biaya di Azure Monitor.

Memantau akses pengguna

Karena indeks pencarian adalah komponen aplikasi klien yang lebih besar, tidak ada metodologi bawaan untuk mengontrol atau memantau akses per pengguna ke indeks. Permintaan diasumsikan berasal dari aplikasi klien yang menyajikan permintaan admin atau kueri. Operasi baca-tulis admin meliputi membuat, memperbarui, dan menghapus objek di seluruh layanan. Operasi baca-saja adalah kueri terhadap pengumpulan dokumen, yang dicakup ke satu indeks.

Dengan demikian, yang akan Anda lihat di log aktivitas adalah referensi ke panggilan yang menggunakan kunci admin atau kunci kueri. Kunci yang sesuai disertakan dalam permintaan yang berasal dari kode klien. Layanan ini tidak dilengkapi untuk menangani token identitas atau peniruan identitas.

Jika persyaratan bisnis ada untuk otorisasi per pengguna, rekomendasinya adalah integrasi dengan Azure Active Directory. Anda dapat menggunakan $filter dan identitas pengguna untuk memangkas hasil pencarian dokumen yang tidak boleh dilihat pengguna.

Tidak ada cara untuk mencatat informasi ini secara terpisah dari string kueri yang menyertakan parameter $filter. Lihat Memantau kueri untuk detail tentang melaporkan string kueri.

Langkah berikutnya

Pemahaman tentang Azure Monitor sangat diperlukan untuk pengawasan layanan Azure apa pun, termasuk sumber daya seperti Azure Cognitive Search. Jika Anda tidak terbiasa dengan Azure Monitor, luangkan waktu untuk meninjau artikel yang terkait dengan sumber daya. Selain tutorial, artikel berikut adalah tempat yang baik untuk memulai.