Referenční informace k datům monitorování služby Azure AI Search
Tento článek obsahuje všechny referenční informace o monitorování pro tuto službu.
Metriky
V této části jsou uvedeny všechny automaticky shromážděné metriky platformy pro tuto službu. Tyto metriky jsou také součástí globálního seznamu všech metrik platformy podporovaných ve službě Azure Monitor.
Informace o uchovávání metrik najdete v přehledu metrik služby Azure Monitor.
Podporované metriky pro Microsoft.Search/searchServices
Následující tabulka uvádí metriky dostupné pro typ prostředku Microsoft.Search/searchServices.
- Všechny sloupce nemusí být v každé tabulce.
- Některé sloupce můžou být mimo oblast zobrazení stránky. Výběrem možnosti Rozbalit tabulku zobrazíte všechny dostupné sloupce.
Záhlaví tabulky
- Kategorie – skupina metrik nebo klasifikace.
- Metrika – zobrazovaný název metriky, jak se zobrazuje na webu Azure Portal.
- Název v rozhraní REST API – název metriky, který se označuje v rozhraní REST API.
- Jednotka – měrná jednotka .
- Agregace – výchozí typ agregace . Platné hodnoty: Průměr (Průměr), Minimum (Minimum), Maximum (Maximum), Celkem (Součet), Počet.
- - Dimenze dostupné pro metriku
- Intervaly časových zrn - , ve kterých se metrika vzorkuje. Například označuje,
PT1Mže se metrika vzorkuje každou minutu,PT30Mkaždých 30 minut,PT1Hkaždou hodinu atd. - DS Export – určuje, jestli je metrika exportovatelná do protokolů služby Azure Monitor prostřednictvím nastavení diagnostiky. Informace o exportu metrik najdete v tématu Vytvoření nastavení diagnostiky ve službě Azure Monitor.
| Metrika | Název v rozhraní REST API | Unit | Agregace | Dimenze | Časová zrnka | DS Export |
|---|---|---|---|---|---|---|
| Počet zpracovaných dokumentů Počet zpracovaných dokumentů |
DocumentsProcessedCount |
Počet | Total (Sum), Count | DataSourceName, Failed, IndexerName, , IndexNameSkillsetName |
PT1M | Ano |
| Latence vyhledávání Průměrná latence vyhledávání vyhledávací služby |
SearchLatency |
Sekundy | Průměr | <žádné> | PT1M | Ano |
| Vyhledávací dotazy za sekundu Vyhledávací dotazy za sekundu pro vyhledávací službu |
SearchQueriesPerSecond |
CountPerSecond | Průměr | <žádné> | PT1M | Ano |
| Počet vyvolání dovedností Počet provádění dovedností |
SkillExecutionCount |
Počet | Total (Sum), Count | DataSourceName, Failed, IndexerName, SkillName, , SkillsetNameSkillType |
PT1M | Ano |
| Procento omezených vyhledávacích dotazů Procento omezených vyhledávacích dotazů pro vyhledávací službu |
ThrottledSearchQueriesPercentage |
Procenta | Průměr | <žádné> | PT1M | Ano |
Vyhledávací dotazy za sekundu
Tato metrika zobrazuje průměr vyhledávacích dotazů za sekundu (QPS) vyhledávací služby. Běžně se dotazy spouštějí v milisekundách, takže se v metrikě, jako je QPS, zobrazují jenom dotazy, které měří jako sekundy. Minimum je nejnižší hodnota pro vyhledávací dotazy za sekundu, která byla zaregistrována během této minuty. Maximum je nejvyšší hodnota. Průměr je agregace za celou minutu.
| Typ agregace | Popis |
|---|---|
| Průměr | Průměrný počet sekund během minuty, během které došlo k provedení dotazu. |
| Počet | Počet metrik vygenerovaných do protokolu v intervalu jedné minuty. |
| Maximum | Nejvyšší počet vyhledávacích dotazů za sekundu zaregistrovaných během minuty. |
| Minimum | Nejnižší počet vyhledávacích dotazů za sekundu zaregistrovaných během minuty. |
| Sum | Součet všech dotazů provedených během minuty |
Například během jedné minuty můžete mít vzor podobný tomuto: jednu sekundu vysokého zatížení, což je maximum pro SearchQueriesPerSecond, následované 58 sekundami průměrného zatížení a nakonec jednu sekundu s jediným dotazem, což je minimum.
Jiný příklad: Pokud uzel generuje 100 metrik, kde hodnota každé metriky je 40, pak hodnota Count je 100, Sum je 4000, Průměr je 40 a Maximum je 40.
Latence vyhledávání
Latence vyhledávání udává, jak dlouho trvá dokončení dotazu.
| Typ agregace | Latence |
|---|---|
| Průměr | Průměrná doba trvání dotazu v milisekundách |
| Počet | Počet metrik vygenerovaných do protokolu v intervalu jedné minuty. |
| Maximum | Nejdéle běžící dotaz v ukázce. |
| Minimum | Nejkratší spuštěný dotaz v ukázce |
| Celkem | Celková doba provádění všech dotazů v ukázce, která se provádí v intervalu (jedna minuta). |
Procento omezených vyhledávacích dotazů
Tato metrika odkazuje na dotazy, které se místo zpracování zahodí. K omezování dochází v případě, že počet požadavků při provádění překročí kapacitu. Při vyřazení repliky z rotace nebo během indexování se může zobrazit zvýšení počtu omezených požadavků. Požadavky na dotazy i indexování se zpracovávají stejnou sadou prostředků.
Služba určuje, jestli se mají požadavky odstraňovat na základě spotřeby prostředků. Procento prostředků spotřebovaných v paměti, procesoru a vstupně-výstupních operacích disku se v průběhu časového období průměruje. Pokud toto procento překročí prahovou hodnotu, omezí se všechny požadavky na index, dokud se nezmenší objem požadavků.
V závislosti na vašem klientovi se omezený požadavek označuje těmito způsoby:
- Služba vrátí chybu.
"You are sending too many requests. Please try again later." - Služba vrátí kód chyby 503 označující, že služba je momentálně nedostupná.
- Pokud používáte Web Azure Portal (například Průzkumník služby Search), dotaz se zahodí bezobslužně a budete muset znovu vybrat Hledat .
Pokud chcete potvrdit omezené dotazy, použijte metriku omezených vyhledávacích dotazů. Metriky můžete prozkoumat na webu Azure Portal nebo vytvořit metriku upozornění, jak je popsáno v tomto článku. U dotazů, které byly vyřazeny v intervalu vzorkování, použijte součet k získání procenta dotazů, které se nespustily.
| Typ agregace | Omezování |
|---|---|
| Průměr | Procento vyřazených dotazů v intervalu |
| Počet | Počet metrik vygenerovaných do protokolu v intervalu jedné minuty. |
| Maximum | Procento vyřazených dotazů v intervalu |
| Minimum | Procento vyřazených dotazů v intervalu |
| Celkem | Procento vyřazených dotazů v intervalu |
U omezených vyhledávacích dotazů v procentech, minimálním, maximálním, průměrném a celkovém počtu mají všechny stejné hodnoty: procento omezených vyhledávacích dotazů z celkového počtu vyhledávacích dotazů během jedné minuty.
Rozměry metrik
Informace o rozměrech metrik najdete v tématu Vícerozměrné metriky.
Azure AI Search má přidružené dimenze k následujícím metrikám, které zachycují počet spuštěných dokumentů nebo dovedností.
| Název metriky | Popis | Dimenze | Příklady případů použití |
|---|---|---|---|
| Počet zpracovaných dokumentů | Zobrazuje počet zpracovaných dokumentů indexeru. | Název zdroje dat, selhání, název indexu, název indexeru, název sady dovedností | Lze na ně odkazovat jako na přibližnou míru propustnosti (počet dokumentů zpracovaných indexerem v průběhu času). – Nastavení upozornění na neúspěšné dokumenty |
| Počet vyvolání dovedností | Zobrazuje počet vyvolání dovedností. | Název zdroje dat, selhal, název indexu, název indexeru, název dovednosti, typ dovednosti, název sady dovedností | Odkaz na zajištění toho, aby se dovednosti vyvolávaly podle očekávání porovnáním relativních čísel volání mezi dovednostmi a počtem vyvolání dovedností s počtem dokumentů. – Nastavení upozornění na neúspěšné vyvolání dovedností |
| Název dimenze | Popis |
|---|---|
| DataSourceName | Pojmenované připojení ke zdroji dat použité při provádění indexeru. Platné hodnoty jsou jedním z podporovaných typů zdrojů dat. |
| Neúspěch | Určuje, jestli instance selhala. |
| IndexerName | Název indexeru |
| Název indexu | Název indexu |
| SkillsetName | Název sady dovedností používané při provádění indexeru |
| SkillName | Název dovednosti v rámci sady dovedností. |
| SkillType | Dovednost @odata.type . |
Protokoly prostředků
Tato část obsahuje seznam typů protokolů prostředků, které můžete pro tuto službu shromažďovat. Oddíl načítá ze seznamu všech typů protokolů prostředků podporovaných ve službě Azure Monitor.
Podporované protokoly prostředků pro Microsoft.Search/searchServices
| Kategorie | Zobrazovaný název kategorie | Tabulka protokolů | Podporuje základní plán protokolu. | Podporuje transformaci v čase příjmu dat. | Vzorové dotazy | Náklady na export |
|---|---|---|---|---|---|---|
OperationLogs |
Protokoly operací | AzureDiagnostics Protokoly z několika prostředků Azure. |
No | No | Ne |
Tabulky protokolů služby Azure Monitor
Tato část uvádí tabulky protokolů služby Azure Monitor relevantní pro tuto službu, které jsou k dispozici pro dotazování službou Log Analytics pomocí dotazů Kusto. Tabulky obsahují data protokolu prostředků a případně i více v závislosti na tom, co se na nich shromažďuje a směruje.
Vyhledávací služby
Microsoft.Search/searchServices
| Table | Popis |
|---|---|
| AzureActivity | Položky z protokolu aktivit Azure poskytují přehled o operacích roviny řízení. Úlohy vyvolané v řídicí rovině, jako je přidání nebo odebrání replik a oddílů, jsou reprezentovány prostřednictvím aktivity Získat klíč správce. |
| AzureDiagnostics | Protokolované operace dotazování a indexování Dotazy na tabulku AzureDiagnostics v Log Analytics můžou zahrnovat společné vlastnosti, vlastnosti specifické pro vyhledávání a operace specifické pro vyhledávání uvedené v části s referenčními informacemi ke schématu. |
| AzureMetrics | Data metrik vygenerovaných službou Azure AI Search, která měří stav a výkon. |
Tabulky protokolů prostředků
Následující tabulka uvádí vlastnosti protokolů prostředků ve službě Azure AI Search. Protokoly prostředků se shromažďují do protokolů služby Azure Monitor nebo Azure Storage. V Azure Monitoru se protokoly shromažďují v tabulce AzureDiagnostics pod názvem Microsoft.Searchposkytovatele prostředků .
| Pole nebo vlastnost Služby Azure Storage | Vlastnost Protokolů služby Azure Monitor | Popis |
|---|---|---|
| čas | ČASOVÉ RAZÍTKO | Datum a čas (UTC), kdy k operaci došlo. |
| resourceId | Concat("/", "/subscriptions", SubscriptionId, "resourceGroups", ResourceGroupName, "providers/Microsoft.Search/searchServices", ServiceName) | Prostředek Azure AI Search, pro který jsou povolené protokoly. |
| category | "OperationLogs" | Kategorie protokolů zahrnují Audit, Operational, Executiona Request. |
| operationName | Název | Název operace. Název operace může být Indexes.ListIndexStatsSummaries, , Indexes.Get, , Indexers.ListQuery.SuggestQuery.SearchQuery.AutocompleteIndexes.UpdateQuery.LookupIndexes.StatsCORS.Preflight, Indexes.Prototype, , ServiceStats, . Indexers.WarmupDataSources.List |
| durationMS | DurationMilliseconds | Doba trvání operace v milisekundách. |
| operationVersion | ApiVersion | Verze rozhraní API použitá v požadavku. |
| resultType | (Selhalo) ? "Neúspěšné" : "Úspěch" | Typ odpovědi. |
| resultSignature | Stav | Stav odpovědi HTTP operace. |
| vlastnosti | Vlastnosti | Všechny rozšířené vlastnosti související s touto kategorií událostí. |
Protokol aktivit
Propojená tabulka uvádí operace, které lze zaznamenat v protokolu aktivit pro tuto službu. Tyto operace jsou podmnožinou všech možných operací poskytovatele prostředků v protokolu aktivit.
Další informace o schématu položek protokolu aktivit naleznete v tématu Schéma protokolu aktivit.
Následující tabulka uvádí běžné operace související se službou Azure AI Search, které se můžou zaznamenávat v protokolu aktivit. Úplný seznam všech operací Microsoft.Search najdete v tématu Operace poskytovatele prostředků Microsoft.Search.
| Operation | Popis |
|---|---|
| Získání klíče správce | Jakákoli operace, která vyžaduje práva správce, se protokoluje jako operace Získání klíče správce. |
| Získání klíče dotazu | Všechny operace jen pro čtení s kolekcí dokumentů indexu. |
| Znovu vygenerovat klíč správce | Žádost o opětovné vygenerování primárního nebo sekundárního klíče rozhraní API pro správu |
Mezi běžné položky patří odkazy na klíče rozhraní API – obecná informační oznámení, jako je Získání klíče správce a získání klíčů dotazů. Tyto aktivity označují požadavky, které byly provedeny pomocí klíče správce (vytvoření nebo odstranění objektů) nebo klíče dotazu, ale nezobrazují se samotný požadavek. Pro informace o tomto agregačním intervalu je nutné nakonfigurovat protokolování prostředků.
Případně můžete získat přehled o historii změn. Na webu Azure Portal vyberte aktivitu, aby se otevřela stránka podrobností, a pak vyberte Změnit historii, kde najdete informace o podkladové operaci.
Další schémata
Pro tuto službu se používají následující schémata.
Pokud vytváříte dotazy nebo vlastní sestavy, datové struktury, které obsahují protokoly prostředků Azure AI Search, odpovídají následujícím schématům.
V případě protokolů prostředků odesílaných do úložiště objektů blob má každý objekt jeden kořenový objekt označovaný jako záznamy obsahující pole objektů protokolu. Každý objekt blob obsahuje záznamy pro všechny operace, které proběhly ve stejné hodině.
Schéma protokolu prostředků
Všechny protokoly prostředků dostupné prostřednictvím služby Azure Monitor sdílejí společné schéma nejvyšší úrovně. Azure AI Search doplňuje další vlastnosti a operace , které jsou jedinečné pro vyhledávací službu.
Následující příklad ukazuje protokol prostředků, který obsahuje společné vlastnosti (TimeGenerated, Resource, Category atd.) a vlastnosti specifické pro vyhledávání (OperationName a OperationVersion).
| Name | Type | Popis a příklad |
|---|---|---|
| TimeGenerated | Datum a čas | Časové razítko operace. Příklad: 2021-12-07T00:00:43.6872559Z |
| Prostředek | String | ID prostředku. Příklad: /subscriptions/<your-subscription-id>/resourceGroups/<your-resource-group-name>/providers/Microsoft.Search/searchServices/<your-search-service-name> |
| Kategorie | String | "OperationLogs". Tato hodnota je konstanta. OperationLogs je jediná kategorie používaná pro protokoly prostředků. |
| OperationName | String | Název operace (viz úplný seznam operací). Příklad: Query.Search |
| OperationVersion | String | Verze api použitá v požadavku. Příklad: 2024-07-01 |
| ResultType | String | "Úspěch". Další možné hodnoty: Úspěch nebo Selhání |
| ResultSignature | Int | Kód výsledku HTTP. Příklad: 200 |
| DurationMS | Int | Doba trvání operace v milisekundách. |
| Vlastnosti | Objekt | Objekt obsahující data specifická pro operace Viz následující tabulka schématu vlastností. |
Schéma vlastností
Následující vlastnosti jsou specifické pro Azure AI Search.
| Name | Type | Popis a příklad |
|---|---|---|
| Description_s | String | Koncový bod operace. Příklad: GET /indexes('content')/docs |
| Documents_d | Int | Počet zpracovaných dokumentů |
| IndexName_s | String | Název indexu přidruženého k operaci. |
| Query_s | String | Parametry dotazu použité v požadavku. Příklad: ?search=beach access&$count=true&api-version=2024-07-01 |
Hodnoty OperationName (protokolované operace)
V protokolu prostředků se můžou objevit následující operace.
| OperationName | Popis |
|---|---|
| Zdroje dat.* | Platí pro zdroje dat indexeru. Může se jednat o vytvoření, odstranění, získání, seznam. |
| DebugSessions.* | Platí pro ladicí relaci. Může se jednat o vytvoření, odstranění, získání, seznam, zahájení a stav. |
| DebugSessions.DocumentStructure | Obohacený dokument se načte do ladicí relace. |
| DebugSessions.RetrieveIndexerExecutionHistoricalData | Požadavek na podrobnosti o spuštění indexeru |
| DebugSessions.RetrieveProjectedIndexerExecutionHistoricalData | Historie spouštění pro rozšiřování promítané do úložiště znalostí. |
| Indexování.* | Platí pro indexer. Může se jednat o vytvoření, odstranění, získání, výpis a stav. |
| Indexy.* | Platí pro index vyhledávání. Může se jednat o vytvoření, odstranění, získání, seznam. |
| indexy. Prototyp | Tento index vytvoří průvodce importem dat. |
| Indexing.Index | Tato operace je voláním indexových dokumentů. |
| Metadata.GetMetadata | Žádost o systémová data vyhledávací služby |
| Query.Autocomplete | Automatické dokončování dotazu na index. Podívejte se na typy a složení dotazů. |
| Query.Lookup | Vyhledávací dotaz na index. Podívejte se na typy a složení dotazů. |
| Query.Search | Požadavek fulltextového vyhledávání na index. Podívejte se na typy a složení dotazů. |
| Query.Suggest | Zadejte před sebou dotaz na index. Podívejte se na typy a složení dotazů. |
| ServiceStats | Tato operace je rutinní volání Načíst statistiky služby, buď volané přímo, nebo implicitně k naplnění stránky přehledu portálu při načtení nebo aktualizaci. |
| Dovednosti.* | Platí pro sadu dovedností. Může se jednat o vytvoření, odstranění, získání, seznam. |
Související obsah
- Popis monitorování služby Azure AI Search najdete v tématu Monitorování služby Azure AI Search.
- Podrobnosti o monitorování prostředků Azure najdete v tématu Monitorování prostředků Azure pomocí služby Azure Monitor .