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 | Nombre total | DataSourceName, , FailedIndexerName, , IndexNameSkillsetName |
PT1M | Oui |
| Latence de recherche Latence moyenne de recherche du service de recherche |
SearchLatency |
Secondes | Moyenne | <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 | Nombre total | 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 |
SearchQueriesPerSecond affiche 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.
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.
Dimensions de métrique
Pour plus d’informations sur les dimensions de métrique, consultez Métriques multidimensionnelles.
Azure AI Search a les dimensions suivantes associées aux métriques qui capturent le nombre de documents ou de compétences exécutés, « Nombre de documents traités » et « Nombre d’appels d’exécution de compétence ».
| 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 journaux Azure Monitor pertinentes pour ce service, qui sont disponibles pour les requêtes par Log Analytics à l’aide de requêtes Kusto. Les tables contiennent des données de journal des ressources et éventuellement plus en fonction de ce qui est collecté et routé vers eux.
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 Administration clé ». |
| 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 Administration clé ». |
| 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 : 2020-06-30 |
| 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=2020-06-30 |
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 à Ajout, mise à jour ou suppression de 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.