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.

Podrobnosti o datech, která můžete shromažďovat pro Azure AI Search a jak je používat, najdete v tématu Monitorování služby Azure AI Search .

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, PT30M každých 30 minut, PT1H kaž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, 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, 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 portál (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 portálu 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: 2023-11-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	Object	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=2023-11-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 přidat , aktualizovat nebo odstranit dokumenty.
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 .