Docs Menu
Docs Home
/ /

Supervisar las estadísticas de forma de consulta con Query Shape Insights

Puede supervisar las métricas de ejecución de consultas a nivel de operación para formas de consulta con consultas de ejecución lenta utilizando Query Shape Insights. El Query Shape Insights Esta página muestra gráficos y una tabla que describen las métricas de rendimiento de las formas de consulta de su proyecto con el mayor tiempo total de ejecución. Puede filtrar los datos de las formas de consulta por host, fragmento e intervalo de tiempo, y seleccionar hasta cinco formas de consulta para visualizarlas en los gráficos de métricas correspondientes.

Atlas admite Query Shape Insights solo en clústeres dedicados (M10 y superiores) que ejecutan MongoDB versión 8.0 y superiores.

Nota

Para garantizar el rendimiento y la escalabilidad de los clústeres con un alto volumen de consultas, Query Shape Insights puede mostrar datos de un conjunto de muestra de la totalidad de consultas ejecutadas en su clúster.

Para ver métricas con Query Shape Insights, debe tener Project Observability Viewer,,, Project Data Access Read Only Project Data Access Read/WriteProject Data Access Admino acceso al Project Owner proyecto.

Importante

Las consultas dan forma a los nombres de los campos, pero los valores redactados pueden contener información del usuario. Información de identificación personal (PII). Para ver formas de consulta truncadas o completas en Query Shape Insights, debe tener uno de los roles de proyecto mencionados anteriormente, cada uno de los cuales otorga acceso para ver la PII. Para los usuarios sin estos permisos, Query Shape Insights identifica las formas de consulta por su hash.

Para acceder a Query Shape Insights:

1
  1. Si aún no se muestra, seleccione la organización que contiene su proyecto deseado en el menú Organizations de la barra de navegación.

  2. Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.

  3. En la barra lateral, haz clic en Clusters en la sección Database.

La página de clústeres se muestra.

2
  1. Haga clic en View Monitoring para esa instancia en el panel del proyecto.

  2. Haz clic en la pestaña Query Insights.

    La pestaña Query Shapes se muestra de forma predeterminada.

Puede filtrar la página Query Insights por nodo, estado del nodo (principal o secundario) y fragmento. También puede filtrar por un rango de fechas personalizado dentro de los últimos siete días o seleccionar uno de los siguientes rangos de tiempo predefinidos:

  • días de 7

  • días de 5

  • 2 días

  • 24 horas (predeterminado)

  • horas de 12

  • 8 horas

  • 1 hora

Cuando se aplica un filtro, Atlas vuelve a buscar datos para los gráficos y la tabla en la pantalla actual.

Query Shape Insights muestra gráficos y una tabla que describen las métricas de las formas de consulta en su proyecto con consultas de ejecución lenta.

La tabla "Información de formas de consulta" contiene una fila por cada forma de consulta principal del proyecto. Estas se determinan según el tiempo total de ejecución más alto. Cada fila contiene la forma de consulta o su hash, el espacio de nombres de la forma de consulta, el comando de consulta y las métricas que seleccione para mostrar. Puede usar el botón Edit Columns para seleccionar cuáles de las siguientes métricas desea incluir como columnas de la tabla:

Métrica
Descripción

Tiempo total de ejecución

Tiempo total en microsegundos dedicado a ejecutar consultas con la forma de consulta especificada. Si la consulta generó getMore comandos, esta métrica incluye el tiempo dedicado a procesar las getMore solicitudes. Esta métrica no incluye el tiempo de espera del cliente.

Tiempo promedio de ejecución

Tiempo promedio en microsegundos dedicado a ejecutar consultas con la forma de consulta especificada. Si la consulta generó getMore comandos, esta métrica incluye el tiempo dedicado a procesar las getMore solicitudes. Esta métrica no incluye el tiempo de espera del cliente.

Recuento de ejecuciones

Número total de veces que se han ejecutado queries con la forma del query dada.

Llaves examinadas

Número total de claves de índice dentro y fuera de los límites examinadas por queries con la forma del query dada.

Llaves examinadas: devueltas

Relación de claves de índice dentro y fuera de los límites examinadas con respecto a los índices que contienen documentos devueltos por consultas con la forma de consulta dada.

Documentos examinados

Número total de documentos examinados por consultas con la forma de consulta dada.

Documentos devueltos

Número total de documentos devueltos por queries con la forma del query dada.

Docs examinados: devueltos

Proporción de documentos examinados respecto a documentos devueltos por consultas con la forma del query dada.

Tiempo total de respuesta

Tiempo en microsegundos transcurrido desde el comienzo del procesamiento de la consulta hasta la primera respuesta del servidor.

Hora de la última ejecución

Tiempo de ejecución en microsegundos para la consulta más reciente con la forma de consulta dada.

P50 Tiempo de ejecución

Percentil 50en el histograma de tiempo de ejecución.

P90 Tiempo de ejecución

Percentil 90en el histograma de tiempo de ejecución.

P99 Tiempo de ejecución

Percentil 99en el histograma de tiempo de ejecución.

También puede mostrar gráficos para una o más de las métricas anteriores seleccionando cada métrica que desee graficar en el menú desplegable en el encabezado del componente Query Shape Statistics.

Atlas puede graficar cada métrica para hasta cinco formas de consulta simultáneamente. De forma predeterminada, Atlas grafica cada métrica para las cinco formas de consulta con el valor más alto Total Execution Time. Puede elegir graficar diferentes formas de consulta marcando o desmarcando la casilla correspondiente a la forma deseada. Puede administrar las formas de consulta que desea graficar desde la tabla marcando o desmarcando la casilla correspondiente a la forma deseada.

Para ver más detalles sobre una forma de consulta, haga clic en la fila correspondiente para abrir la vista Query Shape Details. Esta vista contiene la forma de consulta completa y su hash, cada métrica de tabla mencionada anteriormente y las siguientes métricas adicionales:

  • Sello de tiempo de última visualización

  • Marca de tiempo de primera vista

  • Aplicación vista por última vez

  • Último nombre y versión del controlador visto

  • Aplicación vista por primera vez

  • Nombre y versión del controlador vistos por primera vez

De forma predeterminada, Query Shape Insights muestra gráficos de métricas para las cinco formas de consulta principales con el valor más alto de Total Execution Time. Puede seleccionar hasta cinco formas de consulta para representarlas en la tabla Query Shape Insights.

Para buscar y seleccionar formas de consulta en la tabla Query Shape Insights:

1

Puede filtrar la tabla Query Shape Insights por las siguientes categorías:

  • Forma de consulta: en el Search by Query Shape cuadro de búsqueda, ingrese la forma de consulta o su hash de consulta asociado.

  • Espacio de nombres: en el Select Namespaces menú desplegable, seleccione uno o más espacios de nombres para filtrar.

  • Comando: en el Select Commands menú desplegable, seleccione uno o más comandos para filtrar.

2

Puedes ordenar la tabla Query Shape Insights por una o más columnas de métricas para ayudar a identificar qué formas del query graficar.

Para ordenar por una métrica en orden descendente o ascendente, haga clic en el icono sort junto al nombre de la columna asociada una o dos veces, respectivamente. Para ordenar por varias columnas, pulse Shift y haga clic en los íconos sort en el orden en el que desea ordenar la tabla de forma múltiple.

3

Haga clic en la casilla de verificación en la fila de la forma de consulta deseada.

Puede seleccionar hasta cinco formas de consulta a la vez.

Volver

Acceso con el servidor MCP

En esta página