Az Azure AI Search monitorozási adatainak referenciája
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 , IndexName SkillsetName |
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 , SkillName SkillsetName SkillType |
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 |
A SearchQueriesPerSecond a keresési szolgáltatás keresési lekérdezéseinek másodpercenkénti átlagát (QPS) jeleníti meg. 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.
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.
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ő dimenziókkal rendelkezik azokhoz a metrikákhoz, amelyek rögzítik a végrehajtott dokumentumok vagy készségek számát, a "Dokumentum feldolgozott száma" és a "Képesség-végrehajtás hívásainak száma" értéket.
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 feladatokat, például replikák és partíciók hozzáadását vagy eltávolítását a rendszer egy "Rendszergazda kulcs lekérése" tevékenységen keresztül jeleníti 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.Search
alatt.
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 Audit kö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.Autocomplete Query.Lookup , , CORS.Preflight , Indexes.Update , Indexes.Prototype , ServiceStats DataSources.List Indexers.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 |
---|---|
Rendszergazda kulcs lekérése | Minden olyan művelet, amely rendszergazdai jogosultságokat igényel, "Rendszergazda kulcs lekérése" műveletként van naplózva. |
Lekérdezési kulcs lekérése | Bármely írásvédett művelet az index dokumentumgyűjteménye ellen. |
Rendszergazda 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 Rendszergazda 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: 2020-06-30 |
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=2020-06-30 |
OperationName értékek (naplózott műveletek)
Az alábbi műveletek megjelenhetnek egy erőforrásnaplóban.
OperationName | Leírás |
---|---|
Datasources.* | 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. |
Skillsets.* | Egy készségkészletre vonatkozik. Létrehozhat, törölhet, lekérhet, listázhat. |
Kapcsolódó tartalom
- Az Azure AI Search monitorozásával kapcsolatos leírást az Azure AI Search figyelése című témakörben talál.
- Az Azure-erőforrások monitorozásával kapcsolatos részletekért tekintse meg az Azure-erőforrások monitorozását az Azure Monitorral .