Azure Cognitive Search referensi data pemantauan
Artikel ini menyediakan referensi data log dan metrik yang dikumpulkan untuk menganalisis performa dan ketersediaan Azure Cognitive Search. Lihat Memantau Azure Cognitive Search untuk gambaran umum.
Metrik
Bagian ini mencantumkan metrik platform yang dikumpulkan untuk Azure Cognitive Search (Microsoft.Search/searchServices).
| ID metrik | Unit | Deskripsi |
|---|---|---|
| DocumentsProcessedCount | Jumlah | Total jumlah dokumen yang berhasil diproses dalam operasi pengindeksan (baik oleh pengindeks atau dengan mendorong dokumen secara langsung). |
| SearchLatency | Detik | Latensi pencarian rata-rata untuk kueri yang dijalankan pada layanan pencarian. |
| SearchQueriesPerSecond | CountPerSecond | Rata-rata kueri pencarian per detik (QPS) untuk layanan pencarian. Kueri biasanya dijalankan dalam milidetik, jadi hanya kueri yang mengukur sebagai detik yang akan muncul dalam metrik seperti QPS. Nilai minimum adalah nilai terendah untuk kueri pencarian per detik yang didaftarkan selama menit tersebut. Hal yang sama berlaku untuk nilai maksimum. Rata-rata adalah agregat sepanjang menit. Misalnya, dalam satu menit, Anda mungkin memiliki pola seperti ini: satu detik dari 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. |
| SkillExecutionCount | Jumlah | Jumlah total eksekusi keterampilan yang diproses selama operasi pengindeks. |
| ThrottledSearchQueriesPercentage | Persen | Persentase rata-rata kueri pencarian yang dibatasi dari jumlah total kueri pencarian yang dijalankan selama interval satu menit. |
Untuk referensi, lihat daftar semua metrik platform yang didukung di Azure Monitor.
Dimensi metrik
Dimensi metrik adalah pasangan nama/nilai yang membawa data tambahan untuk menggambarkan nilai metrik. Azure Cognitive Search memiliki dimensi berikut yang terkait dengan metriknya yang menangkap jumlah dokumen atau keterampilan yang dijalankan ("Jumlah yang diproses dokumen" dan "Jumlah pemanggilan eksekusi keterampilan").
| 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 set keterampilan yang digunakan selama eksekusi pengindeks. |
| SkillName | Nama keterampilan dalam set keterampilan. |
| SkillType | Dari @odata.type keterampilan. |
Untuk informasi selengkapnya tentang definisi dimensi metrik, lihat Metrik multidimensi.
Log sumber daya
Log sumber daya adalah log platform yang memberikan wawasan tentang operasi yang dilakukan dalam sumber daya Azure. Log sumber daya dihasilkan oleh layanan pencarian secara otomatis, tetapi tidak dikumpulkan secara default. Anda harus membuat pengaturan diagnostik untuk mengirim log sumber daya ke ruang kerja Analitik Log untuk digunakan dengan Log Azure Monitor, Azure Event Hubs untuk meneruskan ke luar Azure, atau ke Azure Storage untuk pengarsipan.
Bagian ini mengidentifikasi jenis (atau kategori) log sumber daya yang dapat Anda kumpulkan untuk Azure Cognitive Search:
- Log sumber daya dikelompokkan menurut jenis (atau kategori). Azure Cognitive Search menghasilkan log sumber daya di bawah kategori Operasi.
Sebagai referensi, lihat daftar semua jenis kategori log sumber daya yang didukung di Azure Monitor.
Tabel log Azure Monitor
Azure Monitor Logs adalah fitur Azure Monitor yang mengumpulkan dan mengatur data log dan performa dari sumber daya yang dipantau. Jika Anda mengonfigurasi pengaturan diagnostik untuk Analitik Log, Anda dapat mengkueri tabel Log Azure Monitor untuk log sumber daya yang dihasilkan oleh Azure Cognitive Search.
Bagian ini mengacu pada semua tabel Kusto Log Azure Monitor yang relevan dengan Azure Cognitive Search dan tersedia untuk kueri oleh Log Analytics dan Metrics Explorer di portal Azure.
| Tabel | Deskripsi |
|---|---|
| AzureActivity | Entri dari log Aktivitas Azure yang memberikan wawasan tentang operasi sarana kontrol. Tugas yang dipanggil pada sarana kontrol, seperti menambahkan atau menghapus replika dan partisi, akan diwakili melalui aktivitas "Dapatkan Kunci Admin". |
| AzureDiagnostics | Operasi kueri dan pengindeksan yang dicatat. |
| AzureMetrics | Data metrik yang dipancarkan oleh Azure Cognitive Search yang mengukur kesehatan dan performa. |
Untuk referensi semua tabel Log Azure Monitor / Log Analytics, lihat Referensi Tabel Log Azure Monitor.
Tabel diagnostik
Azure Cognitive Search menggunakan tabel Diagnostik Azure untuk mengumpulkan log sumber daya yang terkait dengan kueri dan pengindeksan pada layanan pencarian Anda.
Kueri terhadap tabel ini di Analitik Log dapat menyertakan properti umum, properti khusus pencarian, dan operasi khusus pencarian yang tercantum di bagian referensi skema.
Untuk contoh kueri Kusto yang berguna untuk Azure Cognitive Search, lihat Memantau Azure Cognitive Search dan Menganalisis performa di Azure Cognitive Search.
Log aktivitas
Tabel berikut ini mencantumkan operasi umum yang terkait dengan Azure Cognitive Search yang mungkin dibuat di log Aktivitas Azure.
| Operasi | Deskripsi |
|---|---|
| Dapatkan Kunci Admin | Setiap operasi yang memerlukan hak administratif akan 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 primer 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.
Untuk informasi selengkapnya tentang skema entri Log Aktivitas, lihat Skema Log Aktivitas.
Schemas
Skema berikut sedang digunakan oleh Azure Cognitive Search. Jika Anda membuat kueri atau laporan kustom, struktur data yang berisi log sumber daya Azure Cognitive Search sesuai dengan skema di bawah ini.
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 umum. Azure Cognitive Search suplemen dengan properti dan operasitambahan 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 | 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 di bawah). Contohnya adalah Query.Search |
| OperationVersion | String | Versi api yang digunakan pada permintaan. Misalnya: 2020-06-30 |
| ResultType | String | "Sukses". Nilai lain yang mungkin: Berhasil atau Gagal |
| ResultSignature | Int | Kode hasil HTTP. Misalnya: 200 |
| DurationMS | Int | Durasi operasi dalam milidetik. |
| Properti | Objek | Objek yang berisi data khusus operasi. Lihat tabel skema properti berikut ini. |
Skema properti
Properti di bawah ini khusus untuk Azure Cognitive Search.
| Nama | Jenis | 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=2020-06-30 |
Nilai OperationName (operasi yang dicatat)
Operasi di bawah ini dapat muncul di log sumber daya.
| OperationName | Deskripsi |
|---|---|
| DataSources.* | Berlaku untuk sumber data pengindeks. Dapat berupa 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. Dapat berupa Buat, Hapus, Dapatkan, Daftar. |
| indexes.Prototype | Ini merupakan indeks yang dibuat oleh wizard Import Data. |
| Indexing.Index | Operasi ini adalah perintah untuk Menambahkan, Memperbarui, atau Menghapus Dokumen. |
| 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 perintah rutin untuk Mendapatkan Statistik Layanan, baik diperintahkan secara langsung atau implisit untuk mengisi halaman gambaran umum portal ketika dimuat atau di-refresh. |
| Set keterampilan.* | Berlaku untuk set keterampilan. Dapat berupa Buat, Hapus, Dapatkan, Daftar. |
Lihat juga
Lihat Memantau Azure Cognitive Search untuk konsep dan instruksi.
Lihat Memantau sumber daya Azure dengan Azure Monitor untuk detail tentang memantau sumber daya Azure.