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,
PT1Mindique que la métrique est échantillonnée toutes les minutes,PT30Mtoutes les 30 minutes,PT1Htoutes 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. |
Contenu connexe
- Consultez Monitor Azure AI Search pour obtenir une description de la surveillance d’Azure AI Search.
- Pour plus d’informations sur la supervision des ressources Azure, consultez Superviser des ressources Azure avec Azure Monitor.