Referencia de datos de supervisión de Búsqueda de Azure AI
Este artículo contiene toda la información de referencia de supervisión de este servicio.
Consulte Supervisión de Azure AI Search para más información sobre los datos que puede recopilar para Azure AI Search y cómo usarlo.
Métricas
En esta sección se indican todas las métricas de la plataforma recopiladas automáticamente para este servicio. Estas métricas también forman parte de la lista global de todas las métricas de plataforma admitidas en Azure Monitor.
Para obtener información sobre la retención de métricas, consulte Información general sobre las métricas de Azure Monitor.
Métricas admitidas para Microsoft.Search/searchServices
En la tabla siguiente se enumeran las métricas disponibles para el tipo de recurso Microsoft.Search/searchServices.
- Es posible que todas las columnas no estén presentes en todas las tablas.
- Es posible que algunas columnas estén fuera del área de visualización de la página. Seleccione Expandir tabla para ver todas las columnas disponibles.
Encabezados de tabla
- Categoría: el grupo de métricas o la clasificación.
- Métrica: el nombre para mostrar de la métrica tal como aparece en Azure Portal.
- Nombre en la API REST: el nombre de la métrica por el que se conoce en la API REST.
- Unidad: unidad de medida.
- Agregación: el tipo de agregación predeterminado. Valores válidos: promedio (Avg), mínimo (Min), máximo (Max), total (Sum), recuento.
- Dimensiones - : dimensiones disponibles para la métrica.
- Intervalos de agregación - : intervalos en los que se obtiene una muestra de la métrica. Por ejemplo,
PT1Mindica que la métrica se muestrea cada minuto,PT30Mcada 30 minutos,PT1Hcada hora, etc. - Exportación de DS: indica si la métrica se puede exportar a los registros de Azure Monitor a través de la configuración de diagnóstico. Para obtener más información, consulte Creación de configuración de diagnóstico en Azure Monitor.
| Métrica | Nombre en la API de REST | Unidad | Agregación | Dimensiones | Intervalos de agregación | Exportación de DS |
|---|---|---|---|---|---|---|
| Recuento procesado de documentos Número de documentos procesados |
DocumentsProcessedCount |
Count | Total, Recuento | DataSourceName, Failed, IndexerName, , IndexName, SkillsetName |
PT1M | Sí |
| Latencia de búsqueda Promedio de latencia de búsqueda para el servicio de búsqueda |
SearchLatency |
Segundos | Media | <none> | PT1M | Sí |
| Consultas de búsqueda por segundo Consultas de búsqueda por segundo para el servicio de búsqueda |
SearchQueriesPerSecond |
CountPerSecond | Average | <none> | PT1M | Sí |
| Recuento de invocaciones de ejecución de aptitudes Número de ejecuciones de aptitudes |
SkillExecutionCount |
Count | Total, Recuento | DataSourceName, Failed, IndexerName, SkillName, , SkillsetName, SkillType |
PT1M | Sí |
| Porcentaje de consultas de búsqueda limitadas Porcentaje de consultas de búsqueda limitadas para el servicio de búsqueda |
ThrottledSearchQueriesPercentage |
Percent | Media | <none> | PT1M | Sí |
SearchQueriesPerSecond muestra el promedio de las consultas de búsqueda por segundo (QPS) para el servicio de búsqueda. Es habitual que las consultas se ejecuten en milisegundos, por lo que solo las consultas que miden como segundos aparecen en una métrica como QPS. El mínimo es el valor más bajo de consultas de búsqueda por segundo que se registró durante ese minuto. El máximo es el valor más alto. El promedio es el agregado en todo el minuto.
Por ejemplo, en el transcurso de un minuto, podría tener un patrón parecido a este: un segundo de carga elevada que es el máximo en SearchQueriesPerSecond, seguido de 58 segundos de carga media y, por último, 1 segundo con solo una consulta (que es el mínimo).
Dimensiones de métricas
Para obtener más información sobre las dimensiones de métricas, consulte Métricas multidimensionales.
Azure AI Search tiene las siguientes dimensiones asociadas a las métricas que capturan un recuento de documentos o aptitudes que se ejecutaron, "Recuento procesado de documentos" y "Recuento de invocaciones de ejecución de aptitudes".
| Nombre de la dimensión | Descripción |
|---|---|
| DataSourceName | Una conexión de origen de datos con nombre que se usa durante la ejecución del indexador. Los valores válidos son uno de los tipos de origen de datos admitidos. |
| Con error | Indica si la instancia devolvió un error. |
| IndexerName | Nombre de un indexador. |
| IndexName | Nombre de un indexador. |
| SkillsetName | Nombre de un conjunto de aptitudes que se usa durante la ejecución del indexador. |
| SkillName | Nombre de una aptitud dentro de un conjunto de aptitudes. |
| SkillType | @odata.type de la aptitud. |
Registros del recurso
En esta sección se enumeran los tipos de registros de recursos que se pueden recopilar para este servicio. La sección extrae de la lista de todos los tipos de categorías de registros admitidos en Azure Monitor.
Registros de recursos admitidos para Microsoft.Search/searchServices
| Category | Nombre para mostrar de categoría | Tabla de registro | Admite el plan de registro básico | Admite la transformación en tiempo de ingesta | Consultas de ejemplo | Costos para exportar |
|---|---|---|---|---|---|---|
OperationLogs |
Registros de operaciones | AzureDiagnostics Registros de varios recursos de Azure. |
No | N.º | No |
Tablas de registros de Azure Monitor
En esta sección se enumeran las tablas de registros de Azure Monitor relevantes para este servicio, que están disponibles para su consulta mediante Consultas de Kusto. Las tablas contienen datos de registro de recursos y, posiblemente, más dependiendo de lo que se recopila y se enrutan a ellos.
Search Service
Microsoft.Search/searchServices
| Tabla | Descripción |
|---|---|
| AzureActivity | Las entradas del registro de actividad de Azure proporcionan información sobre las operaciones del plano de control. Las tareas invocadas en el plano de control, como agregar o quitar réplicas y particiones, se representan mediante una actividad "Obtener Administración clave". |
| AzureDiagnostics | Operaciones de indexación y consulta registradas. Las consultas en la tabla AzureDiagnostics de Log Analytics pueden incluir las propiedades comunes, las propiedades específicas de la búsqueda y las operaciones específicas de búsqueda enumeradas en la sección de referencia de esquema. |
| AzureMetrics | Datos de métrica que emite Azure IA Search para medir el estado y el rendimiento. |
Tablas de registro de recursos
En la tabla siguiente se enumeran las propiedades de los registros de recursos en Azure AI Search. Los registros de recursos se recopilan en los registros de Azure Monitor o en Azure Storage. En Azure Monitor, los registros se recopilan en la tabla AzureDiagnostics en el nombre del proveedor de recursos de Microsoft.Search.
| Propiedad o campo de Azure Storage | Propiedad de registros de Azure Monitor | Descripción |
|---|---|---|
| time | TIMESTAMP | La fecha y hora (UTC) cuando se produjo la operación. |
| resourceId | Concat("/", "/subscriptions", SubscriptionId, "resourceGroups", ResourceGroupName, "providers/Microsoft.Search/searchServices", ServiceName) | Recurso de Azure AI Search para el que se habilitan los registros. |
| category | "OperationLogs" | Las categorías de registro incluyen Audit, Operational, Executiony Request. |
| operationName | Nombre | Nombre de la operación. El nombre de la operación puede ser Indexes.ListIndexStatsSummaries, Indexes.Get, Indexes.Stats, Query.SuggestIndexers.WarmupDataSources.ListServiceStatsIndexes.PrototypeCORS.PreflightQuery.LookupIndexes.UpdateIndexers.ListQuery.SearchQuery.Autocomplete. |
| durationMS | DurationMilliseconds | Duración de la operación en milisegundos. |
| operationVersion | ApiVersion | La versión de LA API usada en la solicitud. |
| resultType | (Error) ? "Error": "Correcto" | Tipo de respuesta. |
| resultSignature | Estado | Estado de respuesta HTTP de la operación. |
| properties | Propiedades | Todas las propiedades extendidas relacionadas con esta categoría de eventos. |
Registro de actividad
En la tabla vinculada se enumeran las operaciones que se pueden registrar en el registro de actividad de este servicio. Estas operaciones son un subconjunto de todas las posibles operaciones del proveedor de recursos en el registro de actividad.
Para obtener más información sobre el esquema de las entradas del registro de actividad, consulte Esquema del registro de actividad.
En la tabla siguiente se enumeran las operaciones comunes relacionadas con Azure AI Search que se pueden registrar en el registro de actividad. Para obtener una lista completa de todas las operaciones de Microsoft.Search, consulte Operaciones del proveedor de recursos Microsoft.Search.
| Operación | Descripción |
|---|---|
| Obtener clave de administrador | Cualquier operación que requiera derechos administrativos se registra como una operación "Obtener Administración clave". |
| Obtener clave de consulta | Cualquier operación de solo lectura en la colección de documentos de un índice. |
| Nueva generación de clave de administración | Una solicitud para volver a generar la clave de API de administración principal o secundaria. |
Entre las entradas comunes se incluyen referencias a las claves de API: notificaciones de información genéricas como Obtener la clave de administrador y Obtener claves de consulta. Estas actividades indican solicitudes realizadas mediante la clave de administrador (crear o eliminar objetos) o la clave de consulta, pero no muestran la propia solicitud. Para obtener información de este nivel de detalle, debe configurar el registro de recurso.
Como alternativa, puede obtener información detallada a través del historial de cambios. En Azure Portal, seleccione la actividad para abrir la página de detalles y, a continuación, seleccione "Historial de cambios" para obtener información sobre la operación subyacente.
Otros esquemas
Los esquemas siguientes están en uso para este servicio.
Si va a crear consultas o informes personalizados, las estructuras de datos que contienen registros de recursos de Azure AI Search se ajustan a los esquemas siguientes.
En el caso de los registros de recursos que se envían a Blob Storage, cada blob tiene un objeto raíz llamado registros que contiene una matriz de objetos de registro. Cada blob contiene registros de todas las operaciones que tuvieron lugar durante la misma hora.
Esquema del registro de recursos
Todos los registros de recursos disponibles en Azure Monitor comparten un esquema de nivel superior común. Azure AI Search complementa con más propiedades y operaciones que son exclusivas de un servicio de búsqueda.
En el ejemplo siguiente se muestra un registro de recursos que incluye propiedades comunes (TimeGenerated, Resource, Category, etc.) y propiedades específicas de búsqueda (OperationName y OperationVersion).
| Nombre | Tipo | Descripción y ejemplo |
|---|---|---|
| TimeGenerated | Datetime | Marca de tiempo de la operación. Por ejemplo: 2021-12-07T00:00:43.6872559Z |
| Recurso | String | Identificador del recurso. Por ejemplo: /subscriptions/<your-subscription-id>/resourceGroups/<your-resource-group-name>/providers/Microsoft.Search/searchServices/<your-search-service-name> |
| Category | String | "OperationLogs". Este valor es una constante. OperationLogs es la única categoría que se usa para los registros de recursos. |
| OperationName | Cadena | Nombre de la operación (consulte la lista completa de operaciones). Un ejemplo sería Query.Search |
| OperationVersion | String | Versión de api que se usa en la solicitud. Por ejemplo: 2020-06-30 |
| ResultType | String | "Success". Valores posibles: Success o Failure |
| ResultSignature | Int | Código de resultado HTTP. Por ejemplo: 200 |
| DurationMS | Int | Duración de la operación en milisegundos. |
| Propiedades | Object | Objeto que contiene datos específicos de la operación. Consulte la tabla de esquema de propiedades siguiente. |
Esquema de propiedades
Las siguientes propiedades son específicas de Azure AI Search.
| Nombre | Tipo | Descripción y ejemplo |
|---|---|---|
| Description_s | String | Punto de conexión de la operación. Por ejemplo: GET /indexes('content')/docs |
| Documents_d | Int | Número de documentos procesados. |
| IndexName_s | String | Nombre del índice asociado a la operación. |
| Query_s | String | Parámetros de consulta que se usan en la solicitud. Por ejemplo: ?search=beach access&$count=true&api-version=2020-06-30 |
Valores operationName (operaciones registradas)
Las siguientes operaciones pueden aparecer en un registro de recursos.
| OperationName | Descripción |
|---|---|
| DataSources.* | Se aplica a los orígenes de datos del indexador. Pueden ser Create, Delete, Get o List. |
| DebugSessions.* | Se aplica a una sesión de depuración. Pueden ser Create, Delete, Get, List, Start y Status. |
| DebugSessions.DocumentStructure | Un documento enriquecido se carga en una sesión de depuración. |
| DebugSessions.RetrieveIndexerExecutionHistoricalData | Solicitud de detalles de la ejecución del indexador. |
| DebugSessions.RetrieveProjectedIndexerExecutionHistoricalData | Historial de ejecución de enriquecimientos proyectados en un almacén de conocimiento. |
| Indexers.* | Se aplica a un indexador. Pueden ser Create, Delete, Get, List y Status. |
| Indexes.* | Se aplica a un índice de búsqueda. Pueden ser Create, Delete, Get o List. |
| indexes.Prototype | El Asistente para importar datos crea este índice. |
| Indexing.Index | Esta operación es una llamada a Agregación, actualización o eliminación de documentos. |
| Metadata.GetMetadata | Solicitud de datos del sistema de servicio de búsqueda. |
| Query.Autocomplete | Una consulta de autocompletar en un índice. Consulte Tipos de consulta y composición. |
| Query.Lookup | Consulta de búsqueda en un índice. Consulte Tipos de consulta y composición. |
| Query.Search | Solicitud de búsqueda de texto completo en un índice. Consulte Tipos de consulta y composición. |
| Query.Suggest | Escriba la consulta por adelantado en un índice. Consulte Tipos de consulta y composición. |
| ServiceStats | Esta operación es una llamada rutinaria a Get Service Statistics, ya sea llamada directamente o implícitamente para rellenar una página de información general del portal cuando se carga o se actualiza. |
| Skillsets.* | Se aplica a un conjunto de aptitudes. Pueden ser Create, Delete, Get o List. |
Contenido relacionado
- Consulte Supervisión de Azure AI Search para obtener una descripción de la supervisión de Azure AI Search.
- Consulte Supervisión de los recursos de Azure con Azure Monitor para obtener información sobre la supervisión de los recursos de Azure.