referenční informace k datům monitorování Azure AI Vyhledávač

Note

Azure AI Vyhledávač je k dispozici prostřednictvím portálu Azure, rozhraní REST API a Sady Azure SDK. Podporuje také Foundry IQ, spravovanou znalostní vrstvu, která transformuje podnikový obsah na opakovaně použitelné znalostní báze s podporou oprávnění pro agenty na portálu Microsoft Foundry.

Tento článek obsahuje všechny referenční informace o monitorování této služby.

Podrobnosti o datech, která můžete shromažďovat pro Azure AI Vyhledávač a jak je používat, najdete v tématu Monitor Azure AI Vyhledávač.

Metriky

Tato sekce uvádí všechny automaticky sbírané metriky platformy pro tuto službu. Tyto metriky jsou také součástí globálního seznamu všech platformních metrik podporovaných v Azure Monitor.

Pro informace o zadržení metrik viz přehled Azure Monitor Metrik.

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 ve všech tabulkách.
  • Některé sloupce mohou být mimo oblast zobrazení stránky. Vyberte Rozbalit tabulku pro zobrazení všech dostupných sloupců.

Záhlaví tabulky

  • Kategorie – Skupina metrik nebo klasifikace.
  • Metric - Zobrazovaný název metriky, jak se objevuje v portálu Azure.
  • Název v REST API – Název metriky, jak je uveden v REST API.
  • Jednotka – Jednotka měření.
  • Agregace – výchozí typ agregace . Platné hodnoty: Průměr (avg), Minimum (min), Maximum (max), Součet (součet), Počet.
  • Rozměry - Rozměry dostupné pro tuto metriku.
  • Časová zrna - Intervaly , ve kterých je metrika vzorkována. Například označuje, PT1M že metrika je vzorkována každou minutu, PT30M každých 30 minut, PT1H každou hodinu a tak dále.
  • DS Export – Zda je metrika exportovatelná do Azure Monitor logů přes diagnostická nastavení. Pro informace o exportu metrik viz Vytvořte diagnostická nastavení v Azure Monitor.
Metrika Název v REST API Pokročilé metriky platformy Jednotka Agregace Dimenze Časová zrnka DS Vývoz
Zpracované soubory indexeru (bajty)

Celkový počet bajtů zdrojových dat zpracovaných indexery ze souborového zdroje dat (např. Blob, ADLS Gen2, File, SharePoint, OneLake)
DocumentsProcessedBytes Ne Bytes Celkem (Suma), Průměr DataSourceName, IndexerName, IndexName PT1M Ano
Počet zpracovaných dokumentů

Počet zpracovaných dokumentů
DocumentsProcessedCount Ne Počet Celkem (Suma), Počet DataSourceName, Failed, IndexerName, , IndexNameSkillsetName PT1M Ano
Využití úložiště

Využití úložiště (text + vektor) pro vyhledávací službu podle indexu
IndexStorageUsage Ne Bytes Průměrná hodnota, Maximální hodnota, Minimální hodnota IndexName PT1M Ano
Využití služby Vector Storage

Využití vektorového úložiště pro vyhledávací službu podle indexu
IndexVectorUsage Ne Bytes Průměrná hodnota, Maximální hodnota, Minimální hodnota IndexName PT1M Ano
Využité výpočetní jednotky

Výpočetní jednotky spotřebované operacemi služby vyhledávání a během období zahřívání indexu, v mikro-CU-hodinách (celkovou hodnotu vydělte 1 000 000, abyste získali CU-hodiny). Filtr stavu je zastaralý.
PerRequestComputeConsumption Ne Počet Celkem (Suma), Průměr Status, IndexName, , ResourceKindEventType PT1M Ano
Latence vyhledávání

Průměrná latence vyhledávání vyhledávací služby
SearchLatency Ne Sekund Průměr <žádné> PT1M Ano
Vyhledávací dotazy za sekundu

Vyhledávací dotazy za sekundu pro vyhledávací službu
SearchQueriesPerSecond Ne PočetZaSekundu Průměr <žádné> PT1M Ano
Počet vyvolání dovedností

Počet provádění dovedností
SkillExecutionCount Ne Počet Celkem (Suma), Počet DataSourceName, Failed, IndexerName, SkillName, , SkillsetNameSkillType PT1M Ano
Procento škrcených vyhledávacích dotazů

Procento vyhledávacích dotazů, které byly omezeny z důvodu omezení rychlosti pro vyhledávací službu
ThrottledSearchQueriesPercentage Ne 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.
Maximální Nejvyšší počet vyhledávacích dotazů za sekundu zaregistrovaných během minuty.
Minimální Nejnižší počet vyhledávacích dotazů za sekundu zaregistrovaných během minuty.
Součet 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.
Maximální Nejdéle běžící dotaz v ukázce.
Minimální Nejkratší spuštěný dotaz v ukázce
Celkem Celková doba provádění všech dotazů v ukázce prováděné v intervalu jedné minuty.

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 zvýšit počet omezených požadavků. Požadavky na dotazy i indexování se zpracovávají stejnou sadou prostředků.

Služba určuje, zda mají být požadavky zamítnuty 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 Azure (například Průzkumník služby Search), dotaz se zahodí bezobslužně a budete muset znovu vybrat Search.

Pokud chcete potvrdit omezené dotazy, použijte metriku omezených vyhledávacích dotazů . Metriky můžete prozkoumat na portálu Azure nebo vytvořit metriku upozornění, jak je popsáno v tomto článku. U dotazů, které byly vyřazeny během intervalu vzorkování, použijte Total k určení procentuálního podílu dotazů, které se nespustily.

Typ agregace Omezení
Průměr Procento vyřazených dotazů v intervalu
Počet Počet metrik vygenerovaných do protokolu v intervalu jedné minuty.
Maximální Procento vyřazených dotazů v intervalu
Minimální Procento vyřazených dotazů v intervalu
Celkem Procento vyřazených dotazů v intervalu

Poměr omezených vyhledávacích dotazů v procentech má stejnou hodnotu ve všech metrikách: minimální, maximální, průměrná i celková. Znamená to procento omezených vyhledávacích dotazů z celkového počtu vyhledávacích dotazů během jedné minuty.

Využití výpočetních jednotek

Tato metrika měří výpočetní prostředky, paměť a vstupně-výstupní prostředky spotřebované vaší službou Azure AI Vyhledávač vyjádřené v mili výpočetních jednotkách (mCU). Slouží jako ukazatel nákladů na zpracování různých typů operací. Využití se může v průběhu času lišit v závislosti na spuštěných operacích.

Tuto metriku můžete zobrazit na dvou úrovních:

  • Úroveň vyhledávací služby: Agregovaná spotřeba výpočetních prostředků napříč celou službou.
  • Úroveň indexu: Spotřeba vymezená na konkrétní index, užitečná pro identifikaci indexů, které řídí největší využití prostředků.
Typ agregace Popis
Součet Celkový počet jednotek mCU spotřebovaných během vybraného časového intervalu Užitečné pro pochopení celkových nákladů na výpočetní prostředky v průběhu času.
Průměr Průměrné spotřebované jednotky mCU během vybraného časového intervalu

Tato metrika podporuje následující filtry:

  • Název indexu: Filtruje metriku na konkrétní index. Pokud se nepoužije žádný filtr, metrika odráží celkovou spotřebu napříč všemi indexy ve službě.

  • Název operace: Filtruje metriku podle operace, která přispívá ke spotřebě výpočetních prostředků. Pokud se nepoužije žádný filtr, metrika odráží kombinovanou spotřebu napříč všemi typy operací. Podporované hodnoty najdete v tématu Referenční informace k datům monitorování.

Rozměry v metrické soustavě

Pro informace o metrických rozměrech viz Vícerozměrné metriky.

Azure AI Vyhledávač má dimenze přidružené k následujícím metrikám, které zachycují počet spuštěných dokumentů nebo dovedností.

Název metriky Popis Dimenze Ukázkové případy 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í Zajištění toho, že jsou dovednosti vyvolány podle očekávání, pomocí srovnání relativního počtu aktivací mezi dovednostmi a počtu aktivací dovedností s počtem dokumentů.
– Nastavení upozornění na neúspěšné vyvolání dovedností
Využití výpočetních jednotek Zobrazuje jednotky mCU spotřebované operacemi ve vyhledávací službě. Název indexu, operace Vyhodnoťte, která operace spotřebovala nejvíce výpočetních prostředků.
-Nastavte upozornění, když spotřeba rubaniny překročí očekávané prahové hodnoty pro daný typ operace
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.
Se nezdařilo 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í.
TypDovednosti Dovednost @odata.type .

Protokoly prostředků

Tato sekce uvádí typy záznamů zdrojů, které můžete pro tuto službu shromažďovat. Tato sekce čerpá ze seznamu kategorií všech typů zdrojových logů podporovaných v Azure Monitor.

Podporované logy prostředků pro Microsoft Search/searchServices

Kategorie Náklady na export Tabulka protokolů Podporuje základní logovací plán Podporuje transformaci při příjmu dat Ukázkové dotazy
Protokoly operací Ne AzureDiagnostics

Logy z více Azure zdrojů.

Ne Ne

Azure Monitor Logs tabulky

Tato sekce uvádí tabulky Azure Monitor Logs relevantní pro tuto službu, které jsou k dispozici pro dotazy Log Analytics pomocí dotazů Kusto. Tabulky obsahují data z resource log a možná i další v závislosti na tom, co je shromážděno a směrováno do nich.

Vyhledávací služby

Microsoft.Search/searchServices

Tabulka 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 zastoupeny 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 vyhledat a operace specifické pro search uvedené v referenční části schématu.
Azure Metriky Metická data generovaná službou Azure AI Vyhledávač, která měří zdraví systému a jeho výkon.

Tabulky záznamů prostředků

Následující tabulka uvádí vlastnosti logů zdrojů v Azure AI Vyhledávač. Protokoly prostředků se shromažďují do protokolů Azure Monitor nebo Azure Storage. V Azure Monitor se logy shromažďují v tabulce AzureDiagnostics u poskytovatele prostředků s názvem Microsoft.Search.

Azure Storage pole či vlastnost Vlastnost Azure Monitor Logs 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 Vyhledávač, u kterého jsou protokoly povoleny.
kategorie "OperationLogs" Kategorie protokolů zahrnují Audit, Operational, Executiona Request.
název operace Jméno Název operace. Název operace může být Indexes.ListIndexStatsSummaries, , Indexes.Get, , Indexes.StatsIndexers.ListQuery.SearchQuery.SuggestQuery.LookupQuery.AutocompleteCORS.PreflightIndexes.Update, Indexes.Prototype, , ServiceStats, . DataSources.ListIndexers.Warmup
durationMS DobaVMilisekundách Doba trvání operace v milisekundách.
verze operace ApiVersion Verze rozhraní API použitá v požadavku.
resultType (Selhalo) ? "Neúspěšný" : "Úspěch" Typ odpovědi.
výsledkový podpis Stav Stav odpovědi operace HTTP.
Vlastnosti Vlastnosti Všechny rozšířené vlastnosti související s touto kategorií událostí.

Záznam aktivit

Propojená tabulka uvádí operace, které lze zaznamenat v záznamu aktivit této služby. Tyto operace jsou podmnožinou všech možných operací poskytovatele zdrojů v logu aktivit.

Pro více informací o schématu záznamů v denníku aktivit viz schéma záznamu aktivit.

Následující tabulka uvádí běžné operace související s Azure AI Vyhledávač, které se můžou zaznamenávat v protokolu aktivit. Úplný seznam všech operací Microsoft.Search najdete v operacích poskytovatele prostředků Microsoft.Search.

Operace 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ískejte klíč dotazu Jakákoliv 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. Abyste získali informace o tomto detailu, je nutné nakonfigurovat protokolování prostředků.

Případně můžete získat přehled o historii změn. Na portálu Azure vyberte aktivitu, aby se otevřela stránka podrobností, a pak v části Historie změn vyhledejte informace o příslušné 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 Vyhledávač, 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ý blob jeden kořenový objekt označovaný jako záznamy, který obsahuje pole objektů protokolu. Každý blob obsahuje záznamy pro všechny operace, které proběhly ve stejnou hodinu.

Schéma záznamu zdrojů

Všechny protokoly prostředků dostupné prostřednictvím Azure Monitor sdílejí schéma nejvyšší úrovně common. Azure AI Vyhledávač doplňky s vlastnostmi a operations, 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).

Jméno Typ Popis a příklad
TimeGenerated Datum a čas Časové razítko operace. Například: 2021-12-07T00:00:43.6872559Z
Zdroj Řetězec ID prostředku. Například: /subscriptions/<your-subscription-id>/resourceGroups/<your-resource-group-name>/providers/Microsoft.Search/searchServices/<your-search-service-name>
Kategorie Řetězec "OperationLogs". Tato hodnota je konstanta. OperationLogs je jediná kategorie, která se používá pouze pro protokoly prostředků.
Název operace Řetězec Název operace (viz úplný seznam operací). Příklad: Query.Search
OperationVersion Řetězec Použitá verze api v požadavku. Například: 2026-04-01
Typ výsledku Řetězec "Úspěch". Další možné hodnoty: Úspěch nebo Selhání
VýsledekPodpis Int Kód výsledku HTTP. Například: 200
DobaTrváníMS 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 Vyhledávač.

Jméno Typ Popis a příklad
Popis_s Řetězec Koncový bod operace. Například: GET /indexes('content')/docs
Documents_d Int Počet zpracovaných dokumentů
IndexName_s Řetězec Název indexu přidruženého k operaci.
Query_s Řetězec Parametry dotazu použité v požadavku. Například: ?search=beach access&$count=true&api-version=2026-04-01

Hodnoty OperationName (protokolované operace)

V protokolu prostředků se můžou objevit následující operace.

Název operace Popis
DataSources.* Platí pro datové zdroje indexátoru. 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.StrukturaDokumentu Obohacený dokument se načte do ladicí relace.
DebugSessions.RetrieveIndexerExecutionHistoricalData Požadavek na podrobné informace o provádění indexovacího programu.
DebugSessions.RetrieveProjectedIndexerExecutionHistoricalData Historie provádění pro obohacení přenesená do úložiště znalostí.
Indexování.* Platí pro indexátor. 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 Metadata indexu jsou definována průvodcem importem dat na základě vstupů dat.
Indexace.Index Tato operace je voláním indexových dokumentů.
Metadata.GetMetadata Žádost o systémová data vyhledávací služby
Dotaz.Autodokončování 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 na fulltextové vyhledávání v indexu. Podívejte se na typy a složení dotazů.
Query.Suggest Proveďte vyhledávání v indexu podle zadání. Podívejte se na typy a složení dotazů.
ServiceStats Tato operace představuje rutinní volání Načíst statistiky služby, které je buď vykonáno přímo, nebo implicitně za účelem naplnění stránky přehledu portálu při jejím načtení nebo aktualizaci.
Dovednostní sady.* Platí pro soubor dovedností. Může se jednat o vytvoření, odstranění, získání, seznam.