Dela via


Referens för Övervakningsdata för Azure AI Search

Den här artikeln innehåller all övervakningsreferensinformation för den här tjänsten.

Mer information om de data som du kan samla in för Azure AI Search och hur du använder den finns i Övervaka Azure AI Search .

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, , , IndexNameSkillsetName 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, , , SkillsetNameSkillType 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, Executionoch 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.ListIndexers.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.