Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Note
Recherche Azure AI est disponible via le portail Azure, les API REST et les SDK Azure. Il sous-tend également Foundry IQ, la couche de connaissances managée qui transforme le contenu d’entreprise en bases de connaissances réutilisables et prenant en charge les autorisations pour les agents dans le portail Microsoft Foundry.
Cet article contient toutes les informations de référence de surveillance pour ce service.
Consultez Monitor Recherche Azure AI pour plus d’informations sur les données que vous pouvez collecter pour Recherche Azure AI et comment l’utiliser.
Métriques
Cette section liste tous les indicateurs de plateforme collectés automatiquement pour ce service. Ces indicateurs font également partie de la liste mondiale des indicateurs de toutes les plateformes pris en charge dans Azure Monitor.
Pour des informations sur la rétention des métriques, voir Azure Monitor Aperçu des métriques.
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 ne sont peut-être pas présentes dans chaque tableau.
- Certaines colonnes peuvent être au-delà de la zone de vue de la page. Sélectionnez Tableau agrandi pour voir toutes les colonnes disponibles.
En-têtes de tableau
- Catégorie - Le groupe métrique ou la classification.
- Metric - Le nom d’affichage métrique tel qu’il apparaît dans le portail Azure.
- Nom dans l’API REST - Le nom de la métrique tel qu’il est mentionné dans l’API REST.
- Unité - Unité de mesure.
- Agrégation - Le type d’agrégation par défaut. Valeurs valides : Moyenne (moyenne), Minimum (Min), Maximum (Max), Total (Somme), Compte.
- Dimensions - Dimensions disponibles pour la métrique.
-
Graaux temporels - Intervalles auxquels la métrique est échantillonnée. Par exemple,
PT1Mindique que la métrique est échantillonnée toutes les minutes,PT30Mtoutes les 30 minutes,PT1Htoutes les heures, etc. - DS Export - Si la métrique est exportable vers Azure Monitor Logs via les paramètres de diagnostic. Pour des informations sur l’exportation des métriques, voir Créer des paramètres de diagnostic dans Azure Monitor.
| Métrique | Nom dans l’API REST | Métriques avancées de la plateforme | Unité | Agrégation | Dimensions | Grains de temps | Exportation DS |
|---|---|---|---|---|---|---|---|
|
Fichiers traités de l’indexeur (octets) Nombre total d’octets de données sources traités par les indexeurs à partir d’une source de données basée sur des fichiers (par exemple, Blob, ADLS Gen2, File, SharePoint, OneLake) |
DocumentsProcessedBytes |
Non | Octets | Total (Somme), Moyenne |
DataSourceName, IndexerName, IndexName |
PT1M | Oui |
|
Nombre de documents traités Nombre de documents traités |
DocumentsProcessedCount |
Non | Compter | Total (Somme), Nombre |
DataSourceName, , FailedIndexerName, , IndexNameSkillsetName |
PT1M | Oui |
|
Utilisation du stockage Utilisation du stockage (texte + vecteur) pour le service de recherche par index |
IndexStorageUsage |
Non | Octets | Moyenne, Maximum, Minimum | IndexName |
PT1M | Oui |
|
Utilisation du stockage vectoriel Utilisation du stockage vectoriel pour le service de recherche par index |
IndexVectorUsage |
Non | Octets | Moyenne, Maximum, Minimum | IndexName |
PT1M | Oui |
|
Unités de calcul utilisées Unités de calcul consommées par les opérations du service de recherche et les fenêtres de préchauffage de l’index, en micro-CU-heures (divisez le total par 1 000 000 pour obtenir des CU-heures). Le filtre d’état est déconseillé. |
PerRequestComputeConsumption |
Non | Compter | Total (Somme), Moyenne |
Status, IndexName, ResourceKind, EventType |
PT1M | Oui |
|
Latence de recherche Latence moyenne de recherche pour le service de recherche |
SearchLatency |
Non | Secondes | Moyenne | <aucun> | PT1M | Oui |
|
Requêtes de recherche par seconde Requêtes de recherche par seconde pour le service de recherche |
SearchQueriesPerSecond |
Non | ComptageParSeconde | Moyenne | <aucun> | PT1M | Oui |
|
Nombre d’appels d’exécution de compétences Nombre d’exécutions de compétences |
SkillExecutionCount |
Non | Compter | Total (Somme), Nombre |
DataSourceName, , Failed, IndexerNameSkillName, , 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 |
Non | Pourcentage | Moyenne | <aucun> | 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 est la valeur la plus basse pour les requêtes de recherche par seconde enregistrées pendant cette minute. La valeur maximale est la valeur la plus élevée. La moyenne est l’agrégat sur l’ensemble de la minute.
| Type d’agrégation | Description |
|---|---|
| Moyenne | Nombre moyen de secondes dans une minute pendant laquelle l’exécution de la requête s’est produite. |
| Compter | Nombre de métriques émises dans le log pendant l'intervalle d'une minute. |
| Maximum | Nombre maximal de requêtes de recherche par seconde inscrites pendant une minute. |
| Minimum | Nombre le plus bas de requêtes de recherche par seconde enregistrées pendant une minute. |
| Somme | Somme de toutes les requêtes exécutées dans la minute. |
Par exemple, dans un délai d’une minute, vous pouvez avoir un modèle comme celui-ci : une seconde de charge élevée qui est le maximum pour SearchQueriesPerSecond, suivie de 58 secondes de charge moyenne, et enfin une seconde avec une seule requête, ce qui est le minimum.
Autre exemple : si un nœud émet 100 métriques, où la valeur de chaque métrique est 40, « Count » est 100, « Sum » est 4000, « Average » est 40 et « Max » est 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 des requêtes en millisecondes. |
| Compter | Nombre de métriques émises dans le log pendant l'intervalle d'une minute. |
| Maximum | Requête la plus longue de l'échantillon. |
| Minimum | Requête en cours d’exécution la plus courte dans l’exemple. |
| Total | Durée d’exécution totale de toutes les requêtes de l’exemple, en cours d’exécution 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 requêtes et les demandes d’indexation sont gérées par le même ensemble de ressources.
Le service détermine s’il faut supprimer des demandes en fonction de la consommation des ressources. Le pourcentage de ressources consommées en termes de mémoire, de CPU et d'E/S de disque est calculé en moyenne sur une période donnée. Si ce pourcentage dépasse un seuil, toutes les demandes adressées à l’index sont limitées jusqu’à ce que le volume des requêtes soit réduit.
Selon votre client, une demande limitée est indiquée de ces façons :
- Un service retourne une erreur
"You are sending too many requests. Please try again later." - Un service retourne un code d’erreur 503 indiquant que le service n’est pas disponible.
- Si vous utilisez le portail Azure (par exemple, l'Explorateur de recherche), la requête est supprimée silencieusement et vous devez sélectionner Search à nouveau.
Pour confirmer les requêtes limitées, utilisez la métrique Requêtes de recherche limitées. Vous pouvez explorer les métriques dans le portail Azure ou créer une métrique d’alerte comme décrit dans cet article. Pour les requêtes qui ont été supprimées dans l’intervalle d’échantillonnage, utilisez Total pour obtenir le pourcentage de requêtes qui n’ont pas été exécutées.
| Type d’agrégation | Limitation |
|---|---|
| Moyenne | Pourcentage de requêtes supprimées dans l’intervalle. |
| Compter | Nombre de métriques émises dans le log pendant l'intervalle d'une minute. |
| Maximum | Pourcentage de requêtes supprimées dans l’intervalle. |
| Minimum | Pourcentage de requêtes supprimées dans l’intervalle. |
| Total | Pourcentage de requêtes supprimées dans l’intervalle. |
Pour le pourcentage de requêtes de recherche limitées, le nombre minimal, le maximum, la moyenne et le total, ont toutes la même valeur : pourcentage de requêtes de recherche limitées, à partir du nombre total de requêtes de recherche au cours d’une minute.
Utilisation des unités de calcul
Cette métrique mesure les ressources de calcul, de mémoire et d’E/S consommées par votre service de Recherche Azure AI, exprimées en unités de calcul de milli (MTU). Il sert de proxy pour le coût de traitement de différents types d’opérations. L’utilisation peut varier au fil du temps en fonction des opérations exécutées.
Vous pouvez afficher cette métrique à deux niveaux :
- Niveau de service de recherche : consommation de calcul agrégée sur l’ensemble du service.
- Niveau d’index : Consommation limitée à un index spécifique, utile pour identifier les index qui entraînent la plus grande utilisation des ressources.
| Type d’agrégation | Description |
|---|---|
| Somme | Nombre total d’unités mC consommées pendant l’intervalle de temps sélectionné. Utile pour comprendre le coût global de calcul au fil du temps. |
| Moyenne | Nombre moyen d’unités mC consommées pendant l’intervalle de temps sélectionné. |
Cette métrique prend en charge les filtres suivants :
Nom de l’index : filtre la métrique sur un index spécifique. Si aucun filtre n’est appliqué, la métrique reflète la consommation totale sur tous les index du service.
Nom de l’opération : filtre la métrique par l’opération contribuant à la consommation de calcul. Si aucun filtre n’est appliqué, la métrique reflète la consommation combinée entre tous les types d’opérations. Pour connaître les valeurs prises en charge, consultez Informations de référence sur les données de surveillance.
Dimensions métriques
Pour des informations sur ce que sont les dimensions métriques, voir Métriques multidimensionnelles.
Recherche Azure AI a des dimensions associées aux métriques suivantes qui capturent le nombre de documents ou de compétences exécutés.
| Nom de la métrique | Description | Dimensions | Exemples de cas d’usage |
|---|---|---|---|
| Nombre de documents traités | Affiche 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étences | Affiche le nombre d’appels de compétence. | 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 garantir que les compétences sont invoquées comme prévu en comparant les nombres d'invocation relatifs entre les compétences et le nombre d'invocations de compétences avec le nombre de documents. - Configurer pour alerter sur les appels de compétence ayant échoué |
| Utilisation des unités de calcul | Affiche les mCUs consommés par les opérations du service de recherche | Nom de l’index, opération | Évaluez l’opération qui a consommé le plus de calcul. -Configurer des alertes lorsque la consommation de muck dépasse les seuils attendus pour un type d’opération donné |
| Nom de la dimension | Description |
|---|---|
| DataSourceName | Connexion de 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. |
| Échoué | Indique si l’instance a échoué. |
| IndexerName | Nom d’un indexeur. |
| IndexName | Nom d’un index. |
| SkillsetName | Nom d’un ensemble de compétences utilisé pendant l’exécution de l’indexeur. |
| SkillName | Nom d’une compétence dans un ensemble de compétences. |
| SkillType | @odata.type de la compétence. |
Journaux des ressources
Cette section liste les types de journaux de ressources que vous pouvez collecter pour ce service. La section est issue de la liste de tous les types de catégories de journaux de ressources pris en charge dans Azure Monitor.
Journaux de ressources pris en charge pour Microsoft.Search/searchServices
| Catégorie | Coûts d’exportation | Table de logs | Prend en charge le plan de journalisation de base | Prend en charge la transformation du temps d’ingestion | Exemples de requêtes |
|---|---|---|---|---|---|
| OperationLogs | Non |
AzureDiagnostics Journaux provenant de plusieurs ressources Azure. |
Non | Non |
Tables Azure Monitor Logs
Cette section liste les tables Azure Monitor Logs pertinentes pour ce service, qui sont disponibles pour requête par Log Analytics via les requêtes Kusto. Les tables contiennent des données de journal de ressources et peut-être plus encore selon ce qui y est collecté et acheminé.
Services de recherche
Microsoft.Search/searchServices
| Tableau | Description |
|---|---|
| AzureActivity | Les entrées du journal d’activité Azure fournissent des insights 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 courantes, les propriétés propres à search et les opérations spécifiques à search répertoriées dans la section de référence de schéma. |
| AzureMetrics | Données de métriques émises par Recherche Azure AI qui mesurent l’état de santé et les performances. |
Tableaux de journal des ressources
Le tableau suivant répertorie les propriétés des journaux de ressources dans Recherche Azure AI. Les journaux de ressources sont collectés dans Azure Monitor Logs ou stockage Azure. Dans Azure Monitor, les journaux sont collectés dans la table AzureDiagnostics sous le nom du fournisseur de ressources de Microsoft.Search.
| champ ou propriété stockage Azure | Propriété des journaux Azure Monitor | Description |
|---|---|---|
| Temps | TIMESTAMP | Date et heure (UTC) de l’opération. |
| resourceId | Concat(« / », « /subscriptions », SubscriptionId, « resourceGroups », ResourceGroupName, « providers/Microsoft.Search/searchServices », ServiceName) | La ressource Recherche Azure AI pour laquelle les journaux sont activés. |
| Catégorie | « OperationLogs » | Les catégories de journaux incluent Audit, Operational, Execution et Request. |
| operationName | Nom | Nom de l’opération. Le nom de l’opération peut être Indexes.ListIndexStatsSummaries, Indexes.GetIndexes.StatsIndexers.ListQuery.SearchQuery.SuggestQuery.LookupQuery.AutocompleteCORS.PreflightIndexes.UpdateIndexes.Prototype, ServiceStats, . DataSources.ListIndexers.Warmup |
| durationMS | Durée en Millisecondes | Durée de l’opération, en millisecondes. |
| operationVersion | ApiVersion | Version de l’API utilisée sur la demande. |
| type de résultat | (Échec) ? « Échec » : « Réussite » | Type de réponse. |
| resultSignature | Statut | État de la réponse HTTP de l’opération. |
| Propriétés | Propriétés | Toutes les propriétés étendues associées à cette catégorie d’événements. |
Journal d’activité
Le tableau lié liste les opérations pouvant ê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é, voir 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 une liste complète de toutes les opérations de Microsoft.Search, consultez opérations du fournisseur de ressources Microsoft.Search.
| Opération | 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érer la clé d’administration | Demande de régénérer la clé API d’administration primaire ou secondaire. |
Les entrées courantes incluent des références aux clés API : notifications d’information génériques telles que 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 les journaux de ressources Recherche Azure AI suivent ces schémas.
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 blob contient des enregistrements de toutes les opérations qui ont eu lieu au cours de la même heure.
Schéma du journal des ressources
Tous les journaux de ressources disponibles via Azure Monitor partagent un schéma de niveau supérieur common. Recherche Azure AI complète avec des propriétés supplémentaires et des opérations propres à un service de recherche.
L’exemple suivant illustre un journal des ressources qui inclut des propriétés courantes (TimeGenerated, Resource, Category, etc.) et des propriétés spécifiques à la recherche (OperationName et OperationVersion).
| Nom | Type | Description et exemple |
|---|---|---|
| TimeGenerated | Date et heure | Horodatage de l’opération. Par exemple : 2021-12-07T00:00:43.6872559Z |
| Ressource | Chaîne | ID de 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. |
| Nom de l'Opération | Chaîne | Nom de l’opération (voir la liste complète des opérations). Exemple : Query.Search |
| OperationVersion | Chaîne | Version de l’API utilisée sur la demande. Par exemple : 2026-04-01 |
| TypeDeRésultat | Chaîne | « Réussite ». Autres valeurs possibles : Réussite ou Échec |
| ResultSignature | Int | 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 spécifiques à l’opération. Consultez la table de schéma de propriétés suivante. |
Schéma des propriétés
Les propriétés suivantes sont spécifiques à Recherche Azure AI.
| 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=2026-04-01 |
Valeurs de noms d'opération (opérations enregistrées)
Les opérations suivantes peuvent apparaître dans un journal des ressources.
| Nom de l'Opération | Description |
|---|---|
| SourcesDeDonnées.* | 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 importé dans une session de débogage. |
| DebugSessions.RetrieveIndexerExecutionHistoricalData | Demande de détails d'exécution de l'indexeur. |
| SessionsDeDébogage.RécupérerDonnéesHistoriquesD'ExécutionDeL'IndexeurProjeté | Historique d’exécution des 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 | Les métadonnées d’index sont définies par l’Assistant Importation de données en fonction des entrées de données. |
| Indexing.Index | Cette opération est un appel à indexer des documents. |
| Metadata.GetMetadata | Demande de données système de service de recherche. |
| Query.Autocomplete | Requête d'autocomplétion sur un index. Consultez les types de requêtes et la composition. |
| Query.Lookup | Requête de recherche sur un index. Consultez les types de requêtes et la composition. |
| Query.Search | Requête de recherche en texte intégral sur un index. Consultez les types de requêtes et la composition. |
| Query.Suggest | Requête de saisie anticipée sur un index. Consultez les types de requêtes et la 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. |
| Compétences.* | S’applique à un ensemble de compétences. Peut être Create, Delete, Get, List. |
Contenu connexe
- Consultez Monitor Recherche Azure AI pour une description de la surveillance d'Recherche Azure AI.
- Voir Surveiller Azure ressources avec Azure Monitor pour plus de détails sur la surveillance Azure ressources.