Teilen über

Azure KI-Suche-Überwachungsdatenreferenz

  • Artikel

Dieser Artikel enthält alle Referenzinformationen zur Überwachung dieses Dienstes.

Details zu den Daten, die Sie für Azure AI Search sammeln können, und deren Verwendung finden Sie unter "Überwachen von Azure AI Search ".

Metriken

In diesem Abschnitt werden alle automatisch erfassten Plattformmetriken für diesen Dienst aufgeführt. Diese Metriken sind auch Teil der globalen Liste aller in Azure Monitor unterstützten Plattformmetriken.

Informationen zur Aufbewahrung von Metriken finden Sie unter Überblick über Metriken in Azure Monitor.

Unterstützte Metriken für Microsoft.Search/searchServices

In der folgenden Tabelle sind die Metriken aufgeführt, die für den Ressourcentyp "Microsoft.Search/searchServices" verfügbar sind.

  • Möglicherweise sind nicht alle Spalten in jeder Tabelle vorhanden.
  • Einige Spalten können über den Anzeigebereich der Seite hinausgehen. Wählen Sie Tabelle erweitern aus, um alle verfügbaren Spalten anzuzeigen.

Tabellenüberschriften

  • Kategorie – Die Metrikgruppe oder -klassifizierung.
  • Metrik – Der Anzeigename der Metrik, wie er im Azure-Portal angezeigt wird.
  • Name in REST-API: Der Metrikname im REST-API
  • Einheit – Abrechnungseinheit.
  • Aggregation – Der Standard-Aggregationstyp. Gültige Werte: Mittelwert (Avg), Minimum (Min), Maximum (Max), Gesamt (Sum), Anzahl
  • Dimensionen - Für die Metrik verfügbare Dimensionen.
  • Aggregationsintervall - Intervalle, in denen die Metrik gesampelt wird. PT1M bedeutet zum Beispiel, dass die Metrik jede Minute abgerufen wird, PT30M alle 30 Minuten, PT1H jede Stunde usw.
  • DS-Export – Gibt an, ob die Metrik über Diagnose-Einstellungen in Azure Monitor-Protokolle exportiert werden kann. Informationen zum Exportieren von Metriken finden Sie unter Diagnoseeinstellungen in Azure Monitor erstellen.
Metrik Name in der REST-API Einheit Aggregation Dimensionen Aggregationsintervalle DS-Export
Anzahl der verarbeiteten Dokumente

Anzahl von verarbeiteten Dokumenten		 DocumentsProcessedCount Anzahl Gesamtanzahl DataSourceName, , FailedIndexerName, , IndexNameSkillsetName PT1M Ja
Suchlatenz

Durchschnittliche Suchlatenz für den Suchdienst		 SearchLatency Sekunden Average <none> PT1M Ja
Suchabfragen pro Sekunde

Suchabfragen pro Sekunde für den Suchdienst		 SearchQueriesPerSecond Anzahl pro Sekunde Average <none> PT1M Ja
Anzahl der Fähigkeitsausführungsaufrufe

Anzahl der Skillausführungen		 SkillExecutionCount Anzahl Gesamtanzahl DataSourceName, , FailedIndexerName, SkillName, , SkillsetNameSkillType PT1M Ja
Prozentsatz der gedrosselten Suchabfragen

Prozentsatz der Suchabfragen, die für den Suchdienst gedrosselt wurden		 ThrottledSearchQueriesPercentage Percent Average <none> PT1M Ja

Suchabfragen pro Sekunde

Diese Metrik zeigt den Mittelwert der Suchabfragen pro Sekunde (QPS) für den Suchdienst an. Es ist üblich, dass Abfragen in Millisekunden ausgeführt werden, sodass nur Abfragen, die als Sekunden messen, in einer Metrik wie QPS angezeigt werden. Bei der Metrik „SearchQueriesPerSecond“ ist der Mindestwert der niedrigste Wert für Suchabfragen pro Sekunde, der während dieser Minute registriert wurde. Maximum ist der höchste Wert. Der Durchschnittswert ist das Aggregat der gesamten Minute.

Aggregationstyp Beschreibung
Average Die durchschnittliche Anzahl von Sekunden innerhalb einer Minute, in der die Abfrageausführung erfolgt ist.
Anzahl Anzahl der Metriken, die innerhalb des Ein-Minuten-Intervalls an das Protokoll ausgegeben werden.
Maximum Die höchste Anzahl von Suchabfragen pro Sekunde, die während einer Minute erfasst wurden.
Mindestanforderungen Die niedrigste Anzahl von Suchabfragen pro Sekunde, die während einer Minute erfasst wurden.
Sum Die Summe aller Abfragen, die innerhalb der Minute ausgeführt wurden.

Innerhalb einer Minute kann beispielsweise folgendes Muster vorliegen: Für eine Sekunde tritt eine sehr hohe Last auf (dies ist der Höchstwert für „SearchQueriesPerSecond“), gefolgt von 58 Sekunden mit mittlerer Last sowie einer Sekunde mit nur einer Abfrage, was der Mindestwert ist.

Ein weiteres Beispiel: Wenn ein Knoten 100 Metriken ausgibt, bei denen der Wert jeder Metrik 40 beträgt, weist „Count“ den Wert „100“, „Sum“ den Wert „4000“, „Average“ den Wert „40“ und „Max“ den Wert „40“ auf.

Wartezeit bei Suchvorgängen

Die Suchlatenz gibt an, wie lange eine Abfrage benötigt, bis sie abgeschlossen ist.

Aggregationstyp Latency
Average Durchschnittliche Abfragedauer in Millisekunden.
Anzahl Anzahl der Metriken, die innerhalb des Ein-Minuten-Intervalls an das Protokoll ausgegeben werden.
Maximum Die Abfrage mit der längsten Ausführungszeit in der Stichprobe.
Mindestanforderungen Die Abfrage mit der kürzesten Ausführungszeit in der Stichprobe.
Summe Gesamtausführungszeit aller Abfragen in der Stichprobe, die innerhalb des Intervalls (eine Minute) ausgeführt werden.

Gedrosselte Suchabfragen in Prozent

Diese Metrik bezieht sich auf Abfragen, die statt verarbeitet werden. Eine Drosselung tritt auf, wenn die Anzahl von Anforderungen, die sich in Ausführung befinden, die Kapazität überschreitet. Wenn ein Replikat aus der Rotation herausgenommen wird, oder während der Indizierung kann es zu einer Erhöhung der gedrosselten Anforderungen kommen. Abfrage- und Indizierungsanforderungen werden vom selben Ressourcensatz verarbeitet.

Der Dienst bestimmt, ob Anforderungen basierend auf der Ressourcennutzung gelöscht werden. Der Prozentsatz der für Arbeitsspeicher, CPU und Datenträger-E/AE genutzten Ressourcen wird als Durchschnittswert über einen bestimmten Zeitraum berechnet. Wenn dieser Prozentsatz einen Schwellenwert überschreitet, werden alle Anforderungen an den Index gedrosselt, bis die Anzahl der Anforderungen reduziert wird.

Abhängig vom Client wird eine gedrosselte Anforderung wie folgt angezeigt:

  • Ein Dienst gibt den Fehler "You are sending too many requests. Please try again later." zurück.
  • Ein Dienst gibt einen 503-Fehlercode zurück, der angibt, dass der Dienst derzeit nicht verfügbar ist.
  • Wenn Sie das Portal verwenden (z. B. den Suchexplorer), wird die Abfrage automatisch gelöscht, und Sie müssen erneut Suchen auswählen.

Um gedrosselte Abfragen zu bestätigen, verwenden Sie die Metrik Gedrosselte Suchabfragen. Sie können Metriken im Portal untersuchen oder eine Warnungsmetrik erstellen, wie in diesem Artikel beschrieben. Verwenden Sie für Abfragen, die innerhalb des Intervalls für die Stichprobenentnahme gelöscht wurden, die Option Gesamt, um den Prozentsatz nicht ausgeführter Abfragen zu erhalten.

Aggregationstyp Drosselung
Average Prozentsatz der innerhalb des Intervalls gelöschten Abfragen.
Anzahl Anzahl der Metriken, die innerhalb des Ein-Minuten-Intervalls an das Protokoll ausgegeben werden.
Maximum Prozentsatz der innerhalb des Intervalls gelöschten Abfragen.
Mindestanforderungen Prozentsatz der innerhalb des Intervalls gelöschten Abfragen.
Summe Prozentsatz der innerhalb des Intervalls gelöschten Abfragen.

Für Gedrosselte Suchabfragen in Prozent entsprechen der Mindest-, Höchst-, Durchschnitts- und Gesamtwert demselben Wert, nämlich dem Prozentsatz von Suchabfragen, die gedrosselt wurden, basierend auf der Gesamtanzahl von Suchabfragen während einer Minute.

Metrikdimensionen

Informationen darüber, was metrische Dimensionen sind, finden Sie unter Mehrdimensionale Metriken.

Azure AI Search verfügt über Dimensionen, die den folgenden Metriken zugeordnet sind, die eine Anzahl von Dokumenten oder Fähigkeiten erfassen, die ausgeführt wurden.

Metrikname Beschreibung Dimensionen Beispiele für Anwendungsfälle
Anzahl der verarbeiteten Dokumente Zeigt die Anzahl der vom Indexer verarbeiteten Dokumente an. Datenquellenname, Fehler, Indexname, Indexername, Skillsetname Kann als grobes Maß für den Durchsatz referenziert werden (Anzahl der dokumente, die im Laufe der Zeit vom Indexer verarbeitet werden)
– Wird für Warnungen bei fehlerhaften Dokumenten eingerichtet.
Anzahl der Fähigkeitsausführungsaufrufe Zeigt die Anzahl der Skillaufrufe an. Datenquellenname, Fehler, Indexname, Indexername, Skillname, Skilltyp, Skillsetname Referenz, um sicherzustellen, dass Fähigkeiten wie erwartet aufgerufen werden, indem relative Aufrufzahlen zwischen Fähigkeiten und Anzahl der Fähigkeitsaufrufe mit der Anzahl der Dokumente verglichen werden.
– Wird für Warnungen bei fehlerhaften Skillaufrufen eingerichtet.
Dimensionsname Beschreibung
DataSourceName Eine benannte Datenquellenverbindung, die während der Indexerausführung verwendet wird. Gültige Werte sind eine der unterstützten Datenquellentypen.
Fehler Gibt an, ob bei der Instanz ein Fehler aufgetreten ist.
IndexerName Name eines Indexers.
IndexName Name eines Indizes.
SkillsetName Name eines Skillsets, das während der Indexerausführung verwendet wird.
SkillName Name eines Skills innerhalb eines Skillsets.
SkillType Der @odata.type des Skills.

Ressourcenprotokolle

In diesem Abschnitt werden die Ressourcenprotokolltypen aufgeführt, die für diesen Service erfasst werden können. Der Abschnitt wird aus der Liste aller in Azure Monitor unterstützten Kategorietypen für Ressourcenprotokolle gezogen.

Unterstützte Ressourcenprotokolle für Microsoft.Search/searchServices

Kategorie Anzeigename der Kategorie Protokolltabelle Unterstützt grundlegenden Protokollplan Unterstützt die Erfassungszeittransformation Beispielabfragen Exportkosten
OperationLogs Vorgangsprotokolle AzureDiagnostics

Protokolle aus mehreren Azure-Ressourcen.

 No Nr. No

Tabellen in Azure Monitor-Protokollen

Dieser Abschnitt bezieht sich die für diesen Service relevanten Azure-Monitor-Protokolltabellen, die für die Abfrage durch Protokollanalyse mit Kusto-Abfragen zur Verfügung stehen. Diese Tabellen enthalten Ressourcenprotokolldaten und möglicherweise mehr, je nachdem, was erfasst und an sie weitergeleitet wird.

Suchdienste

Microsoft.Search/searchServices

Tabelle Beschreibung
AzureActivity Einträge aus dem Azure-Aktivitätsprotokoll bieten Einblicke in Steuerungsebenenvorgänge. Aufgaben, die auf der Steuerungsebene aufgerufen werden, z. B. das Hinzufügen oder Entfernen von Replikaten und Partitionen, werden durch eine Aktivität "Administratorschlüssel abrufen" dargestellt.
AzureDiagnostics Protokollierte Abfrage- und Indizierungsvorgänge. Abfragen für die AzureDiagnostics-Tabelle in Log Analytics können die allgemeinen Eigenschaften, die suchspezifischen Eigenschaften und die im Schemareferenzabschnitt aufgeführten suchspezifischen Vorgänge enthalten.
AzureMetrics Metrikdaten, die von Azure AI Search ausgegeben werden, die Integrität und Leistung messen.

Ressourcenprotokolltabellen

In der folgenden Tabelle sind die Eigenschaften von Ressourcenprotokollen in Azure AI Search aufgeführt. Die Ressourcenprotokolle werden in Azure Monitor-Protokollen oder in Azure Storage erfasst. In Azure Monitor werden Protokolle in der Tabelle "AzureDiagnostics" unter dem Namen des Ressourcenanbieters Microsoft.Searcherfasst.

Azure Storage-Feld oder -Eigenschaft Eigenschaft von Azure Monitor-Protokolle BESCHREIBUNG
time TIMESTAMP Datum und Uhrzeit (UTC), zu denen der Vorgang aufgetreten ist.
Ressourcen-ID Concat("/", "/subscriptions", SubscriptionId, "resourceGroups", ResourceGroupName, "providers/Microsoft.Search/searchServices", ServiceName) Die Azure AI Search-Ressource, für die Protokolle aktiviert sind.
category „OperationLogs“ Protokollkategorien umfassen Audit, , Operational, Executionund Request.
operationName Name Name des Vorgangs. Der Vorgangsname kann Indexes.ListIndexStatsSummaries, , Indexes.StatsIndexes.Get, Indexers.List, Query.Search, , Query.Suggest, , Query.Lookup, CORS.PreflightQuery.Autocomplete, Indexes.Update, , Indexes.Prototype, ServiceStats, , . DataSources.List. . Indexers.Warmup
durationMS DurationMilliseconds Die Dauer des Vorgangs in Millisekunden.
operationVersion ApiVersion Die API-Version, die für die Anforderung verwendet wird.
resultType (Fehlgeschlagen) ? "Failed" : "Success" Der Typ der Antwort.
resultSignature Status Der HTTP-Antwortstatus des Vorgangs.
properties Eigenschaften Erweiterte Eigenschaften, die sich auf diese Kategorie von Ereignissen beziehen.

Aktivitätsprotokoll

In der verknüpften Tabelle sind die Vorgänge aufgeführt, die im Aktivitätsprotokoll für diesen Dienst aufgezeichnet werden können. Diese Operationen sind eine Teilmenge aller möglichen Ressourcenanbietervorgänge im Aktivitätsprotokoll.

Weitere Informationen zum Schema von Aktivitätsprotokolleinträgen finden Sie unter Ereignisschema des Azure-Aktivitätsprotokolls.

In der folgenden Tabelle sind allgemeine Vorgänge im Zusammenhang mit Azure AI Search aufgeführt, die im Aktivitätsprotokoll aufgezeichnet werden können. Eine vollständige Auflistung aller Microsoft.Search-Vorgänge finden Sie unter Microsoft.Search-Ressourcenanbietervorgänge.

Vorgang Beschreibung
Abrufen des Administratorschlüssels Jeder Vorgang, der Administratorrechte erfordert, wird als Vorgang "Administratorschlüssel abrufen" protokolliert.
Abrufen des Abfrageschlüssels Alle schreibgeschützten Vorgänge für die Dokumentsammlung eines Indexes.
Erneutes Generieren des Administratorschlüssels Eine Anforderung zum erneuten Generieren des primären oder sekundären Administrator-API-Schlüssels.

Zu den üblichen Einträgen zählen Verweise auf API-Schlüssel, d. h. generische informative Benachrichtigungen wie Get Admin Key (Administratorschlüssel abrufen) und Get Query Keys (Abfrageschlüssel abrufen). Diese Aktivitäten geben Anforderungen an, die mit dem Administratorschlüssel (Erstellen oder Löschen von Objekten) oder Abfrageschlüsseln vorgenommen wurden, aber die Anforderung selbst nicht anzeigen. Um weitere Informationen auf dieser Ebene zu erhalten, müssen Sie die Diagnoseprotokollierung konfigurieren.

Alternativ können Sie auch einen Einblick durch den Änderungsverlauf erhalten. Wählen Sie im Azure-Portal die Aktivität aus, um die Detailseite zu öffnen, und wählen Sie dann "Änderungsverlauf" aus, um Informationen zum zugrunde liegenden Vorgang zu erhalten.

Andere Schemas

Die folgenden Schemas werden für diesen Dienst verwendet.

Wenn Sie Abfragen oder benutzerdefinierte Berichte erstellen, entsprechen die Datenstrukturen, die Azure AI Search-Ressourcenprotokolle enthalten, den folgenden Schemas.

Bei Ressourcenprotokolle, die an den Blobspeicher geschickt werden, hat jedes Blob ein Stammobjekt mit dem Namen records, das ein Array von Protokollobjekten enthält. Jedes Blob enthält Einträge zu allen Vorgängen, die während einer bestimmten Stunde erfolgt sind.

Ressourcenprotokollschema

Alle Ressourcenprotokolle, die über Azure Monitor verfügbar sind, verwenden ein gemeinsames Schema der obersten Ebene. Azure AI Search ergänzt weitere Eigenschaften und Vorgänge , die für einen Suchdienst einzigartig sind.

Das folgende Beispiel veranschaulicht ein Ressourcenprotokoll, das allgemeine Eigenschaften (TimeGenerated, Resource, Category usw.) und suchspezifische Eigenschaften (OperationName und OperationVersion) enthält.

Name Typ Beschreibung und Beispiel
TimeGenerated Datetime Zeitstempel des Vorgangs. Beispiel: 2021-12-07T00:00:43.6872559Z
Resource String Ressourcen-ID Beispiel: /subscriptions/<your-subscription-id>/resourceGroups/<your-resource-group-name>/providers/Microsoft.Search/searchServices/<your-search-service-name>
Kategorie String „OperationLogs“. Dieser Wert ist eine Konstante. „OperationLogs“ ist die einzige Kategorie, die für Ressourcenprotokolle verwendet wird.
Vorgangsname String Der Name des Vorgangs (siehe vollständige Liste der Vorgänge). Beispiel: Query.Search.
OperationVersion String Die in der Anforderung verwendete API-Version. Beispiel: 2023-11-01
ResultType String „Success“. Andere mögliche Werte: „Success“ oder „Failure“
ResultSignature Int Ein HTTP-Ergebniscode. Beispiel: 200
DurationMS Int Dauer des Vorgangs in Millisekunden
Eigenschaften Object Objekt, das vorgangsspezifische Daten enthält. Weitere Informationen finden Sie in der folgenden Eigenschaftenschematabelle.

Eigenschaftsschema

Die folgenden Eigenschaften sind spezifisch für Azure AI Search.

Name Typ Beschreibung und Beispiel
Description_s String Endpunkt des Vorgangs. Beispiel: GET /indexes('content')/docs
Documents_d Int Anzahl der verarbeiteten Dokumente.
IndexName_s String Name des Indexes, der dem Vorgang zugeordnet ist.
Query_s String Die in der Anforderung verwendeten Abfrageparameter. Beispiel: ?search=beach access&$count=true&api-version=2023-11-01

„OperationName“-Werte (protokollierte Vorgänge)

Die folgenden Vorgänge können in einem Ressourcenprotokoll angezeigt werden.

Vorgangsname Beschreibung
DataSources.* Gilt für Indexerdatenquellen. Kann „Create“, „Delete“, „Get“, „List“ sein.
DebugSessions.* Gilt für eine Debugsitzung. Kann „Create“, „Delete“, „Get“, „List“, „Start“ und „Status“ sein.
DebugSessions.DocumentStructure Ein angereichertes Dokument wird in eine Debugsitzung geladen.
DebugSessions.RetrieveIndexerExecutionHistoricalData Eine Anforderung für Indexerausführungsdetails.
DebugSessions.RetrieveProjectedIndexerExecutionHistoricalData Ausführungsverlauf für Anreicherungen, die in einen Wissensspeicher projiziert werden.
Indexers.* Gilt für einen Indexer. Kann „Create“, „Delete“, „Get“, „List“ und „Status“ sein.
Indexes.* Gilt für einen Suchindex. Kann „Create“, „Delete“, „Get“, „List“ sein.
indexes.Prototype Dieser Index wird vom Assistenten zum Importieren von Daten erstellt.
Indexing.Index Dieser Vorgang dient dem Hinzufügen, Aktualisieren oder Löschen von Dokumenten.
Metadata.GetMetadata Eine Anforderung für Suchdienstsystemdaten.
Query.Autocomplete Eine AutoVervollständigen-Abfrage für einen Index. Weitere Informationen finden Sie unter Abfragetypen und Komposition.
Query.Lookup Eine Lookup-Abfrage für einen Index. Weitere Informationen finden Sie unter Abfragetypen und Komposition.
Query.Search Eine Volltextsuchanforderung für einen Index. Weitere Informationen finden Sie unter Abfragetypen und Komposition.
Query.Suggest Geben Sie eine Ahead-Abfrage für einen Index ein. Weitere Informationen finden Sie unter Abfragetypen und Komposition.
ServiceStats Bei diesem Vorgang handelt es sich um einen Routineaufruf zum Abrufen von Dienststatistiken, der entweder direkt oder implizit aufgerufen wird, um eine Portalübersichtsseite aufzufüllen, wenn sie geladen oder aktualisiert wird.
Skillsets.* Gilt für ein Skillset. Kann „Create“, „Delete“, „Get“, „List“ sein.

Zugehöriger Inhalt