Partager via


Référence des données de surveillance Recherche Azure AI

Cet article contient toutes les informations de référence de surveillance pour ce service.

Pour plus d’informations sur les données que vous pouvez collecter pour Recherche d’IA Azure et comment l’utiliser, consultez Monitor Azure AI Search .

Métriques

Cette section répertorie toutes les métriques de plateforme collectées automatiquement pour App Service. Ces métriques font également partie de la liste globale de toutes les métriques de plateforme prises en charge dans Azure Monitor.

Pour plus d’informations sur les métriques de surveillance, consultez la section Présentation des métriques Azure Monitor.

Métriques prises en charge pour Microsoft.Search/searchServices

Le tableau suivant répertorie les métriques disponibles pour le type de ressource Microsoft.Search/searchServices.

  • Toutes les colonnes peuvent ne pas être présentes dans chaque table.
  • Certaines colonnes peuvent dépasser la zone d’affichage de la page. Sélectionnez Développer la table pour afficher toutes les colonnes disponibles.

Titres du tableau

  • Catégorie : le groupe de métriques ou classification.
  • Métrique : nom complet de la métrique tel qu’il apparaît dans le portail Azure.
  • Nom dans l’API REST : le nom de la métrique comme appelé dans l’API REST.
  • Unité : unité de mesure.
  • Agrégation : le type d’agrégation par défaut. Valeurs valides : Moyen (moy), Minimum (min), Maximum (max), Total (somme), Nombre.
  • Dimensions - Dimensions disponibles pour la métrique.
  • Fragments de temps - Intervalles auxquels la métrique est échantillonnée. Par exemple, PT1M indique que la métrique est échantillonnée toutes les minutes, PT30M toutes les 30 minutes, PT1H toutes les heures, et ainsi de suite.
  • Exportation DS : indique si la métrique est exportable vers les journaux Azure Monitor via les paramètres de diagnostic. Pour plus d’informations sur l’exportation des métriques, consultez Créer des paramètres de diagnostic dans Azure Monitor.
Mesure Nom dans l’API REST Unité Agrégation Dimensions Fragments de temps Exportation DS
Nombre de documents traités

Nombre de documents traités
DocumentsProcessedCount Count Total (Somme), Nombre DataSourceName, , FailedIndexerName, , IndexNameSkillsetName PT1M Oui
Latence de recherche

Latence moyenne de recherche du service de recherche
SearchLatency Secondes Average <aucune> PT1M Oui
Requêtes de recherche par seconde

Requêtes de recherche par seconde pour le service de recherche
SearchQueriesPerSecond CountPerSecond Average <aucune> PT1M Oui
Nombre d’appels d’exécution de compétence

Nombre d’exécutions de compétences
SkillExecutionCount Count Total (Somme), Nombre DataSourceName, , Failed, SkillNameIndexerName, , SkillsetNameSkillType PT1M Oui
Pourcentage de requêtes de recherche limitées

Pourcentage de requêtes de recherche limitées par le service de recherche
ThrottledSearchQueriesPercentage Pourcentage Average <aucune> PT1M Oui

Requêtes de recherche par seconde

Cette métrique montre la moyenne des requêtes de recherche par seconde (QPS) pour le service de recherche. Il est courant que les requêtes s’exécutent en millisecondes. Seules les requêtes qui mesurent en secondes apparaissent dans une métrique comme QPS. La valeur minimale correspondra à la valeur la plus faible des requêtes de recherche par seconde qui a été enregistrée pendant cette minute. La valeur maximale est la valeur la plus élevée. La moyenne représentera l’agrégat de ces valeurs pour toute la minute.

Type d’agrégation Description
Moyenne Sur une période d'une minute, nombre moyen de secondes nécessaires à l'exécution de la requête.
Count Nombre de métriques émises dans le journal pendant l'intervalle d'une minute.
Maximum Nombre maximum de requêtes de recherche par seconde enregistrées en une minute.
Minimum Nombre minimum de requêtes de recherche par seconde enregistrées en une minute.
Somme Somme de toutes les requêtes exécutées pendant l'intervalle d'une minute.

Par exemple, sur une minute, le schéma peut être le suivant : une seconde de charge élevée, qui représente votre valeur SearchQueriesPerSecond maximale, puis 58 secondes de charge moyenne, et enfin une seconde avec une seule requête, qui représente la valeur minimale.

Autre exemple : si un nœud émet 100 métriques, sachant que la valeur de chaque métrique est égale à 40, alors "Count" = 100, "Sum" = 4000, "Average" = 40 et "Max" = 40.

Latence de recherche

La latence de recherche indique le temps nécessaire à l’exécution d’une requête.

Type d’agrégation Latence
Moyenne Durée moyenne de la requête en millisecondes.
Count Nombre de métriques émises dans le journal pendant l'intervalle d'une minute.
Maximum Requête la plus longue de l'échantillon.
Minimum Requête la plus courte de l'échantillon.
Total Durée d'exécution totale de toutes les requêtes de l'échantillon, exécutées dans l'intervalle (une minute).

Pourcentage de requêtes de recherche limitées

Cette métrique fait référence aux requêtes supprimées au lieu du traitement. La limitation se produit lorsque le nombre de requêtes en cours d’exécution dépasse la capacité. Vous pouvez constater une augmentation du nombre de demandes limitées lorsqu'un réplica est retiré de la rotation ou pendant l'indexation. Les demandes de requête et d'indexation sont gérées par le même ensemble de ressources.

Le service détermine s'il faut abandonner les demandes en fonction de la consommation des ressources. Le pourcentage de ressources consommées sur la mémoire, le processeur et les E/S disque est calculé en moyenne sur une période donnée. Si ce pourcentage dépasse un certain seuil, toutes les demandes adressées à l'index sont limitées jusqu'à ce que le volume de demandes baisse.

Selon votre client, une demande limitée est signalée comme suit :

  • Un service retourne une erreur "You are sending too many requests. Please try again later."
  • Un code d'erreur 503 est renvoyé pour indiquer que le service est indisponible.
  • Si vous utilisez le portail (par exemple, l'Explorateur de recherche), la requête est abandonnée en mode silencieux et vous devez à nouveau sélectionner Rechercher.

Pour confirmer les requêtes limitées, utilisez la métrique Requêtes de recherche limitées. Vous pouvez explorer les métriques sur le portail ou créer une métrique d'alerte comme décrit dans cet article. Pour les requêtes qui ont été abandonnées au cours de l'intervalle d'échantillonnage, utilisez Total afin d'obtenir le pourcentage de requêtes qui n'ont pas été exécutées.

Type d’agrégation Limitation
Moyenne Pourcentage de requêtes abandonnées pendant l'intervalle.
Count Nombre de métriques émises dans le journal pendant l'intervalle d'une minute.
Maximum Pourcentage de requêtes abandonnées pendant l'intervalle.
Minimum Pourcentage de requêtes abandonnées pendant l'intervalle.
Total Pourcentage de requêtes abandonnées pendant l'intervalle.

Pour Pourcentage de requêtes de recherche limitées, les valeurs minimales, maximales, moyennes et totales seront identiques : il s’agit du pourcentage de requêtes de recherche qui ont été limitées, en fonction du nombre total de requêtes de recherche pendant une minute.

Dimensions de métrique

Pour plus d’informations sur les dimensions de métrique, consultez Métriques multidimensionnelles.

Azure AI Search a des dimensions associées aux métriques suivantes qui capturent le nombre de documents ou de compétences exécutés.

Nom de métrique Description Dimensions Exemples de cas d’utilisation
Nombre de documents traités Indique le nombre de documents traités par l’indexeur. Nom de la source de données, échec, nom de l’index, nom de l’indexeur, nom de l’ensemble de compétences Peut être référencé comme une mesure approximative du débit (nombre de documents traités par l’indexeur au fil du temps)
- Configurer pour alerter sur les documents en échec
Nombre d’appels d’exécution de compétence Indique le nombre d’appels de compétences. Nom de la source de données, échec, nom de l’index, nom de l’indexeur, nom de la compétence, type de compétence, nom de l’ensemble de compétences Référence pour vous assurer que les compétences sont appelées comme prévu en comparant les nombres d’appels relatifs entre les compétences et le nombre d’appels de compétences au nombre de documents.
- Configurer pour alerter sur les appels de compétences en échec
Nom de la dimension Description
DataSourceName Une connexion à une source de données nommée utilisée pendant l’exécution de l’indexeur. Les valeurs valides sont l’un des types de sources de données pris en charge.
Échec Indique si l’instance a échoué.
IndexerName Nom d’un indexeur.
IndexName Nom d’un index.
SkillsetName Nom des compétences utilisées pendant l’exécution de l’indexeur.
SkillName Nom d’une compétence au sein d’une compétence.
SkillType @odata.type de la compétence.

Journaux d’activité de ressources

Cette section répertorie les types de journaux d’activité de ressources que vous pouvez collecter pour ce service. La section extrait la liste de tous les types de catégorie de journaux d’activité de ressources pris en charge dans Azure Monitor.

Journaux de ressources pris en charge pour Microsoft.Search/searchServices

Category Nom complet de la catégorie Table de journal Prend en charge le plan de journal de base Prend en charge la transformation de la durée d’ingestion Exemples de requêtes Coûts d’exportation
OperationLogs Journaux d’activité des opérations AzureDiagnostics

Journaux d’activité de plusieurs ressources Azure.

Non Non Non

Tables Azure Monitor Logs

Cette section répertorie les tables de journaux Azure Monitor pertinentes pour ce service, disponibles pour une requête par l’analytique des journaux d’activité à l’aide de requêtes Kusto. Les tables contiennent les données du journal des ressources et éventuellement d’autres données en fonction de ce qui est collecté et acheminé vers elles.

Services Recherche

Microsoft.Search/searchServices

Table Description
AzureActivity Les entrées du journal d’activité Azure fournissent des informations sur les opérations du plan de contrôle. Les tâches appelées sur le plan de contrôle, telles que l’ajout ou la suppression de réplicas et de partitions, sont représentées par le biais d’une activité « Obtenir une clé d’administration ».
AzureDiagnostics Opérations de requête et d’indexation journalisées. Les requêtes sur la table AzureDiagnostics dans Log Analytics peuvent inclure les propriétés communes, les propriétés spécifiques à la recherche et les opérations spécifiques à la recherche répertoriées dans la section référence du schéma.
AzureMetrics Données de métriques émises par Recherche Azure AI qui mesurent l’intégrité et les performances.

Tables du journal des ressources

Le tableau suivant répertorie les propriétés des journaux de ressources dans Recherche IA Azure. Les journaux de ressources sont collectés dans les journaux d’activité Azure Monitor journaux ou dans Stockage Azure. Dans Azure Monitor, les journaux sont collectés dans la table AzureDiagnostics sous le nom du fournisseur de ressources .Microsoft.Search

Propriété ou champ du stockage Azure Propriété des journaux Azure Monitor Description
time timestamp Date et heure (UTC) de l’opération.
resourceId Concat(« / », « /subscriptions », SubscriptionId, « resourceGroups », ResourceGroupName, « providers/Microsoft.Search/searchServices », ServiceName) Ressource Recherche d’IA Azure pour laquelle les journaux d’activité sont activés.
category « OperationLogs » Les catégories de journaux incluent Audit, , OperationalExecutionet Request.
operationName Nom Nom de l’opération. Le nom de l’opération peut être Indexes.ListIndexStatsSummaries, Query.SearchIndexes.StatsIndexes.GetQuery.SuggestQuery.LookupIndexers.ListIndexes.PrototypeIndexes.UpdateQuery.AutocompleteCORS.Preflight, ServiceStats, . DataSources.ListIndexers.Warmup
durationMS DurationMilliseconds Durée de l’opération en millisecondes.
operationVersion ApiVersion Version de l’API utilisée sur la demande.
resultType (Échec) ? « Échec » : « Réussite » Type de réponse.
resultSignature État État de la réponse HTTP de l’opération.
properties Propriétés Toutes les propriétés étendues associées à cette catégorie d’événements.

Journal d’activité

La table liée répertorie les opérations qui peuvent être enregistrées dans le journal d’activité de ce service. Ces opérations constituent un sous-ensemble de toutes les opérations possibles du fournisseur de ressources dans le journal d’activité.

Pour plus d’informations sur le schéma des entrées du journal d’activité, consultez Schéma du journal d’activité.

Le tableau suivant répertorie les opérations courantes liées à Recherche AZURE AI qui peuvent être enregistrées dans le journal d’activité. Pour obtenir la liste complète de toutes les opérations Microsoft.Search, consultez les opérations du fournisseur de ressources Microsoft.Search.

Operation Description
Obtenir la clé d’administration Toute opération nécessitant des droits d’administration est enregistrée sous la forme d’une opération « Obtenir une clé d’administration ».
Obtenir la clé de requête Toute opération en lecture seule sur la collection de documents d’un index.
Régénération de clé d'administration Demande de régénération de la clé d’API d’administration principale ou secondaire.

Parmi les entrées courantes figurent les références à des clés API, à savoir des notifications d’information génériques comme Obtenir une clé d’administration et Obtenir des clés de requête. Ces activités indiquent les demandes effectuées à l’aide de la clé d’administration (créer ou supprimer des objets) ou de la clé de requête, mais n’affichent pas la requête elle-même. Pour plus d’informations de ce fragment, vous devez configurer la journalisation des ressources.

Vous pouvez également obtenir des informations sur l’historique des modifications. Dans le Portail Azure, sélectionnez l’activité à ouvrir la page de détails, puis sélectionnez « Historique des modifications » pour plus d’informations sur l’opération sous-jacente.

Autres schémas

Les schémas suivants sont utilisés pour ce service.

Si vous créez des requêtes ou des rapports personnalisés, les structures de données qui contiennent des journaux de ressources Recherche Azure AI sont conformes aux schémas suivants.

Pour les journaux de ressources envoyés au stockage d’objets blob, chaque objet blob a un objet racine appelé records contenant un tableau d’objets de journal. Chaque objet blob contient des enregistrements de toutes les opérations qui ont eu lieu au cours de la même heure.

Schéma des journaux de ressource

Tous les journaux de ressources disponibles via Azure Monitor partagent un schéma de niveau supérieur commun. Recherche Azure AI complète avec plus de propriétés et d’opérations propres à un service de recherche.

L’exemple suivant illustre un journal des ressources qui comprend des propriétés communes (TimeGenerated, Resource, Category, etc.) et des propriétés spécifiques à la recherche (OperationName et OperationVersion).

Nom Type Description et exemple
TimeGenerated DateHeure Horodatage de l’opération. Par exemple : 2021-12-07T00:00:43.6872559Z
Ressource Chaîne ID de la ressource Par exemple : /subscriptions/<your-subscription-id>/resourceGroups/<your-resource-group-name>/providers/Microsoft.Search/searchServices/<your-search-service-name>
Catégorie Chaîne "OperationLogs". Cette valeur est une constante. OperationLogs est la seule catégorie utilisée pour les journaux de ressources.
NomOpération Chaîne Nom de l’opération (voir la liste complète des opérations). Par exemple Query.Search.
OperationVersion Chaîne Version de l’API utilisée sur la requête. Par exemple : 2024-07-01
ResultType Chaîne "Success". Autres valeurs possibles : Réussite ou Échec
ResultSignature Int Un code de résultat HTTP. Par exemple : 200
DurationMS Int Durée de l’opération en millisecondes.
Propriétés Objet Objet contenant des données propres à l’opération. Consultez la table de schéma des propriétés ci-dessous.

Schéma de propriétés

Les propriétés suivantes sont spécifiques à Azure AI Search.

Nom Type Description et exemple
Description_s Chaîne Point de terminaison de l’opération. Par exemple : GET /indexes('content')/docs
Documents_d Int Nombre de documents traités.
IndexName_s Chaîne Nom de l’index associé à l’opération.
Query_s Chaîne Paramètres de requête utilisés dans la requête. Par exemple : ?search=beach access&$count=true&api-version=2024-07-01

Valeurs OperationName (opérations journalisées)

Les opérations suivantes peuvent apparaître dans un journal des ressources.

NomOpération Description
DataSources.* S’applique aux sources de données de l’indexeur. Peut être Create, Delete, Get, List.
DebugSessions.* S’applique à une session de débogage. Peut être Create, Delete, Get, List, Start et Status.
DebugSessions.DocumentStructure Un document enrichi est chargé dans une session de débogage.
DebugSessions.RetrieveIndexerExecutionHistoricalData Requête de détails sur l’exécution de l’indexeur.
DebugSessions.RetrieveProjectedIndexerExecutionHistoricalData Historique d’exécution pour les enrichissements projetés dans une base de connaissances.
Indexeurs.* S’applique à un indexeur. Peut être Create, Delete, Get, List ou Status.
Index.* S’applique à un index de recherche. Peut être Create, Delete, Get, List.
indexes.Prototype Cet index est créé par l’Assistant Importation de données.
Indexing.Index Cette opération est un appel à indexer des documents.
Metadata.GetMetadata Demande de données du système de service de recherche.
Query.Autocomplete Requête de saisie semi-automatique sur un index. Voir Types de requêtes et composition.
Query.Lookup Requête de recherche sur un index. Voir Types de requêtes et composition.
Query.Search Demande de recherche en texte intégral sur un index. Voir Types de requêtes et composition.
Query.Suggest Requête de saisie anticipée sur un index. Voir Types de requêtes et composition.
ServiceStats Cette opération est un appel de routine à Get Service Statistics, appelé directement ou implicitement pour remplir une page de vue d’ensemble du portail lorsqu’elle est chargée ou actualisée.
Ensembles de compétences.* S’applique à un ensemble de compétences. Peut être Create, Delete, Get, List.