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 (Suma), 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 (Suma), 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í |
Consultas de búsqueda por segundo
Esta métrica 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.
| Tipo de agregación | Descripción |
|---|---|
| Average | El número medio de segundos de un minuto durante el que se produjo la ejecución de la consulta. |
| Recuento | El número de métricas emitidas en el registro en el intervalo de un minuto. |
| Máximo | Número máximo de consultas de búsqueda por segundo registradas durante un minuto. |
| Mínimo | Número mínimo de consultas de búsqueda por segundo registradas durante un minuto. |
| Sum | La suma de todas las consultas ejecutadas dentro del 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).
Otro ejemplo: si un nodo emite 100 métricas y el valor de cada una de las métricas es 40, "Count" es 100, "Sum" es 4000, "Average" es 40 y "Max" es 40.
Latencia de búsqueda
La latencia de búsqueda indica cuánto tiempo tarda una consulta en completarse.
| Tipo de agregación | Latencia |
|---|---|
| Average | Duración promedio de la consulta en milisegundos. |
| Recuento | El número de métricas emitidas en el registro en el intervalo de un minuto. |
| Máximo | Consulta con la ejecución más larga del ejemplo. |
| Mínimo | Consulta con la ejecución más corta del ejemplo. |
| Total | Tiempo total de ejecución de todas las consultas del ejemplo que se ejecutan en el intervalo (un minuto). |
Porcentaje de consultas de búsqueda limitadas
Esta métrica hace referencia a las consultas que se quitan en lugar de procesadas. La limitación se produce cuando el número de solicitudes en ejecución supera la capacidad. Puede que observe un aumento en las solicitudes limitadas cuando se saca una réplica de la rotación o durante la indexación. El mismo conjunto de recursos controla las solicitudes de consulta y de indexación.
El servicio determina si debe reducir el número de solicitudes según el consumo de los recursos. Se realiza el promedio del porcentaje de los recursos que se consume entre memoria, CPU y E/S de disco durante un período de tiempo. Si este porcentaje supera un umbral, todas las solicitudes al índice se limitan hasta que el volumen de solicitudes se reduce.
En función del cliente, se indica una solicitud limitada de estas maneras:
- Un servicio devuelve un error
"You are sending too many requests. Please try again later." - Un servicio devuelve un código de error 503 que indica que el servicio no está disponible actualmente.
- Si usa el portal (por ejemplo, el Explorador de búsqueda), la consulta se quita silenciosamente y debe seleccionar Buscar de nuevo.
Para confirmar las consultas limitadas, use la métrica Consultas de búsqueda limitadas. Puede explorar las métricas en el portal o crear una métrica de alerta tal y como se describe en este artículo. En el caso de las consultas que se quitaron dentro del intervalo de muestreo, use Total para obtener el porcentaje de consultas que no se ejecutaron.
| Tipo de agregación | Limitaciones |
|---|---|
| Average | Porcentaje de consultas eliminadas en el intervalo. |
| Recuento | El número de métricas emitidas en el registro en el intervalo de un minuto. |
| Máximo | Porcentaje de consultas eliminadas en el intervalo. |
| Mínimo | Porcentaje de consultas eliminadas en el intervalo. |
| Total | Porcentaje de consultas eliminadas en el intervalo. |
En el caso de Porcentaje de consultas de búsqueda limitadas, "minimum", "maximum", "average" y "total" tienen el mismo valor: el porcentaje de consultas de búsqueda que se limitaron en comparación con el número total de consultas de búsqueda durante un minuto.
Dimensiones de métricas
Para obtener más información sobre las dimensiones de métricas, consulte Métricas multidimensionales.
Azure AI Search tiene dimensiones asociadas a las siguientes métricas que capturan un recuento de documentos o aptitudes que se ejecutaron.
| Nombre de métrica | Descripción | Dimensiones | Casos de uso de ejemplo |
|---|---|---|---|
| Recuento procesado de documentos | Muestra el número de documentos procesados por el indizador. | Nombre del origen de datos, error, nombre del índice, nombre del indizador, nombre del conjunto de aptitudes | Se puede hacer referencia a ellos como una medida aproximada del rendimiento (número de documentos procesados por indexador a lo largo del tiempo) - Se configura para alertar sobre documentos con errores |
| Recuento de invocaciones de ejecución de aptitudes | Muestra el número de invocaciones de aptitud. | Nombre del origen de datos, error, nombre del índice, nombre del indizador, nombre de la aptitud, tipo de la aptitud, nombre del conjunto de aptitudes | Referencia para asegurarse de que las aptitudes se invocan según lo previsto comparando los números de invocación relativos entre las aptitudes y el número de invocaciones de aptitudes al número de documentos. - Se configura para alertar sobre invocaciones de aptitudes con error |
| Nombre de 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 todas las tablas de registros de Azure Monitor relacionadas con este servicio y que están disponibles para consulta mediante Log Analytics con 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 clave de administración". |
| 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 clave de administrador". |
| 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: 2024-07-01 |
| 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=2024-07-01 |
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 Index Documents. |
| 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.