Referensi data pemantauan Pencarian Azure AI

Note

Pencarian Azure AI tersedia melalui portal Azure, REST API, dan Azure SDK. Ini juga mendukung Foundry IQ, lapisan pengetahuan terkelola yang mengubah konten perusahaan menjadi pangkalan pengetahuan yang dapat digunakan kembali dan sadar izin untuk agen di portal Microsoft Foundry.

Artikel ini berisi semua informasi referensi pemantauan untuk layanan ini.

Lihat Monitor Pencarian Azure AI untuk detail tentang data yang dapat Anda kumpulkan untuk Pencarian Azure AI dan cara menggunakannya.

Metrik

Bagian ini mencantumkan semua metrik platform yang dikumpulkan secara otomatis untuk layanan ini. Metrik ini juga merupakan bagian dari daftar global metrik platform all yang didukung dalam Azure Monitor.

Untuk informasi tentang retensi metrik, lihat Ringkasan Metrik Azure Monitor.

Metrik yang didukung untuk Microsoft. Search/searchServices

Tabel berikut mencantumkan metrik yang tersedia untuk jenis sumber daya Microsoft.Search/searchServices.

  • Semua kolom mungkin tidak ada di setiap tabel.
  • Beberapa kolom mungkin berada di luar area tampilan halaman. Pilih Perluas tabel untuk melihat semua kolom yang tersedia.

Judul tabel

  • Kategori - Grup atau klasifikasi metrik.
  • Metric - Nama tampilan metrik seperti yang muncul di portal Azure.
  • Nama di REST API - Nama metrik seperti yang dirujuk dalam REST API.
  • Satuan - Satuan ukuran.
  • Agregasi - Jenis agregasi default. Nilai yang valid: Rata-rata (Rata-rata), Minimum (Min), Maksimum (Maks), Total (Jumlah), Jumlah.
  • Dimensi-dimensi - Dimensi-dimensi yang tersedia untuk metrik.
  • Butir Waktu - Interval yang digunakan untuk pengambilan sampel metrik. Misalnya, PT1M menunjukkan bahwa metrik diambil sampelnya setiap menit, PT30M setiap 30 menit, PT1H setiap jam, dan seterusnya.
  • DS Export- Apakah metrik dapat diekspor ke Azure Monitor Log melalui pengaturan diagnostik. Untuk informasi tentang mengekspor metrik, lihat Membuat pengaturan diagnostik di Azure Monitor.
Metrik Nama di REST API Metrik platform tingkat lanjut Unit Agregasi Dimensi Granul Waktu Ekspor DS
File Yang Diproses Pengindeks (byte)

Jumlah total byte data sumber yang diproses oleh pengindeks dari sumber data berbasis file (misalnya Blob, ADLS Gen2, File, SharePoint, OneLake)
DocumentsProcessedBytes Tidak Bytes Total (Jumlah), Rata-rata DataSourceName, IndexerName, IndexName PT1M Ya
Jumlah dokumen yang diproses

Jumlah dokumen yang diproses
DocumentsProcessedCount Tidak Menghitung Total (Keseluruhan), Jumlah DataSourceName, Failed, , IndexerName, IndexNameSkillsetName PT1M Ya
Penggunaan penyimpanan

Penggunaan penyimpanan (teks + vektor) untuk layanan pencarian menurut indeks
IndexStorageUsage Tidak Bytes Rata-rata, Maksimum, Minimum IndexName PT1M Ya
Penggunaan Penyimpanan Vektor

Penggunaan penyimpanan vektor untuk layanan pencarian menurut indeks
IndexVectorUsage Tidak Bytes Rata-rata, Maksimum, Minimum IndexName PT1M Ya
Unit komputasi yang digunakan

Unit komputasi yang digunakan oleh operasi layanan pencarian dan jendela hangat indeks, dalam jam CU mikro (bagi total 1.000.000 untuk mendapatkan jam CU). Filter status tidak digunakan lagi.
PerRequestComputeConsumption Tidak Menghitung Total (Jumlah), Rata-rata Status,IndexName,ResourceKind,EventType PT1M Ya
Latensi Pencarian

Latensi pencarian rata-rata untuk layanan pencarian
SearchLatency Tidak Detik Rata-rata <tidak ada> PT1M Ya
Kueri pencarian per detik

Kueri pencarian per detik untuk layanan pencarian
SearchQueriesPerSecond Tidak HitunganPerDetik Rata-rata <tidak ada> PT1M Ya
Jumlah pemanggilan pelaksanaan kemampuan

Jumlah pelaksanaan keahlian
SkillExecutionCount Tidak Menghitung Total (Keseluruhan), Jumlah DataSourceName, Failed, IndexerName, SkillName, SkillsetName, SkillType PT1M Ya
Persentase kueri pencarian yang terkendala

Persentase kueri pencarian yang dibatasi untuk layanan pencarian
ThrottledSearchQueriesPercentage Tidak Persen Rata-rata <tidak ada> PT1M Ya

Kueri pencarian per detik

Metrik ini menunjukkan rata-rata kueri pencarian per detik (QPS) untuk layanan pencarian. Kueri umum dijalankan dalam milidetik, jadi hanya kueri yang mengukur saat detik muncul dalam metrik seperti QPS. Nilai minimum adalah nilai terendah untuk kueri pencarian per detik yang didaftarkan selama menit tersebut. Maksimum adalah nilai tertinggi. Rata-rata adalah penggabungan untuk seluruh durasi satu menit.

Jenis agregasi Deskripsi
Rata-rata Rata-rata jumlah detik dalam satu menit ketika eksekusi kueri terjadi.
Menghitung Jumlah metrik yang dipancarkan ke log dalam interval satu menit.
Maksimum Jumlah kueri pencarian tertinggi per detik yang terdaftar selama satu menit.
Minimum Jumlah kueri pencarian terendah per detik yang terdaftar selama satu menit.
Jumlah Jumlah seluruh kueri yang diproses dalam waktu satu menit.

Misalnya, dalam satu menit, Anda mungkin memiliki pola seperti ini: satu detik beban tinggi yang merupakan maksimum untuk SearchQueriesPerSecond, diikuti oleh 58 detik beban rata-rata, dan akhirnya satu detik dengan hanya satu kueri, yang merupakan minimum.

Contoh lain: jika simpul memancarkan 100 metrik, di mana nilai setiap metrik adalah 40, maka "Jumlah" adalah 100, "Jumlah" adalah 4000, "Rata-rata" adalah 40, dan "Maks" adalah 40.

Latensi pencarian

Latensi pencarian menunjukkan berapa lama waktu yang dibutuhkan kueri untuk diselesaikan.

Jenis agregasi Latensi
Rata-rata Durasi kueri rata-rata dalam milidetik.
Menghitung Jumlah metrik yang dipancarkan ke log dalam interval satu menit.
Maksimum Kueri yang berlangsung paling lama dalam sampel.
Minimum Kueri terpendek yang berjalan dalam sampel.
Jumlah Total waktu pemrosesan kueri dalam sampel, yang dieksekusi dalam selang waktu (satu menit).

Persentase kueri pencarian yang diatur pembatasannya

Metrik ini mengacu pada kueri yang dihilangkan alih-alih diproses. Pembatasan terjadi ketika jumlah permintaan yang sedang dilakukan melebihi kapasitas. Anda mungkin melihat peningkatan permintaan yang dibatasi saat replika dikeluarkan dari siklus atau selama pengindeksan. Permintaan kueri dan pengindeksan ditangani oleh sekumpulan sumber daya yang sama.

Layanan menentukan apakah akan menghilangkan permintaan berdasarkan konsumsi sumber daya. Persentase sumber daya yang digunakan pada memori, CPU, dan IO disk dirata-ratakan selama jangka waktu tertentu. Jika persentase ini melebihi ambang batas, semua permintaan ke indeks dibatasi hingga volume permintaan berkurang.

Bergantung pada klien Anda, permintaan yang dibatasi ditunjukkan dengan cara berikut:

  • Layanan mengembalikan kesalahan "You are sending too many requests. Please try again later."
  • Layanan mengembalikan kode kesalahan 503 yang menunjukkan layanan saat ini tidak tersedia.
  • Jika Anda menggunakan portal Azure (misalnya, Search Explorer), kueri dihilangkan secara diam-diam dan Anda perlu memilih Search lagi.

Untuk mengonfirmasi kueri yang dibatasi, gunakan metrik Kueri pencarian yang dibatasi . Anda dapat menjelajahi metrik di portal Azure atau membuat metrik pemberitahuan seperti yang dijelaskan dalam artikel ini. Untuk kueri yang dihilangkan dalam interval pengambilan sampel, gunakan Total untuk mendapatkan persentase kueri yang tidak dijalankan.

Jenis agregasi Pembatasan Akses
Rata-rata Persentase kueri yang ditolak dalam interval.
Menghitung Jumlah metrik yang dipancarkan ke log dalam interval satu menit.
Maksimum Persentase kueri yang ditolak dalam interval.
Minimum Persentase kueri yang ditolak dalam interval.
Jumlah Persentase kueri yang ditolak dalam interval.

Untuk Persentase Kueri Pencarian yang Dibatasi, minimum, maksimum, rata-rata, dan total, semuanya memiliki nilai yang sama: persentase kueri pencarian yang dibatasi, dari jumlah total kueri pencarian selama satu menit.

Penggunaan unit komputasi

Metrik ini mengukur sumber daya komputasi, memori, dan I/O yang digunakan oleh layanan Pencarian Azure AI Anda, yang dinyatakan dalam Satuan Komputasi (mCU) mili. Ini berfungsi sebagai proksi untuk biaya pemrosesan dari berbagai jenis operasi. Penggunaan dapat bervariasi dari waktu ke waktu tergantung pada operasi yang dijalankan.

Anda dapat melihat metrik ini pada dua tingkat:

  • Tingkat layanan pencarian: Konsumsi komputasi agregat di seluruh layanan.
  • Tingkat indeks: Konsumsi dilingkup ke indeks tertentu, berguna untuk mengidentifikasi indeks mana yang mendorong penggunaan sumber daya terbanyak.
Jenis agregasi Deskripsi
Jumlah Total mKU yang digunakan selama interval waktu yang dipilih. Berguna untuk memahami biaya komputasi secara keseluruhan dari waktu ke waktu.
Rata-rata Rata-rata mCU yang digunakan selama interval waktu yang dipilih.

Metrik ini mendukung filter berikut:

  • Nama indeks: Memfilter metrik ke indeks tertentu. Jika tidak ada filter yang diterapkan, metrik mencerminkan konsumsi total di semua indeks dalam layanan.

  • Nama operasi: Memfilter metrik menurut operasi yang berkontribusi pada konsumsi komputasi. Jika tidak ada filter yang diterapkan, metrik mencerminkan konsumsi gabungan di semua jenis operasi. Untuk nilai yang didukung, lihat Referensi Data Pemantauan.

Dimensi metrik

Untuk informasi tentang dimensi metrik, lihat Metrik multidimensi.

Pencarian Azure AI memiliki aspek yang terkait dengan metrik berikut yang menghitung jumlah dokumen atau kemampuan yang telah dijalankan.

Nama metrik Deskripsi Dimensi Contoh kasus penggunaan
Jumlah dokumen yang diproses Memperlihatkan jumlah dokumen yang diproses pengindeks. Nama sumber data, gagal, nama indeks, nama pengindeks, nama rangkaian keterampilan Dapat direferensikan sebagai ukuran throughput kasar (jumlah dokumen yang diproses oleh pengindeks dari waktu ke waktu)
- Menyetel peringatan untuk dokumen yang gagal
Jumlah pemanggilan pelaksanaan kemampuan Menunjukkan jumlah invokasi keterampilan. Nama sumber data, gagal, nama indeks, nama pengindeks, nama keterampilan, jenis keterampilan, nama keterampilan Referensi untuk memastikan keterampilan dipanggil seperti yang diharapkan dengan membandingkan jumlah pemanggilan relatif antara keterampilan dan jumlah pemanggilan keterampilan dengan jumlah dokumen.
- Mengatur peringatan pada invokasi keterampilan yang gagal
Penggunaan Unit Komputasi Menampilkan mKU yang digunakan oleh operasi pada layanan pencarian Nama indeks, Operasi Evaluasi operasi mana yang paling banyak menggunakan komputasi.
-Siapkan pemberitahuan saat konsumsi muck melebihi ambang batas yang diharapkan untuk jenis operasi tertentu
Nama dimensi Deskripsi
DataSourceName Koneksi sumber data bernama yang digunakan selama eksekusi pengindeks. Nilai yang valid adalah salah satu jenis sumber data yang didukung.
Gagal Menunjukkan apakah instans gagal.
IndexerName Nama pengindeks.
IndexName Nama indeks.
SkillsetName Nama skillset yang digunakan selama eksekusi pengindeksan.
SkillName Nama keterampilan dalam kumpulan keterampilan.
JenisKeahlian Bagian @odata.type dari keterampilan.

Log sumber daya

Bagian ini mencantumkan jenis log sumber daya yang dapat Anda kumpulkan untuk layanan ini. Bagian ini mengambil informasi dari daftar semua jenis kategori log sumber daya yang didukung di Azure Monitor.

Log sumber daya yang didukung untuk Microsoft. Search/searchServices

Kategori Biaya ekspor Tabel log Mendukung rencana log dasar Mendukung transformasi waktu penyerapan Contoh kueri
OperationLogs Tidak AzureDiagnostics

Catatan log dari beberapa sumber-sumber daya Azure.

Tidak Tidak

Tabel Log Azure Monitor

Bagian ini mencantumkan tabel Azure Monitor Logs yang relevan dengan layanan ini dan tersedia untuk dipertanyakan menggunakan Log Analytics dengan kueri Kusto. Tabel berisi data log sumber daya dan kemungkinan lebih banyak lagi tergantung pada apa yang dikumpulkan dan diarahkan ke tabel tersebut.

Layanan Pencarian

Microsoft.Search/searchServices

Meja Deskripsi
AzureActivity Entri dari log aktivitas Azure memberikan wawasan tentang operasi sarana kontrol. Tugas yang dipanggil pada sarana kontrol, seperti menambahkan atau menghapus replika dan partisi, diwakili melalui aktivitas "Dapatkan Kunci Admin".
AzureDiagnostics Operasi kueri dan pengindeksan yang dicatat. Kueri terhadap tabel AzureDiagnostics di Log Analytics dapat menyertakan properti umum, properti khusus search, dan operasi khusus search yang tercantum di bagian referensi skema.
AzureMetrics Data metrik yang dipancarkan oleh Pencarian Azure AI yang mengukur kesehatan dan performa.

Tabel log sumber daya

Tabel berikut mencantumkan properti log sumber daya di Pencarian Azure AI. Log sumber daya dikumpulkan ke dalam Log Azure Monitor atau Azure Storage. Di Azure Monitor, log dikumpulkan dalam tabel AzureDiagnostics di bawah nama penyedia sumber daya Microsoft.Search.

bidang atau properti Azure Storage Properti Log Azure Monitor Deskripsi
Waktu TIMESTAMP Tanggal dan waktu (UTC) ketika operasi terjadi.
resourceId Concat("/", "/subscriptions", SubscriptionId, "resourceGroups", ResourceGroupName, "providers/Microsoft.Search/searchServices", ServiceName) Sumber daya Pencarian Azure AI yang lognya telah diaktifkan.
kategori "OperationLogs" Kategori log meliputi Audit, , OperationalExecution, dan Request.
operationName Nama Nama operasi. Nama operasi dapat berupa Indexes.ListIndexStatsSummaries, Indexes.Get, Indexes.Stats, Indexers.List, Query.Search, Query.Suggest, Query.Lookup, Query.Autocomplete, CORS.Preflight, Indexes.Update, Indexes.Prototype, ServiceStats, DataSources.List, Indexers.Warmup
durationMS DurasiMilidetik Durasi operasi, dalam milidetik.
versiOperasi ApiVersion Versi API yang digunakan pada permintaan.
jenisHasil (Gagal) ? "Gagal" : "Berhasil" Jenis respons.
hasilTandaTangan Status Status respons HTTP dari operasi.
Properti Properti Semua properti ekstensi yang terkait dengan kategori acara ini.

Log aktivitas

Tabel tertaut menyebutkan operasi yang dapat dicatat dalam catatan aktivitas untuk layanan ini. Operasi ini adalah bagian dari semua kemungkinan operasi penyedia sumber daya dalam log aktivitas.

Untuk informasi selengkapnya tentang skema entri log aktivitas, lihat Skema Log Aktivitas.

Tabel berikut ini mencantumkan operasi umum yang terkait dengan Pencarian Azure AI yang mungkin dicatat dalam log aktivitas. Untuk daftar lengkap semua Microsoft. Operasi pencarian, lihat Microsoft. Operasi penyedia sumber daya pencarian.

Operasi Deskripsi
Dapatkan Kunci Admin Setiap operasi yang memerlukan hak administratif dicatat sebagai operasi "Dapatkan Kunci Admin".
Dapatkan Kunci Kueri Setiap operasi baca-saja terhadap kumpulan dokumen dari suatu indeks.
Meregenerasi Kunci Admin Permintaan untuk meregenerasi kunci API admin utama atau sekunder.

Entri umum termasuk 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 butir ini, Anda harus mengonfigurasi pengelogan sumber daya.

Atau, Anda mungkin mendapatkan beberapa wawasan melalui riwayat perubahan. Di portal Azure, pilih aktivitas untuk membuka halaman detail lalu pilih "Ubah riwayat" untuk informasi tentang operasi yang mendasar.

Skema lainnya

Skema berikut sedang digunakan untuk layanan ini.

Jika Anda membangun kueri atau laporan kustom, struktur data yang berisi log sumber daya Pencarian Azure AI sesuai dengan skema berikut.

Untuk log sumber daya yang dikirim ke penyimpanan blob, setiap blob memiliki satu objek akar yang disebut rekaman yang berisi array objek log. Setiap blob berisi rekaman untuk semua operasi yang berlangsung selama jam yang sama.

Skema log sumber daya

Semua log sumber daya yang tersedia melalui Azure Monitor berbagi skema tingkat atas common. Pencarian Azure AI dilengkapi dengan lebih banyak properti dan operasi yang unik untuk layanan pencarian.

Contoh berikut mengilustrasikan log sumber daya yang mencakup properti umum (TimeGenerated, Resource, Category, dan sebagainya) dan properti khusus pencarian (OperationName dan OperationVersion).

Nama Jenis Deskripsi dan contoh
TimeGenerated Tanggal dan Waktu Tanda waktu operasi. Sebagai contoh: 2021-12-07T00:00:43.6872559Z
Sumber daya String ID Sumber Daya. Sebagai contoh: /subscriptions/<your-subscription-id>/resourceGroups/<your-resource-group-name>/providers/Microsoft.Search/searchServices/<your-search-service-name>
Kategori String "OperationLogs". Nilai ini adalah konstanta. OperationLogs adalah satu-satunya kategori yang digunakan untuk log sumber daya.
OperationName String Nama operasi (lihat daftar lengkap operasi). Contohnya adalah Query.Search
VersiOperasi String Versi api yang digunakan pada permintaan. Sebagai contoh: 2026-04-01
TipeHasil String "Sukses". Nilai lain yang mungkin: Berhasil atau Gagal
ResultSignature Int Kode hasil HTTP. Sebagai contoh: 200
DurasiMS Int Durasi operasi dalam milidetik.
Properti Objek Objek yang berisi data khusus operasi. Lihat tabel skema properti berikut ini.

Skema properti

Properti berikut ini khusus untuk Pencarian Azure AI.

Nama Jenis Deskripsi dan contoh
Deskripsi_s String Titik akhir operasi. Sebagai contoh: GET /indexes('content')/docs
Dokumen_d Int Jumlah dokumen yang diproses.
IndexName_s String Nama indeks yang terkait dengan operasi.
Query_s String Parameter kueri yang digunakan dalam permintaan. Sebagai contoh: ?search=beach access&$count=true&api-version=2026-04-01

Nilai OperationName (operasi yang dicatat)

Operasi berikut dapat muncul di log sumber daya.

OperationName Deskripsi
DataSources.* Berlaku untuk sumber data pengindeks. Bisa Buat, Hapus, Dapatkan, Daftar.
DebugSessions.* Berlaku untuk sesi debug. Dapat berupa Buat, Hapus, Dapatkan, Daftar, Mulai, dan Status.
DebugSessions.DocumentStructure Dokumen yang diperkaya dimuat ke dalam sesi debug.
DebugSessions.RetrieveIndexerExecutionHistoricalData Permintaan untuk detail eksekusi pengindeksan.
DebugSessions.RetrieveProjectedIndexerExecutionHistoricalData Riwayat eksekusi untuk pengayaan yang diprogramkan ke dalam basis pengetahuan.
Pengindeks.* Berlaku untuk pengindeks. Dapat berupa Buat, Hapus, Dapatkan, Daftar, dan Status.
Indeks.* Berlaku untuk indeks pencarian. Bisa Buat, Hapus, Dapatkan, Daftar.
Indeks. Prototipe Metadata indeks ditentukan oleh wizard Impor data berdasarkan input data.
Pengindeksan.Indeks Operasi ini adalah panggilan ke Dokumen Indeks.
Metadata.GetMetadata Permintaan untuk data sistem layanan pencarian.
Query.Autocomplete Kueri pelengkapan otomatis pada indeks. Lihat Jenis dan komposisi kueri.
Query.Lookup Kueri pencarian terhadap indeks. Lihat Jenis dan komposisi kueri.
Query.Search Permintaan pencarian teks lengkap terhadap indeks. Lihat Jenis dan komposisi kueri.
Query.Suggest Ketik kueri di depan terhadap indeks. Lihat Jenis dan komposisi kueri.
ServiceStats Operasi ini adalah panggilan rutin ke Dapatkan Statistik Layanan, baik yang dipanggil secara langsung atau implisit untuk mengisi halaman gambaran umum portal saat dimuat atau disegarkan.
Set keterampilan.* Berlaku untuk keterampilan. Bisa Buat, Hapus, Dapatkan, Daftar.