Docs Menu
Docs Home
/ /

Supervisar estadísticas de las formas del query con Query Shape Perspectivas

Puede supervisar las métricas de ejecución de query a nivel de operación para formas del query con queries de ejecución lenta usando Query Shape Perspectivas. el Query Shape Insights La página muestra gráficos y una tabla que describen las métricas de rendimiento de las formas del query en tu proyecto con el mayor tiempo total de ejecución. Puedes filtrar los datos de la forma del query mostrados por host, partición y rango de tiempo, y seleccionar hasta cinco formas del query para visualizar en los correspondientes gráficos métricos.

Atlas solo es compatible con forma del query perspectivas en clústeres dedicados (M10 y superiores) que ejecutan MongoDB versión 8.0 o superiores.

Nota

Para garantizar el rendimiento y la escalabilidad en clústeres con un alto volumen de queries, Query Shape Insights puede mostrar datos de un conjunto de muestras del total de queries ejecutadas en tu clúster.

Para ver métricas con forma del query perspectivas, debes tener Project Observability Viewer, Project Data Access Read Only, Project Data Access Read/Write, Project Data Access Admin, o Project Owner acceso al proyecto.

Importante

Las formas del query que exponen nombres de campos pero valores redactados pueden contener información de usuario PII. Para ver formas del query truncadas o completas en Query Shape Perspectivas, debes tener uno de los roles de Proyecto enumerados anteriormente, que otorgan acceso para ver PII. Para los usuarios sin estos permisos, Query Shape Insights identifica las formas del query por su hash de forma del query.

Para acceder a forma del query perspectivas:

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. Haz clic en el nombre del clúster para abrir la barra lateral Cluster.

  2. Haz clic en Query Insights en la barra lateral de Cluster.

    La pestaña Query Shapes se muestra por defecto.

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

  • 7 días

  • 5 días

  • 2 días

  • 24 horas (por defecto)

  • 12 horas

  • 8 horas

  • 1 hora

Cuando aplicas un filtro, Atlas vuelve a obtener los datos para las gráficas y la tabla en la pantalla actual.

Nota

Los nodos de análisis se incluyen cuando filtras por estado de nodo secundario.

Query Shape Perspectivas muestra gráficas y una tabla que describen métricas para las formas del query en tu Proyecto con queries de ejecución lenta.

La tabla de Perspectivas de forma del query contiene una fila para cada una de las principales formas del query en tu Proyecto, donde las formas del query principales se determinan por el mayor tiempo total de ejecución. Cada fila contiene la forma del query o su hash de forma del query, el namespace de la forma del query, el comando de query y cualquier métricas que elija mostrar. Puedes usar el botón Edit Columns para elegir cuáles de las siguientes métricas incluir como columnas de la tabla:

Métrica
Descripción

Tiempo total de ejecución

Tiempo total en microsegundos dedicado a ejecutar queries con la forma del query dada. Si la query resultó en getMore comandos, esta métrica incluye el tiempo dedicado al procesamiento de las solicitudes de getMore. Esta métrica no incluye el tiempo dedicado a esperar por el cliente.

Tiempo medio de ejecución

Tiempo promedio en microsegundos empleado en la ejecución de queries con la forma del query dada. Si la query resultó en getMore comandos, esta métrica incluye el tiempo dedicado a procesar las solicitudes getMore. Esta métrica no incluye el tiempo que se pasa esperando al cliente.

Recuento de ejecuciones

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

Claves examinadas

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

Claves examinadas:devueltas

Proporción entre las claves índice dentro y fuera de los límites examinadas y los índices que contienen documentos devueltos por queries con la forma del query dada.

Docs examinados

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

Docs 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 query hasta la primera respuesta del servidor.

Última hora de ejecución

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

Tiempo de ejecución de P50

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

Tiempo de ejecución de P90

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

Tiempo de ejecución de P99

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

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

Atlas puede graficar cada métrica para hasta cinco formas (shapes) de consulta a la vez. Por defecto, Atlas Charts cada métrica para las cinco formas de consulta con el Total Execution Time más alto. Puedes optar por graficar diferentes formas de consulta seleccionando o deseleccionando la casilla de verificación en la fila de las formas de consulta que desees. Puedes gestionar qué formas de consulta graficar desde la tabla, seleccionando o desmarcando la casilla de verificación en la fila de las formas de consulta que desees.

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

  • Sello de tiempo de última visualización

  • Primera marca de tiempo vista

  • Última aplicación vista

  • Nombre y versión del controlador vistos por última vez

  • Primera vez que se ve la Aplicación

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

Por defecto, Query Shape Insights muestra gráficos de métricas para las cinco principales forma del query con el mayor Total Execution Time. Puede seleccionar hasta cinco forma del query para graficar en la tabla Query Shape Insights.

Buscar y seleccionar forma del query en la tabla Query Shape Insights:

1

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

  • Forma del query: En el cuadro de búsqueda Search by Query Shape, introduce la forma del query o su hash de query asociado.

  • Espacio de nombres: En el menú desplegable Select Namespaces, selecciona uno o más espacios de nombres por los que filtrar.

  • Comando: En el menú desplegable Select Commands, seleccione uno o más comandos por los que 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, haz clic en el icono sort junto al nombre de la columna asociada una vez o dos, respectivamente. Para ordenar por varias columnas, presiona Shift y haga clic en los iconos sort en el orden en que desea ordenar múltiples veces la tabla.

3

Has clic en la casilla de verificación en la fila de la forma del query deseada.

Puede seleccionar hasta cinco formas de consulta a la vez.

Volver

Acceso con el servidor MCP

En esta página