Naslaginformatie over bewakingsgegevens in Azure AI Search
Dit artikel bevat alle informatie over bewakingsreferenties voor deze service.
Zie Azure AI Search bewaken voor meer informatie over de gegevens die u kunt verzamelen voor Azure AI Search en hoe u deze kunt gebruiken.
Metrische gegevens voor
In deze sectie vindt u alle automatisch verzamelde platformgegevens voor deze service. Deze metrische gegevens maken ook deel uit van de algemene lijst met alle platformgegevens die worden ondersteund in Azure Monitor.
Zie het overzicht van metrische gegevens in Azure Monitor voor meer informatie over het bewaren van metrische gegevens.
Ondersteunde metrische gegevens voor Microsoft.Search/searchServices
De volgende tabel bevat de metrische gegevens die beschikbaar zijn voor het resourcetype Microsoft.Search/searchServices.
- Alle kolommen zijn mogelijk niet aanwezig in elke tabel.
- Sommige kolommen kunnen zich buiten het weergavegebied van de pagina bevinden. Selecteer Tabel uitvouwen om alle beschikbare kolommen weer te geven.
Tabelkoppen
- Categorie : de groep of classificatie van metrische gegevens.
- Metrische waarde : de weergavenaam van metrische gegevens zoals deze wordt weergegeven in Azure Portal.
- Naam in REST API : de naam van de metrische waarde die wordt genoemd in de REST API.
- Eenheid : maateenheid.
- Aggregatie: het standaardaggregatietype. Geldige waarden: Gemiddelde (Gemiddeld), Minimum (Min), Maximum (Max), Totaal (Som), Aantal.
- Dimensies die - beschikbaar zijn voor de metrische waarde.
- Tijdsintervallen - waarmee de metrische gegevens worden bemonsterd. Geeft bijvoorbeeld
PT1Maan dat de metrische waarde elke minuut,PT30Mom de 30 minuten,PT1Helk uur enzovoort wordt genomen. - DS Exporteren: of de metrische waarde kan worden geëxporteerd naar Azure Monitor-logboeken via diagnostische instellingen. Zie Diagnostische instellingen maken in Azure Monitor voor meer informatie over het exporteren van metrische gegevens.
| Metrische gegevens | Naam in REST API | Eenheid | Statistische functie | Afmetingen | Tijdsinterval | DS Exporteren |
|---|---|---|---|---|---|---|
| Aantal verwerkte documenten Aantal verwerkte documenten |
DocumentsProcessedCount |
Tellen | Totaal (som), aantal | DataSourceNameIndexerName, Failed, IndexNameSkillsetName |
PT1M | Ja |
| Zoeklatentie Gemiddelde zoeklatentie voor de zoekservice |
SearchLatency |
Seconden | Gemiddeld | <geen> | PT1M | Ja |
| Zoekquery's per seconde Zoekquery's per seconde voor de zoekservice |
SearchQueriesPerSecond |
CountPerSecond | Gemiddeld | <geen> | PT1M | Ja |
| Aantal aanroepen van vaardigheidsuitvoering Aantal vaardigheidsuitvoeringen |
SkillExecutionCount |
Tellen | Totaal (som), aantal | DataSourceName, , FailedIndexerName, SkillName, , , SkillsetNameSkillType |
PT1M | Ja |
| Percentage van beperkte zoekquery's Percentage zoekquery's dat is beperkt voor de zoekservice |
ThrottledSearchQueriesPercentage |
Procent | Gemiddeld | <geen> | PT1M | Ja |
Zoekquery's per seconde
Deze metrische waarde toont het gemiddelde van de zoekquery's per seconde (QPS) voor de zoekservice. Het is gebruikelijk dat query's worden uitgevoerd in milliseconden, dus alleen query's die als seconden worden gemeten, worden weergegeven in een metrische waarde, zoals QPS. Het minimum is de laagste waarde voor zoekquery's per seconde die tijdens die minuut zijn geregistreerd. Maximum is de hoogste waarde. Het gemiddelde is de aggregaties gedurende de hele minuut.
| Aggregatietype | Beschrijving |
|---|---|
| Gemiddeld | Het gemiddelde aantal seconden binnen een minuut waarin de uitvoering van de query heeft plaatsgevonden. |
| Tellen | Het aantal metrische gegevens dat wordt verzonden naar het logboek binnen het interval van één minuut. |
| Maximum | Het hoogste aantal zoekquery's per seconde dat gedurende een minuut is geregistreerd. |
| Minimum | Het laagste aantal zoekquery's per seconde dat gedurende een minuut is geregistreerd. |
| Sum | De som van alle query's die binnen de minuut worden uitgevoerd. |
U kunt bijvoorbeeld binnen één minuut een patroon als volgt hebben: een seconde hoge belasting die het maximum is voor SearchQueriesPerSecond, gevolgd door 58 seconden van gemiddelde belasting en ten slotte één seconde met slechts één query, wat het minimum is.
Een ander voorbeeld: als een knooppunt 100 metrische gegevens verzendt, waarbij de waarde van elke metriek 40 is, is 'Aantal' 100, 'Som' is 4000, 'Gemiddelde' is 40 en 'Max' is 40.
Zoeklatentie
De zoeklatentie geeft aan hoe lang het duurt voordat een query is voltooid.
| Aggregatietype | Latentie |
|---|---|
| Gemiddeld | Gemiddelde queryduur in milliseconden. |
| Tellen | Het aantal metrische gegevens dat wordt verzonden naar het logboek binnen het interval van één minuut. |
| Maximum | Langst lopende query in het voorbeeld. |
| Minimum | De kortste actieve query in het voorbeeld. |
| Totaal | Totale uitvoeringstijd van alle query's in het voorbeeld, uitgevoerd binnen het interval (één minuut). |
Percentage van beperkte zoekquery's
Deze metrische waarde verwijst naar query's die worden verwijderd in plaats van verwerkt. Beperking treedt op wanneer het aantal aanvragen in de uitvoering de capaciteit overschrijdt. Mogelijk ziet u een toename in vertraagde aanvragen wanneer een replica uit de rotatie of tijdens het indexeren wordt gehaald. Zowel query- als indexeringsaanvragen worden verwerkt door dezelfde set resources.
De service bepaalt of aanvragen moeten worden verwijderd op basis van resourceverbruik. Het percentage resources dat in het geheugen, de CPU en de schijf-IO wordt verbruikt, wordt gedurende een bepaalde periode gemiddeld berekend. Als dit percentage een drempelwaarde overschrijdt, worden alle aanvragen voor de index beperkt totdat het aantal aanvragen wordt verminderd.
Afhankelijk van uw client wordt een vertraagde aanvraag op deze manieren aangegeven:
- Een service retourneert een fout
"You are sending too many requests. Please try again later." - Een service retourneert een 503-foutcode die aangeeft dat de service momenteel niet beschikbaar is.
- Als u de portal gebruikt (bijvoorbeeld Search Explorer), wordt de query op de achtergrond verwijderd en moet u Zoeken opnieuw selecteren.
Gebruik de metrische gegevens voor beperkte zoekquery's om vertraagde query's te bevestigen. U kunt metrische gegevens verkennen in de portal of een waarschuwingsmetriek maken, zoals beschreven in dit artikel. Gebruik Totaal voor query's die zijn verwijderd binnen het steekproefinterval om het percentage query's op te halen dat niet is uitgevoerd.
| Aggregatietype | Beperking |
|---|---|
| Gemiddeld | Het percentage query's dat binnen het interval is verwijderd. |
| Tellen | Het aantal metrische gegevens dat wordt verzonden naar het logboek binnen het interval van één minuut. |
| Maximum | Het percentage query's dat binnen het interval is verwijderd. |
| Minimum | Het percentage query's dat binnen het interval is verwijderd. |
| Totaal | Het percentage query's dat binnen het interval is verwijderd. |
Voor beperkt zoekquery'spercentage, minimum, maximum, gemiddelde en totaal hebben allemaal dezelfde waarde: het percentage zoekquery's dat gedurende één minuut is beperkt, van het totale aantal zoekquery's.
Metrische dimensies
Zie Multidimensionale metrische gegevens voor informatie over wat metrische dimensies zijn.
Azure AI Search heeft dimensies die zijn gekoppeld aan de volgende metrische gegevens waarmee een aantal documenten of vaardigheden wordt vastgelegd die zijn uitgevoerd.
| Naam van meetwaarde | Beschrijving | Dimensies | Gebruiksvoorbeelden |
|---|---|---|---|
| Aantal verwerkte documenten | Geeft het aantal verwerkte documenten van de indexeerfunctie weer. | Naam van gegevensbron, mislukt, indexnaam, naam van indexeerfunctie, naam van vaardighedenset | Kan worden verwezen als een ruwe meting van doorvoer (aantal documenten verwerkt door indexeerfunctie in de loop van de tijd) - Waarschuwing instellen voor mislukte documenten |
| Aantal aanroepen van vaardigheidsuitvoering | Geeft het aantal vaardigheidsvocations weer. | Naam van gegevensbron, mislukt, indexnaam, naam indexeerfunctie, vaardigheidsnaam, vaardigheidstype, naam van vaardighedenset | Verwijzing om ervoor te zorgen dat vaardigheden worden aangeroepen zoals verwacht, door relatieve aanroepen tussen vaardigheden en het aantal vaardigheden aanroepen te vergelijken met het aantal documenten. - Waarschuwing instellen voor mislukte aanroepen van vaardigheden |
| Dimensienaam | Beschrijving |
|---|---|
| DataSourceName | Een benoemde gegevensbronverbinding die wordt gebruikt tijdens de uitvoering van de indexeerfunctie. Geldige waarden zijn een van de ondersteunde gegevensbrontypen. |
| Mislukt | Geeft aan of het exemplaar is mislukt. |
| IndexerName | Naam van een indexeerfunctie. |
| IndexName | Naam van een index. |
| SkillsetName | Naam van een vaardighedenset die wordt gebruikt tijdens de uitvoering van de indexeerfunctie. |
| SkillName | Naam van een vaardigheid binnen een vaardighedenset. |
| SkillType | De @odata.type vaardigheid. |
Resourcelogboeken
Deze sectie bevat de typen resourcelogboeken die u voor deze service kunt verzamelen. De sectie wordt opgehaald uit de lijst met alle typen resourcelogboeken die worden ondersteund in Azure Monitor.
Ondersteunde resourcelogboeken voor Microsoft.Search/searchServices
| Categorie | Weergavenaam van categorie | Logboektabel | Biedt ondersteuning voor basislogboekabonnement | Ondersteunt opnametijdtransformatie | Voorbeeldquery's | Kosten voor export |
|---|---|---|---|---|---|---|
OperationLogs |
Bewerkingslogboeken | AzureDiagnostics Logboeken van meerdere Azure-resources. |
Nee | Nee | Nr. |
Azure Monitor-logboekentabellen
In deze sectie vindt u de Tabellen van Azure Monitor-logboeken die relevant zijn voor deze service, die beschikbaar zijn voor query's door Log Analytics met behulp van Kusto-query's. De tabellen bevatten resourcelogboekgegevens en mogelijk meer, afhankelijk van wat er wordt verzameld en doorgestuurd naar deze tabellen.
Search-services
Microsoft.Search/searchServices
| Table | Beschrijving |
|---|---|
| AzureActivity | Vermeldingen uit het Azure-activiteitenlogboek bieden inzicht in besturingsvlakbewerkingen. Taken die worden aangeroepen op het besturingsvlak, zoals het toevoegen of verwijderen van replica's en partities, worden weergegeven via een activiteit 'Beheersleutel ophalen'. |
| AzureDiagnostics | Vastgelegde query- en indexeringsbewerkingen. Query's voor de tabel AzureDiagnostics in Log Analytics kunnen de algemene eigenschappen, de zoekspecifieke eigenschappen en de zoekspecifieke bewerkingen in de sectie schemaverwijzing bevatten. |
| AzureMetrics | Metrische gegevens die worden verzonden door Azure AI Search die de status en prestaties meten. |
Resourcelogboektabellen
De volgende tabel bevat de eigenschappen van resourcelogboeken in Azure AI Search. De resourcelogboeken worden verzameld in Azure Monitor-logboeken of Azure Storage. In Azure Monitor worden logboeken verzameld in de tabel AzureDiagnostics onder de naam van de resourceprovider.Microsoft.Search
| Azure Storage-veld of -eigenschap | Eigenschap Azure Monitor-logboeken | Beschrijving |
|---|---|---|
| tijd | TIMESTAMP | De datum en tijd (UTC) waarop de bewerking is opgetreden. |
| resourceId | Concat("/", "/subscriptions", SubscriptionId, "resourceGroups", ResourceGroupName, "providers/Microsoft.Search/searchServices", ServiceName) | De Azure AI Search-resource waarvoor logboeken zijn ingeschakeld. |
| category | "OperationLogs" | Logboekcategorieën zijn onder andere Audit, Operational, Executionen Request. |
| operationName | Naam | Naam van de bewerking. De naam van de bewerking kan zijnIndexes.ListIndexStatsSummaries, , Indexes.Get, Indexes.Stats, Indexers.List, Query.SuggestQuery.Search, Query.Lookup, Indexes.UpdateQuery.AutocompleteServiceStatsDataSources.ListCORS.PreflightIndexes.Prototype. Indexers.Warmup |
| durationMS | DurationMilliseconden | De duur van de bewerking, in milliseconden. |
| operationVersion | ApiVersion | De API-versie die wordt gebruikt voor de aanvraag. |
| resultType | (Mislukt) ? "Mislukt" : "Geslaagd" | Het type antwoord. |
| resultSignature | Status | De HTTP-antwoordstatus van de bewerking. |
| properties | Eigenschappen | Uitgebreide eigenschappen met betrekking tot deze categorie gebeurtenissen. |
Activiteitenlogboek
De gekoppelde tabel bevat de bewerkingen die kunnen worden vastgelegd in het activiteitenlogboek voor deze service. Deze bewerkingen zijn een subset van alle mogelijke bewerkingen van de resourceprovider in het activiteitenlogboek.
Zie het schema voor activiteitenlogboeken voor meer informatie over het schema van vermeldingen in het activiteitenlogboek.
De volgende tabel bevat algemene bewerkingen met betrekking tot Azure AI Search die kunnen worden vastgelegd in het activiteitenlogboek. Zie Microsoft.Search-resourceproviderbewerkingen voor een volledige lijst met alle bewerkingen van Microsoft.Search.
| Operation | Omschrijving |
|---|---|
| Beheerderssleutel ophalen | Elke bewerking waarvoor beheerdersrechten zijn vereist, wordt geregistreerd als een bewerking 'Beheersleutel ophalen'. |
| Querysleutel ophalen | Elke bewerking met het kenmerk Alleen-lezen voor de verzameling documenten van een index. |
| Beheersleutel opnieuw genereren | Een aanvraag voor het opnieuw genereren van de primaire of secundaire beheer-API-sleutel. |
Veelvoorkomende vermeldingen zijn verwijzingen naar API-sleutels: algemene informatieve meldingen, zoals Beheerderssleutel ophalen en Querysleutels ophalen. Deze activiteiten geven aanvragen aan die zijn gedaan met behulp van de beheersleutel (objecten maken of verwijderen) of querysleutel, maar de aanvraag zelf niet weergeven. Voor informatie over dit graan moet u logboekregistratie van resources configureren.
U kunt ook inzicht krijgen in de wijzigingsgeschiedenis. Selecteer in Azure Portal de activiteit om de detailpagina te openen en selecteer vervolgens 'Geschiedenis wijzigen' voor informatie over de onderliggende bewerking.
Andere schema's
De volgende schema's worden gebruikt voor deze service.
Als u query's of aangepaste rapporten bouwt, voldoen de gegevensstructuren die Azure AI Search-resourcelogboeken bevatten aan de volgende schema's.
Voor resourcelogboeken die naar blobopslag worden verzonden, heeft elke blob één hoofdobject met de naam records die een matrix met logboekobjecten bevatten. Elke blob bevat records voor alle bewerkingen die plaatsvonden tijdens hetzelfde uur.
Logboekschema van resource
Alle resourcelogboeken die beschikbaar zijn via Azure Monitor, delen een algemeen schema op het hoogste niveau. Azure AI Search is een aanvulling op meer eigenschappen en bewerkingen die uniek zijn voor een zoekservice.
In het volgende voorbeeld ziet u een resourcelogboek met algemene eigenschappen (TimeGenerated, Resource, Category, enzovoort) en zoekspecifieke eigenschappen (OperationName en OperationVersion).
| Name | Type | Beschrijving en voorbeeld |
|---|---|---|
| TimeGenerated | Datum/tijd | Tijdstempel van de bewerking. Bijvoorbeeld: 2021-12-07T00:00:43.6872559Z |
| Bron | String | Resource-id. Bijvoorbeeld: /subscriptions/<your-subscription-id>/resourceGroups/<your-resource-group-name>/providers/Microsoft.Search/searchServices/<your-search-service-name> |
| Categorie | String | "OperationLogs". Deze waarde is een constante. OperationLogs is de enige categorie die wordt gebruikt voor resourcelogboeken. |
| OperationName | String | De naam van de bewerking (zie de volledige lijst met bewerkingen). Een voorbeeld is Query.Search |
| OperationVersion | String | De API-versie die wordt gebruikt voor de aanvraag. Bijvoorbeeld: 2024-07-01 |
| ResultType | String | "Geslaagd". Andere mogelijke waarden: Geslaagd of Mislukt |
| ResultSignature | Int | Een HTTP-resultaatcode. Bijvoorbeeld: 200 |
| DurationMS | Int | Duur van de bewerking in milliseconden. |
| Eigenschappen | Object | Object met bewerkingsspecifieke gegevens. Zie de volgende schematabel met eigenschappen. |
Eigenschappenschema
De volgende eigenschappen zijn specifiek voor Azure AI Search.
| Name | Type | Beschrijving en voorbeeld |
|---|---|---|
| Description_s | String | Het eindpunt van de bewerking. Bijvoorbeeld: GET /indexes('content')/docs |
| Documents_d | Int | Aantal verwerkte documenten. |
| IndexName_s | String | Naam van de index die aan de bewerking is gekoppeld. |
| Query_s | String | De queryparameters die in de aanvraag worden gebruikt. Bijvoorbeeld: ?search=beach access&$count=true&api-version=2024-07-01 |
OperationName-waarden (vastgelegde bewerkingen)
De volgende bewerkingen kunnen worden weergegeven in een resourcelogboek.
| OperationName | Beschrijving |
|---|---|
| DataSources.* | Van toepassing op gegevensbronnen van de indexeerfunctie. Kan worden gemaakt, verwijderd, get, list. |
| FoutopsporingSessions.* | Van toepassing op een foutopsporingssessie. Kan maken, verwijderen, ophalen, weergeven, starten en status zijn. |
| FoutopsporingSessions.DocumentStructure | Een verrijkt document wordt geladen in een foutopsporingssessie. |
| DebugSessions.RetrieveIndexerExecutionHistoricalData | Een aanvraag voor uitvoeringsdetails van de indexeerfunctie. |
| DebugSessions.RetrieveProjectedIndexerExecutionHistoricalData | Uitvoeringsgeschiedenis voor verrijkingen die naar een kennisarchief zijn geprojecteerd. |
| Indexeerfuncties.* | Van toepassing op een indexeerfunctie. Kan worden gemaakt, verwijderd, get, list en status. |
| Indexen.* | Is van toepassing op een zoekindex. Kan worden gemaakt, verwijderd, get, list. |
| Indexen. Prototype | Deze index wordt gemaakt door de wizard Gegevens importeren. |
| Indexeren.Index | Deze bewerking is een aanroep van indexdocumenten. |
| Metadata.GetMetadata | Een aanvraag voor zoekservicesysteemgegevens. |
| Query.AutoComplete | Een query voor automatisch aanvullen op basis van een index. Zie Querytypen en samenstelling. |
| Query.Lookup | Een opzoekquery op basis van een index. Zie Querytypen en samenstelling. |
| Query.Search | Een zoekopdracht in volledige tekst op basis van een index. Zie Querytypen en samenstelling. |
| Query.Suggest | Typ een vooruitquery op basis van een index. Zie Querytypen en samenstelling. |
| ServiceStats | Deze bewerking is een routine-aanroep voor servicestatistieken ophalen, die rechtstreeks of impliciet wordt aangeroepen om een overzichtspagina van de portal te vullen wanneer deze wordt geladen of vernieuwd. |
| Vaardighedensets.* | Is van toepassing op een vaardighedenset. Kan worden gemaakt, verwijderd, get, list. |
Gerelateerde inhoud
- Zie Azure AI Search bewaken voor een beschrijving van het bewaken van Azure AI Search.
- Zie Azure-resources bewaken met Azure Monitor voor meer informatie over het bewaken van Azure-resources.