Azure KI-Suche-Überwachungsdatenreferenz
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 | Summe (Summe), Anzahl | DataSourceName , , Failed IndexerName , , IndexName SkillsetName |
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 | Summe (Summe), Anzahl | DataSourceName , , Failed IndexerName , SkillName , , SkillsetName SkillType |
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.Search
erfasst.
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 , Execution und Request . |
operationName | Name | Name des Vorgangs. Der Vorgangsname kann Indexes.ListIndexStatsSummaries , , Indexes.Stats Indexes.Get , Indexers.List , Query.Search , , Query.Suggest , , Query.Lookup , CORS.Preflight Query.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: 2024-07-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=2024-07-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 ist ein Aufruf von Index Documents. |
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
- Eine Beschreibung der Überwachung von Azure AI Search finden Sie unter Überwachen von Azure AI Search .
- Weitere Informationen zur Überwachung von Azure-Ressourcen finden Sie unter Überwachen von Azure-Ressourcen mit Azure Monitor.