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.
PT1Mbedeutet zum Beispiel, dass die Metrik jede Minute abgerufen wird,PT30Malle 30 Minuten,PT1Hjede 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 |
SearchQueriesPerSecond zeigt den Durchschnitt 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.
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.
Metrikdimensionen
Informationen darüber, was metrische Dimensionen sind, finden Sie unter Mehrdimensionale Metriken.
Azure AI Search weist die folgenden Dimensionen auf, die den Metriken zugeordnet sind, die eine Anzahl von Dokumenten oder Fähigkeiten erfassen, die ausgeführt wurden, "Anzahl der verarbeiteten Dokumente" und "Anzahl der Aufrufe der Fähigkeitsausführung".
| 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
In diesem Abschnitt werden die Azure Monitor Logs-Tabellen aufgeführt, die für diesen Dienst relevant sind, die für abfragen von Log Analytics mithilfe von Kusto-Abfragen verfügbar sind. Die Tabellen enthalten Ressourcenprotokolldaten und möglicherweise mehr, je nachdem, was gesammelt 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: 2020-06-30 |
| 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=2020-06-30 |
„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
- 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.