Referens för Övervakningsdata för Azure AI Search
Den här artikeln innehåller all övervakningsreferensinformation för den här tjänsten.
Mått
I det här avsnittet visas alla automatiskt insamlade plattformsmått för den här tjänsten. Dessa mått är också en del av den globala listan över alla plattformsmått som stöds i Azure Monitor.
Information om kvarhållning av mått finns i Översikt över Azure Monitor-mått.
Mått som stöds för Microsoft.Search/searchServices
I följande tabell visas de mått som är tillgängliga för resurstypen Microsoft.Search/searchServices.
- Alla kolumner kanske inte finns i varje tabell.
- Vissa kolumner kan ligga utanför sidans visningsområde. Välj Expandera tabell för att visa alla tillgängliga kolumner.
Tabellrubriker
- Kategori – måttgruppen eller klassificeringen.
- Mått – Måttets visningsnamn som det visas i Azure Portal.
- Namn i REST API – måttnamnet som anges i REST-API:et.
- Enhet – måttenhet.
- Sammansättning – standardaggregeringstypen. Giltiga värden: Genomsnitt (genomsnitt), Minimum (Min), Maximum (Max), Total (Sum), Count.
- Dimensionsdimensioner - som är tillgängliga för måttet.
- Tidsintervall - Intervall där måttet samplas. Indikerar till exempel
PT1M
att måttet samplas varje minut,PT30M
var 30:e minut,PT1H
varje timme och så vidare. - DS-export – Om måttet kan exporteras till Azure Monitor-loggar via diagnostikinställningar. Information om hur du exporterar mått finns i Skapa diagnostikinställningar i Azure Monitor.
Mått | Namn i REST API | Enhet | Aggregering | Dimensioner | Tidsintervall | DS-export |
---|---|---|---|---|---|---|
Antal bearbetade dokument Antal bearbetade dokument |
DocumentsProcessedCount |
Antal | Totalt (summa), antal | DataSourceName , Failed , IndexerName , , , IndexName SkillsetName |
PT1M | Ja |
Svarstid för sökning Genomsnittlig söksvarstid för söktjänsten |
SearchLatency |
Sekunder | Genomsnitt | <ingen> | PT1M | Ja |
Sökfrågor per sekund Sökfrågor per sekund för söktjänsten |
SearchQueriesPerSecond |
CountPerSecond | Genomsnitt | <ingen> | PT1M | Ja |
Antal anrop för färdighetskörning Antal färdighetskörningar |
SkillExecutionCount |
Antal | Totalt (summa), antal | DataSourceName , Failed , IndexerName , SkillName , , , SkillsetName SkillType |
PT1M | Ja |
Procentandel begränsade sökfrågor Procentandel sökfrågor som har begränsats för söktjänsten |
ThrottledSearchQueriesPercentage |
Procent | Genomsnitt | <ingen> | PT1M | Ja |
Sökfrågor per sekund
Det här måttet visar medelvärdet av sökfrågorna per sekund (QPS) för söktjänsten. Det är vanligt att frågor körs i millisekunder, så endast frågor som mäter som sekunder visas i ett mått som QPS. Minimivärdet är det lägsta värdet för sökfrågor per sekund som registrerades under den minuten. Maximum är det högsta värdet. Medelvärdet är aggregerat under hela minuten.
Sammansättningstyp | beskrivning |
---|---|
Genomsnitt | Det genomsnittliga antalet sekunder inom en minut under vilken frågekörningen inträffade. |
Antal | Antalet mått som skickas till loggen inom intervallet på en minut. |
Högsta | Det högsta antalet sökfrågor per sekund som registrerats under en minut. |
Minimal | Det lägsta antalet sökfrågor per sekund som registrerats under en minut. |
Sum | Summan av alla frågor som körs inom minuten. |
Inom en minut kan du till exempel ha ett mönster som det här: en sekund med hög belastning som är det högsta för SearchQueriesPerSecond, följt av 58 sekunders genomsnittlig belastning och slutligen en sekund med bara en fråga, vilket är det minsta.
Ett annat exempel: om en nod genererar 100 mått, där värdet för varje mått är 40, är "Count" 100, "Sum" är 4000, "Average" är 40 och "Max" är 40.
Svarstid för sökning
Svarstid för sökning anger hur lång tid en fråga tar att slutföra.
Sammansättningstyp | Svarstid |
---|---|
Genomsnitt | Genomsnittlig frågevaraktighet i millisekunder. |
Antal | Antalet mått som skickas till loggen inom intervallet på en minut. |
Högsta | Den längsta frågan som körs i exemplet. |
Minimal | Kortaste körningsfråga i exemplet. |
Totalt | Total körningstid för alla frågor i exemplet som körs inom intervallet (en minut). |
Procentandel begränsade sökfrågor
Det här måttet refererar till frågor som tas bort i stället för att bearbetas. Begränsning sker när antalet begäranden i körningen överskrider kapaciteten. Du kan se en ökning av begränsade begäranden när en replik tas ur rotation eller under indexering. Både fråge- och indexeringsbegäranden hanteras av samma uppsättning resurser.
Tjänsten avgör om begäranden ska tappas baserat på resursförbrukning. Procentandelen resurser som förbrukas över minne, CPU och disk-I/O är i genomsnitt under en tidsperiod. Om den här procentandelen överskrider ett tröskelvärde begränsas alla begäranden till indexet tills mängden begäranden minskas.
Beroende på din klient anges en begränsad begäran på följande sätt:
- En tjänst returnerar ett fel
"You are sending too many requests. Please try again later."
- En tjänst returnerar en 503-felkod som anger att tjänsten för närvarande inte är tillgänglig.
- Om du använder portalen (till exempel Sökutforskaren) tas frågan bort tyst och du måste välja Sök igen.
Om du vill bekräfta begränsade frågor använder du måttet Begränsade sökfrågor . Du kan utforska mått i portalen eller skapa ett aviseringsmått enligt beskrivningen i den här artikeln. För frågor som har tagits bort inom samplingsintervallet använder du Total för att hämta procentandelen frågor som inte kördes.
Sammansättningstyp | Begränsning |
---|---|
Genomsnitt | Procentandel frågor som tagits bort inom intervallet. |
Antal | Antalet mått som skickas till loggen inom intervallet på en minut. |
Högsta | Procentandel frågor som tagits bort inom intervallet. |
Minimal | Procentandel frågor som tagits bort inom intervallet. |
Totalt | Procentandel frågor som tagits bort inom intervallet. |
För Begränsade sökfrågor i procent, lägsta, högsta, genomsnittliga och totala har alla samma värde: procentandelen sökfrågor som har begränsats, från det totala antalet sökfrågor under en minut.
Måttdimensioner
Information om vilka måttdimensioner som finns i Flerdimensionella mått.
Azure AI Search har dimensioner som är associerade med följande mått som samlar in ett antal dokument eller färdigheter som har utförts.
Måttnamn | beskrivning | Dimensioner | Exempel på användningsfall |
---|---|---|---|
Antal bearbetade dokument | Visar antalet bearbetade indexeraredokument. | Datakällans namn, misslyckades, indexnamn, indexerarens namn, kompetensuppsättningsnamn | Kan refereras som ett grovt mått på dataflöde (antal dokument som bearbetas av indexeraren över tid) – Konfigurera för att avisera om misslyckade dokument |
Antal anrop för färdighetskörning | Visar antalet kompetensanrop. | Datakällans namn, misslyckades, indexnamn, indexerarens namn, kunskapsnamn, kunskapstyp, kompetensuppsättningsnamn | Referens för att säkerställa att färdigheter anropas som förväntat genom att jämföra relativa anropsnummer mellan färdigheter och antalet kompetensanrop med antalet dokument. – Konfigurera för avisering om misslyckade kompetensanrop |
Dimensionsnamn | beskrivning |
---|---|
DataSourceName | En namngiven anslutning till datakällan som användes under indexeringskörningen. Giltiga värden är en av de typer av datakällor som stöds. |
Misslyckades | Anger om instansen misslyckades. |
IndexerName | Namn på en indexerare. |
IndexName | Namn på ett index. |
SkillsetName | Namn på en kompetensuppsättning som används under indexeringskörningen. |
SkillName | Namn på en färdighet inom en kompetensuppsättning. |
SkillType | Skicklighetens @odata.type . |
Resursloggar
I det här avsnittet visas de typer av resursloggar som du kan samla in för den här tjänsten. Avsnittet hämtar från listan över alla kategorityper för resursloggar som stöds i Azure Monitor.
Resursloggar som stöds för Microsoft.Search/searchServices
Kategori | Visningsnamn för kategori | Loggtabell | Stöder grundläggande loggplan | Stöder inmatningstidstransformering | Exempelfrågor | Kostnader för export |
---|---|---|---|---|---|---|
OperationLogs |
Åtgärdsloggar | AzureDiagnostics Loggar från flera Azure-resurser. |
Nej | Nej | Nej |
Tabeller för Azure Monitor-loggar
I det här avsnittet visas tabellerna för Azure Monitor-loggar som är relevanta för den här tjänsten, som är tillgängliga för frågor av Log Analytics med kusto-frågor. Tabellerna innehåller resursloggdata och eventuellt mer beroende på vad som samlas in och dirigeras till dem.
Söktjänster
Microsoft.Search/searchServices
Register | beskrivning |
---|---|
AzureActivity | Poster från Azure-aktivitetsloggen ger insikter om kontrollplansåtgärder. Uppgifter som anropas på kontrollplanet, till exempel att lägga till eller ta bort repliker och partitioner, representeras via en "Hämta administratörsnyckel"-aktivitet. |
AzureDiagnostics | Loggade fråge- och indexeringsåtgärder. Frågor mot tabellen AzureDiagnostics i Log Analytics kan innehålla vanliga egenskaper, sökspecifika egenskaper och sökspecifika åtgärder som anges i schemareferensavsnittet. |
AzureMetrics | Måttdata som genereras av Azure AI Search som mäter hälsa och prestanda. |
Resursloggtabeller
I följande tabell visas egenskaperna för resursloggar i Azure AI Search. Resursloggarna samlas in i Azure Monitor-loggar eller Azure Storage. I Azure Monitor samlas loggar in i tabellen AzureDiagnostics under resursproviderns namn Microsoft.Search
.
Azure Storage-fält eller -egenskap | Azure Monitor-loggegenskap | beskrivning |
---|---|---|
time | TIMESTAMP | Datum och tid (UTC) när åtgärden inträffade. |
resourceId | Concat("/", "/subscriptions", SubscriptionId, "resourceGroups", ResourceGroupName, "providers/Microsoft.Search/searchServices", ServiceName) | Azure AI Search-resursen som loggar är aktiverade för. |
category | "OperationLogs" | Loggkategorier är Audit , Operational , Execution och Request . |
operationName | Name | Namnet på åtgärden. Åtgärdsnamnet kan vara Indexes.ListIndexStatsSummaries , Indexes.Get , Indexes.Stats , Indexers.List , Query.Search , Query.Suggest , Query.Lookup , Query.Autocomplete , CORS.Preflight , Indexes.Update , , Indexes.Prototype , ServiceStats , , DataSources.List Indexers.Warmup . |
durationMS | DurationMilliseconds | Varaktigheten för åtgärden, i millisekunder. |
operationVersion | ApiVersion | DEN API-version som används för begäran. |
resultType | (Misslyckades) ? "Misslyckades" : "Lyckades" | Typ av svar. |
resultSignature | Status | HTTP-svarsstatus för åtgärden. |
egenskaper | Egenskaper | Utökade egenskaper som är relaterade till den här kategorin av händelser. |
Aktivitetslogg
Den länkade tabellen visar de åtgärder som kan registreras i aktivitetsloggen för den här tjänsten. Dessa åtgärder är en delmängd av alla möjliga resursprovideråtgärder i aktivitetsloggen.
Mer information om schemat för aktivitetsloggposter finns i Aktivitetsloggschema.
I följande tabell visas vanliga åtgärder relaterade till Azure AI Search som kan registreras i aktivitetsloggen. En fullständig lista över alla Microsoft.Search-åtgärder finns i Microsoft.Search-resursprovideråtgärder.
Operation | beskrivning |
---|---|
Hämta administratörsnyckel | Alla åtgärder som kräver administrativa rättigheter loggas som en "Hämta administratörsnyckel"-åtgärd. |
Hämta frågenyckel | Skrivskyddade åtgärder mot dokumentsamlingen för ett index. |
Återskapa administratörsnyckel | En begäran om att återskapa antingen den primära eller sekundära administratörs-API-nyckeln. |
Vanliga poster inkluderar referenser till API-nycklar – allmänna informationsmeddelanden som Hämta administratörsnyckel och Hämta frågenycklar. De här aktiviteterna anger begäranden som har gjorts med hjälp av administratörsnyckeln (skapa eller ta bort objekt) eller frågenyckeln, men visa inte själva begäran. Om du vill ha information om det här kornet måste du konfigurera resursloggning.
Du kan också få viss insikt genom ändringshistorik. I Azure Portal väljer du aktiviteten för att öppna informationssidan och väljer sedan "Ändra historik" för information om den underliggande åtgärden.
Andra scheman
Följande scheman används för den här tjänsten.
Om du skapar frågor eller anpassade rapporter följer de datastrukturer som innehåller Azure AI Search-resursloggar följande scheman.
För resursloggar som skickas till bloblagring har varje blob ett rotobjekt som kallas poster som innehåller en matris med loggobjekt. Varje blob innehåller poster för alla åtgärder som ägde rum under samma timme.
Resursloggschema
Alla resursloggar som är tillgängliga via Azure Monitor delar ett gemensamt schema på den översta nivån. Azure AI Search kompletterar med fler egenskaper och åtgärder som är unika för en söktjänst.
I följande exempel visas en resurslogg som innehåller vanliga egenskaper (TimeGenerated, Resource, Category och så vidare) och sökspecifika egenskaper (OperationName och OperationVersion).
Namn | Type | Beskrivning och exempel |
---|---|---|
TimeGenerated | Datetime | Tidsstämpel för åtgärden. Till exempel: 2021-12-07T00:00:43.6872559Z |
Resurs | String | Resurs-ID. Till exempel: /subscriptions/<your-subscription-id>/resourceGroups/<your-resource-group-name>/providers/Microsoft.Search/searchServices/<your-search-service-name> |
Kategori | String | "OperationLogs". Det här värdet är en konstant. OperationLogs är den enda kategorin som används för resursloggar. |
OperationName | String | Namnet på åtgärden (se den fullständiga listan över åtgärder). Ett exempel är Query.Search |
OperationVersion | String | Api-versionen som används i begäran. Till exempel: 2024-07-01 |
ResultType | String | "Framgång". Andra möjliga värden: Lyckad eller misslyckad |
ResultSignature | Int | En HTTP-resultatkod. Till exempel: 200 |
DurationMS | Int | Varaktigheten för åtgärd i milisekunder. |
Egenskaper | Objekt | Objekt som innehåller åtgärdsspecifika data. Se följande schematabell för egenskaper. |
Egenskapsschema
Följande egenskaper är specifika för Azure AI Search.
Namn | Type | Beskrivning och exempel |
---|---|---|
Description_s | String | Åtgärdens slutpunkt. Till exempel: GET /indexes('content')/docs |
Documents_d | Int | Antal bearbetade dokument. |
IndexName_s | String | Namnet på det index som är associerat med åtgärden. |
Query_s | String | Frågeparametrarna som används i begäran. Till exempel: ?search=beach access&$count=true&api-version=2024-07-01 |
OperationName-värden (loggade åtgärder)
Följande åtgärder kan visas i en resurslogg.
OperationName | beskrivning |
---|---|
DataSources.* | Gäller för indexerarens datakällor. Kan vara Skapa, Ta bort, Hämta, Lista. |
FelsökningSessioner.* | Gäller för en felsökningssession. Kan vara Skapa, Ta bort, Hämta, Lista, Start och Status. |
DebugSessions.DocumentStructure | Ett berikat dokument läses in i en felsökningssession. |
DebugSessions.RetrieveIndexerExecutionHistoricalData | En begäran om information om indexerarens körning. |
DebugSessions.RetrieveProjectedIndexerExecutionHistoricalData | Körningshistorik för berikningar som projiceras till ett kunskapslager. |
Indexerare.* | Gäller för en indexerare. Kan vara Skapa, Ta bort, Hämta, Lista och Status. |
Index.* | Gäller för ett sökindex. Kan vara Skapa, Ta bort, Hämta, Lista. |
Index. Prototyp | Det här indexet skapas av guiden Importera data. |
Indexing.Index | Den här åtgärden är ett anrop till Indexdokument. |
Metadata.GetMetadata | En begäran om söktjänstsystemdata. |
Query.Autocomplete | En automatisk kompletteringsfråga mot ett index. Se Frågetyper och sammansättning. |
Query.Lookup | En sökningsfråga mot ett index. Se Frågetyper och sammansättning. |
Query.Search | En fulltextsökningsbegäran mot ett index. Se Frågetyper och sammansättning. |
Query.Suggest | Skriv framåtfråga mot ett index. Se Frågetyper och sammansättning. |
ServiceStats | Den här åtgärden är ett rutinanrop till Hämta tjänststatistik, som antingen anropas direkt eller implicit för att fylla i en portalöversiktssida när den läses in eller uppdateras. |
Kompetensuppsättningar.* | Gäller för en kompetensuppsättning. Kan vara Skapa, Ta bort, Hämta, Lista. |
Relaterat innehåll
- Se Övervaka Azure AI Search för en beskrivning av övervakning av Azure AI Search.
- Mer information om övervakning av Azure-resurser finns i Övervaka Azure-resurser med Azure Monitor .