Supervisión Azure Cognitive Search
Azure Monitor está habilitado con cada suscripción para proporcionar funcionalidades de supervisión en todos los recursos de Azure, incluido Cognitive Search. Al registrarse para la búsqueda, Azure Monitor recopila los registros de actividad y las métricas de la plataforma tan pronto como empiece a usar el servicio.
Opcionalmente, puede habilitar la configuración de diagnóstico para recopilar registros de recursos. Los registros de recursos contienen información detallada sobre las operaciones del servicio de búsqueda, que es útil para un análisis y una investigación más profundos.
En este artículo se explica cómo funciona la supervisión para Azure Cognitive Search. También se describen las API del sistema que devuelven información sobre el servicio.
Nota
Cognitive Search no supervisa el acceso de usuario individual al contenido en el servicio de búsqueda. Si necesita este nivel de supervisión, deberá implementarlo en la aplicación cliente.
Supervisión en Azure Portal
En las páginas del servicio de búsqueda de Azure Portal, puede encontrar el estado actual de las operaciones y la capacidad.
La pestaña Supervisión de la página Información general resume las métricas de consulta clave, incluida la latencia de búsqueda, las consultas de búsqueda por segundo y las consultas limitadas. En la siguiente pestaña (no mostrada), la opción Uso indica la capacidad disponible y la cantidad de índices, indexadores, orígenes de datos y conjuntos de aptitudes relativos al máximo permitido para el nivel de servicio.
El registro de actividad del menú de navegación captura eventos de nivel de servicio: creación, configuración y eliminación de servicios.
Más abajo en el menú de navegación, la sección Supervisión incluye acciones para Azure Monitor, filtradas para la búsqueda. Aquí puede habilitar la configuración de diagnóstico y el registro de recursos, así como especificar cómo desea almacenar los datos.
Nota
Como las páginas del portal se actualizan cada pocos minutos, los números que se notifican son aproximados y están pensados para proporcionarle una idea general de la capacidad del sistema para administrar las solicitudes. Las métricas actuales, como las consultas por segundo (QPS), pueden ser mayores o menores que el número que se muestra en la página. Si la precisión es un requisito, considere la posibilidad de usar las API.
Obtención de datos del sistema de las API REST
Las API REST de Cognitive Search proporcionan los datos de Uso que están visibles en el portal. Esta información se recupera del servicio de búsqueda, que puede obtener mediante programación:
- Estadísticas del servicio (REST)
- Estadísticas de índice (REST)
- Número de documentos (REST)
- Estado del indexador (REST)
Para las llamadas REST, use una clave de API de administrador y Postman u otro cliente REST para consultar el servicio de búsqueda.
Supervisión de los registros de actividad
En Azure Cognitive Search, los registros de actividad reflejan la actividad del plano de control, como la creación y configuración de servicios, o el uso o la administración de las claves de API.
Los registros de actividad se recopilan de forma gratuita, sin que se requiera ninguna configuración. La retención de datos es de 90 días, pero puede configurar un almacenamiento duradero para una retención más larga.
Busque el servicio de búsqueda en Azure Portal. En el menú de la izquierda, seleccione Registros de actividad para ver los registros del servicio de búsqueda. Consulte Registro de actividad de Azure Monitor para obtener instrucciones generales sobre cómo trabajar con registros de actividad.
Revise las entradas. Las entradas suelen incluir Get Admin Key, una entrada por cada llamada que haya proporcionado una clave de API de administrador en la solicitud. No hay detalles sobre la propia llamada, solo una notificación de que se ha utilizado la clave de administrador.
Para otras entradas, consulte Referencia de API REST de administración para ver la actividad del plano de control que puede aparecer en el registro.
La captura de pantalla siguiente muestra las señales del registro de actividad que se pueden configurar en una alerta. Estas señales representan las entradas que puede ver en el registro de actividad.
Supervisión de métricas
En Azure Cognitive Search, las métricas de plataforma miden el rendimiento de las consultas, el volumen de indexación y la invocación del conjunto de aptitudes.
Las métricas se recopilan de forma gratuita, sin que se requiera ninguna configuración. Las métricas de plataforma se almacenan durante 93 días. Sin embargo, en el portal solo puede consultar un máximo de 30 días de datos de métricas de la plataforma en un solo gráfico.
Busque el servicio de búsqueda en Azure Portal. En el menú de la izquierda, en Supervisión, seleccione Métricas para abrir el Explorador de métricas.
Los vínculos siguientes proporcionan más información sobre cómo trabajar con métricas de plataforma:
Tutorial: Análisis de métricas para recursos de Azure: instrucciones generales sobre el uso del Explorador de métricas.
Microsoft.Search/searchServices (Azure Monitor): referencia de las métricas de la plataforma.
Referencia de datos de supervisión: descripciones y dimensiones complementarias.
Supervisión de consultas: detalle sobre las métricas de consulta.
Configuración de alertas
Las alertas le ayudan a identificar y solucionar incidencias antes de que se conviertan en un problema para los usuarios de la aplicación. Puede establecer alertas en métricas, registros de recursos y registros de actividad. Las alertas son facturables (consulte el Modelo de precios para más información).
Busque el servicio de búsqueda en Azure Portal. En el menú de la izquierda, en Supervisión, seleccione Alertas para abrir el Explorador de métricas.
Consulte Tutorial: Creación de una alerta de métrica para un recurso de Azure para obtener instrucciones generales sobre cómo configurar alertas desde el Explorador de métricas.
En la tabla siguiente se describen varias reglas. En un servicio de búsqueda, la limitación o la latencia de consulta que supera un umbral determinado son las alertas que se usan con más frecuencia, pero también es posible que quiera recibir una notificación si se elimina un servicio de búsqueda.
| Tipo de alerta | Condición | Descripción |
|---|---|---|
| Latencia de búsqueda (alerta de métrica) | Cada vez que la latencia media de búsqueda es mayor que un umbral especificado por el usuario (en segundos) | Enviar una alerta por SMS cuando el tiempo medio de respuesta de la consulta supere el umbral. |
| Porcentaje de consultas de búsqueda limitadas (alerta de métrica) | Siempre que el porcentaje total de consultas de búsqueda limitadas sea mayor o igual que un umbral especificado por el usuario | Enviar una alerta por SMS cuando las consultas descartadas empiecen a superar el umbral. |
| Eliminar servicio de búsqueda (alerta del registro de actividad) | Siempre que el registro de actividad tenga un evento con Category='Administrative', Signal name='Delete Search Service (searchServices)', Level='critical' | Enviar un correo electrónico si se elimina un servicio de búsqueda en la suscripción. |
Nota
Actualmente, no hay alertas relacionadas con el almacenamiento (los datos de consumo de almacenamiento no se agregan ni se registran en la tabla AzureMetrics). Para obtener alertas de almacenamiento, podría compilar una solución personalizada que emita notificaciones relacionadas con los recursos, en las que el código compruebe el tamaño del almacenamiento y administre la respuesta.
Habilitación de registro de recurso
En Azure Cognitive Search, los registros de recursos capturan las operaciones de indexación y consulta en el propio servicio de búsqueda.
Los registros de recursos no se recopilan ni almacenan hasta que se crea una configuración de diagnóstico. Una configuración de diagnóstico especifica la recopilación y el almacenamiento de datos. Puede crear varias configuraciones si desea mantener separados los datos de registro y las métricas, o si desea más de uno de cada tipo de destino.
El registro de recursos es facturable (consulte el Modelo de precios para más información) y comienza cuando crea una configuración de diagnóstico. Consulte Configuración de diagnóstico en Azure Monitor para obtener instrucciones generales.
Busque el servicio de búsqueda en Azure Portal. En el menú de la izquierda, en Supervisión, seleccione Configuración de diagnóstico.
Seleccione + Agregar configuración de diagnóstico.
Asigne un nombre a la configuración de diagnóstico. Use nombres pormenorizados y descriptivos si va a crear más de una configuración.
Seleccione los registros y las métricas que están en el ámbito de esta configuración. Las selecciones incluyen "allLogs", "OperationLogs" y "AllMetrics". Puede excluir registros de actividad seleccionando la categoría "OperationLogs".
Consulte Microsoft.Search/searchServices (en Métricas compatibles).
Consulte Referencia de datos de supervisión de Azure Cognitive Search para el esquema extendido.
Seleccione Enviar al área de trabajo de Log Analytics. Las consultas y la exploración de datos de Kusto tendrán como destino el área de trabajo.
Opcionalmente, seleccione otros destinos.
Seleccione Guardar.
Una vez que el área de trabajo contenga datos, puede ejecutar consultas de registro:
Consulte Tutorial: Recopilación y análisis de registros de recurso desde un recurso de Azure para obtener instrucciones generales sobre consultas de registros.
Consulte Análisis del rendimiento en Azure Cognitive Search para obtener ejemplos e instrucciones específicas sobre los servicios de búsqueda.
Ejemplos de consultas de Kusto
Importante
Al seleccionar Registros en el menú de Azure Cognitive Search, se abre Log Analytics con el ámbito de la consulta establecido en el servicio de búsqueda actual. Esto significa que las consultas de registro solo incluirán datos de ese recurso. Si quiere ejecutar una consulta sobre varios servicios de búsqueda o datos combinados de otros servicios de Azure, seleccione Registros en el menú de Azure Monitor. Consulte Ámbito e intervalo de tiempo de una consulta de registro en Log Analytics de Azure Monitor para obtener más información.
Kusto es el lenguaje de consulta que se usa para Log Analytics. En la sección siguiente se incluyen algunas consultas para empezar. Consulte Referencia de datos de supervisión de Azure Cognitive Search para obtener descripciones de los elementos de esquema que se utilizan en una consulta. Consulte Análisis del rendimiento en Azure Cognitive Search para obtener más ejemplos e instrucciones específicas sobre los servicios de búsqueda.
Enumeración de métricas por nombre
Devuelve una lista de métricas y la agregación asociada. La consulta tiene como ámbito el servicio de búsqueda actual durante el intervalo de tiempo que especifique.
AzureMetrics
| project MetricName, Total, Count, Maximum, Minimum, Average
Enumeración de operaciones por nombre
Devuelve una lista de operaciones y un recuento de cada una de ellas.
AzureDiagnostics
| summarize count() by OperationName
Consultas de ejecución prolongada
Esta consulta de Kusto en AzureDiagnostics devuelve Query.Search operaciones, ordenadas por duración (en milisegundos). Para ver más ejemplos de consultas Query.Search, consulte Análisis del rendimiento en Azure Cognitive Search.
AzureDiagnostics
| project OperationName, resultSignature_d, DurationMs, Query_s, Documents_d, IndexName_s
| where OperationName == "Query.Search"
| sort by DurationMs
Estado del indizador
Esta consulta de Kusto devuelve el estado de las operaciones del indexador. Los resultados incluyen el nombre de la operación, la descripción de la solicitud (que incluye el nombre del indexador), el estado del resultado (correcto o error) y el código de estado HTTP. Para más información sobre la ejecución del indexador, consulte Supervisión del estado del indexador.
AzureDiagnostics
| project OperationName, Description_s, Documents_d, ResultType, resultSignature_d
| where OperationName == "Indexers.Status"
Pasos siguientes
Azure Monitor proporciona la plataforma de supervisión para Azure Cognitive Search. Si no está familiarizado con este servicio, comience por Supervisión de recursos de Azure con Azure Monitor para revisar los conceptos principales. También puede leer los siguientes artículos para Azure Cognitive Search: