Referencia de datos de supervisión de Azure Cognitive Search

  • Artículo
  • Tiempo de lectura: 8 minutos

En este artículo se proporciona una referencia de datos de registro y métricas recopilados para analizar el rendimiento y la disponibilidad de Azure Cognitive Search. Consulte Supervisión Azure Cognitive Search para obtener información general.

Métricas

En esta sección se enumeran las métricas de plataforma recopiladas para Azure Cognitive Search (Microsoft.Search/searchServices).

Identificador de la métrica Unidad Descripción
DocumentsProcessedCount Count Total del número de documentos procesados correctamente en una operación de indexación (ya sea mediante un indexador o mediante la inserción de documentos directamente).
SearchLatency Segundos Latencia de búsqueda promedio para las consultas que se ejecutan en el servicio de búsqueda.
SearchQueriesPerSecond CountPerSecond Promedio de consultas de búsqueda por segundo (QPS) para el servicio de búsqueda. Es habitual que las consultas se ejecuten en cuestión de milisegundos, por lo que solo las consultas que duran segundos aparecerán en las métricas como QPS.
El mínimo es el valor más bajo de consultas de búsqueda por segundo que se registró durante ese minuto. Lo mismo sucede con el valor máximo. 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).
SkillExecutionCount Count Número total de ejecuciones de aptitudes procesadas durante una operación de indexador.
ThrottledSearchQueriesPercentage Percent Porcentaje medio de las consultas de búsqueda limitadas del número total de consultas de búsqueda que se ejecutaron durante un intervalo de un minuto.

Para su referencia, consulte una lista de todas las métricas de la plataforma que se admiten en Azure Monitor.

Dimensiones de métricas

Las dimensiones de una métrica son pares nombre-valor que transportan datos adicionales para describir el valor de la métrica. Azure Cognitive Search tiene las siguientes dimensiones asociadas a sus 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 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.
Erróneo 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.

Para obtener más información sobre las dimensiones de métricas, consulte Métricas multidimensionales.

Registros del recurso

Los registros de recursos son registros de plataforma que proporcionan información sobre las operaciones que se realizaron en un recurso de Azure. Los registros de recursos los genera automáticamente el servicio de búsqueda, pero no se recopilan de forma predeterminada. Debe crear una configuración de diagnóstico con el fin de enviar los registros de recursos a un área de trabajo Log Analytics que se usará con registros de Azure Monitor y Azure Event Hubs para reenviar fuera de Azure, o a Azure Storage para su archivado.

En esta sección se identifica el tipo (o categoría) de los registros de recursos que puede recopilar para Azure Cognitive Search:

  • Los registros de recursos se agrupan por tipo (o categoría). Azure Cognitive Search genera registros de recursos en la categoría Operaciones.

Como referencia, vea una lista de todos los tipos de categorías de registros de recursos admitidos en Azure Monitor.

Tablas de registros de Azure Monitor

Los registros de Azure Monitor son una característica de Azure Monitor que recopila y organiza los datos de registro y rendimiento de los recursos supervisados. Si ha realizado una configuración de diagnóstico para Log Analytics, puede consultar en las tablas de registros de Azure Monitor los registros de recursos que generó Azure Cognitive Search.

En esta sección se hace referencia a todas las tablas de registro de Kusto de Azure Monitor relevantes para Azure Cognitive Search y que están disponibles para su consulta mediante Log Analytics y el Explorador de métricas en Azure Portal.

Tabla Descripción
AzureActivity Entradas del registro de actividad de Azure que 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 representarán a través de una actividad denominada "Obtener clave de administración".
AzureDiagnostics Operaciones de indexación y consulta registradas.
AzureMetrics Datos de métrica que emite Azure Cognitive Search para medir el estado y el rendimiento.

Puede encontrar una referencia de todas las tablas de registros de Azure Monitor o de Log Analytics en Referencia de la tabla de registros de Azure Monitor.

Tablas de diagnóstico

Azure Cognitive Search usa la tabla Azure Diagnostics para recopilar registros de recursos relacionados con las consultas y la indexación en el servicio de búsqueda.

Las consultas realizadas en esta tabla en Log Analytics pueden incluir las propiedades comunes, las propiedades específicas de la búsqueda y las operaciones específicas de búsqueda que se enumeran en la sección de referencia de esquema.

Para obtener ejemplos de consultas de Kusto útiles para Azure Cognitive Search, consulte Supervisión de Azure Cognitive Search y Análisis del rendimiento en Azure Cognitive Search.

Registros de actividad

En la tabla siguiente, se enumeran las operaciones comunes relacionadas con Azure Cognitive Search que se pueden crear en el registro de actividad de Azure.

Operación Descripción
Obtener clave de administrador Cualquier operación que requiera derechos administrativos se registrará 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 las solicitudes realizadas con la clave de administración (creación o eliminación de 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.

Para más información sobre el esquema de las entradas del registro de actividad, consulte Esquema del registro de actividad.

Esquemas

Los siguientes esquemas los usa Azure Cognitive Search. Si va a compilar consultas o informes personalizados, las estructuras de datos que contienen registros de recursos de Azure Cognitive Search se ajustan al esquema siguiente.

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 Cognitive Search se complementa con propiedades y operaciones adicionales que son únicas para 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 String Nombre de la operación (consulte la lista completa de operaciones a continuación). 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 propiedades siguientes son específicas de Azure Cognitive 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 operaciones siguientes 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 Este es un índice que crea el Asistente para importar datos.
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 de una rutina a Get Service Statistics, que se realiza de forma directa o implícita 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.

Consulte también