Megosztás a következőn keresztül:

Az Azure AI Search monitorozási adatainak referenciája

  • Cikk

Ez a cikk a szolgáltatás figyelési referenciaadatait tartalmazza.

Az Azure AI Search monitorozásával kapcsolatos részletekért tekintse meg az Azure AI Search szolgáltatáshoz gyűjthető adatok részleteit és azok használatát.

Mérőszámok

Ez a szakasz a szolgáltatáshoz automatikusan gyűjtött platformmetrikákat sorolja fel. Ezek a metrikák az Azure Monitorban támogatott összes platformmetrika globális listájának részét képezik.

A metrikamegőrzésről további információt az Azure Monitor Metrics áttekintésében talál.

Támogatott metrikák a Microsoft.Search/searchServices szolgáltatáshoz

Az alábbi táblázat a Microsoft.Search/searchServices erőforrástípushoz elérhető metrikákat sorolja fel.

  • Előfordulhat, hogy nem minden oszlop szerepel minden táblában.
  • Előfordulhat, hogy egyes oszlopok a lap megtekintési területén kívül esnek. Válassza a Táblázat kibontása lehetőséget az összes elérhető oszlop megtekintéséhez.

Táblázatfejlécek

  • Kategória – A metrikák csoportja vagy besorolása.
  • Metrika – A metrika megjelenítendő neve az Azure Portalon.
  • Név a REST API-ban – A REST API-banemlített metrikanév.
  • Egység – Mértékegység.
  • Összesítés – Az alapértelmezett összesítési típus. Érvényes értékek: Átlag (Avg), Minimum (Min), Maximum (Max), Összeg (Összeg), Darabszám.
  • A metrikához elérhető dimenziók - dimenziói.
  • Időszemcse-intervallumok - , amelyeken a metrika mintavétele történik. Például azt jelzi, PT1M hogy a metrika mintavétele percenként, PT30M 30 percenként, PT1H óránként és így tovább történik.
  • DS Export – Azt jelzi, hogy a metrika exportálható-e az Azure Monitor-naplókba diagnosztikai beállításokon keresztül. A metrikák exportálásával kapcsolatos információkért lásd: Diagnosztikai beállítások létrehozása az Azure Monitorban.
Metrika Név a REST API-ban Unit (Egység) Összesítés Dimenziók Időszemcsék DS-exportálás
A dokumentum feldolgozott száma

Feldolgozott dokumentumok száma		 DocumentsProcessedCount Count Összeg, Darabszám DataSourceName, Failed, IndexerName, IndexNameSkillsetName PT1M Igen
Keresési késés

A keresési szolgáltatás átlagos keresési késése		 SearchLatency Másodperc Átlag <none> PT1M Igen
Lekérdezések keresése másodpercenként

Keresési lekérdezések másodpercenként a keresési szolgáltatáshoz		 SearchQueriesPerSecond CountPerSecond Átlag <none> PT1M Igen
Képesség-végrehajtás hívásainak száma

Készségvégrehajtások száma		 SkillExecutionCount Count Összeg, Darabszám DataSourceName, Failed, IndexerName, SkillNameSkillsetNameSkillType PT1M Igen
Szabályozott keresési lekérdezések százalékos aránya

A keresési szolgáltatáshoz szabályozott keresési lekérdezések százalékos aránya		 ThrottledSearchQueriesPercentage Százalék Átlag <none> PT1M Igen

Lekérdezések keresése másodpercenként

Ez a metrika a keresési szolgáltatás keresési lekérdezéseinek másodpercenkénti átlagát (QPS) mutatja. Gyakran előfordul, hogy a lekérdezések ezredmásodpercben futnak, így csak a másodpercben mért lekérdezések jelennek meg egy olyan metrikában, mint a QPS. A minimális érték a keresési lekérdezések másodpercenkénti legalacsonyabb értéke, amelyet az adott percben regisztráltak. A maximum a legmagasabb érték. Az átlag az egész perc összesítése.

Összesítés típusa Leírás
Átlag A lekérdezés végrehajtásának átlagos száma egy percen belül.
Count A naplóban az egyperces időközön belül kibocsátott metrikák száma.
Maximum Az egy perc alatt regisztrált keresési lekérdezések száma másodpercenként.
Minimum Az egy perc alatt regisztrált keresési lekérdezések másodpercenkénti legalacsonyabb száma.
Sum A percen belül végrehajtott összes lekérdezés összege.

Egy percen belül például a következőhöz hasonló minta lehet: egy másodpercnyi magas terhelés, amely a SearchQueriesPerSecond maximális értéke, majd 58 másodpercnyi átlagos terhelés, végül pedig egy másodperc egyetlen lekérdezéssel, ami a minimum.

Egy másik példa: ha egy csomópont 100 metrikát bocsát ki, ahol az egyes metrikák értéke 40, akkor a "Darabszám" 100, az "Összeg" 4000, az "Átlag" 40, a "Max" pedig 40.

Keresési késés

A keresési késés azt jelzi, hogy egy lekérdezés mennyi ideig tart.

Összesítés típusa Késés
Átlag A lekérdezés átlagos időtartama ezredmásodpercben.
Count A naplóban az egyperces időközön belül kibocsátott metrikák száma.
Maximum Leghosszabb ideig futó lekérdezés a mintában.
Minimum A legrövidebb futó lekérdezés a mintában.
Összesen A mintában szereplő összes lekérdezés teljes végrehajtási ideje, amely az intervallumon belül (egy percen belül) fut.

Szabályozott keresési lekérdezések százalékos aránya

Ez a metrika a feldolgozott helyett elvetett lekérdezésekre vonatkozik. Szabályozás akkor történik, ha a végrehajtás alatt álló kérések száma meghaladja a kapacitást. A szabályozott kérelmek számának növekedése akkor jelenhet meg, ha egy replikát kivesznek a forgatásból vagy az indexelés során. A lekérdezési és indexelési kérelmeket is ugyanaz az erőforráskészlet kezeli.

A szolgáltatás meghatározza, hogy az erőforrás-felhasználás alapján elveti-e a kérelmeket. A memóriában, a processzorban és a lemez I/O-ban felhasznált erőforrások százalékos aránya egy adott időszak átlaga. Ha ez a százalék meghaladja a küszöbértéket, a rendszer a kérelmek mennyiségének csökkentéséig szabályozza az indexhez érkező összes kérést.

Az ügyféltől függően a rendszer az alábbi módokon jelez egy szabályozott kérést:

  • Egy szolgáltatás hibát ad vissza "You are sending too many requests. Please try again later."
  • A szolgáltatás egy 503-at tartalmazó hibakódot ad vissza, amely jelzi, hogy a szolgáltatás jelenleg nem érhető el.
  • Ha a portált (például a Search Explorert) használja, a lekérdezés csendesen el lesz ejtve, és újra ki kell választania a Keresés lehetőséget .

A szabályozott lekérdezések megerősítéséhez használja a szabályozott keresési lekérdezések metrikáit. A metrikákat a portálon ismerheti meg, vagy létrehozhat egy riasztási metrikát a jelen cikkben leírtak szerint. A mintavételezési időközön belül elvetett lekérdezések esetében a Total (Összesítés) használatával lekérheti a nem végrehajtott lekérdezések százalékos arányát.

Összesítés típusa Szabályozás
Átlag Az intervallumon belül elvetett lekérdezések százalékos aránya.
Count A naplóban az egyperces időközön belül kibocsátott metrikák száma.
Maximum Az intervallumon belül elvetett lekérdezések százalékos aránya.
Minimum Az intervallumon belül elvetett lekérdezések százalékos aránya.
Összesen Az intervallumon belül elvetett lekérdezések százalékos aránya.

A szabályozott keresési lekérdezések százalékos aránya, minimális, maximális, átlag és összeg, mind ugyanazzal az értékkel rendelkezik: a szabályozott keresési lekérdezések százalékos aránya az egy perc alatt végzett keresési lekérdezések teljes számától.

Metrikadimenziók

A metrikák dimenzióiról további információt a többdimenziós metrikák című témakörben talál.

Az Azure AI Search a következő metrikákhoz társított dimenziókkal rendelkezik, amelyek a végrehajtott dokumentumok vagy készségek számát rögzítik.

Metrika neve Leírás Dimenziók Használati példák
A dokumentum feldolgozott száma Az indexelő által feldolgozott dokumentumok számát jeleníti meg. Adatforrás neve, sikertelen, indexnév, indexelő neve, képességkészlet neve Az átviteli sebesség hozzávetőleges mértékeként hivatkozható (az indexelő által feldolgozott dokumentumok száma az idő függvényében)
– Riasztás beállítása sikertelen dokumentumok esetén
Képesség-végrehajtás hívásainak száma A képesség-meghívások számát jeleníti meg. Adatforrás neve, sikertelen, index neve, indexelő neve, képesség neve, készségtípus, képességkészlet neve A készségek elvárt meghívásának biztosítására való hivatkozás a készségek és a készséghívások száma közötti relatív meghívási számok és a dokumentumok számának összehasonlítása révén.
– Riasztás beállítása sikertelen készséghívások esetén
Dimenzió neve Leírás
DataSourceName Az indexelő végrehajtása során használt elnevezett adatforrás-kapcsolat. Az érvényes értékek a támogatott adatforrástípusok egyike.
Sikertelen Azt jelzi, hogy a példány nem sikerült-e.
IndexerName Indexelő neve.
IndexNév Index neve.
SkillsetName Az indexelő végrehajtása során használt készségkészlet neve.
SkillName Képesség neve egy készségkészleten belül.
SkillType A @odata.type képesség.

Erőforrásnaplók

Ez a szakasz a szolgáltatáshoz gyűjthető erőforrásnaplók típusait sorolja fel. A szakasz lekéri az Azure Monitorban támogatott összes erőforrásnapló-kategóriatípus listáját.

A Microsoft.Search/searchServices támogatott erőforrásnaplói

Kategória Kategória megjelenítendő neve Naplótábla Támogatja az alapszintű naplótervet Támogatja a betöltési idő átalakítást Példa a lekérdezésekre Exportálási költségek
OperationLogs Műveleti naplók AzureDiagnostics

Naplók több Azure-erőforrásból.

 Nem Nem Nem

Azure Monitor-naplók táblái

Ez a szakasz a szolgáltatáshoz kapcsolódó Azure Monitor-naplók tábláit sorolja fel, amelyek a Log Analytics által Kusto-lekérdezésekkel történő lekérdezéshez érhetők el. A táblák erőforrásnapló-adatokat tartalmaznak, és valószínűleg többet is, attól függően, hogy mit gyűjtenek és irányítanak hozzájuk.

Keresési szolgáltatások

Microsoft.Search/searchServices

Tábla Leírás
AzureActivity Az Azure-tevékenységnapló bejegyzései betekintést nyújtanak a vezérlősík műveleteibe. A vezérlősíkon meghívott feladatok, például replikák és partíciók hozzáadása vagy eltávolítása, "Rendszergazdai kulcs lekérése" tevékenységen keresztül jelennek meg.
AzureDiagnostics Naplózott lekérdezési és indexelési műveletek. A Log Analytics AzureDiagnostics táblájának lekérdezései közé tartozhatnak a gyakori tulajdonságok, a keresésspecifikus tulajdonságok és a sémahivatkozási szakaszban felsorolt keresésspecifikus műveletek .
AzureMetrics Az Azure AI Search által kibocsátott metrikaadatok, amelyek az állapotot és a teljesítményt mérik.

Erőforrásnapló-táblák

Az alábbi táblázat az Azure AI Search erőforrásnaplóinak tulajdonságait sorolja fel. Az erőforrásnaplók az Azure Monitor-naplókba vagy az Azure Storage-ba kerülnek. Az Azure Monitorban a naplók az AzureDiagnostics táblában lesznek összegyűjtve az erőforrás-szolgáltató neve Microsoft.Searchalatt.

Azure Storage-mező vagy tulajdonság Azure Monitor Logs tulajdonság Leírás
time TIMESTAMP A művelet bekövetkezésének dátuma és időpontja (UTC).
resourceId Concat("/", "/subscriptions", SubscriptionId, "resourceGroups", ResourceGroupName, "providers/Microsoft.Search/searchServices", ServiceName) Az Azure AI Search-erőforrás, amelyhez engedélyezve vannak a naplók.
kategória "OperationLogs" A naplókategóriák közé tartoznak a Auditkövetkezők: , Operational, Executionés Request.
operationName Név A művelet neve. A művelet neve lehet Indexes.ListIndexStatsSummaries, Indexes.Get, Indexes.Stats, Indexers.List, Query.Search, Query.Suggest, Query.AutocompleteQuery.Lookup, , CORS.Preflight, Indexes.Update, Indexes.Prototype, ServiceStatsDataSources.ListIndexers.Warmup.
durationMS DurationMilliseconds A művelet időtartama ezredmásodpercben.
operationVersion ApiVersion A kérelemben használt API-verzió.
resultType (Sikertelen) ? "Sikertelen" : "Siker" A válasz típusa.
resultSignature Állapot A művelet HTTP-válasz állapota.
tulajdonságok Tulajdonságok Az eseménykategóriához kapcsolódó bármely kiterjesztett tulajdonság.

Tevékenységnapló

A csatolt tábla felsorolja a szolgáltatás tevékenységnaplójában rögzíthető műveleteket. Ezek a műveletek a tevékenységnapló összes lehetséges erőforrás-szolgáltatói műveletének egy részét képezik.

A tevékenységnapló-bejegyzések sémájára vonatkozó további információkért lásd : Tevékenységnapló séma.

Az alábbi táblázat az Azure AI Search szolgáltatással kapcsolatos gyakori műveleteket sorolja fel, amelyek rögzíthetők a tevékenységnaplóban. Az összes Microsoft.Search-művelet teljes listáját a Microsoft.Search erőforrás-szolgáltatói műveleteiben talál.

Művelet Leírás
Rendszergazdai kulcs lekérése Minden rendszergazdai jogosultságot igénylő műveletet a rendszer "Rendszergazdai kulcs lekérése" műveletként naplóz.
Lekérdezési kulcs lekérése Bármely írásvédett művelet az index dokumentumgyűjteménye ellen.
Rendszergazdai kulcs újragenerálása Az elsődleges vagy másodlagos rendszergazdai API-kulcs újragenerálására irányuló kérés.

A gyakori bejegyzések közé tartoznak az API-kulcsokra mutató hivatkozások – általános tájékoztató értesítések, például a rendszergazdai kulcs lekérése és a lekérdezési kulcsok lekérése. Ezek a tevékenységek olyan kéréseket jeleznek, amelyek a rendszergazdai kulccsal (objektumok létrehozása vagy törlése) vagy lekérdezési kulccsal történtek, de nem mutatják meg magát a kérést. A részletes információkért konfigurálnia kell az erőforrás-naplózást.

Másik lehetőségként betekintést nyerhet a változáselőzményekbe. Az Azure Portalon válassza ki a tevékenységet a részletes lap megnyitásához, majd válassza az "Előzmények módosítása" lehetőséget az alapul szolgáló művelettel kapcsolatos információkért.

Egyéb sémák

A szolgáltatáshoz az alábbi sémák vannak használatban.

Ha lekérdezéseket vagy egyéni jelentéseket készít, az Azure AI Search-erőforrásnaplókat tartalmazó adatstruktúrák megfelelnek az alábbi sémáknak.

A blobtárolóba küldött erőforrásnaplók esetében minden blob rendelkezik egy gyökérobjektummal, úgynevezett rekordokkal , amelyek naplóobjektum-tömböt tartalmaznak. Minden blob rekordokat tartalmaz az adott órában végrehajtott összes művelethez.

Erőforrásnapló sémája

Az Azure Monitoron keresztül elérhető összes erőforrásnapló közös legfelső szintű sémát használ. Az Azure AI Search további, a keresési szolgáltatásra jellemző tulajdonságokkal és műveletekkel egészíti ki azokat.

Az alábbi példa egy olyan erőforrásnaplót mutat be, amely a gyakori tulajdonságokat (TimeGenerated, Resource, Category stb.) és a keresésspecifikus tulajdonságokat (OperationName és OperationVersion) tartalmazza.

Név Típus Leírás és példa
TimeGenerated Datetime A művelet időbélyege. Például: 2021-12-07T00:00:43.6872559Z
Erőforrás Sztring Erőforrás-azonosító. Például: /subscriptions/<your-subscription-id>/resourceGroups/<your-resource-group-name>/providers/Microsoft.Search/searchServices/<your-search-service-name>
Kategória Sztring "OperationLogs". Ez az érték állandó. Az OperationLogs az erőforrásnaplókhoz használt egyetlen kategória.
OperationName Sztring A művelet neve (lásd a műveletek teljes listáját). Példa: Query.Search
OperationVersion Sztring A kérelemben használt API-verzió. Például: 2023-11-01
ResultType Sztring "Siker". Egyéb lehetséges értékek: Sikeres vagy sikertelen
ResultSignature Int HTTP-eredménykód. Például: 200
DurationMS Int A művelet időtartama ezredmásodpercben.
Tulajdonságok Objektum Műveletspecifikus adatokat tartalmazó objektum. Tekintse meg a következő tulajdonságok sématábláját.

Tulajdonságok séma

Az alábbi tulajdonságok az Azure AI Searchre vonatkoznak.

Név Típus Leírás és példa
Description_s Sztring A művelet végpontja. Például: GET /indexes('content')/docs
Documents_d Int Feldolgozott dokumentumok száma.
IndexName_s Sztring A művelethez társított index neve.
Query_s Sztring A kérelemben használt lekérdezési paraméterek. Például: ?search=beach access&$count=true&api-version=2023-11-01

OperationName értékek (naplózott műveletek)

Az alábbi műveletek megjelenhetnek egy erőforrásnaplóban.

OperationName Leírás
Adatforrások.* Az indexelő adatforrásokra vonatkozik. Létrehozhat, törölhet, lekérhet, listázhat.
DebugSessions.* Hibakeresési munkamenetre vonatkozik. Lehet létrehozás, törlés, beolvasás, lista, kezdés és állapot.
DebugSessions.DocumentStructure A bővített dokumentum be lesz töltve egy hibakeresési munkamenetbe.
DebugSessions.RetrieveIndexerExecutionHistoricalData Az indexelő végrehajtási adataira vonatkozó kérés.
DebugSessions.RetrieveProjectedIndexerExecutionHistoricalData A tudástárba vetített gazdagítások végrehajtási előzményei.
Indexelők.* Indexelőre vonatkozik. Lehet létrehozás, törlés, beolvasás, lista és állapot.
Indexek.* Keresési indexre vonatkozik. Létrehozhat, törölhet, lekérhet, listázhat.
Indexek. Prototípus Ezt az indexet az Adatok importálása varázsló hozza létre.
Indexelés.Index Ez a művelet a dokumentumok hozzáadására, frissítésére vagy törlésére irányuló hívás.
Metadata.GetMetadata A keresési szolgáltatás rendszeradataira vonatkozó kérés.
Query.Autocomplete Automatikus kiegészítési lekérdezés egy indexen. Lásd: Lekérdezéstípusok és -összetétel.
Query.Lookup Keresési lekérdezés egy indexen. Lásd: Lekérdezéstípusok és -összetétel.
Query.Search Teljes szöveges keresési kérelem egy indexen. Lásd: Lekérdezéstípusok és -összetétel.
Query.Suggest Írjon be előre lekérdezést egy indexhez. Lásd: Lekérdezéstípusok és -összetétel.
ServiceStats Ez a művelet a szolgáltatásstatisztikák lekérésére irányuló rutinhívás, amely közvetlenül vagy implicit módon történik a portál áttekintési oldalának feltöltéséhez, amikor betölti vagy frissíti.
Készségkészletek.* Egy készségkészletre vonatkozik. Létrehozhat, törölhet, lekérhet, listázhat.

Kapcsolódó tartalom