Referensi data pemantauan Azure AI Search
Artikel ini berisi semua informasi referensi pemantauan untuk layanan ini.
Lihat Memantau Azure AI Search untuk detail tentang data yang bisa Anda kumpulkan untuk Azure AI Search dan cara menggunakannya.
Bagian ini mencantumkan semua metrik platform yang dikumpulkan secara otomatis untuk layanan ini. Metrik ini juga merupakan bagian dari daftar global semua metrik platform yang didukung di Azure Monitor.
Untuk informasi tentang retensi metrik, lihat Gambaran umum Metrik Azure Monitor.
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 menampilkan semua kolom yang tersedia.
Judul tabel
- Kategori - Grup metrik atau klasifikasi.
- Metrik - Nama tampilan metrik seperti yang muncul di portal Azure.
- Nama di REST API - Nama metrik seperti yang disebutkan dalam REST API.
- Unit - Satuan ukuran.
- Agregasi - Jenis agregasi default. Nilai yang valid: Rata-rata (Rata-rata), Minimum (Min), Maksimum (Maks), Total (Jumlah), Hitungan.
- Dimensi dimensi - tersedia untuk metrik.
-
Interval Butir - Waktu tempat metrik diambil sampelnya. Misalnya,
PT1Mmenunjukkan bahwa metrik diambil sampelnya setiap menit,PT30Msetiap 30 menit,PT1Hsetiap jam, dan sebagainya. - Ekspor DS- Apakah metrik dapat diekspor ke Log Azure Monitor melalui pengaturan diagnostik. Untuk informasi tentang mengekspor metrik, lihat Membuat pengaturan diagnostik di Azure Monitor.
| Metrik | Nama dalam REST API | Unit | Agregasi | Dimensi | Butir Waktu | Ekspor DS |
|---|---|---|---|---|---|---|
|
Jumlah yang diproses dokumen Jumlah dokumen yang diproses |
DocumentsProcessedCount |
Hitung | Total (Jumlah), Jumlah |
DataSourceName, , FailedIndexerName, , IndexName,SkillsetName |
PT1M | Ya |
|
Latensi Pencarian Latensi pencarian rata-rata untuk layanan pencarian |
SearchLatency |
Detik | Tengah | <Tidak ada> | PT1M | Ya |
|
Kueri pencarian per detik Kueri pencarian per detik untuk layanan pencarian |
SearchQueriesPerSecond |
CountPerSecond | Tengah | <Tidak ada> | PT1M | Ya |
|
Jumlah pemanggilan eksekusi keterampilan Jumlah eksekusi keterampilan |
SkillExecutionCount |
Hitung | Total (Jumlah), Jumlah |
DataSourceName, , FailedIndexerName, SkillName, , SkillsetName,SkillType |
PT1M | Ya |
|
Persentase kueri pencarian yang dibatasi Persentase kueri pencarian yang dibatasi untuk layanan pencarian |
ThrottledSearchQueriesPercentage |
Persen | Tengah | <Tidak ada> | PT1M | Ya |
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 agregat sepanjang menit.
| Jenis agregasi | Deskripsi |
|---|---|
| Tengah | Jumlah rata-rata detik dalam satu menit saat eksekusi kueri terjadi. |
| Hitung | Jumlah metrik yang dipancarkan ke log dalam interval satu menit. |
| Maksimum | Jumlah pencarian kueri tertinggi per detik yang didaftarkan selama satu menit. |
| Minimum | Jumlah pencarian kueri terendah per detik yang didaftarkan selama satu menit. |
| Jumlah total | Jumlah total semua kueri yang dieksekusi dalam menit. |
Contohnya, dalam satu menit, Anda mungkin memiliki pola seperti ini: satu detik dari beban tinggi yang merupakan nilai maksimum untuk SearchQueriesPerSecond, diikuti oleh 58 detik beban rata-rata, dan akhirnya satu detik dengan hanya satu kueri, yang merupakan nilai minimum.
Contoh lain: jika node memancarkan 100 metrik, saat nilai setiap metrik adalah 40, maka "Jumlah" adalah 100, "Jumlah total" adalah 4000, "Rata-rata" adalah 40, dan "Maksimum" adalah 40.
Latensi pencarian menunjukkan berapa lama waktu yang dibutuhkan kueri untuk diselesaikan.
| Jenis agregasi | Latensi |
|---|---|
| Tengah | Durasi kueri rata-rata dalam milidetik. |
| Hitung | Jumlah metrik yang dipancarkan ke log dalam interval satu menit. |
| Maksimum | Kueri terlama dalam sampel. |
| Minimum | Kueri terpendek dalam sampel. |
| Total | Total waktu eksekusi semua kueri dalam sampel, dieksekusi dalam interval (satu menit). |
Metrik ini mengacu pada kueri yang dihilangkan alih-alih diproses. Pembatasan terjadi ketika jumlah permintaan dalam eksekusi melebihi kapasitas. Anda mungkin melihat peningkatan permintaan yang dibatasi saat replika diambil dari rotasi atau selama pengindeksan. Permintaan kueri dan pengindeksan ditangani oleh set sumber daya yang sama.
Layanan ini menentukan apakah akan menghilangkan permintaan berdasarkan konsumsi sumber daya atau tidak. Persentase sumber daya yang dikonsumsi di seluruh memori, CPU, dan IO disk dirata-ratakan selama periode waktu tertentu. Jika persentase ini melebihi ambang batas, semua permintaan ke indeks akan dibatasi hingga volume permintaan dikurangi.
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 bahwa saat ini layanan tidak tersedia.
- Jika Anda menggunakan portal Azure (misalnya, Search Explorer), kueri dihilangkan secara diam-diam dan Anda perlu memilih Cari 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 |
|---|---|
| Tengah | Persentase kueri yang dihilangkan dalam interval. |
| Hitung | Jumlah metrik yang dipancarkan ke log dalam interval satu menit. |
| Maksimum | Persentase kueri yang dihilangkan dalam interval. |
| Minimum | Persentase kueri yang dihilangkan dalam interval. |
| Total | Persentase kueri yang dihilangkan 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.
Untuk informasi tentang dimensi metrik apa itu, lihat Metrik multi-dimensi.
Azure AI Search memiliki dimensi yang terkait dengan metrik berikut yang menangkap hitungan dokumen atau keterampilan yang dijalankan.
| Nama metrik | Deskripsi | Dimensi | Contoh kasus penggunaan |
|---|---|---|---|
| Jumlah yang diproses dokumen | Memperlihatkan jumlah dokumen yang diproses pengindeks. | Nama sumber data, gagal, nama indeks, nama pengindeks, nama set keterampilan | Dapat direferensikan sebagai ukuran throughput kasar (jumlah dokumen yang diproses oleh pengindeks dari waktu ke waktu) - Menyiapkan pemberitahuan pada dokumen yang gagal |
| Jumlah pemanggilan eksekusi keterampilan | Menunjukkan jumlah pemanggilan 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. - Menyiapkan untuk memperingatkan pada pemanggilan keterampilan yang gagal |
| 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 pengindeks. |
| SkillName | Nama keterampilan dalam set keterampilan. |
| SkillType | Dari @odata.type keterampilan. |
Bagian ini mencantumkan jenis log sumber daya yang dapat Anda kumpulkan untuk layanan ini. Bagian menarik dari daftar semua jenis kategori log sumber daya yang didukung di Azure Monitor.
| Kategori | Nama tampilan kategori | Tabel log | Mendukung rencana log dasar | Mendukung transformasi waktu penyerapan | Contoh kueri | Biaya untuk diekspor |
|---|---|---|---|---|---|---|
OperationLogs |
Log Operasi |
AzureDiagnostics Log dari beberapa sumber daya Azure. |
Tidak | No | Tidak |
Bagian ini mencantumkan tabel Log Azure Monitor yang relevan dengan layanan ini, yang tersedia untuk kueri oleh Analitik Log menggunakan kueri Kusto. Tabel berisi data log sumber daya dan mungkin lebih bergantung pada apa yang dikumpulkan dan dirutekan ke dalamnya.
Microsoft.Search/searchServices
| Table | 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 Analitik Log dapat menyertakan properti umum, properti khusus pencarian, dan operasi khusus pencarian yang tercantum di bagian referensi skema. |
| AzureMetrics | Data metrik yang dipancarkan oleh Azure AI Search yang mengukur kesehatan dan performa. |
Tabel berikut ini mencantumkan properti log sumber daya di Azure AI Search. Log sumber daya dikumpulkan ke dalam Azure Monitor Logs atau Penyimpanan Azure. Di Azure Monitor, log dikumpulkan dalam tabel AzureDiagnostics di bawah nama Microsoft.Searchpenyedia sumber daya .
| Bidang atau properti Penyimpanan Azure | Solusi log Azure Monitor | Deskripsi |
|---|---|---|
| waktu | TANDA WAKTU | Tanggal dan waktu (UTC) ketika operasi terjadi. |
| resourceId | Concat("/", "/subscriptions", SubscriptionId, "resourceGroups", ResourceGroupName, "providers/Microsoft.Search/searchServices", ServiceName) | Sumber daya Azure AI Search tempat log diaktifkan. |
| category | "OperationLogs" | Kategori log meliputi Audit, , ExecutionOperational, dan Request. |
| operationName | Nama | Nama operasi. Nama operasi dapat berupa Indexes.ListIndexStatsSummaries, , Indexes.Get, Indexes.Stats, Indexers.List, Query.SearchQuery.Suggest, Query.Lookup, Query.Autocomplete, CORS.Preflight, Indexes.Update, Indexes.Prototype, ServiceStats, DataSources.List, . Indexers.Warmup |
| durationMs | DurationMilliseconds | Durasi operasi, dalam milidetik. |
| operationVersion | ApiVersion | Versi API yang digunakan pada permintaan. |
| resultType | (Gagal) ? "Gagal" : "Berhasil" | Jenis respons. |
| resultSignature | Status | Status respons HTTP operasi. |
| properti | Properti | Semua properti tambahan yang terkait dengan kategori peristiwa ini. |
Tabel tertaut mencantumkan operasi yang dapat direkam dalam log aktivitas untuk layanan ini. Operasi ini adalah subset 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 direkam dalam log aktivitas. Untuk daftar lengkap semua operasi Microsoft.Search, lihat Operasi penyedia sumber daya Microsoft.Search.
| 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 indeks. |
| Meregenerasi Kunci Admin | Permintaan untuk meregenerasi kunci API admin utama atau sekunder. |
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 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 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.
Semua log sumber daya yang tersedia melalui Azure Monitor berbagi skema tingkat atas umum. Azure AI Search melengkapi 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 | Tipe | Deskripsi dan contoh |
|---|---|---|
| TimeGenerated | Tanggalwaktu | Tanda waktu operasi. Misalnya: 2021-12-07T00:00:43.6872559Z |
| Sumber daya | String | ID Sumber Daya. Misalnya: /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 |
| OperationVersion | String | Versi api yang digunakan pada permintaan. Misalnya: 2024-07-01 |
| ResultType | String | "Sukses". Nilai lain yang mungkin: Berhasil atau Gagal |
| ResultSignature | Int | Kode hasil HTTP. Misalnya: 200 |
| Durasi | Int | Durasi operasi dalam milidetik. |
| Properti | Objek | Objek yang berisi data khusus operasi. Lihat tabel skema properti berikut ini. |
Properti berikut ini khusus untuk Azure AI Search.
| Nama | Tipe | Deskripsi dan contoh |
|---|---|---|
| Description_s | String | Titik akhir operasi. Misalnya: GET /indexes('content')/docs |
| Documents_d | Int | Jumlah dokumen yang diproses. |
| IndexName_s | String | Nama indeks yang terkait dengan operasi. |
| Query_s | String | Parameter kueri yang digunakan dalam permintaan. Misalnya: ?search=beach access&$count=true&api-version=2024-07-01 |
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 pengindeks. |
| DebugSessions.RetrieveProjectedIndexerExecutionHistoricalData | Riwayat eksekusi untuk pengayaan yang diproyeksikan ke penyimpanan pengetahuan. |
| Pengindeks.* | Berlaku untuk pengindeks. Dapat berupa Buat, Hapus, Dapatkan, Daftar, dan Status. |
| Indeks.* | Berlaku untuk indeks pencarian. Bisa Buat, Hapus, Dapatkan, Daftar. |
| indexes.Prototype | Indeks ini dibuat oleh wizard Impor Data. |
| Indexing.Index | Operasi ini adalah panggilan ke Dokumen Indeks. |
| Metadata.GetMetadata | Permintaan untuk data sistem layanan pencarian. |
| Query.Autocomplete | Kueri lengkapi otomatis terhadap 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. |
| Skillsets.* | Berlaku untuk set keterampilan. Bisa Buat, Hapus, Dapatkan, Daftar. |
- Lihat Memantau Pencarian Azure AI untuk deskripsi pemantauan Azure AI Search.
- Lihat Memantau sumber daya Azure dengan Azure Monitor untuk detail tentang memantau sumber daya Azure.